# Get product reviews (v1)

Returns one page of 20 customer reviews for a Best Buy product with rating, title, text, date, verified-purchase and incentivized flags, helpful votes and photos, plus the star breakdown, recommend rate and the pros and cons reviewers mention. A product without reviews returns an empty page.

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

| Parameter | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `sku_or_url` | query | yes | string | The sku from a search result, or a bestbuy.com product link that carries it, such as https://www.bestbuy.com/site/hp-omnibook-3/6679316.p?skuId=6679316 or https://www.bestbuy.com/product/hp-omnibook-3/J3PPHFY77J/sku/6679316. |
| `page` | query | no | integer | One-based page of 20 reviews; total_pages says how many there are. Default: 1. |
| `sort` | query | no | enum: most_recent, most_helpful, most_relevant, oldest, highest_rating, lowest_rating | Review order, as on the bestbuy.com reviews page. Default: most_recent. |

## Example request

```bash
curl "https://api.toolzerhub.com/v1/bestbuy/reviews?sku_or_url=<sku_or_url>" \
  -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.
