docs / bestbuy
Best Buy
Electronics products, prices and availability.
base /bestbuy/v12 endpoints
post
/bestbuy/v1/product_detail1 creditfull product card by `sku` OR `url`: sku/name/brand/model/price(current+regular+savings+savings_pct)/rating(average+review_count)/availability(in_stock+button_state+ship_by)/image/url/category/open_box/condition. Resolves sku|url -> product name (via the bare 308 Location) -> exact-match in the search grid (never hits the walled PDP). specs/features/review-text are PDP-walled (Phase-2 mint).
| Parameter | Required |
|---|---|
| sku | optional |
| url | optional |
post
/bestbuy/v1/search2 creditsproduct search by keyword -> results[]{sku,name,brand,model,price{current,regular,savings,savings_pct},rating{average,review_count},availability,image,url,category}. ~4-10 clean grid products/page bare; deep pagination is bifrost-walled (Phase-2). max_results param.
| Parameter | Required |
|---|---|
| query | required |
| max_results | optional |
Example request · product_detail
curl -X POST https://api.reefapi.com/bestbuy/v1/product_detail \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"sku":"6571043"}'Response shape
{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}