Best Buy API
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.
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, 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 |
| 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
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.
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.