# Best Buy Availability API Documentation

<p><strong>Best Buy Availability API Documentation</strong> Send a SKU and a five digit destinationZipCode. The response has the honest button states for that ZIP, an in-stock flag, shipping and delivery options and nearby stores with an availability label. Best Buy defaults to its own headquarters ZIP; this API never reports that default as your local stock. One availability request costs 1 credit. An invalid ZIP or SKU is a 422 and is not billed. Failed requests are not billed. Not affiliated with Best Buy.</p>

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

## 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 |
| --- | --- | --- | --- |
| `sku` | string | Yes | Best Buy product id from search or suggest. |
| `destinationZipCode` | string | Yes | Five digit US ZIP code used for stock. |

## Example response

```json
{
    "data": {
        "sku": "6505727",
        "delivery": [
            {
                "dates": [
                    "2026-11-21T00:00:00+00:00"
                ],
                "eligible": true,
                "services": [
                    "Same day"
                ],
                "condition": "NEW",
                "deliverable": true
            }
        ],
        "in_stock": true,
        "shipping": [
            {
                "name": "Ground",
                "price": {
                    "amount": 0,
                    "currency": "USD"
                },
                "max_date": "2026-11-25T00:00:00+00:00",
                "min_date": "2026-11-24T00:00:00+00:00",
                "condition": "NEW",
                "display_date_type": "IN_HAND"
            }
        ],
        "button_states": [
            "ADD_TO_CART"
        ],
        "nearby_stores": [
            {
                "name": "New York Union Square",
                "store_id": "42",
                "availability": "In Stock",
                "distance_miles": 1.2
            }
        ],
        "pickup_eligible": null,
        "shipping_eligible": true,
        "destination_zip_code": "10001"
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "availability"
    },
    "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)
