Bing

SERP API Bing Query Parameters

including output options for parameters such as localization, geographical location, and pagination.

q ,Search Query(Required)

Define the search query for data crawling (default value: q=pizza). Any keywords in any language are supported.

Example Request:

Example with q:pizza parameter

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=bing" \
 -d "q=pizza" \
 -d "json=1"

Localization

cc ,Country(Optional)

This parameter defines that during crawling, you can specify that search results be displayed according to the habits of users in a specific country/region. It is a two-letter country/region code (for example: us, ru, uk).

Examples:

  • cc=us → United States (English)

  • cc=fr → France (French)

Example Request:

Example results for q : pizza,cc:jp

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=bing" \
 -d "q=pizza" \
 -d "json=1" \
 -d "cc=jp"

Geographical Location

mkt ,Language(Optional)

This parameter defines the interface display language of search results during crawling. It adopts the format of <"language code">-<"country/region code">.

For example, en-US. This string is case-insensitive.

Examples:

  • mkt=en-US → English (United States)

  • mkt=zh-CN → Simplified Chinese

Example Request:

Example results for q : pizza,mkt:fr-fr

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=bing" \
 -d "q=pizza" \
 -d "json=1" \
 -d "mkt=fr-fr"
location ,Location(Optional)

This parameter defines the starting geographical location for crawling and should be used in conjunction with the lat (latitude) and lon (longitude) parameters.

Example Request:

Example results for q : pizza,location:Tokyo

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=bing" \
 -d "q=pizza" \
 -d "json=1" \
 -d "location=Tokyo%2CJapan" \
 -d "uule=w+CAIQICILVG9reW8sSmFwYW4"
lat ,Latitude(Optional)

GPS latitude (-90.0 to 90.0). Must be used with lon.

This parameter defines the GPS latitude of the starting geographical location during crawling. It is used together with the location (geographical location) and lon (longitude) parameters.

Example Request:

Example results for q : pizza,lat:40.7128

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=bing" \
 -d "q=pizza" \
 -d "json=1" \
 -d "lat=40.7128" \
 -d "lon=-74.0060"
lon ,Longitude(Optional)

GPS longitude (-180.0 to 180.0). Must be used with lat.

This parameter defines the GPS longitude of the starting geographical location during crawling. It is used together with the location (geographical location) and lat (latitude) parameters.

Example Request:

Example: -74.0060 for New York.

Example results for q : pizza,lon:-74.0060

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=bing" \
 -d "q=pizza" \
 -d "json=1" \
 -d "lat=40.7128" \
 -d "lon=-74.0060"

Pagination

first ,Result offset(Optional)

Sets the result offset (default: 1). For example, first=10 skips the first 9 results.

This parameter is used to control the offset of Organic Search results, with a default value of 1. For example, when first=10, the system will promote the 10th organic search result to the top position.

Example Request:

Example results for q : pizza,first:10

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=bing" \
 -d "q=pizza" \
 -d "json=1" \
 -d "first=10" \
 -d "count=10"
count ,Results per page(Optional)

Number of results per page (range: 150). Use with first for pagination.

The per-page parameter is used to control the number of search results displayed per page (minimum value: 1, maximum value: 50). The actual effective value will be affected by the first offset parameter.

Example Request:

Example results for q : pizza,count:10

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=bing" \
 -d "q=pizza" \
 -d "json=1" \
 -d "first=10" \
 -d "count=10"

Advanced Filters

adlt ,Safe(Optional)

This parameter defines whether adult content is blocked from search results. You can set it to either "strict" or "off".

Adult content filter:

  • strict → Default (blocks adult content)

  • off → Allows adult content

Example Request:

Example results for q : pizza,adlt:strict

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=bing" \
 -d "q=pizza" \
 -d "json=1" \
 -d "adlt=strict"

For assistance, contact [email protected].

Last updated

Was this helpful?