E-commerce & Marketplaces

Best Buy API

The Best Buy API returns Best Buy product data — prices, ratings and availability — as clean JSON.

15 actionsLive JSON1,000 free creditsMCP-ready

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

The primary search endpoint returns products with SKU, name, brand, model, price (current, regular, savings), rating and availability, and you can pull a product_detail, reviews, a review_summary, price, similar products and a description. It is built for price intelligence, catalog enrichment and review analysis that need Best Buy data without a scraper. One ReefAPI key, one shared credit pool, the standard { ok, data, meta, error } envelope.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Jul 18, 2026, 5:19 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/bestbuy/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "laptop"
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "bestbuy",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 4817.5,
    "record_count": 16,
    "bytes": 4362512,
    "cache_hit": false,
    "version": "0.1",
    "page": 1,
    "sort": "relevance",
    "filter": null,
    "grid_size": 40,
    "featured_full": 10,
    "price_enriched": 6,
    "dropped_inactive": 24,
    "field_note": "all cards carry name/price/availability/url; the ~4-6 featured cards also carry image/rating/variants/category. Per-item image for the rest comes from product_detail / the upcoming getProductDetail batch enrichment."
  },
  "data": {
    "query": "laptop",
    "results": [
      {
        "sku": "6671003",
        "name": "[redacted-name]",
        "brand": null,
        "model": null,
        "price": {
          "current": null,
          "regular": null,
          "savings": null,
          "savings_pct": null,
          "currency": "USD"
        },
        "rating": {
          "average": null,
          "review_count": null
        },
        "availability": {
          "in_stock": null,
          "button_state": null,
          "ship_by": null,
          "display_status": null
        },
        "image": "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/4c044006-cea9-4b97-b0d7-27ca77c526da.jpg",
        "images": [
          "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/4c044006-cea9-4b97-b0d7-27ca77c526da.jpg"
        ],
        "url": null,
        "category": null,
        "category_path": null,
        "product_type": null,
        "variants": null,
        "offers": null,
        "seller": null,
        "open_box": {
          "available": true,
          "from_price": null
        },
        "condition": null
      },
      {
        "sku": "6668953",
        "name": "[redacted-name]",
        "brand": "Dell",
        "model": "LDC[redacted-phone]BLK-PUS",
        "price": {
          "current": 449.99,
          "regular": 849.99,
          "savings": 400,
          "savings_pct": 47,
          "currency": "USD"
        },
        "rating": {
          "average": 4.6,
          "review_count": 111
        },
        "availability": {
          "in_stock": true,
          "button_state": "ADD_TO_CART",
          "ship_by": null,
          "display_status": "active"
        },
        "image": "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/12d8df20-f834-486b-bc00-5ddcd1b3dc33.jpg",
        "images": [
          "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/12d8df20-f834-486b-bc00-5ddcd1b3dc33.jpg",
          "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/b427322a-74cf-4ecc-ae26-0ab1556e7639.png"
        ],
        "url": "https://www.bestbuy.com/product/dell-15-6-2k-touchscreen-laptop-intel-13th-generation-core-i5-1334u-2023-8gb-memory-512-gb-storage-carbon-black/J3K4L6QW5Y/sku/6668953",
        "category": {
          "class_id": "768"
        },
        "category_path": null,
        "product_type": [
          "Laptop Computer"
        ],
        "variants": {
          "types": [
            "[trimmed-depth]"
          ],
          "options": [
            "[trimmed-depth]",
            "[trimmed-depth]"
          ]
        },
        "offers": [
          {
            "name": "[trimmed-depth]",
            "id": "[trimmed-depth]"
          },
          {
            "name": "[trimmed-depth]",
            "id": "[trimmed-depth]"
          },
          {
            "name": "[trimmed-depth]",
            "id": "[trimmed-depth]"
          }
        ],
        "seller": null,
        "open_box": null,
        "condition": "new"
      },
      {
        "sku": "6667885",
        "name": "[redacted-name]",
        "brand": "HP",
        "model": "14-HZ0005DX/D0VR2UA#ABA",
        "price": {
          "current": 599.99,
          "regular": 949.99,
          "savings": 350,
          "savings_pct": 36,
          "currency": "USD"
        },
        "rating": {
          "average": 4.6,
          "review_count": 154
        },
        "availability": {
          "in_stock": true,
          "button_state": "ADD_TO_CART",
          "ship_by": null,
          "display_status": "active"
        },
        "image": "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/bcd450f5-6679-4a0c-b249-73a9ac7849ad.jpg",
        "images": [
          "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/bcd450f5-6679-4a0c-b249-73a9ac7849ad.jpg",
          "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/dca3f8e7-775f-4f23-97f6-cfc7ce79997f.jpg",
          "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/3d282762-e634-4be4-bcfb-fb1149e4c2d9.jpg"
        ],
        "url": "https://www.bestbuy.com/product/hp-omnibook-3-14-2k-touchscreen-laptop-snapdragon-x-16gb-memory-512gb-ssd-copilot-pc-glacier-silver/JJGW3FLR3V/sku/6667885",
        "category": {
          "class_id": "768"
        },
        "category_path": null,
        "product_type": [
          "Laptop Computer"
        ],
        "variants": {
          "types": [
            "[trimmed-depth]"
          ],
          "options": [
            "[trimmed-depth]",
            "[trimmed-depth]",
            "[trimmed-depth]"
          ]
        },
        "offers": [
          {
            "name": "[trimmed-depth]",
            "id": "[trimmed-depth]"
          },
          {
            "name": "[trimmed-depth]",
            "id": "[trimmed-depth]"
          },
          {
            "name": "[trimmed-depth]",
            "id": "[trimmed-depth]"
          }
        ],
        "seller": null,
        "open_box": null,
        "condition": "new"
      }
    ]
  }
}

