SERP API Bing Query Parameters

Configure Bing search queries with Bright Data’s SERP API, including parameters for localization, geo-location, pagination, device targeting, and custom data output options.

Search

Localization

setLang

A language to use for user interface strings. You may specify the language using either a 2-letter or 4-letter code. Using 4-letter codes is preferred.

curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&setLang=en-US"

Geo-Location

location

A location for the search origin. Should be used together with lat (latitude) and lon (longitude) parameters.

curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&location=New+York%2C+New+York%2C+United+States&lat=40.7001958&lon=-74.1087142"

cc

A 2-character country code of the country where the results come from.

curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&cc=us"

mkt

A market where the search results come from.

curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&mkt=en-US"

Pagination

count

A number of search results to return in the response. The default is 10 and the maximum value is 50. The actual number delivered may be less than requested.

Examples:

count=30 - request 30 results
count=50 - request 50 results

curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&count=50"

first

An offset that indicates the number of search results to skip before returning results. The default value is 1.

Use this parameter along with the count parameter to page results. For example, set count to 10 and first to 1 to get the first page of results. For each subsequent page, increment first by 10 (for example, 1, 11, 21). It is possible for multiple pages to include some overlap in results.

Examples:

first=1 (default) - first page of results
first=11 - second page of results
first=21 - third page of results, etc.

curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&first=11"

Filters

safesearch

Used to filter webpages, images, and videos for adult content.

The following are the possible filter values:
safesearch=off — Returns content with adult text and images but not adult videos
safesearch=moderate — Returns webpages with adult text, but not adult images or videos
safesearch=strict — Does not return adult text, images, or videos

The default is Moderate.

NOTE: If the request comes from a market that Bing’s adult policy requires that safeSearch be set to Strict, Bing ignores the safesearch value and uses Strict.

curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&safesearch=off"

Device

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

curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&brd_mobile=1"

Browser

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)

curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&brd_browser=chrome"

Parsing

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

curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza?brd_json=1"