# Best Buy Search API Documentation

<p><strong>Best Buy Search API Documentation</strong> Search Best Buy US by keyword. Filter by price range, sort and page. Every item has a SKU, a sale price and an original price as numbers with USD, the discount, a full size image URL and a numeric rating. SKUs work unchanged in the reviews and availability endpoints. Price ranges are checked on every item and a page past the end is never labelled as page 1. One search costs 1 credit. A search without hits is not billed. Failed requests are not billed. Not affiliated with Best Buy.</p>

- **Documentation:** [https://scrappa.co/docs/bestbuy-api/bestbuy_search](https://scrappa.co/docs/bestbuy-api/bestbuy_search)
- **API group:** Best Buy US API
- **Endpoint:** `GET https://scrappa.co/api/bestbuy/search`

## 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 | Keyword, up to 100 characters. |
| `min_price` | number | No | Lowest price. |
| `max_price` | number | No | Highest price. Compared with min_price only when min_price is set. |
| `sort` | string | No | best_match (default) or top_rated. Price sorts are rejected because the upstream token does not order pages. |
| `page` | integer | No | 1-based page, up to 200. |

## Example response

```json
{
    "data": {
        "items": [
            {
                "sku": "6505727",
                "url": "https://www.bestbuy.com/site/sony-headphones/6505727.p",
                "name": "Sony WH-1000XM5 Wireless Headphones",
                "brand": "Sony",
                "image": "https://example-image-host/images/6505727_bd.jpg",
                "price": {
                    "amount": 348,
                    "currency": "USD"
                },
                "images": [
                    "https://example-image-host/images/6505727_bd.jpg"
                ],
                "rating": 4.7,
                "savings": {
                    "amount": 51.99,
                    "currency": "USD"
                },
                "in_stock": true,
                "button_state": "ADD_TO_CART",
                "review_count": 2841,
                "regular_price": {
                    "amount": 399.99,
                    "currency": "USD"
                },
                "discount_percent": 13
            }
        ],
        "filters": {
            "sort": "best_match",
            "query": "sony headphones",
            "max_price": null,
            "min_price": null
        },
        "currency": "USD",
        "pagination": {
            "has_more": true,
            "per_page": 18,
            "total_items": 120,
            "total_pages": 7,
            "current_page": 1
        }
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. Not billable. |
| 502 | Upstream Unavailable | Best Buy did not answer or sent unreadable data. Not billable. Retry later. |

## 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)
