Bing Product API documentation for developers who need the details of one Bing Shopping product as JSON. Scrappa's GET /api/bing/product endpoint returns title, description, specs, rating, review count, images and the seller offers of one product.
How to call the endpoint
First search with GET /api/bing/shopping. Each item has an offer_id. Send it as product_token together with the same query and market, and send your API key in the x-api-key header. One request is one product page.
Response fields
data holds product_token, title, description, rating, review_count, review_count_label (Bing shows large counts as text such as 10K+), specs (name and value), images and offers. Each offer has position, offer_id, seller, seller_logo, title, price, price_value, currency, old_price, shipping, free_shipping, sponsored and url. Fields Bing does not show are null, or an empty list for specs.
Limits
The endpoint returns the offers Bing shows on the product page. It does not return more sellers or the single reviews. A token Bing does not know returns 404 and is not billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
2 required parameters needed before sending a request.
4 optional filters available.
string
Required
The offer_id of an item from /api/bing/shopping. Digits only.
Example: 471566297076
example
string
Required
The search query that found the product, for example the query you used for the shopping search.
Example: laptop
coffee shops
string
Optional
Alias for query. Prefer query for new integrations.
coffee shops
string
Optional
Bing market, language and region together, for example de-DE or en-GB. Use the same market as the shopping search that gave you the token.
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
query
market
source
product_token
results_on_page
{
"data": {
"specs": [
{
"name": "RAM",
"value": "32 GB"
},
{
"name": "Storage Capacity",
"value": "256 GB"
},
{
"name": "Brand",
"value": "Microsoft"
}
],
"title": "Microsoft Surface 15 Copilot+ Laptop with Intel Core Ultra 5 and Windows 11 Pro",
"images": [
"https://th.bing.com/th/id/OPHS.XekHZPuCv1IQvg474C474?w=474&h=474&qlt=100&o=5&dpr=2&pid=21.1"
],
"offers": [
{
"url": "https://www.abt.com/Microsoft-Surface-Laptop-15-inch-Intel-Core-Ultra-5-335-32GB-RAM-256GB-SSD-Windows-11-Pro-8th-Edition-in-Platinum-EP251004/p/246150.html",
"price": "$2,949.99",
"title": "Microsoft Surface 15 Copilot+ Laptop with Intel Core Ultra 5 and Windows 11 Pro",
"seller": "Abt Electronics",
"currency": "USD",
"offer_id": "471566297076",
"position": 1,
"shipping": "Free shipping",
"old_price": null,
"sponsored": true,
"price_value": 2949.99,
"seller_logo": "https://th.bing.com/th/id/ODF.oWJy3UEcyMMQ4D_3VraUkg?w=35&h=35&qlt=100&dpr=2&pid=retail",
"free_shipping": true
}
],
"rating": 5,
"description": "15-Inch (3270x2180) PixelSense Flow Touchscreen Display/ Intel Core Ultra 5 335 Processor/ 32GB RAM/ 256GB SSD/ Windows 11 Pro/ Copilot+ PC",
"review_count": 250,
"product_token": "471566297076",
"review_count_label": "250"
},
"query": "laptop",
"market": {
"cc": "US",
"mkt": "en-US",
"setlang": "en"
},
"source": "bing",
"product_token": "471566297076",
"results_on_page": 1
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
The query or product_token is missing, the product_token is not 6 to 20 digits, or mkt, cc or setlang is malformed.
{
"errors": {
"product_token": [
"The product token field is required."
]
},
"message": "The request validation failed"
}Product Not Found
Bing has no product page for this token. Use the offer_id of a current shopping item. The request is not billed.
{
"error": "Bing has no product page for this product_token. Use the offer_id of a /api/bing/shopping item.",
"retryable": false,
"error_code": "bing_product_not_found"
}Bing Temporarily Unavailable
Bing did not return usable data after the bounded retry on another route. The request is not billed. Retry shortly.
{
"error": "Bing upstream is temporarily unavailable. Please retry shortly.",
"service": "BingProductService",
"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.