# Best Buy API

> Best Buy categories, products, prices, variants and store stock (unverified)

- Vendor: `bestbuyapi` · version 1.0 · category E-commerce · tags best buy api, bestbuy api, electronics store api, best buy product data api, best buy availability api, consumer electronics api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/bestbuyapi
- This document: https://apiclay.com/docs/bestbuyapi.md
- OpenAPI 3.1: https://apiclay.com/api/bestbuyapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `bestbuyapi`
- Updated: 2026-11-18

## About

## Best Buy API

Best Buy's category tree (developer API, bring your own key), category product pages, product pages with prices and variations, and store pickup stock.

Data comes from **bestbuy.com** (https://www.bestbuy.com) and Best Buy's developer API (https://api.bestbuy.com). Every route below calls the site's own endpoint directly and returns the upstream response unchanged.

Typical flow: `/menus` -&gt; `/categories` -&gt; `/products` -&gt; `/product` -&gt; `/variants` / `/availability`

`/menus` and `/categories` need your own Best Buy developer API key (free at developer.bestbuy.com), sent as `apiKey`.

### Routes

#### GET `/menus` - Menus (category tree, developer API)
One page (100 categories) of Best Buy's category list; each category carries its full path, so the tree can be rebuilt from all pages.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| apiKey | query | string | yes | Your own Best Buy developer API key. |
| page | query | string | no | Page number, starting at `1`. |

Returns (fields the source code reads; not yet verified live):
- `totalPages`: number of pages
- `categories[]`: `id` (e.g. `abcat0502000`), `name`, `url`, `active`, `path[]` (ancestors with `id` and `name`; the root is `cat00000`)

#### GET `/categories` - Categories (category list, developer API)
The same paged list as `/menus`; the subcategories of a category are the entries whose `path` contains its id.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| apiKey | query | string | yes | Your own Best Buy developer API key. |
| page | query | string | no | Page number, starting at `1`. |

Returns: same fields as `/menus`.

#### GET `/products` - Products (category page, HTML)
One page (18 products) of a category listing.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| category_id | path | string | yes | Category id from `/categories`, e.g. `abcat0502000`. |
| id | query | string | yes | Same category id. |
| cp | query | string | no | Page number, starting at `1`. |
| Cookie | header | string | no | Store and zip for local results: `locStoreId=;locDestZip=`. |

Returns (HTML; elements the source code reads):
- `span.item-count`: number of results
- `li.sku-item` (`data-sku-id`): one product; `.sku-title` name, `div[data-testid=customer-price]` price, `div[data-testid=regular-price]` regular price, `a.image-link img` image, `div.product-variation-header` when it has variants

#### GET `/product` - Product (product page, HTML)
A product page with price, description and fulfillment flags.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| sku | path | string | yes | SKU from `/products` (`data-sku-id`). |
| skuId | query | string | yes | Same SKU. |
| Cookie | header | string | no | Store and zip: `pst2=\|N;locStoreId=;customerZipCode=\|N;locDestZip=`. |

Returns (HTML; elements the source code reads):
- `script#product-schema`: JSON-LD with `sku`, `name`, `brand.name`, `url`, `offers[0].price`, `offers[0].availability`
- ProductDescription script (`rehydrate`): `productBySkuId.price.customerPrice`, `price.regularPrice`, `primaryImage.piscesHref`, `description.long`, flags `instoreInventoryAvailable`, `deliveryEligible`, `shippingEligible`

#### GET `/variants` - Variants (product page with variation data, HTML)
The product page; its variation script lists the sibling SKUs.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| sku | path | string | yes | SKU from `/products`. |
| skuId | query | string | yes | Same SKU. |
| Cookie | header | string | no | Same store/zip cookie as `/product`. |

Returns (HTML; elements the source code reads):
- `script#shop-product-variations` (or the script containing `variationSku`): JSON whose `skuDetails` keys are the variant SKUs; fetch each with `/product`

#### POST `/availability` - Availability (store pickup stock)
In-store pickup stock for up to 15 SKUs at a store.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| locationId | body (JSON) | string | yes | Best Buy store id. |
| zipCode | body (JSON) | string | yes | Store zip code. |
| items | body (JSON) | array | yes | One entry per SKU: `{"sku": "", "condition": null, "quantity": 1, "itemSeqNumber": "5", "reservationToken": null, "selectedServices": [], "requiredAccessories": [], "isTradeIn": false, "isLeased": false}`. |

Returns (fields the source code reads; not yet verified live):
- `ispu.items[]`: `sku`, `locations[]` with `locationId` and `inStoreAvailability.availableInStoreQuantity`

### Not yet available

| Endpoint | Why |
|---|---|
| product JSON graph (`/api/tcfb/model.json`) | not in the MealMe code; throttled by Akamai when tried |

### Caveats

- These routes were written from MealMe's source code and have not been tested live yet (the site blocks plain requests from the test machine).
- The source site uses bot protection (Akamai on www.bestbuy.com); calls may be blocked until that is handled.
- The developer API routes (`/menus`, `/categories`) use your own Best Buy API key and its rate limits.
- Upstream calls change over time (embedded keys, field names). Verify responses before relying on them.
- Not affiliated with bestbuy.com or Best Buy Co., Inc..

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /menus — Menus (category tree, developer API)
- Gateway: `GET https://api.apiclay.com/v1/api/bestbuyapi/menus`
- Public query params: `apiKey` (string, required), `page` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /categories — Categories (category list, developer API)
- Gateway: `GET https://api.apiclay.com/v1/api/bestbuyapi/categories`
- Public query params: `apiKey` (string, required), `page` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /products — Products (category page, HTML)
- Gateway: `GET https://api.apiclay.com/v1/api/bestbuyapi/products`
- Public headers: `Cookie`
- Public query params: `id` (string, required), `cp` (string), `category_id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /product — Product (product page, HTML)
- Gateway: `GET https://api.apiclay.com/v1/api/bestbuyapi/product`
- Public headers: `Cookie`
- Public query params: `skuId` (string, required), `sku` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /variants — Variants (product page with variation data, HTML)
- Gateway: `GET https://api.apiclay.com/v1/api/bestbuyapi/variants`
- Public headers: `Cookie`
- Public query params: `skuId` (string, required), `sku` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /availability — Availability (store pickup stock)
- Gateway: `POST https://api.apiclay.com/v1/api/bestbuyapi/availability`
- Body sample (JSON):

```json
{"locationId": "281", "zipCode": "55423", "items": [{"sku": "6525410", "condition": null, "quantity": 1, "itemSeqNumber": "5", "reservationToken": null, "selectedServices": [], "requiredAccessories": [], "isTradeIn": false, "isLeased": false}]}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/bestbuyapi/menus?apiKey=<apiKey>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
