Best Buy API & Scraper
The Best Buy API returns Best Buy product data — prices, ratings and availability — as clean JSON.
🤖 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.
Best Buy SKU, product-id code and UPC: which identifier goes where
Best Buy uses three different codes for the same product and the product URL contains two of them. Every action here takes the product number, but several also accept the URL code or the full link, and the UPC only ever comes back in a response. Measured on 2026-08-27 with live search, product_detail, products_batch, deals and price calls.
| Identifier | Shape (measured) | Example | Where it works |
|---|---|---|---|
| SKU / product number | 7 or 8 digits | 6397846, 13006703 | the sku parameter on every action; skus[] on products_batch |
| URL product-id code | 10 characters, uppercase letters and digits | JJGCQLKXL7 | the same sku parameter on product_detail, reviews, description, similar |
| Full product URL | /product/<slug>/<code>/sku/<sku> | www.bestbuy.com/product/apple-macbook-air-.../JJGCQLKXL7/sku/6397846 | the url parameter |
| UPC | 12 digits (UPC-A) | 195950690200 | returned by product_detail, products_batch, description; never an input |
| Promotion offer id | 6 digits | 871883 | returned inside price.offers[] and the gifts action |
An identifier the engine cannot classify is rejected before any upstream call: passing sku 'BADSKU1' returned error code MISSING_PARAM with the message 'could not recognise the product identifier'. A well-formed SKU that Best Buy does not resolve behaves differently in products_batch, where it comes back in not_found[] instead of being dropped: a three-SKU call with one fake number returned record_count 2 and not_found ['0000000'].
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/bestbuy/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "laptop"
}
}{
"ok": true,
"meta": {
"api": "bestbuy",
"endpoint": "search",
"mode": "live",
"latency_ms": 6696.3,
"record_count": 24,
"bytes": 4661413,
"cache_hit": false,
"version": "0.1",
"page": 1,
"sort": "relevance",
"filter": null,
"grid_size": 43,
"with_price": 24,
"incomplete": 0,
"with_brand": 24,
"with_rating": 24,
"sponsored_count": 5,
"hydrate_batches": 5,
"hydrate_fetches": 6,
"hydrate_failed_batches": 0,
"field_note": "every card carries name + brand + rating + image + url; `price.current` is populated for every product BestBuy prices on the grid. `sponsored:true` marks a paid placement — pass include_sponsored=false to exclude them."
},
"data": {
"query": "laptop",
"results": [
{
"sku": "6673811",
"name": "[redacted-name]",
"brand": "Lenovo",
"model": "83SX0000US",
"price": {
"current": 199,
"regular": 419,
"savings": 220,
"savings_pct": 52,
"currency": "USD"
},
"rating": {
"average": 4.6,
"review_count": 29
},
"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/a69588e3-2c25-4d64-bed1-e855f4fed90d.jpg",
"images": [
"https://pisces.bbystatic.com/image2/BestBuy_US/images/products/a69588e3-2c25-4d64-bed1-e855f4fed90d.jpg"
],
"url": "https://www.bestbuy.com/product/lenovo-ideapad-slim-3-chromebook-14-2k-touchscreen-laptop-mediatek-kompanio-[redacted-phone]gb-memory-64gb-emmc-cosmic-blue/JJGH3QCJKR/sku/6673811",
"category": {
"class_id": "769"
},
"category_path": null,
"product_type": [
"Chromebook",
"Laptop Computer"
],
"variants": null,
"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",
"sponsored": false
},
{
"sku": "6667474",
"name": "[redacted-name]",
"brand": "HP",
"model": "14-dq6101dx",
"price": {
"current": 229.99,
"regular": 349.99,
"savings": 120,
"savings_pct": 34,
"currency": "USD"
},
"rating": {
"average": 4.4,
"review_count": 294
},
"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/3bd638b[redacted-phone]e43-34faa18a2382.jpg",
"images": [
"https://pisces.bbystatic.com/image2/BestBuy_US/images/products/3bd638b[redacted-phone]e43-34faa18a2382.jpg",
"https://pisces.bbystatic.com/image2/BestBuy_US/images/products/d7fd5894-07b3-4182-bf0d-8332b09021ea.jpg",
"https://pisces.bbystatic.com/image2/BestBuy_US/images/products/79bae750-4bbb-4842-8bd9-a5c7239aa993.jpg"
],
"url": "https://www.bestbuy.com/product/hp-14-laptop-intel-n150-processor-4gb-memory-128gb-ufs-natural-silver/JJGW3FGFPZ/sku/6667474",
"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",
"sponsored": false
},
{
"sku": "12341769",
"name": "[redacted-name]",
"brand": "HP",
"model": "16-as0023dx",
"price": {
"current": 934.99,
"regular": 1199.99,
"savings": 265,
"savings_pct": 22,
"currency": "USD"
},
"rating": {
"average": 4.8,
"review_count": 1857
},
"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/3909cb40-136f-4a58-b500-4f79b55a0f44.jpg",
"images": [
"https://pisces.bbystatic.com/image2/BestBuy_US/images/products/3909cb40-136f-4a58-b500-4f79b55a0f44.jpg",
"https://pisces.bbystatic.com/image2/BestBuy_US/images/products/d26f0b62-60f1-407a-ac94-397c37298a4c.png",
"https://pisces.bbystatic.com/image2/BestBuy_US/images/products/3057e51c-3d00-40f1-808c-807f7a6ad989.jpg"
],
"url": "https://www.bestbuy.com/product/hp-omnibook-x-flip-2-in-1-16-2k-touchscreen-laptop-intel-core-ultra-7-256v-2024-16gb-memory-1tb-ssd-copilot-pc-eclipse-gray/JJGQJRKGR5/sku/12341769",
"category": {
"class_id": "770"
},
"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]"
}
],
"seller": null,
"open_box": null,
"condition": "new",
"sponsored": false
}
]
}
}What the Best Buy API does
| 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, seller type (Best Buy itself vs a marketplace seller), and the product link. Narrow with friendly filters: brand, min_price/max_price, min_rating, condition. NOTE: the full category breadcrumb (category_path) is not published on Best Buy's result grid - grid rows carry the product_type labels instead. For the breadcrumb, use product_detail for one product or products_batch for up to 15 at a time. | 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 |
| products_batch | Look up MANY Best Buy products in ONE call by product number — up to 15 per request → each product's barcode (UPC), name, brand, price, rating, images, full technical specifications, shipping weight and package dimensions. Built for enriching a whole catalogue or price list at once instead of one product at a time. | Catalog enrichment teams call products_batch to look up MANY Best Buy products in ONE call by product number. | skus |
| 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. | Retail analysts 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. | Pricing teams 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. | Marketplace operators 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). | Catalog enrichment teams 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). | Retail analysts 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. | Pricing teams 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. | Marketplace operators call description to get a Best Buy product's full description and complete technical specifications by SKU → the…. | sku, url |
| 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, include_sponsored |
| 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 |
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();Ask your MCP-connected assistant: call reefapi.bestbuy.search with {"query":"laptop"}.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.
Questions developers ask before integrating
Is a Best Buy SKU always 7 digits?
No. Seven digits is the common case, but eight-digit SKUs exist and the engine accepts both. A deals call on 2026-08-27 returned 4833200 and 4833900 alongside 13006703 and 13006654 in the same result set. Store SKUs as strings and do not validate on length, or you will drop the eight-digit ones.
What is the difference between price.current, price.regular, savings and pricing_type?
current is what you pay today, regular is the reference price, and savings plus savings_pct are the difference between them. A price call for SKU 6565837 on 2026-08-27 returned current 509.99, regular 849.00, savings 339.01, savings_pct 39 and pricing_type 'clearance'. When there is no discount, current and regular are equal and both savings and savings_pct come back null rather than 0, so test for null before doing arithmetic.
How do I tell that a Best Buy product is out of stock?
Read availability.in_stock together with button_state. The same 6565837 lookup returned in_stock false with button_state 'SOLD_OUT' and button_text 'Sold Out', while an in-stock MacBook Air returned in_stock true with button_state 'ADD_TO_CART'. A price is still returned for a sold-out product, so a non-null price is not evidence of availability.
Why is availability null on product_detail when search returns it?
The two actions read different Best Buy surfaces. product_detail reads the catalog surface, which publishes identifiers, specifications, weight, dimensions and images but not stock. A measured call for SKU 6397846 returned upc, weight '2.7 pounds', spec_count 47 and dimensions, with availability, variants, customers_say, category_path and product_type all null. Use search or price for stock, and review_summary for the customers_say pros and cons.
Where do the UPC, shipping weight and package dimensions come from?
From product_detail, products_batch and description. Weight arrives twice: weight as Best Buy prints it ('2.7 pounds', '3.99 pounds') and weight_value plus weight_unit as a number and a unit token such as POUND. dimensions is an object keyed 'Product Height', 'Product Width' and 'Product Depth', each a string with its unit. spec_count tells you how deep the spec list goes, measured at 47 for a MacBook Air and 98 for a Dell laptop.
How many Best Buy products can I enrich in one call?
products_batch takes up to 15 SKUs per request and resolves them in a single upstream call, which is why it is the cheap way to enrich a price list. Anything Best Buy does not recognize comes back in not_found[] with the rest of the products still returned, so one bad SKU never costs you the whole batch.
How deep can Best Buy search go?
search and deals cap at 240 products per call, spanning ten pages of 24. The ceiling is an upper bound rather than a promise, because Best Buy repeats a few products across deep pages and duplicates are dropped. To go past 240, set page: a call with page=11 starts where a 240-result call ended.
What does the Best Buy rating breakdown contain?
review_summary returns average_rating, total_reviews, verified_purchase_count and a rating_breakdown keyed '5' through '1', each with a count and a percent. A measured call for SKU 6397846 returned average_rating 4.93 over 1233 reviews with 1215 verified purchases and a 5-star bucket of 1166 reviews at 94 percent. customers_say arrives here too, as pros and cons with their own counts, for example 'Overall Performance' mentioned by 545 reviewers.
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-5 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.