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