Skip to main content

gl

Two-letter country code used to define the country of search
gl

hl

Two-letter language code used to define the page languages
hl

tbm

Define search type. For regular search there is no need to use the tbm parameter while other types have a unique tbm value.

Example:

tbm=isch - images
tbm=shop - shopping
tbm=nws - news
tbm=vid - videos

ibp

Use the ibp parameter for Jobs search type.

Example:

ibp=htl;jobs - Jobs

start

Define the result offset - results to start from the selected value. Used for managing pagination.

Examples:

start=0 (default) - first page of results
start=20 - second page of results
start=40 - third page of results, etc.

num

Defines the number of results to return.

Examples:

num=20 (default) - return 20 results
num=50 - return 50 results, etc.

uule

Stands for the encoded location you want to use for your search and will be used to change geo-location. A CSV with all available uule values can be downloaded here.The value of column “Canonical Name” from the CSV can be used as a raw string to the API

Example:

&uule=New+York,New+York,United+States

brd_mobile

Define what device type to be represented in user-agent.
Default or 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 (alias brd_mobile=iphone)
brd_mobile=ipad - iPad user-agent (alias brd_mobile=ios_tablet)
brd_mobile=android - Android phone
brd_mobile=android_tablet - Android tablet

brd_browser

Define what browser to be represented in user-agent.
Can be combined with brd_mobile to get according mobile browser.
Default will provide random 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 with brd_mobile=1)

brd_json

Bright Data custom parameter allowing to return parsed JSON instead of raw HTML

Examples:

brd_json=1 - return results in JSON
brd_json=html - return JSON with “html” field containing raw HTML

hotel_occupancy

Number of guests to book a room for (up to 4).
See 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

Check-in date and check-out date, separated by comma.
Format: 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

download

Download image on the proxy side and post it to google using POST request

Examples:

default - download-and-post if google isn’t able to download the image
download=1 - force download-and-post image
download=0 - regular GET request with image URL
Please note that parallel requests work only with async mode.

multi

Make parallel requests through our API server using POST request.
Parallel requests will be using the same peer and session and can be used for comparison tests, I.e. making an identical pair of requests with 2 different values for a selected parameter
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
To initiate a request, perform:
x-response-id header will contain the id of the request so you can use it in the next request to fetch the result

brd_ai_mode=1

Using brd_ai_mode=1 will increase the likelihood of encountering Google’s Generative AI Overviews in your SERP responses (will generally display in ~15-20%+ of results).
  • To better trigger an AI Overview, your SERP keywords must be relevant to topics that Google considers suitable for generative responses.
  • This query parameter is currently supported only on the following Google domains: google.com, google.co.uk, google.co.in, google.com.au, google.ca.

Maps

gl

Two-letter country code used to define the country of search
gl

hl

Two-letter language code used to define the page languages
hl

geo params

Parameters defining GPS coordinates of a search location. It should be constucted the following way: @ + latitude + , + longitude + , + zoom.

Example:

@47.30227,1.67458,14.00z
The zoom parameter is optional but recommended for higher precision. It ranges from 3z, map completely zoomed out - to 21z, map completely zoomed in

start

Define the result offset - results to start from the selected value. Used for managing pagination.

Examples:

start=0 (default) - first page of results
start=20 - second page of results
start=40 - third page of results, etc.

num

Defines the number of results to return.

Examples:

num=20 (default) - return 20 results
num=50 - return 50 results, etc.

fid

Get the results of a Google Maps Place by fid.Use GET request on http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s with the fid value at the end.

brd_accomodation_type

Accomodation type: Hotels or Vacation Rentals.

Examples:

brd_accomodation_type=hotels (default) - search for Hotels
brd_accomodation_type=vacation_rentals - search for Vacation Rentals

brd_json

Bright Data custom parameter allowing to return parsed JSON instead of raw HTML

Examples:

brd_json=1 - return results in JSON
Required Parameters
brd_json=1: Returns parsed JSON results (Trends supports parsed results only).
brd_trends=timeseries,geo_map: Retrieves widget data with best success rates.
We support only the “Trending now” tab within Google Trends. Other tabs (e.g. “Explore”, “Home”) are not supported as they require login access for full functionality.
To display specific widget data within your Google Trends results, use one of the following widget parameters:

timeseries

geo_map

For multiple widgets: Separate them with a comma. e.g. timeseries,geo_map

geo

Location of interest, two-letter country code

hl

Preferred language, two-letter language code

date

Time range to search.
Available values are: now 1-H - Past hour now 4-H - Past 4 hours now 1-d - Past day now 7-d - Past 7 days today 1-m - Past 30 days today 3-m - Past 90 days today 12-m (default) - Past 12 months today 5-y - Past 5 years 2020-07-01 2020-12-31 - custom date range

cat

Category to search within. By default, search within all categories. You can find list of all categories here.

gprop

Google property to filter on. Defaults to web search. Possible values are: images, news, froogle (for Google Shopping), youtube

Reviews

fid

Feature id what you want to fetch reviews to. 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

hl

Preferred language, two-letter language code

sort

The way reviews are sorted.
Possible values are:
sort=qualityScore (default) - most relevant first
sort=newestFirst - newest first
sort=ratingHigh - highest rating first
sort=ratingLow - lowest rating first

filter

Filter keyword. Will respond with reviews that contain specified keyword only.

For Example:

filter=awesome - search for reviews containing ‘awesome’ word

start

Define the result offset - results to start from the selected value. Used for managing pagination.

Examples:

start=0 (default) - first page of results
start=10 - second page of results
start=20 - third page of results, etc.

num

Defines the number of results to return.

Examples:

num=10 (default) - return 10 results
num=20 - return 20 results (max).

Lens

url

URL of image you want to search

hl

Preferred language, two-letter language code

brd_json

Bright Data custom parameter allowing to return parsed JSON instead of raw HTML

Examples:

brd_json=1 - return results in JSON
brd_json=html - return JSON with “html” field containing raw HTML

upload

Upload an image named cat.jpg located in a current directory (not supported on async zones)

brd_lens

The 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).brd_lens

Hotels

gl

Two-letter country code used to define the country of search

hl

Two-letter language code used to define the page language

brd_dates

Check-in date and check-out date, separated by comma.

Format:

YYYY-MM-DD,YYYY-MM-DD

Example:

2022-01-20,2022-02-05

brd_occupancy

Number of guests to book a room for (maximum 6 guests).

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.
Also supports a comma-separated list of integers where:
  • first value is a number of adult guests
  • subsequent values are ages of children

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

Show only offers with free cancellation.

Examples:

brd_free_cancellation=true - with free cancellation
brd_free_cancellation=false (default) - show any offers

brd_accomodation_type

Accomodation type: Hotels or Vacation Rentals.

Examples:

brd_accomodation_type=hotels (default) - search for Hotels
brd_accomodation_type=vacation_rentals - search for Vacation Rentals

brd_currency

Currency to show prices at (3-letter code).

Examples:

brd_currency=USD - United States Dollars
brd_currency=EUR - Euro
brd_currency=INR - Indian Rupees

brd_mobile

Define what device type to be represented in user-agentDefault or 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 (alias brd_mobile=iphone)
brd_mobile=ipad - iPad user-agent (alias brd_mobile=ios_tablet)
brd_mobile=android - Android phone
brd_mobile=android_tablet - Android tablet

brd_json

Bright Data custom parameter allowing to return parsed JSON instead of raw HTML

Examples:

brd_json=1 - return results in JSON

Flights

gl

Two-letter country code used to define the country of search

hl

Two-letter language code used to define the page language

tfs

String representing flight search parameters

curr

Defines the currency of returned prices