跳转到主要内容

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.

Bright Data 为精选企业客户提供快速 SERP 服务。该 SERP 服务返回紧凑的 JSON 格式，为需要实时搜索结果的应用程序提供支持。要获取此服务的访问权限，请联系您的 Bright Data 账户经理。

​
开始前

Fast SERP 支持多个 Google 垂直领域——网络搜索、新闻、购物、图片等。本页面涵盖标准网络搜索 (google.com/search)。如果您需要其他垂直领域，请查看该搜索类型的相关页面。
在开始之前，请同时考虑您的 POC/测试量和预期的生产量。这有助于确保您的区域针对您的工作负载进行了正确配置。如果您不确定，请从估计开始——您的账户经理可以随着您的使用增长而调整您的速率分配。
如果您的系统具有内部速率限制或负载控制机制，请与您的账户经理共享这些��细信息。这有助于将您的区域容量与您的基础设施行为相匹配，并避免不必要的错误。
Fast SERP 最适合使用本机代理接口——它比 REST API 略快。如果您的架构需要，可以提供 REST API 接口。
Fast SERP 支持多个部署区域：美国东部、美国西部、欧盟和 APAC。提前了解您的爬虫区域有助于优化路由和延迟。如果您的生产流量分布在多个区域，请告知您的账户经理。

​
Fast SERP 请求

Fast SERP 最适合与本机代理接口配合使用。如果您的架构需要 REST API 接口，可以提供。
对于 Fast SERP，两者都需要：x-unblock-data-format: parsed_light 请求头和 brd_json=1 URL 参数。省略其中任何一个都会导致意外的响应格式。

​
本机代理请求

​
有机结果

使用请求头值 x-unblock-data-format: parsed_fast——此请求头将返回有机结果。 
curl -i --proxy fserp.brd.superproxy.io:33335 \
  --proxy-user brd-customer-<CUSTOMER>-zone-<ZONE>:<PASSWORD> \
  -k \
  -H 'x-unblock-data-format: parsed_fast' \
  "https://www.google.com/search?q=pizza&brd_json=1" \
  > output.json

​
有机结果及 Google 的”头条新闻”

使用请求头值 x-unblock-data-format: parsed_light——此请求头将在响应中返回 Google 的”头条新闻”以及有机结果。 
curl -i --proxy fserp.brd.superproxy.io:33335 \
  --proxy-user brd-customer-<CUSTOMER>-zone-<ZONE>:<PASSWORD> \
  -k \
  -H 'x-unblock-data-format: parsed_light' \
  "https://www.google.com/search?q=pizza&brd_json=1" \
  > output.json

​
响应格式

​
organic 数组

主要的网络搜索结果数组，存在于 parsed_light 和 parsed_fast 响应中。
字段类型描述
link字符串结果页面的 URL
title字符串结果的标题
description字符串搜索结果中显示的片段/摘要
global_rank整数结果在页面上的排名位置
extensions数组与结果关联的网站链接的可选列表（见下文）

​
extensions 项目

字段类型描述
type字符串扩展类型，例如 site_link
link字符串网站链接的 URL
text字符串网站链接的锚文本

​
top_stories 数组

仅在使用 x-unblock-data-format: parsed_light 时返回。包含 Google 的”头条新闻”新闻轮播结果。
字段类型描述
link字符串新闻文章的 URL
title字符串文章的标题
source字符串新闻发布商的名称
date字符串文章的发布日期/时间
image字符串文章缩略图的 URL

​
响应示例 — parsed_fast（有机结果）

{
  "organic": [
    {
      "link": "https://en.wikipedia.org/wiki/Pizza",
      "title": "Pizza - Wikipedia",
      "description": "Pizza is an Italian dish consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients.",
      "global_rank": 1,
      "extensions": [
        {
          "type": "site_link",
          "link": "https://en.wikipedia.org/wiki/Neapolitan_pizza",
          "text": "Neapolitan pizza"
        }
      ]
    },
    {
      "link": "https://www.example-pizza.com/best-pizza-nyc",
      "title": "Best Pizza in NYC - Joe's Pizza",
      "description": "Family-owned pizzeria serving authentic New York slices since 1975.",
      "global_rank": 2
    },
    {
      "link": "https://www.pizza-guide.com/top-10",
      "title": "Top 10 Pizza Places in NYC",
      "description": "Discover the highest-rated pizza restaurants across all five boroughs.",
      "global_rank": 3
    }
  ]
}

​
响应示例 — parsed_light（包含头条新闻）

{
  "organic": [
    {
      "link": "https://en.wikipedia.org/wiki/Pizza",
      "title": "Pizza - Wikipedia",
      "description": "Pizza is an Italian dish consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients.",
      "global_rank": 1,
      "extensions": [
        {
          "type": "site_link",
          "link": "https://en.wikipedia.org/wiki/Neapolitan_pizza",
          "text": "Neapolitan pizza"
        },
        {
          "type": "site_link",
          "link": "https://en.wikipedia.org/wiki/Pizzeria",
          "text": "Pizzeria"
        }
      ]
    },
    {
      "link": "https://www.example-pizza.com/best-pizza-nyc",
      "title": "Best Pizza in NYC - Joe's Pizza",
      "description": "Family-owned pizzeria serving authentic New York slices since 1975.",
      "global_rank": 2
    }
  ],
  "top_stories": [
    {
      "link": "https://www.example-news.com/pizza-festival",
      "title": "NYC Pizza Festival Returns This Summer",
      "source": "Example News",
      "date": "3 hours ago",
      "image": "https://www.example-news.com/images/pizza-fest.jpg"
    },
    {
      "link": "https://www.another-outlet.com/pizza-record",
      "title": "World Record Pizza Baked in Naples",
      "source": "Another Outlet",
      "date": "5 hours ago",
      "image": "https://www.another-outlet.com/images/pizza-record.jpg"
    }
  ]
}
响应架构——包含头条新闻：https://api.brightdata.com/data_schemas/fast_serp/google_search.schema.json 响应架构——不包含头条新闻：https://api.brightdata.com/data_schemas/fast_serp/google_search_web.schema.json