Configure Google search, maps, trends, reviews, lens, hotels, and flights with Bright Data’s SERP API, including parameters for localization, pagination, device type, parsing, and more.
Localization
google.com
and as such, any SERP API request sent to a different Google TLD (e.g., google.co.uk
, google.ca
) will automatically be routed through google.com
.Localization is no longer determined by the TLD and should instead be configured solely using the gl
(country) and hl
(language) query parameters below:gl
hl
Search type
Pagination
start
Examples:
start=0
(default) - first page of results
start=20
- second page of results
start=40
- third page of results, etc.
num
Examples:
num=20
(default) - return 20 results
num=50
- return 50 results, etc.
Geo-Location
uule
uule
values can be downloaded here.The value of column “Canonical Name” from the CSV can be used as a raw string to the APIExample:
&uule=New+York,New+York,United+States
Device
brd_mobile
brd_mobile=0
will provide random desktop user-agent while brd_mobile=1
will provide random mobile user-agent.For specific mobile platform provide one of the following values:
brd_mobile=ios
- iPhone user-agent (aliasbrd_mobile=iphone
)
brd_mobile=ipad
- iPad user-agent (aliasbrd_mobile=ios_tablet
)
brd_mobile=android
- Android phone
brd_mobile=android_tablet
- Android tablet
Browser
brd_browser
brd_mobile
to get according mobile browser. For specific browser provide one of the following values:
brd_browser=chrome
- Google Chrome
brd_browser=safari
- Safari
brd_browser=firefox
- Mozilla Firefox (not compatible withbrd_mobile=1
)
Parsing
Hotel search
hotel_occupancy
brd_occupancy
parameter of Hotels which provides more flexibility.Examples:
hotel_occupancy=1
- for 1 guest
hotel_occupancy=2
(default) - for 2 guests
hotel_dates
YYYY-MM-DD,YYYY-MM-DD
Examples:
hotel_dates=2022-05-01,2022-05-03
- find rooms available from 1st until 3rd of May, 2022
Search by image (/searchbyimage only)
Multiple requests
multi
To initiate a request, perform:multi=[{"query":{"q":"pizza","num":20}},{"query":{"q":"pizza","num":100}}]
- the same keyword with different num param
multi=[{"query":{"q":"pizza"}},{"query":{"q":"burger"}}]
- different keywords
x-response-id
header will contain the id of the request so you can use it in the next request to fetch the resultAI Overview
brd_ai_overview
brd_ai_overview=2
will increase the likelihood of receiving Google’s Generative AI Overviews in your SERP responses, typically appearing in ~15-20%+ of results.Localization
Coordinates
geo params
@ + latitude + , + longitude + , + zoom
.Example:
@47.30227,1.67458,14.00z
zoom
parameter is optional but recommended for higher precision. It ranges from 3z, map completely zoomed out - to 21z, map completely zoomed inPagination
start
Examples:
start=0
(default) - first page of results
start=20
- second page of results
start=40
- third page of results, etc.
num
Examples:
num=20
(default) - return 20 results
num=50
- return 50 results, etc.
Maps place overview
fid
fid
.Use GET request on http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s with the fid
value at the end.Sorting and filtering
brd_json=1
: Returns parsed JSON results (Trends supports parsed results only).brd_trends=timeseries,geo_map
: Retrieves widget data with best success rates.
Widgets
Geo
Localization
Time range
date
Available values are:now 1-H
- Past hournow 4-H
- Past 4 hoursnow 1-d
- Past daynow 7-d
- Past 7 daystoday 1-m
- Past 30 daystoday 3-m
- Past 90 daystoday 12-m
(default) - Past 12 monthstoday 5-y
- Past 5 years2020-07-01 2020-12-31
- custom date range
Category
Search type
gprop
images
, news
, froogle
(for Google Shopping), youtube
Feature id
fid
fid
parameter can be found in knowledge.fid
field of google search response.For example:
https://www.google.com/search?q=hilton%20new%20york%20midtown
Localization
Sorting and filtering
sort
Possible values are:
sort=qualityScore
(default) - most relevant first
sort=newestFirst
- newest first
sort=ratingHigh
- highest rating first
sort=ratingLow
- lowest rating first
filter
For Example:
filter=awesome
- search for reviews containing ‘awesome’ word
Pagination
start
Examples:
start=0
(default) - first page of results
start=10
- second page of results
start=20
- third page of results, etc.
num
Examples:
num=10
(default) - return 10 results
num=20
- return 20 results (max).
Image URL
Localization
Parsing
Upload image as file
Get exact matches
brd_lens
brd_lens
parameter in your request fetches specific Google Lens tab results by specifying a tab value (e.g. products
, homework
, visual_matches
, exact_matches
).
Localization
Booking dates and options
brd_dates
Format:
YYYY-MM-DD,YYYY-MM-DD
Example:
2022-01-20,2022-02-05
brd_occupancy
Also supports a comma-separated list of integers where:Examples:
brd_occupancy=1
- look for a room for 1 person
brd_occupancy=2
(default) - for 2 persons
brd_occupancy=3
- for 3 persons, etc.
Format:
brd_occupancy=<number of adults>,<child 1 age>,<child 2 age>,...,<child N age>
Examples:
brd_occupancy=1,5,7,12
- for 1 adult and 3 children (5, 7 and 12 years old)
brd_occupancy=2,1,3
- for 2 adults and 2 children (1 and 3 years old)
brd_free_cancellation
Examples:
brd_free_cancellation=true
- with free cancellation
brd_free_cancellation=false
(default) - show any offers
brd_accomodation_type
Examples:
brd_accomodation_type=hotels
(default) - search for Hotels
brd_accomodation_type=vacation_rentals
- search for Vacation Rentals
brd_currency
Examples:
brd_currency=USD
- United States Dollars
brd_currency=EUR
- Euro
brd_currency=INR
- Indian Rupees
Output format
brd_mobile
brd_mobile=0
will provide random desktop user-agent while brd_mobile=1
will provide random mobile user-agent.For specific mobile platform provide one of the following values:
brd_mobile=ios
- iPhone user-agent (aliasbrd_mobile=iphone
)
brd_mobile=ipad
- iPad user-agent (aliasbrd_mobile=ios_tablet
)
brd_mobile=android
- Android phone
brd_mobile=android_tablet
- Android tablet
brd_json
Examples:
brd_json=1
- return results in JSON