# Bing Product API

<p><strong>Bing Product API documentation</strong> for developers who need the details of one Bing Shopping product as JSON. Scrappa's <code>GET /api/bing/product</code> endpoint returns title, description, specs, rating, review count, images and the seller offers of one product.</p><h2>How to call the endpoint</h2><p>First search with <code>GET /api/bing/shopping</code>. Each item has an <code>offer_id</code>. Send it as <code>product_token</code> together with the same <code>query</code> and market, and send your API key in the <code>x-api-key</code> header. One request is one product page.</p><h2>Response fields</h2><p><code>data</code> holds <code>product_token</code>, <code>title</code>, <code>description</code>, <code>rating</code>, <code>review_count</code>, <code>review_count_label</code> (Bing shows large counts as text such as <code>10K+</code>), <code>specs</code> (name and value), <code>images</code> and <code>offers</code>. Each offer has <code>position</code>, <code>offer_id</code>, <code>seller</code>, <code>seller_logo</code>, <code>title</code>, <code>price</code>, <code>price_value</code>, <code>currency</code>, <code>old_price</code>, <code>shipping</code>, <code>free_shipping</code>, <code>sponsored</code> and <code>url</code>. Fields Bing does not show are <code>null</code>, or an empty list for <code>specs</code>.</p><h2>Limits</h2><p>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.</p>

- **Documentation:** [https://scrappa.co/docs/bing-search-api/bing_product](https://scrappa.co/docs/bing-search-api/bing_product)
- **API group:** Bing Search API
- **Endpoint:** `GET https://scrappa.co/api/bing/product`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `product_token` | string | Yes | <p>The <code>offer_id</code> of an item from <code>/api/bing/shopping</code>. Digits only.</p><p><strong>Example:</strong> <code>471566297076</code></p> |
| `query` | string | Yes | <p>The search query that found the product, for example the query you used for the shopping search.</p><p><strong>Example:</strong> <code>laptop</code></p> |
| `q` | string | No | <p>Alias for <code>query</code>. Prefer <code>query</code> for new integrations.</p> |
| `mkt` | string | No | <p>Bing market, language and region together, for example <code>de-DE</code> or <code>en-GB</code>. Use the same market as the shopping search that gave you the token.</p><p><strong>Default:</strong> <code>en-US</code></p> |
| `cc` | string | No | <p>Two-letter country code, for example <code>DE</code>. Scrappa sends it together with <code>mkt</code>.</p><p><strong>Default:</strong> the country of <code>mkt</code></p> |
| `setlang` | string | No | <p>Interface language, for example <code>de</code>. Scrappa sends it together with <code>mkt</code>.</p><p><strong>Default:</strong> the language of <code>mkt</code></p> |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | 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. |
| 404 | 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. |
| 503 | Bing Temporarily Unavailable | Bing did not return usable data after the bounded retry on another route. The request is not billed. Retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)