跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt

Use this file to discover all available pages before exploring further.

无需管理代理、CAPTCHA 或解析，即可大规模收集搜索引擎结果。在 1 秒内从 Google、Bing 等搜索引擎获取结构化数据。 适用场景：
  • SEO 排名跟踪和关键词监控
  • 执行网页搜索和数据丰富的 AI 代理
  • 品牌保护和广告情报
  • 竞争市场调研和价格比较
仅为成功交付付费。

​
开始前

  1. 登录: https://brightdata.com/cp/start
  2. 创建 SERP API: https://brightdata.com/cp/learn_more/serp-api
  3. 获取您的 API 密钥: /cn/api-reference/authentication
新手指南：查看逐步指南: /cn/scraping-automation/serp-api/quickstart

​
快速开始

使用 cURL 的最小请求示例。将 <BRIGHT_DATA_API_KEY> 和 zone 替换为您的值： 
curl -X POST https://api.brightdata.com/request \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <BRIGHT_DATA_API_KEY>" \
  -d '{
    "zone": "YOUR_SERP_API_ZONE",
    "url": "https://www.google.com/search?q=pizza&hl=en&gl=us",
    "format": "raw"
  }'
喜欢 Markdown 输出？设置 “data_format”: “markdown” 接收 Markdown SERP 结构。
喜欢 JSON 输出？设置查询参数 “brd_json=1” 接收 JSON SERP 结构。

在 Postman 中运行

Node.js 示例

Python 示例

​
获取的结果（解析后的 JSON 预览）

解析结构的简要示例： 
{
  "engine": "google",
  "query": "pizza",
  "results": [
    { 
      "type": "organic", 
      "position": 1, 
      "title": "Best Pizza Near Me", 
      "url": "https://example.com" 
    }
  ]
}
查看完整的模式和示例：/cn/scraping-automation/serp-api/parsed-json-results/parsing-search-results

​
支持的搜索引擎和参数

​
性能优化

​
仅获取前 10 条结果（响应更快）

如果只需要前 10 条自然结果（无广告或知识面板），添加 "data_format": "parsed_light" 可加快响应速度： 
curl -X POST 'https://api.brightdata.com/request' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "zone": "<ZONE_NAME>",
    "url": "https://www.google.com/search?q=pizza&hl=en&gl=us",
    "format": "raw",
    "data_format": "parsed_light"
  }'
响应示例：
successful JSON response
{
  "organic": [
    {
      "link": "https://example.com/pizza",
      "title": "Best Pizza in NYC - Joe's Pizza",
      "description": "Family-owned pizzeria serving authentic New York slices since 1975...",
      "global_rank": 1
    },
    {
      "link": "https://example.com/pizza-guide",
      "title": "Top 10 Pizza Places in NYC",
      "description": "Discover the highest-rated pizza restaurants across all five boroughs...",
      "global_rank": 2,
      "extensions": [
        {
          "type": "site_link",
          "link": "https://example.com/pizza-guide/brooklyn",
          "text": "Brooklyn"
        }
      ]
    }
    // ... 其他 8 条结果
  ]
}

​
低于 1 秒的响应时间

使用专为关键 AI 应用设计的高级路由基础设施，可在 1 秒内 获取完整 SERP 结果（自然结果、广告、知识面板及所有元素）。 理想用途：
  • AI 代理执行实时数据丰富
  • 多步骤研究流程和事实验证
  • 模型评估和响应基础
  • 面向用户的搜索应用需即时结果
联系您的客户经理或 sales@brightdata.com 申请访问权限。

​
何时使用异步请求

对于大批量、页面加载慢或查询耗时长的请求，使用异步可提高可靠性和吞吐量。
针对非 SERP 页面？使用 Unlocker API: /cn/scraping-automation/web-unlocker

​
快速排查问题

​
下一步

发送第一个请求

SERP 定价与计费

查询参数（Google）

解析后的 JSON 结果

异步请求

快速开始

常见问题