ToolzerHub Docs

Search products (v1)

Returns one page of up to 15 Best Buy products with price, regular price, rating, review count, seller and shipping or pickup availability, in any order the bestbuy.com sort menu offers.

1 credit / requestBilled only on success
GET
/v1/bestbuy/search

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Query Parameters

query*string

What a shopper would type into bestbuy.com, such as laptop, 4k tv or airpods pro.

Length1 <= length <= 200
page?integer

One-based page of up to 15 products. A page past the last returns empty products with stop_reason set to past_last_page.

Range1 <= value <= 1000
Default1
sort?string

Result order, as in the bestbuy.com sort menu.

Default"best_match"

Value in

  • "best_match"
  • "best_selling"
  • "price_low_to_high"
  • "price_high_to_low"
  • "customer_rating"
  • "best_discount"
  • "new_arrivals"
curl -X GET "https://example.com/v1/bestbuy/search?query=laptop" \  -H "x-api-key: YOUR_API_KEY"
{  "data": {    "query": "laptop",    "page": 1,    "sort": "best_match",    "total": 7018,    "corrected_query": "string",    "count": 0,    "has_more": true,    "next_page": 0,    "stop_reason": null,    "url": "https://www.bestbuy.com/site/searchpage.jsp?st=laptop",    "products": [      {        "sku": "6679316",        "name": "HP - OmniBook 3 - 14\" 2K OLED Laptop - Snapdragon X (8-Core CPU) - 8GB Memory - 256GB SSD - Starlit Blue",        "brand": "HP",        "model_number": "14-hz0088dx/DQ2E7UA#ABA",        "product_type": "Laptop Computer",        "url": "https://www.bestbuy.com/product/hp-omnibook-3-14-2k-oled-laptop/J3PPHFY77J/sku/6679316",        "image": "string",        "price": 399.99,        "regular_price": 599.99,        "savings": 200,        "currency": "USD",        "rating": 4.6,        "review_count": 120,        "condition": "new",        "sold_by_best_buy": true,        "is_active": true,        "availability": {          "shipping": true,          "pickup": true,          "delivery": true        }      }    ]  },  "details": {    "reason": "string",    "message": "string"  }}