# 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.

- Platform: Best Buy
- Request: `GET https://api.toolzerhub.com/v1/bestbuy/search`
- Auth: `x-api-key` header
- Cost: 1 credit per successful request. Failed requests are not billed.
- Page: https://docs.toolzerhub.com/reference/best-buy/search/get-best-buy-search

| Parameter | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `query` | query | yes | string | What a shopper would type into bestbuy.com, such as laptop, 4k tv or airpods pro. |
| `page` | query | no | 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. Default: 1. |
| `sort` | query | no | enum: best_match, best_selling, price_low_to_high, price_high_to_low, customer_rating, best_discount, new_arrivals | Result order, as in the bestbuy.com sort menu. Default: best_match. |

## Example request

```bash
curl "https://api.toolzerhub.com/v1/bestbuy/search?query=<query>" \
  -H "x-api-key: $TOOLZERHUB_API_KEY"
```

Success responses are wrapped as `{ "data": ... }`. Errors return `{ "error": { "code", "status", "message", "retryable", "details" } }`. See https://docs.toolzerhub.com/docs/responses-and-errors.