SERP API 入门

立即开始，每月赠送 5,000 个免费信用额度，无需信用卡。参见免费套餐。我们还将匹配您的首次账户充值金额，最高可达 $500。

无需管理代理、CAPTCHA 或解析，即可大规模收集搜索引擎结果。在 1 秒内从 Google、Bing 等搜索引擎获取结构化数据。 适用场景：

SEO 排名跟踪和关键词监控
执行网页搜索和数据丰富的 AI 代理
品牌保护和广告情报
竞争市场调研和价格比较

仅为成功交付付费。

开始前

登录: https://www.bright.cn/cp/start
创建 SERP API: https://www.bright.cn/cp/learn_more/serp-api
获取您的 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"
  }'

// Node 18+ (global fetch)
const resp = await fetch('https://api.brightdata.com/request', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <BRIGHT_DATA_API_KEY>',
  },
  body: JSON.stringify({
    zone: 'YOUR_SERP_API_ZONE',
    url: 'https://www.google.com/search?q=pizza&hl=en&gl=us',
    format: 'raw' // 设置为 "json" 获取解析后的输出
  }),
});

console.log(await resp.text());

import requests

headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <BRIGHT_DATA_API_KEY>',
}

payload = {
    'zone': 'YOUR_SERP_API_ZONE',
    'url': 'https://www.google.com/search?q=pizza&hl=en&gl=us',
    'format': 'raw'  # 设置为 "json" 获取解析后的输出
}

r = requests.post('https://api.brightdata.com/request',
                  headers=headers, json=payload)

print(r.text)

喜欢 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

支持的搜索引擎和参数

Google、Bing、DuckDuckGo、Yandex、Baidu、Yahoo、Naver
特定引擎查询参数：
- Google: /cn/scraping-automation/serp-api/query-parameters/google
- Bing: /cn/scraping-automation/serp-api/query-parameters/bing

性能优化

仅获取前 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"
  }'

const response = await fetch('https://api.brightdata.com/request', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    zone: '<ZONE_NAME>',
    url: 'https://www.google.com/search?q=pizza&hl=en&gl=us',
    format: 'raw',
    data_format: 'parsed_light'
  })
});

const data = await response.json();
console.log(data.organic);  // 前 10 条结果数组

response = requests.post(
    'https://api.brightdata.com/request',
    headers={'Authorization': 'Bearer <API_KEY>'},
    json={
        'zone': '<ZONE_NAME>',
        'url': 'https://www.google.com/search?q=pizza&hl=en&gl=us',
        'format': 'raw',
        'data_format': 'parsed_light'
    }
)

data = response.json()
print(data['organic'])  # 前 10 条结果数组

响应示例：

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 申请访问权限。

何时使用异步请求

对于大批量、页面加载慢或查询耗时长的请求，使用异步可提高可靠性和吞吐量。

指南：/cn/scraping-automation/serp-api/asynchronous-requests

针对非 SERP 页面？使用 Web Unlocker API: /cn/scraping-automation/web-unlocker

快速排查问题

401/403: 检查 API 密钥和 zone 权限。参考: /cn/api-reference/authentication
429: 减少并发或切换至异步。参考: /cn/scraping-automation/serp-api/asynchronous-requests
结果为空或部分结果: 验证引擎特定参数（如 hl, gl, uule, location）
结果异常: 使用非拉丁字符时可能出现。Google 搜索请求需对查询进行编码。
仍有问题？ 查看常见问题: /cn/scraping-automation/serp-api/faqs

介绍

产品指南

开始前

快速开始

在 Postman 中运行

Node.js 示例

Python 示例

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

支持的搜索引擎和参数

性能优化

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

低于 1 秒的响应时间

何时使用异步请求

快速排查问题

下一步

发送第一个请求

SERP 定价与计费

查询参数（Google）

解析后的 JSON 结果

异步请求

快速开始

常见问题

​开始前

​快速开始

在 Postman 中运行

Node.js 示例

Python 示例

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

​支持的搜索引擎和参数

​性能优化

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

​低于 1 秒的响应时间

​何时使用异步请求

​快速排查问题

​下一步

发送第一个请求

SERP 定价与计费

查询参数（Google）

解析后的 JSON 结果

异步请求

快速开始

常见问题

开始前

快速开始

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

支持的搜索引擎和参数

性能优化

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

低于 1 秒的响应时间

何时使用异步请求

快速排查问题

下一步