Bing Shopping Search
Retrieve product listings and shopping results from Bing Shopping based on a specific query. Useful for price comparison, market research, tracking product availability, and analyzing e-commerce trends across online retailers.
If you already know that you want to use Bing Shopping Search, this page is the one you should read. It shows the required input, the filters you can apply, how pagination works, and what localization controls are available.
At a Glance
| Field | Value |
|---|---|
| Name | Bing Shopping Search |
| Scraper | bing_shopping |
| Engine | bing_shopping_search |
| Website | Bing |
| Website URL | bingshopping.com |
| Output Format | json |
| Version | 1.0.0 |
| Parameter Count | 4 |
| Parameter Groups | Search Query (1), Localization (1), Geographic Location (1), Pagination (1) |
Request Example
This is the real request body used to validate bing_shopping during this docs refresh. For /v1/serp, the engine field should be the engine's scraper value.
curl -X POST "https://run.xcrawl.com/v1/serp" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"engine":"bing_shopping","q":"wireless mouse"}'Response Example
The JSON below comes from the same live response. Long strings, data URLs, and large arrays were shortened so the example stays readable.
{
"search_metadata": {
"cached": true,
"created_at": "2026-03-26 08:19:14 UTC",
"id": "01KMMKKFMP240C475745R3DV3P",
"json_endpoint": "https://serp.xcrawl.com/01KMMKKFMP240C475745R3DV3P.json",
"processed_at": "2026-03-26 08:19:14 UTC",
"raw_html_file": "https://serp.xcrawl.com/01KMMKKFMP240C475745R3DV3P.html",
"status": "completed",
"total_time_taken": 11
},
"search_parameters": {
"engine": "bing_shopping",
"q": "wireless mouse"
},
"total_credits_used": 1,
"ads_results": [
{
"displayed_link": "https://www.amazon.com › Shop › wireless mouse'",
"link": "https://www.bing.com/aclick?ld=e8AFu2EJA1h6bdQSaTsYnwFzVUCUw8vMK4GKwWvvM9QXvDhEj99NvWcrZh0o__4Nt5rvYL3eM_9gtNj2DcMmlk_lWOVzcTz0RtWsTj3uLreFsc8kamQwj4Hr_CoPs3Bf1GKsJg-Hn1eZ42EHXrLmgdRd5vUxJo2em2gdVjQ2LJ7xPJny09vMhcqZkLnol... [truncated, 877 chars]",
"sitelinks": [
{
"link": "https://www.bing.com/aclick?ld=e8AnRZMx_GaGHGPCh9EJOJajVUCUy1Bh2IUA0pqNaH4OHYjHgr7EM1CzwYadorBLrZ5brgvw2djP54_X5yxuGaxJleDm_q5d6Zm3NU1j-VAX8qnfHedlD_viSVslZaOpjulV7y6kEKA0kkHtUMezHnX2PhkGnCjfsCA0WfHsfBNRf4L1SXVs0fpNOwtKR... [truncated, 888 chars]",
"text": "Amazon Deals"
},
{
"_note": "3 more items omitted"
}
],
"snippet": "Shop Our Huge Selection · Read Ratings & Reviews · Shop Best Sellers · Fast Shipping",
"title": "Wireless Mouse' | Amazon® Official Site | Order At Amazon Now"
},
{
"_note": "10 more items omitted"
}
],
"filters": [
{
"options": [
{
"link": "https://www.bing.com/shop?q=wireless+mouse&filters=gsfilter%3a%22MSxCYXNpYywyPTEsVHw7%22+scenario%3a%2215%22&fk=Show+Only&FORM=SHOPFL&originIGUID=50DBA6EF6BB64846AAFDA9478B2D9222",
"text": "Available nearby"
}
],
"type": "Show Only"
},
{
"_note": "5 more items omitted"
}
],
"inline_ads_results": [
{
"block_position": "top",
"extracted_price": 59.99,
"link": "https://www.bing.com/aclick?ld=e8Lw3luzRJKtRAayrciP9mKTVUCUyQ67nIjkLI-JHbIFFire9Bx6r-0XUR0KLG5Uu3LYP8MmJEJbJwcYIDmVtVw9HKud2zs6kmPjaaJZMmI44lnOZfxbx6NoIEo8VjsPWqSluFRbCiLCQWb1Bs3ZxJ5HcbynuiTIAjyiVaEE4Yd858YB6Q9ia2stWnXTq... [truncated, 1442 chars]",
"price": "$59.99",
"rating": 4.5,
"reviews": "797",
"seller": "Best Buy",
"thumbnail": "https://th.bing.com/th/id/OPHS.xkoNYkM5buBJ1g474C474?w=180&h=180&c=17&pid=21.1",
"title": "Microsoft - Surface Bluetooth Optical Ambidextrous Mouse - Wireless - Silver"
},
{
"_note": "19 more items omitted"
}
],
"pagination": {
"current": 1,
"next": "https://www.bing.com/shop?q=wireless+mouse&filters=scenario%3a%2215%22+LookupKey%3a%225248420ecdc74ec196e01952f32b5490%22+ParentRguid%3a%225248420ecdc74ec196e01952f32b5490%22&originIGUID=50DBA6EF6BB64846AAFDA9478B2D9222&... [truncated, 236 chars]",
"other_pages": {
"2": "https://www.bing.com/shop?q=wireless+mouse&filters=scenario%3a%2215%22+LookupKey%3a%225248420ecdc74ec196e01952f32b5490%22+ParentRguid%3a%225248420ecdc74ec196e01952f32b5490%22&originIGUID=50DBA6EF6BB64846AAFDA9478B2D9222&... [truncated, 236 chars]",
"3": "https://www.bing.com/shop?q=wireless+mouse&filters=scenario%3a%2215%22+LookupKey%3a%225248420ecdc74ec196e01952f32b5490%22+ParentRguid%3a%225248420ecdc74ec196e01952f32b5490%22&originIGUID=50DBA6EF6BB64846AAFDA9478B2D9222&... [truncated, 236 chars]",
"4": "https://www.bing.com/shop?q=wireless+mouse&filters=scenario%3a%2215%22+LookupKey%3a%225248420ecdc74ec196e01952f32b5490%22+ParentRguid%3a%225248420ecdc74ec196e01952f32b5490%22&originIGUID=50DBA6EF6BB64846AAFDA9478B2D9222&... [truncated, 237 chars]"
}
},
"related_searches": [
{
"highlighted_words": [
{
"value": "Logitech"
}
],
"link": "https://www.bing.com/shop?q=Logitech+Wireless+Mouse&FORM=RSPINN",
"text": " Logitech Wireless Mouse"
},
{
"_note": "14 more items omitted"
}
],
"shopping_results": [
{
"free_shipping": true,
"link": "https://www.bing.com/ck/a?!&&p=651a445617d06723ca4c23df2f4ba128bbb4b389df525858413d44e184e74ba1JmltdHM9MTc3NDQ4MzIwMA&ptn=3&ver=2&hsh=4&fclid=385281eb-d962-6476-376d-96c3d83c658e&u=a1L3Nob3AvcHJvZHVjdHBhZ2U_cT13aXJlbGVzc... [truncated, 577 chars]",
"price": "$15.30$17.99",
"seller": "Lenovo AU",
"thumbnail": "https://th.bing.com/th/id/OPHS.4PQFrnWWeQzEiw474C474?w=220&h=220&c=17&o=5&pid=21.1"
},
{
"_note": "35 more items omitted"
}
]
}Required Parameters
If you are sending your first request with this engine, start here. Requiredness is based on properties.<field>.must, not the top-level required array.
| Field | Type | Group | Description |
|---|---|---|---|
q | string | Search Query | The keyword or phrase you want this search engine to look up. |
Available Parameters
The sections below follow the same parameter groups as the backend, but the field descriptions have been rewritten into shorter, user-facing wording so they are easier to scan.
Search Query
| Field | Type | Required | Description |
|---|---|---|---|
q | string | Yes | The keyword or phrase you want this search engine to look up. |
Localization
| Field | Type | Required | Description |
|---|---|---|---|
cc | string | No | Country code used to localize Bing-family results. |
Additional Constraints
cc：Options: 36 options. Examples:AR,AU,AT,BE,BR
Geographic Location
| Field | Type | Required | Description |
|---|---|---|---|
mkt | string | No | Bing market code that combines language and country, such as en-US. |
Additional Constraints
mkt：Options: 37 options. Examples:es-ar,en-au,de-at,nl-be,fr-be
Pagination
| Field | Type | Required | Description |
|---|---|---|---|
efirst | string | No | Result Offset. |