Bing Shopping API

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_shopping" \
 -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_shopping" \
 -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_shopping" \
 -d "q=pizza" \
 -d "json=1" \
 -d "mkt=fr-fr"

Pagination

efirst ,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,efirst:10

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

Advanced Filters

filters ,Additional Filtering(Optional)

Parameters allow for more complex filtering options, such as filtering by date range ex1:"ez5_18169_18230" or using specific display filters

(e.g. ufn:"Wunderman+Thompson"+sid:"5bede9a2-1bda-9887-e6eb-30b1b8b6b513"+catguid:"5bede9a2-1bda-9887-e6eb-30b1b8b6b513_cfb02057"+segment:"generic.carousel"+entitysegment:"Organization").

You can use Bing search and copy filters query parameters to construct precise values.

Example Request:

Example results for q : pizza,filters:ex1:"ez5_18169_18230"

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

For assistance, contact [email protected].

Last updated

Was this helpful?