Bing Shopping API documentation for developers who need Bing Shopping product results as JSON. Scrappa's GET /api/bing/shopping endpoint returns products with title, price, old price, seller, shipping, rating, image and Bing product link.
How to call the endpoint
Send a GET request with a required query and your API key in the x-api-key header. Page with page (1-5, about 36 products per page). Bing decides which products it shows and in which currency; the currency can follow the country Bing sees.
Response fields
Each product has position, offer_id, title, price (text as shown), price_value (number), sale_price, old_price, currency, seller, free_shipping, rating, review_count, image and url. When Bing shows a reduced price, sale_price equals price and old_price is the crossed-out price. A query without products returns an empty list.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
5 optional filters available.
string
Required
Product search query.
Example: laptop
coffee shops
string
Optional
Alias for query. Prefer query for new integrations.
coffee shops
string
Optional
Page number, about 36 products per page.
Range: 1-5
Default: 1
1
string
Optional
Bing market, language and region together, for example de-DE or en-GB. Results, wording and dates follow the market.
Default: en-US
example
string
Optional
Two-letter country code, for example DE. Scrappa sends it together with mkt.
Default: the country of mkt
example
string
Optional
Interface language, for example de. Scrappa sends it together with mkt.
Default: the language of mkt
example
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
page
query
market
source
results_on_page
Common data fields
url
image
price
title
{
"data": [
{
"url": "https://www.bing.com/shop/productdetails?q=laptop&goid=463560127828&FORM=SHPPDP",
"image": "https://th.bing.com/th?id=OPHS.tXZG%2fvCP3LJg4A474C474&w=220&h=220&c=17&o=5&pid=21.1",
"price": "$549.99",
"title": "Lenovo Ideapad Slim 3, Luna Grey - Laptop - Windows 11 Home - AMD Ryzen 5 8540U - 512GB SSD - 8GB RAM - 15.3 in",
"rating": 4.9,
"seller": "Lenovo",
"currency": "USD",
"offer_id": "463560127828",
"position": 2,
"old_price": "$749.99",
"sale_price": "$549.99",
"price_value": 549.99,
"review_count": 178,
"free_shipping": true
}
],
"page": 1,
"query": "laptop",
"market": {
"cc": "US",
"mkt": "en-US",
"setlang": "en"
},
"source": "bing",
"results_on_page": 1
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
The query is missing, page is outside 1-5, or mkt, cc or setlang is malformed.
{
"errors": {
"query": [
"The query field is required."
]
},
"message": "The request validation failed"
}Bing Temporarily Unavailable
Bing did not return usable data after the bounded retry on a second route. The request is not billed. Retry shortly.
{
"error": "Bing upstream is temporarily unavailable. Please retry shortly.",
"service": "BingVerticalsService",
"retryable": true,
"error_code": "bing_upstream_unavailable",
"failed_stage": "upstream_request"
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.