# Amazon Reviews API

> Pull customer reviews for any Amazon product by ASIN or URL: rating, title, text, date, and verified-buyer badge.

Source: https://www.sandbase.ai/apis/amazon/reviews
API reference: https://www.sandbase.ai/apis/amazon/reviews#api

## Facts

- Provider: Amazon
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/amazon/reviews`
- Price: From $0.016 per call
- Capabilities: api, amazon, ecommerce, product data
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/amazon/reviews` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `product` | string | yes |  |
| `sort` | string | no | helpful, recent |
| `limit` | integer | no |  |
| `region` | string | no | amazon.com, amazon.ca, amazon.de, amazon.fr, amazon.co.uk, amazon.it, amazon.es, amazon.com.au, amazon.co.jp, amazon.com.br, amazon.com.mx, amazon.nl, amazon.ie, amazon.se, amazon.com.tr, amazon.ae, amazon.sg, amazon.sa, amazon.pl, amazon.com.be, amazon.eg, amazon.in |
| `endDate` | string | no |  |
| `keyword` | string | no |  |
| `ratings` | array | no |  |
| `startDate` | string | no |  |
| `verifiedOnly` | boolean | no |  |
| `requireFields` | array | no |  |

## FAQ

### How do I use the Amazon Reviews API?

Send a POST request to https://api.sandbase.ai/v1/api/amazon/reviews with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the Amazon Reviews API cost?

From $0.016 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the Amazon Reviews API accept?

Required: product (string). Optional: sort (one of helpful, recent), limit (integer), region (one of amazon.com, amazon.ca, amazon.de, amazon.fr, amazon.co.uk, amazon.it, amazon.es, amazon.com.au, amazon.co.jp, amazon.com.br, amazon.com.mx, amazon.nl, amazon.ie, amazon.se, amazon.com.tr, amazon.ae, amazon.sg, amazon.sa, amazon.pl, amazon.com.be, amazon.eg, amazon.in), endDate (string), keyword (string) and ratings (array) and 3 more. The Parameters table and the Playground on this page list every field.

### What does the Amazon Reviews API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a Amazon developer account or API key?

No. Amazon Reviews runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Amazon API access separately.

## README

### Amazon Reviews API

Pull customer reviews for any Amazon product by ASIN or URL: rating, title, text, date, and verified-buyer badge.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "amazon/reviews", "limit": 3, "product": "B07PXGQC1Q"}'
```

The result is returned in `outputs[0].data`. Lookups that find nothing fail with a not-found error.

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `product` | string | Yes | Amazon product ASIN (e.g. B07CMS5Q6P) or a product link on one of the marketplaces listed under region, such as https://www.amazon.co.uk/dp/<ASIN>, with the ASIN after /dp/, /gp/product/ or /product-reviews/. A link with |
| `endDate` | string | No | Only return reviews on or before this date, inclusive, in YYYY-MM-DD format (e.g. 2026-06-30). |
| `keyword` | string | No | Only return reviews whose title or text contains this keyword, case-insensitively (e.g. battery). |
| `limit` | integer | No | Maximum number of results to return (1-50, default 50). |
| `ratings` | array | No | Only return reviews whose star rating is in this set (e.g. ["5", "4"] for 4 and 5 star reviews); omit for all ratings. |
| `region` | string | No | Amazon marketplace domain the product ASIN belongs to (e.g. amazon.co.uk). One of: `amazon.com`, `amazon.ca`, `amazon.de`, `amazon.fr`, `amazon.co.uk`, `amazon.it`, `amazon.es`, `amazon.com.au`, `amazon.co.jp`, `amazon.c |
| `requireFields` | array | No | Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `url`, and it is served only by a source that returns every one of the |
| `sort` | string | No | Review sort order: most helpful first or most recent first (e.g. recent). One of: `helpful`, `recent`. |
| `startDate` | string | No | Only return reviews on or after this date, inclusive, in YYYY-MM-DD format (e.g. 2026-01-01). |
| `verifiedOnly` | boolean | No | Set true to return only verified-purchase reviews (e.g. true). |

#### Pricing

Billed at the actual cost of each call, about $0.016 per request. A call can cost more when the first data source fails and another one answers. Failed calls and lookups that find nothing are not charged.
