# Best Buy API

> Best Buy workflow and API: products, product and store stock. Returns products, sku, brand and price as JSON.

Best Buy data from bestbuy.com: products, product and store stock.

- Page: https://fous.com/tools/best-buy
- Handle: `@best-buy`
- Category: [Commerce](https://fous.com/tools/category/commerce)
- Source website: https://bestbuy.com
- Last verified: Sep 30, 2026

## Methods

### Check store stock

Operation `check_store_stock`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Check a Best Buy product’s price, shipping estimate, and pickup availability at stores nearest a US ZIP code. Availability can change before checkout.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `product` | string | yes | `"Apple AirPods Pro 3"` | Product name or Best Buy product link, e.g. Apple AirPods Pro 3 or https://www.bestbuy.com/product/apple-airpods-pro-3-wireless-active-noise-cancelling-earbuds-with-heart-rate-sensing-feature-white/JJGCQLYK5F |
| `zip_code` | string | yes | `"60601"` | US ZIP code, e.g. 60601 |
| `max_stores` | integer | no | `4` | Maximum number of nearest stores, e.g. 10 |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "product",
    "zip_code"
  ],
  "properties": {
    "product": {
      "type": "string",
      "description": "Product name or Best Buy product link, e.g. Apple AirPods Pro 3 or https://www.bestbuy.com/product/apple-airpods-pro-3-wireless-active-noise-cancelling-earbuds-with-heart-rate-sensing-feature-white/JJGCQLYK5F",
      "examples": [
        "Apple AirPods Pro 3",
        "https://www.bestbuy.com/product/apple-airpods-pro-3-wireless-active-noise-cancelling-earbuds-with-heart-rate-sensing-feature-white/JJGCQLYK5F"
      ]
    },
    "zip_code": {
      "type": "string",
      "description": "US ZIP code, e.g. 60601",
      "examples": [
        "60601",
        "10001"
      ]
    },
    "max_stores": {
      "type": "integer",
      "default": 10,
      "maximum": 20,
      "minimum": 1,
      "description": "Maximum number of nearest stores, e.g. 10",
      "x-fous-developer": true,
      "examples": [
        4
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "product": "Apple AirPods Pro 3",
      "zip_code": "60601"
    },
    {
      "product": "https://www.bestbuy.com/product/apple-airpods-pro-3-wireless-active-noise-cancelling-earbuds-with-heart-rate-sensing-feature-white/JJGCQLYK5F",
      "zip_code": "10001",
      "max_stores": 4
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `sku` | string | `"6376563"` | Best Buy product SKU |
| `price` | number or null | `249.99` | Current price in US dollars |
| `stores` | array |  |  |
| `stores[].address` | string or null | `"555 W Roosevelt Rd, Chicago, IL 60607"` |  |
| `stores[].store_id` | string | `"1142"` |  |
| `stores[].store_url` | string | `"https://stores.bestbuy.com/1142"` |  |
| `stores[].store_name` | string | `"South Loop"` |  |
| `stores[].pickup_timing` | string or null | `"Ready within 1 hour"` |  |
| `stores[].distance_miles` | number | `1.7` |  |
| `stores[].pickup_available` | boolean | `true` |  |
| `currency` | string | `"USD"` | Price currency |
| `product_url` | string | `"https://www.bestbuy.com/product/apple-airpods-pro-3-wireless-active-noise-cancelling-earbuds-with-heart-rate-sensing-fe` | Product page link |
| `product_name` | string | `"Apple - AirPods Pro 3, Wireless Active Noise Cancelling Earbuds with Heart Rate Sensing Feature - White"` | Best Buy product name |
| `shipping_estimate` | string or null | `"Get it by Tue, Sep 29"` | Estimated shipping timing for the ZIP code |

**Example input**

```json
{
  "product": "Apple AirPods Pro 3",
  "zip_code": "60601"
}
```

**Example output**

```json
{
  "sku": "6376563",
  "price": 249.99,
  "stores": [
    {
      "address": "555 W Roosevelt Rd, Chicago, IL 60607",
      "store_id": "1142",
      "store_url": "https://stores.bestbuy.com/1142",
      "store_name": "South Loop",
      "pickup_timing": "Ready within 1 hour",
      "distance_miles": 1.7,
      "pickup_available": true
    },
    {
      "address": "1000 W North Ave, Chicago, IL 60642",
      "store_id": "323",
      "store_url": "https://stores.bestbuy.com/323",
      "store_name": "North Avenue",
      "pickup_timing": "Ready within 1 hour",
      "distance_miles": 2.5,
      "pickup_available": true
    },
    {
      "address": "2100 N Elston Ave, Chicago, IL 60614",
      "store_id": "814",
      "store_url": "https://stores.bestbuy.com/814",
      "store_name": "Bucktown",
      "pickup_timing": "Ready within 1 hour",
      "distance_miles": 3.4,
      "pickup_available": true
    }
  ],
  "currency": "USD",
  "product_url": "https://www.bestbuy.com/product/apple-airpods-pro-3-wireless-active-noise-cancelling-earbuds-with-heart-rate-sensing-feature-white/JJGCQLYK5F",
  "product_name": "Apple - AirPods Pro 3, Wireless Active Noise Cancelling Earbuds with Heart Rate Sensing Feature - White",
  "shipping_estimate": "Get it by Tue, Sep 29"
}
```

### Get product

Operation `get_product`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get the current US price, deals, specifications, images and customer reviews for a Best Buy product by name or link. Some details may not be shown for every product.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `product` | string | yes | `"https://www.bestbuy.com/product/sony-wh-1000xm6-best-wireless-noise-cancelling-headphones-black/J7XSRH5RCF/sku/6620467"` | Product name or Best Buy product link, for example Sony WH-1000XM6. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "product"
  ],
  "properties": {
    "product": {
      "type": "string",
      "description": "Product name or Best Buy product link, for example Sony WH-1000XM6.",
      "examples": [
        "https://www.bestbuy.com/product/sony-wh-1000xm6-best-wireless-noise-cancelling-headphones-black/J7XSRH5RCF/sku/6620467",
        "Sony WH-1000XM6"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "product": "https://www.bestbuy.com/product/sony-wh-1000xm6-best-wireless-noise-cancelling-headphones-black/J7XSRH5RCF/sku/6620467"
    },
    {
      "product": "Sony WH-1000XM6"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `sku` | string | `"6620467"` |  |
| `brand` | string or null | `"Sony"` |  |
| `price` | number or null | `458` |  |
| `savings` | number or null | `0` |  |
| `currency` | string | `"USD"` |  |
| `image_links` | array |  |  |
| `star_rating` | number or null | `4.7` |  |
| `top_reviews` | array |  |  |
| `top_reviews[].date` | string or null | `"2026-05-08"` |  |
| `top_reviews[].text` | string |  |  |
| `top_reviews[].stars` | number or null | `5` |  |
| `top_reviews[].title` | string or null | `"Sony WH-1000XM6 — Premium Headphone Experience"` |  |
| `model_number` | string or null | `"WH1000XM6/B"` |  |
| `product_link` | string | `"https://www.bestbuy.com/product/sony-wh-1000xm6-best-wireless-noise-cancelling-headphones-black/J7XSRH5RCF/sku/6620467"` |  |
| `product_name` | string | `"Sony - WH-1000XM6- Best Wireless Noise Cancelling Headphones - Black"` |  |
| `regular_price` | number or null | `458` |  |
| `sale_end_date` | string or null |  |  |
| `open_box_options` | array |  |  |
| `open_box_options[].price` | number |  |  |
| `open_box_options[].condition` | string |  |  |
| `number_of_reviews` | integer or null | `1392` |  |
| `key_specifications` | array |  |  |
| `key_specifications[].name` | string | `"Battery Life (Continuous Communication Time)"` |  |
| `key_specifications[].value` | string | `"Max. 24 hours(NC ON), Max. 28 hours(NC OFF)"` |  |

**Example input**

```json
{
  "product": "https://www.bestbuy.com/product/sony-wh-1000xm6-best-wireless-noise-cancelling-headphones-black/J7XSRH5RCF/sku/6620467"
}
```

**Example output**

```json
{
  "sku": "6620467",
  "brand": "Sony",
  "price": 458,
  "savings": 0,
  "currency": "USD",
  "image_links": [
    "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/5c0ff147-1f18-4f75-adbc-680f9fee5308.jpg",
    "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/219f2704-f08d-48f0-b073-f62651985a48.jpg"
  ],
  "star_rating": 4.7,
  "top_reviews": [
    {
      "date": "2026-05-08",
      "text": "The Sony WH-1000XM6 truly exceeded every expectation I had for premium headphones. From the moment I put them on, the industry-leading noise cancellation instantly created a completely immersive exper…",
      "stars": 5,
      "title": "Sony WH-1000XM6 — Premium Headphone Experience"
    },
    {
      "date": "2026-01-27",
      "text": "I’m really enjoying my new Sony headphones. The comfort and active noise cancellation (ANC) are the true highlights, making them perfect for casual, all-day wear. I love the color I chose, and the bui…",
      "stars": 5,
      "title": "One of the best headphones on the market."
    }
  ],
  "model_number": "WH1000XM6/B",
  "product_link": "https://www.bestbuy.com/product/sony-wh-1000xm6-best-wireless-noise-cancelling-headphones-black/J7XSRH5RCF/sku/6620467",
  "product_name": "Sony - WH-1000XM6- Best Wireless Noise Cancelling Headphones - Black",
  "regular_price": 458,
  "sale_end_date": null,
  "open_box_options": [],
  "number_of_reviews": 1392,
  "key_specifications": [
    {
      "name": "Battery Life (Continuous Communication Time)",
      "value": "Max. 24 hours(NC ON), Max. 28 hours(NC OFF)"
    },
    {
      "name": "Battery Charge Method",
      "value": "USB"
    }
  ]
}
```

### Search products

Operation `search_products`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Search Best Buy US products with optional price range, sort order, and page. Prices and availability reflect public listings and may vary by location.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `page` | integer | no | `2` | Page number, for example 1. |
| `sort` | string | no | `"price_low_to_high"` | Sort results, for example price_low_to_high. |
| `query` | string | yes | `"refrigerator"` | Product words to search, for example 65 inch OLED TV. |
| `max_price` | number | no | `1500` | Maximum price in USD, for example 1500. Leave blank for no maximum. |
| `min_price` | number | no | `500` | Minimum price in USD, for example 500. Leave blank for no minimum. |
| `max_results` | integer | no | `5` | Products per page, for example 20 (up to 50). |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number, for example 1.",
      "x-fous-developer": true,
      "examples": [
        2
      ]
    },
    "sort": {
      "enum": [
        "best_match",
        "price_low_to_high",
        "price_high_to_low",
        "top_rated",
        "newest"
      ],
      "type": "string",
      "default": "best_match",
      "description": "Sort results, for example price_low_to_high.",
      "examples": [
        "price_low_to_high"
      ]
    },
    "query": {
      "type": "string",
      "description": "Product words to search, for example 65 inch OLED TV.",
      "examples": [
        "refrigerator",
        "65 inch OLED TV",
        "zzzxxyyqqnoproductmatch2026"
      ]
    },
    "max_price": {
      "type": "number",
      "description": "Maximum price in USD, for example 1500. Leave blank for no maximum.",
      "examples": [
        1500
      ]
    },
    "min_price": {
      "type": "number",
      "description": "Minimum price in USD, for example 500. Leave blank for no minimum.",
      "examples": [
        500
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Products per page, for example 20 (up to 50).",
      "x-fous-developer": true,
      "examples": [
        5,
        20
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "page": 2,
      "sort": "price_low_to_high",
      "query": "refrigerator",
      "max_price": 1500,
      "min_price": 500,
      "max_results": 5
    },
    {
      "query": "65 inch OLED TV",
      "max_results": 20
    },
    {
      "query": "zzzxxyyqqnoproductmatch2026",
      "max_results": 5
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `products` | array |  |  |
| `products[].sku` | string or null | `"6361281"` |  |
| `products[].brand` | string or null | `"GE"` |  |
| `products[].price` | number or null | `598.99` |  |
| `products[].savings` | number or null | `166` |  |
| `products[].currency` | string | `"USD"` |  |
| `products[].photo_link` | string or null | `"https://pisces.bbystatic.com/image2/BestBuy_US/images/products/6361/6361281_sd.jpg"` |  |
| `products[].star_rating` | number or null | `4.4` |  |
| `products[].model_number` | string or null | `"GTS17DTNRBB"` |  |
| `products[].product_link` | string or null | `"https://www.bestbuy.com/product/ge-28-in-wide-16-6-cu-ft-top-freezer-refrigerator-with-interior-led-lighting-black/J764` |  |
| `products[].product_name` | string or null | `"GE - 28 in. Wide 16.6 Cu. Ft. Top-Freezer Refrigerator with Interior LED Lighting - Black"` |  |
| `products[].regular_price` | number or null | `764.99` |  |
| `products[].available_to_buy` | boolean | `true` |  |
| `products[].number_of_reviews` | integer or null | `496` |  |
| `products[].open_box_starting_price` | number or null | `1203.99` |  |

**Example input**

```json
{
  "page": 2,
  "sort": "price_low_to_high",
  "query": "refrigerator",
  "max_price": 1500,
  "min_price": 500,
  "max_results": 5
}
```

**Example output**

```json
{
  "products": [
    {
      "sku": "6361281",
      "brand": "GE",
      "price": 598.99,
      "savings": 166,
      "currency": "USD",
      "photo_link": "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/6361/6361281_sd.jpg",
      "star_rating": 4.4,
      "model_number": "GTS17DTNRBB",
      "product_link": "https://www.bestbuy.com/product/ge-28-in-wide-16-6-cu-ft-top-freezer-refrigerator-with-interior-led-lighting-black/J7645S2386",
      "product_name": "GE - 28 in. Wide 16.6 Cu. Ft. Top-Freezer Refrigerator with Interior LED Lighting - Black",
      "regular_price": 764.99,
      "available_to_buy": true,
      "number_of_reviews": 496,
      "open_box_starting_price": null
    },
    {
      "sku": "6672092",
      "brand": "Frigidaire",
      "price": 599.99,
      "savings": 210,
      "currency": "USD",
      "photo_link": "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/d045b9e5-4111-4e62-a2b6-8dc0c7d48181.jpg",
      "star_rating": 5,
      "model_number": "FRTE1814AB",
      "product_link": "https://www.bestbuy.com/product/frigidaire-19-cu-ft-garage-ready-top-freezer-refrigerator-black/J3GWPSK9WR",
      "product_name": "Frigidaire - 19 Cu. Ft. Garage Ready Top Freezer Refrigerator - Black",
      "regular_price": 809.99,
      "available_to_buy": true,
      "number_of_reviews": 1,
      "open_box_starting_price": null
    }
  ]
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@best-buy",
  "visibility": "public",
  "operation": "check_store_stock",
  "version": 1,
  "input": {
    "product": "Apple AirPods Pro 3",
    "zip_code": "60601"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@best-buy\",\n  \"visibility\": \"public\",\n  \"operation\": \"check_store_stock\",\n  \"version\": 1,\n  \"input\": {\n    \"product\": \"Apple AirPods Pro 3\",\n    \"zip_code\": \"60601\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@best-buy",
  "visibility": "public",
  "operation": "check_store_stock",
  "version": 1,
  "input": {
    "product": "Apple AirPods Pro 3",
    "zip_code": "60601"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/best-buy`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `check_store_stock`: Check store stock. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_product`: Get product. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `search_products`: Search products. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-best-buy https://api.fous.com/mcp/tools/best-buy --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Best Buy tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Best Buy account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from bestbuy.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 30, 2026.

## Related

- [B&H Photo API](https://fous.com/tools/bh-photo.md): B&H Photo returns cameras, audio, computers and electronics, with product prices and details reflecting public pages at the time they are viewed.
- [Newegg API](https://fous.com/tools/newegg.md): Newegg provides US computer and electronics listings, with product details and selected public offers whose prices, availability, stock, and shipping can change or may not be displayed.
- [Walmart API](https://fous.com/tools/walmart.md): Walmart helps shoppers find products from Walmart and marketplace sellers, view details, prices, ratings and reviews; availability uses Walmart’s default location, not ZIP codes.
- [Amazon API](https://fous.com/tools/amazon.md): Amazon returns publicly shown product listings, prices, details, ratings, reviews, current best sellers, and Today's Deals; availability and content vary by store, location, and access.
- [eBay API](https://fous.com/tools/ebay.md): eBay provides listings, listing details, seller reputation and newest feedback; shipping varies by destination, and some details or counts may be missing or approximate.
- [Apple Store API](https://fous.com/tools/apple-store.md): Apple Store shows current public-store prices and configurations, compares prices across up to 15 countries at latest ECB rates, checks local pickup without reservations, and lists currently shown refurbished products.
- [Nike API](https://fous.com/tools/nike.md): Nike returns country-specific listings and details, including prices, sizes, availability and reviews, plus publicly shown upcoming or recently stocked SNKRS releases with local launch times.
- [Costco API](https://fous.com/tools/costco.md): Costco returns US product prices/details and warehouse hours/services/gas prices; delivery affects availability, member prices may be hidden, and posted gas and holiday hours may differ.
- [All Commerce tools](https://fous.com/tools/category/commerce)