> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Best Buy API — Overview

> Search Best Buy US products, compare deals and specifications, read reviews and questions, and check ZIP-specific fulfillment.

Search Best Buy US products, compare deals and specifications, read reviews and questions, and check ZIP-specific fulfillment.

Authenticate with `X-API-Key`. Requests use `https://scrapebadger.com/v1/bestbuy`.

## Endpoints

| Endpoint | Request | Credits |
| - | - | -: |
| [List supported markets](https://docs.scrapebadger.com/api-reference/endpoint/bestbuy/markets.md) | `GET /markets` | 0 |
| [Search products](https://docs.scrapebadger.com/api-reference/endpoint/bestbuy/search.md) | `GET /search` | 10 |
| [Browse a category](https://docs.scrapebadger.com/api-reference/endpoint/bestbuy/category.md) | `GET /category` | 10 |
| [Get categories](https://docs.scrapebadger.com/api-reference/endpoint/bestbuy/categories.md) | `GET /categories` | 5 |
| [Get laptop and computer deals](https://docs.scrapebadger.com/api-reference/endpoint/bestbuy/deals.md) | `GET /deals` | 10 |
| [Get search suggestions](https://docs.scrapebadger.com/api-reference/endpoint/bestbuy/autocomplete.md) | `GET /autocomplete` | 5 |
| [Get product reviews](https://docs.scrapebadger.com/api-reference/endpoint/bestbuy/products-sku-reviews.md) | `GET /products/{sku}/reviews` | 5 |
| [Get product questions](https://docs.scrapebadger.com/api-reference/endpoint/bestbuy/products-sku-questions.md) | `GET /products/{sku}/questions` | 5 |
| [Get product availability](https://docs.scrapebadger.com/api-reference/endpoint/bestbuy/products-sku-availability.md) | `GET /products/{sku}/availability` | 5 |
| [Get product detail](https://docs.scrapebadger.com/api-reference/endpoint/bestbuy/products-sku.md) | `GET /products/{sku}` | 10 |

Credits apply to successful requests. Failed requests and empty result sets are not charged.

## Markets

Supported market codes: `us`.

Use the same market and location parameters across search, product and availability requests. Store availability and prices reflect the requested context at collection time.

## Pagination

Follow each endpoint’s pagination fields and retain product IDs to deduplicate results. Search counts and stock can change between calls.

## Get started

[Open the playground](https://scrapebadger.com/dashboard/bestbuy-scraper) or use the [Python and Node.js SDKs](https://docs.scrapebadger.com/sdks.md).

## Run this asynchronously

Calls on this API can run in the background, so you don't hold a connection open while they work. Add one of these to the call:

| Add | What you get |
| - | - |
| `async=true` | The normal response if the call finishes within 25 s. Otherwise `202` with a `request_id`, which you poll at `GET /v1/requests/{request_id}` for free. |
| `callback_url=https://…` | `202` at once. When the call completes, the result is POSTed to your URL, signed with your webhook secret. |
| `Idempotency-Key: <your id>` header | A resent submit returns the first call instead of running it again. |

```bash theme={null}
curl -s "https://scrapebadger.com/v1/...?your=params&async=true" \
  -H "X-API-Key: $SCRAPEBADGER_API_KEY"
# 202 {"request_id": "…", "status": "running", …}, then:
curl -s "https://scrapebadger.com/v1/requests/REQUEST_ID" \
  -H "X-API-Key: $SCRAPEBADGER_API_KEY"
```

An async call is billed once, when it completes. See [Async requests and webhooks](https://docs.scrapebadger.com/long-running-requests.md) for webhooks, signatures and the SDK helpers.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.