Actions

What the Best Buy API does

Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/bestbuy/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"laptop"}'

import requests

r = requests.post(
    "https://api.reefapi.com/bestbuy/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "laptop"
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/bestbuy/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "query": "laptop"
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.bestbuy.search with {"query":"laptop"}.

Use cases

Who uses this API and why

Pricing teams call search and price to track Best Buy prices, deals and savings against competitors.
Catalog-enrichment tools use product_detail to fill product pages with specs, images and availability.
Review-analysis products pull reviews and review_summary to monitor sentiment and ratings for a SKU.

FAQ

Questions developers ask before integrating

What is the Best Buy API?

Best Buy API is a ReefAPI endpoint group for electronics products, prices and availability. It returns live JSON through POST requests under /bestbuy/v1.

Is the Best Buy API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Best Buy calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Best Buy login or account?

No login to Best Buy is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Best Buy data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Best Buy API use?

Best Buy actions currently cost 1-2 credits per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

Can I call Best Buy from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call bestbuy actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Best Buy API a Best Buy scraper?

It is the managed alternative to a DIY Best Buy scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same electronics products, prices and availability back as clean JSON.

Why does my Best Buy scraper keep getting blocked?

Most Best Buy scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.

docs / bestbuy

Best Buy

Electronics products, prices and availability.

base /bestbuy/v115 endpoints

post/bestbuy/v1/search2 credits

Search Best Buy by keyword → a paginated, sortable, filterable list of products with name, brand, model, current & regular price, savings, star rating + review count, stock status, image gallery, variants, category, and the product link. Narrow with friendly filters: brand, min_price/max_price, min_rating, condition.

Parameter		Allowed / range	Description
query	required	—	What to search for on Best Buy (product keywords, brand, or model).
max_results = 24	optional	1–240	How many products to return (1–240). Spans multiple result pages automatically (24/page).
page = 1	optional	1–	Result page to start from (1-based; ~24 products/page).
sort = relevance	optional	relevance · best_selling · best_discount · price_low · price_high · rating · newest	Result ordering.
brand	optional	—	Filter to one brand (e.g. Apple, HP, Samsung, Sony). Use the exact brand name as Best Buy shows it.
min_price	optional	0–	Lowest price to include (USD). Combine with max_price for a price window.
max_price	optional	0–	Highest price to include (USD).
min_rating	optional	5 · 4 · 3 · 2 · top_rated	Only products at or above this customer rating.
condition	optional	new · open_box · refurbished · pre_owned	Product condition.
category	optional	—	Advanced: restrict results with a raw Best Buy facet token (escape hatch for power users). Discover the available facets for a keyword with the `categories` action. Most users want the brand / min_price / max_price / min_rating / condition filters instead.

Try in playground →

post/bestbuy/v1/product_detail1 credit

Get the full product card for one Best Buy item by its product number, URL, or product-id → name, brand, model, current/regular price + savings, clearance/sale flags & special offers, stock status, star rating with a 5★-to-1★ breakdown, what customers like/dislike, image gallery, color/storage/carrier variants, and the category breadcrumb.

Parameter		Allowed / range	Description
sku	optional	—	Best Buy product number. Accepts the 7-digit SKU (e.g. 6565837), OR the product-id from the page URL (the code like JJGCQ8VCFQ), OR a full bestbuy.com product link — any of the three works.
url	optional	—	A full bestbuy.com product page URL (alternative to the product number).

Try in playground →

post/bestbuy/v1/reviews1 credit

Get customer reviews for a Best Buy product → each review's star rating, title, full text, author, date, pros & cons, verified-purchase / incentivized flags, how long they've owned it, helpful-vote counts, and any customer photos. Paginated.

Parameter		Allowed / range	Description
sku	optional	—	Best Buy product number. Accepts the 7-digit SKU (e.g. 6565837), OR the product-id from the page URL (the code like JJGCQ8VCFQ), OR a full bestbuy.com product link — any of the three works.
url	optional	—	A full bestbuy.com product page URL (alternative to the product number).
page = 1	optional	1–	Page of reviews to return.
page_size = 20	optional	1–100	Reviews per page (max 100).
sort = MOST_RECENT	optional	MOST_RECENT · MOST_HELPFUL · HIGHEST_RATING · LOWEST_RATING	How to order the reviews.

Try in playground →

post/bestbuy/v1/review_summary1 credit

Get the review snapshot for a Best Buy product → average rating, total review count, verified-purchase count, the full 5★-to-1★ rating breakdown, and a 'what customers say' summary of the most-mentioned pros and cons — in a single call.

Parameter		Allowed / range	Description
sku	optional	—	Best Buy product number. Accepts the 7-digit SKU (e.g. 6565837), OR the product-id from the page URL (the code like JJGCQ8VCFQ), OR a full bestbuy.com product link — any of the three works.
url	optional	—	A full bestbuy.com product page URL (alternative to the product number).

Try in playground →

post/bestbuy/v1/search_suggestions1 credit

Get Best Buy search autocomplete suggestions for a partial query → the suggested search terms (with spell-correction), just like the dropdown under the search box.

Parameter		Allowed / range	Description
query	required	—	The partial search text to autocomplete (e.g. 'lapt').
limit = 11	optional	1–40	How many suggestions to return (1–40).

Try in playground →

post/bestbuy/v1/popular_terms1 credit

Get Best Buy's currently trending / most-popular search terms (no input needed).

Try in playground →

post/bestbuy/v1/price1 credit

Get the live pricing for a Best Buy product by SKU → current price, regular price, savings, clearance/sale flags and special offers (from Best Buy's pricing API).

Parameter		Allowed / range	Description
sku	required	—	The Best Buy product SKU (7-digit number, e.g. 6565837).

Try in playground →

post/bestbuy/v1/gifts1 credit

Get the Gift-With-Purchase offers for a Best Buy product by SKU → each promotional offer (e.g. 'Apple TV Up to 1 Month GWP') and the free gift SKUs that come with it.

Parameter		Allowed / range	Description
sku	required	—	The Best Buy product SKU to check for gift-with-purchase.

Try in playground →

post/bestbuy/v1/description1 credit

Get a Best Buy product's full description and complete technical specifications by SKU → the marketing description plus every spec (name/value pairs: connectivity, dimensions, features, etc.). The deep product detail that lives on the product page.

Parameter		Allowed / range	Description
sku	optional	—	The Best Buy product SKU (7-digit, e.g. 6505727).
url	optional	—	A full bestbuy.com /product/ URL (alternative to the SKU).

Try in playground →

post/bestbuy/v1/similar1 credit

Get the products Best Buy recommends as similar to a given product (by SKU) → each recommended product's SKU, name, current price and link.

Parameter		Allowed / range	Description
sku	optional	—	The Best Buy product SKU to find similar products for.
url	optional	—	A full bestbuy.com /product/ URL (alternative to the SKU).
limit = 20	optional	1–40	How many similar products to return (1–40).

Try in playground →

post/bestbuy/v1/deals1 credit

Browse Best Buy's current deals — on-sale and clearance products site-wide, sorted by biggest discount by default → each product's name, brand, current & regular price, the amount and percent saved, star rating, stock status, image and link. Great for a 'today's best deals' / price-drop feed. (To find deals within a category, use search with sort=best_discount.)

Parameter		Allowed / range	Description
sort = best_discount	optional	best_discount · best_selling · price_low · price_high · rating · newest	How to order the deals (default: biggest discount).
max_results = 24	optional	1–240	How many deal products to return (1–240; ~24/page).
page = 1	optional	1–	Result page to start from (1-based; ~24/page).

Try in playground →

post/bestbuy/v1/qa1 credit

Get the customer questions & answers for a Best Buy product → each question with its author, date, and every answer (text, author, date, helpful-vote count, and which answer was voted best). Great for pre-purchase research. Paginated.

Parameter		Allowed / range	Description
sku	optional	—	Best Buy product number. Accepts the 7-digit SKU (e.g. 6565837), OR the product-id from the page URL (the code like JJGCQ8VCFQ), OR a full bestbuy.com product link — any of the three works.
url	optional	—	A full bestbuy.com product page URL (alternative to the product number).
page = 1	optional	1–	Page of questions to return.
page_size = 10	optional	1–100	Questions per page (max 100).
sort = MOST_RECENT	optional	MOST_RECENT · MOST_HELPFUL	How to order the questions.

Try in playground →

post/bestbuy/v1/store_availability1 credit

Check whether a Best Buy product (by SKU) is available to buy for a given ZIP code (and optionally a specific store) → an available flag plus the live buy-button status (e.g. Add to Cart / Sold Out / Pre-Order). Useful for retail-arbitrage and local-stock checks.

Parameter		Allowed / range	Description
sku	required	—	The Best Buy product SKU (7-digit number, e.g. 6505727).
zip = 10001	optional	—	The US ZIP code to check availability for (defaults to 10001 / New York if omitted).
store_id	optional	—	Optional Best Buy store number to check a specific store. Omit to check general availability for the ZIP.

Try in playground →

post/bestbuy/v1/categories1 credit

Discover the categories and filter facets available for a Best Buy keyword search → the category sub-paths (each with a category id you can browse) plus every filterable facet (Brand, Price, Customer Rating, and category-specific attributes) with their values and product counts. Use it to learn what you can filter by before calling search.

Parameter		Allowed / range	Description
query	required	—	The keyword to discover categories & filters for (e.g. 'laptop', 'tv', 'headphones').
category	optional	—	Advanced: narrow to a sub-category first (raw facet token) to discover its deeper facets.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/bestbuy/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"laptop"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}

Action	Description	Concrete use case	Key params
search	Search Best Buy by keyword → a paginated, sortable, filterable list of products with name, brand, model, current & regular price, savings, star rating + review count, stock status, image gallery, variants, category, and the product link. Narrow with friendly filters: brand, min_price/max_price, min_rating, condition.	Pricing teams call search to search Best Buy by keyword → a paginated, sortable, filterable list of products with name, br….	query, max_results, page, sort, brand, ...
product_detail	Get the full product card for one Best Buy item by its product number, URL, or product-id → name, brand, model, current/regular price + savings, clearance/sale flags & special offers, stock status, star rating with a 5★-to-1★ breakdown, what customers like/dislike, image gallery, color/storage/carrier variants, and the category breadcrumb.	Marketplace operators call product_detail to get the full product card for one Best Buy item by its product number, URL, or product-id → n….	sku, url
reviews	Get customer reviews for a Best Buy product → each review's star rating, title, full text, author, date, pros & cons, verified-purchase / incentivized flags, how long they've owned it, helpful-vote counts, and any customer photos. Paginated.	Catalog enrichment teams call reviews to get customer reviews for a Best Buy product → each review's star rating, title, full text, au….	sku, url, page, page_size, sort
review_summary	Get the review snapshot for a Best Buy product → average rating, total review count, verified-purchase count, the full 5★-to-1★ rating breakdown, and a 'what customers say' summary of the most-mentioned pros and cons — in a single call.	Retail analysts call review_summary to get the review snapshot for a Best Buy product → average rating, total review count, verified….	sku, url
search_suggestions	Get Best Buy search autocomplete suggestions for a partial query → the suggested search terms (with spell-correction), just like the dropdown under the search box.	Pricing teams call search_suggestions to get Best Buy search autocomplete suggestions for a partial query → the suggested search terms….	query, limit
popular_terms	Get Best Buy's currently trending / most-popular search terms (no input needed).	Marketplace operators call popular_terms to get Best Buy's currently trending / most-popular search terms (no input needed)..	none
price	Get the live pricing for a Best Buy product by SKU → current price, regular price, savings, clearance/sale flags and special offers (from Best Buy's pricing API).	Catalog enrichment teams call price to get the live pricing for a Best Buy product by SKU → current price, regular price, savings, c….	sku
gifts	Get the Gift-With-Purchase offers for a Best Buy product by SKU → each promotional offer (e.g. 'Apple TV Up to 1 Month GWP') and the free gift SKUs that come with it.	Retail analysts call gifts to get the Gift-With-Purchase offers for a Best Buy product by SKU → each promotional offer (e.g.	sku
description	Get a Best Buy product's full description and complete technical specifications by SKU → the marketing description plus every spec (name/value pairs: connectivity, dimensions, features, etc.). The deep product detail that lives on the product page.	Pricing teams call description to get a Best Buy product's full description and complete technical specifications by SKU → the….	sku, url
similar	Get the products Best Buy recommends as similar to a given product (by SKU) → each recommended product's SKU, name, current price and link.	Marketplace operators call similar to get the products Best Buy recommends as similar to a given product (by SKU) → each recommende….	sku, url, limit
deals	Browse Best Buy's current deals — on-sale and clearance products site-wide, sorted by biggest discount by default → each product's name, brand, current & regular price, the amount and percent saved, star rating, stock status, image and link. Great for a 'today's best deals' / price-drop feed. (To find deals within a category, use search with sort=best_discount.)	Catalog enrichment teams call deals to get browse Best Buy's current deals.	sort, max_results, page
trending	Get Best Buy's trending-right-now search terms — what shoppers are searching for at the moment (distinct from popular_terms, which is all-time most-popular). No input needed.	Retail analysts call trending to get Best Buy's trending-right-now search terms.	none
qa	Get the customer questions & answers for a Best Buy product → each question with its author, date, and every answer (text, author, date, helpful-vote count, and which answer was voted best). Great for pre-purchase research. Paginated.	Pricing teams call qa to get the customer questions & answers for a Best Buy product → each question with its author,….	sku, url, page, page_size, sort
store_availability	Check whether a Best Buy product (by SKU) is available to buy for a given ZIP code (and optionally a specific store) → an available flag plus the live buy-button status (e.g. Add to Cart / Sold Out / Pre-Order). Useful for retail-arbitrage and local-stock checks.	Marketplace operators call store_availability to check whether a Best Buy product (by SKU) is available to buy for a given ZIP code (and optio….	sku, zip, store_id
categories	Discover the categories and filter facets available for a Best Buy keyword search → the category sub-paths (each with a category id you can browse) plus every filterable facet (Brand, Price, Customer Rating, and category-specific attributes) with their values and product counts. Use it to learn what you can filter by before calling search.	Catalog enrichment teams call categories to discover the categories and filter facets available for a Best Buy keyword search → the categ….	query, category