# Bing Shopping API

<p><strong>Bing Shopping API documentation</strong> for developers who need Bing Shopping product results as JSON. Scrappa's <code>GET /api/bing/shopping</code> endpoint returns products with title, price, old price, seller, shipping, rating, image and Bing product link.</p><h2>How to call the endpoint</h2><p>Send a <code>GET</code> request with a required <code>query</code> and your API key in the <code>x-api-key</code> header. Page with <code>page</code> (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.</p><h2>Response fields</h2><p>Each product has <code>position</code>, <code>offer_id</code>, <code>title</code>, <code>price</code> (text as shown), <code>price_value</code> (number), <code>sale_price</code>, <code>old_price</code>, <code>currency</code>, <code>seller</code>, <code>free_shipping</code>, <code>rating</code>, <code>review_count</code>, <code>image</code> and <code>url</code>. When Bing shows a reduced price, <code>sale_price</code> equals <code>price</code> and <code>old_price</code> is the crossed-out price. A query without products returns an empty list.</p>

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

## 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 |
| --- | --- | --- | --- |
| `query` | string | Yes | <p>Product search query.</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> |
| `page` | string | No | <p>Page number, about 36 products per page.</p><p><strong>Range:</strong> 1-5</p><p><strong>Default:</strong> 1</p> |
| `mkt` | string | No | <p>Bing market, language and region together, for example <code>de-DE</code> or <code>en-GB</code>. Results, wording and dates follow the market.</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": [
        {
            "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The query is missing, page is outside 1-5, or mkt, cc or setlang is malformed. |
| 503 | Bing Temporarily Unavailable | Bing did not return usable data after the bounded retry on a second 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)