Best Buy
Electronics products, prices and availability.
/bestbuy/v1/search2 creditsSearch 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.
| 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. |
| category | optional | — | Restrict results with a Best Buy facet (e.g. a category_facet, brand_facet, or customerreviews_facet). Pass the raw facet value. |
/bestbuy/v1/product_detail1 creditGet 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). |
/bestbuy/v1/reviews1 creditGet 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. |
/bestbuy/v1/review_summary1 creditGet 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). |
/bestbuy/v1/search_suggestions1 creditGet 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). |
/bestbuy/v1/popular_terms1 creditGet Best Buy's currently trending / most-popular search terms (no input needed).
Try in playground →/bestbuy/v1/price1 creditGet 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). |
/bestbuy/v1/gifts1 creditGet 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. |
/bestbuy/v1/description1 creditGet 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). |
/bestbuy/v1/similar1 creditGet 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). |
/bestbuy/v1/deals1 creditBrowse 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). |
/bestbuy/v1/trending1 creditGet 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.
Try in playground →curl -X POST https://api.reefapi.com/bestbuy/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"laptop"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}