For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

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"

For assistance, contact support@thordata.com.

Last updated