Fast SERP web search

Bright Data offers a fast SERP service with a compact JSON response, to power real-time applications in need of search results. To gain access to Bright Data FAST SERP service, please contact your Bright Data account manager.

Fast SERP Request

Fast SERP works best with the native proxy interface. If you need a REST API interface for your architecture, one can be provided.

For Fast SERP, both the x-unblock-data-format: parsed_lightrequest header and the brd_json=1 URL parameter are required. Omitting either will result in an unexpected response format.

How to get organic results

Use header value x-unblock-data-format: parsed_fast, this request header will return organic results.

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

Organic results: response format

`organic` array

The primary array of web search results, present in both parsed_light and parsed_fast responses.

Field	Type	Description
`link`	string	URL of the result page
`title`	string	Title of the result
`description`	string	Snippet/summary shown in the search result
`global_rank`	integer	Rank position of the result on the page
`extensions`	array	Optional list of site links associated with the result (see below)

`extensions` items

Field	Type	Description
`type`	string	Type of extension, e.g. `site_link`
`link`	string	URL of the site link
`text`	string	Anchor text of the site link

Example response, `parsed_fast` (organic results)

{
  "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
    }
  ]
}

Organic results with “Top Stories”

Use header value x-unblock-data-format: parsed_light, this request header will return Google’s “Top Stories” in the response alongside organic results.

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

`top_stories` array

Returned only when using x-unblock-data-format: parsed_light. Contains Google’s “Top Stories” news carousel results.

Field	Type	Description
`link`	string	URL of the news article
`title`	string	Headline of the article
`source`	string	Name of the news publisher
`date`	string	Publication date/time of the article
`image`	string	URL of the article’s thumbnail image

Example response, `parsed_light` (with Top Stories)

{
  "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"
    }
  ]
}

Response schema, with Top Stories: https://api.brightdata.com/data_schemas/fast_serp/google_search.schema.json Response schema, without Top Stories: https://api.brightdata.com/data_schemas/fast_serp/google_search_web.schema.json

Supported parameters

Parameter	Description	Example	Notes
`q`	Search query (must be first in URL)	`q=pizza`	Query size must be under 8,000 charachters. Longer queries fail with error.
`gl`	Two-letter country code for search country	`gl=us`
`hl`	Two-letter language code for page language	`hl=en`
`brd_json`	Required.`1` = parsed JSON	`brd_json=1`

Introduction

Product Guides

Fast SERP Request

How to get organic results

Organic results: response format

`organic` array

`extensions` items

Example response, `parsed_fast` (organic results)

Organic results with “Top Stories”

`top_stories` array

Example response, `parsed_light` (with Top Stories)

Supported parameters

​Fast SERP Request

​How to get organic results

​Organic results: response format

​organic array

​extensions items

​Example response, parsed_fast (organic results)

​Organic results with “Top Stories”

​top_stories array

​Example response, parsed_light (with Top Stories)

​Supported parameters

Fast SERP Request

How to get organic results

Organic results: response format

`organic` array

`extensions` items

Example response, `parsed_fast` (organic results)

Organic results with “Top Stories”

`top_stories` array

Example response, `parsed_light` (with Top Stories)

Supported parameters