> Documentation index: https://docs.scrapier.io/llms.txt
> Auth: header `X-API-Key: <key>` · Base: https://api.scrapier.io/api/v2 · Synchronous; paginate with `cursor` ← `data.next_cursor`.

# Amazon Product Reviews

Get the reviews Amazon shows for a product from its ASIN or product URL, with rating, text, author and date.

`GET|POST https://api.scrapier.io/api/v2/amazon-review/` · 2 credits per successful call · Single lookup

## Overview

Send a bare ASIN or an Amazon product URL in `asins` and get the product's reviews back, each with title, text, rating, author, helpful votes, verified flag and publish date.

This is a single lookup: `next_cursor` is always `null`. Without a sign-in Amazon serves only the product page's "Top reviews" card (up to 8 US reviews and up to about 5 international ones), so there are no further pages. The `warning` field says so in the response.

## Use cases

- Pull recent reviews of your own or a competitor's product.
- Feed review text into sentiment or issue analysis.
- Check whether reviewers are verified purchasers.

## Request

```bash
curl -G "https://api.scrapier.io/api/v2/amazon-review/" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "asins=B0B2RM68G2" \
  --max-time 210
```

```python
import requests

resp = requests.get(
    "https://api.scrapier.io/api/v2/amazon-review/",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"asins": "B0B2RM68G2"},
    timeout=210,
)
body = resp.json()
if not resp.ok:
    raise RuntimeError(body.get("error") or body.get("detail"))

print(body["data"]["reviews"])
```

POST with a JSON body works too (same parameters; the body is merged over the query string).

## Parameters

| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| `X-API-Key` (header) | string | yes | — | Your API key. |
| `asins` | string | yes | e.g. `B0B2RM68G2` | Bare ASIN or amazon.com product URL (/dp/, /gp/product/, slugged). Single lookup -- next_cursor always null. CAP: logged-out Amazon serves only the product page's "Top reviews" card (up to 8 US + up to ~5 international reviews); the full paginated list requires sign-in (stated in the `warning` field). Unknown ASIN / no reviews -> 404; Amazon wall on every attempt -> 502; bad input -> 400. |
| `use_proxy` | boolean | no | `true` | Route the request through Scrapier's residential proxy pool. Default: `true`. Leave as is unless support tells you otherwise. |
| `raw_data` | boolean | no | `false` | When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. |

## Response

HTTP 200. Results are in `data.reviews`. Sample from the live catalog, arrays trimmed to 3 items.

```json
{
  "success": true,
  "data": {
    "asins": "B0B2RM68G2",
    "product": {
      "asin": "B0B2RM68G2",
      "title": "BIODANCE Bio-Collagen Real Deep Mask, Hydrating Overnight Hydrogel Face Mask, ...",
      "url": "https://www.amazon.com/dp/B0B2RM68G2",
      "rating": 4.5,
      "ratings_total": 49090
    },
    "page": 1,
    "page_size": 13,
    "reviews": [
      {
        "input_asin": "B0B2RM68G2",
        "entity_id": "B0B2RM68G2",
        "status": "ok",
        "error": null,
        "id": "R2V1U0N5TAYC88",
        "url": "https://www.amazon.com/gp/customer-reviews/R2V1U0N5TAYC88",
        "title": "Overnight Hydration That Leaves Skin Soft, Plump, and Refreshed",
        "text": "The BIODANCE Bio-Collagen Real Deep Mask is one of the most impressive overnight masks I've tried...",
        "rating": {
          "value": 5,
          "max": 5
        },
        "author": {
          "name": "Klee",
          "avatar_url": "https://m.media-amazon.com/images/S/amazon-avatars-global/default._SX48_.png",
          "url": "https://www.amazon.com/gp/profile/amzn1.account.xxx",
          "location": "US",
          "reviews_count": null
        },
        "helpful_votes": 3,
        "verified": true,
        "source": "top_reviews_local",
        "position": 1,
        "variant": "Scent: Collagen | Size: 4 Count (Pack of 1)",
        "language": "en",
        "original_language": "en",
        "translated": false,
        "images": null,
        "responses": null,
        "published_at": "2026-09-20T00:00:00.000Z",
        "product": {
          "asin": "B0B2RM68G2",
          "title": "BIODANCE Bio-Collagen Real Deep Mask, ...",
          "url": "https://www.amazon.com/dp/B0B2RM68G2",
          "rating": 4.5,
          "ratings_total": 49090
        },
        "computed": {
          "labels": {
            "sentiment": {
              "level": 4,
              "score_0_1": 0.96,
              "confidence": 0.99,
              "rating_mismatch": false
            },
            "issue": {
              "label": "product_defect",
              "confidence": 0.7
            }
          }
        },
        "scraped_at": "2026-09-24T17:00:00.000Z"
      }
    ],
    "next_cursor": null,
    "warning": "Amazon shows logged-out visitors only the product page's 'Top reviews' card (up to 8 US reviews + up to ~5 from other countries); the full paginated review list requires sign-in, so no further pages exist for this endpoint."
  }
}
```

## Response fields

| Field | Type | Example | Description |
|---|---|---|---|
| `asins` | string | `B0B2RM68G2` |  |
| `product` | object | `{…}` |  |
| `page` | integer | `1` |  |
| `page_size` | integer | `13` |  |
| `reviews` | array | `[1 item]` | The results. |
| `next_cursor` | null | `null` | Pass back as `cursor` for the next page. `null` on the last page. |
| `warning` | string | `Amazon shows logged-out visitors only the pro…` | Notes the logged-out review cap on this response. |
| `reviews[].input_asin` | string | `B0B2RM68G2` |  |
| `reviews[].entity_id` | string | `B0B2RM68G2` |  |
| `reviews[].status` | string | `ok` |  |
| `reviews[].error` | null | `null` |  |
| `reviews[].id` | string | `R2V1U0N5TAYC88` |  |
| `reviews[].url` | string | `https://www.amazon.com/gp/customer-reviews/R2…` |  |
| `reviews[].title` | string | `Overnight Hydration That Leaves Skin Soft, Pl…` |  |
| `reviews[].text` | string | `The BIODANCE Bio-Collagen Real Deep Mask is o…` |  |
| `reviews[].rating` | object | `{…}` | Star rating as an object with value and max. |
| `reviews[].author` | object | `{…}` |  |
| `reviews[].helpful_votes` | integer | `3` | Number of helpful votes on the review. |
| `reviews[].verified` | boolean | `true` | Whether Amazon marks the review as a verified purchase. |
| `reviews[].source` | string | `top_reviews_local` |  |
| `reviews[].position` | integer | `1` |  |
| `reviews[].variant` | string | `Scent: Collagen \| Size: 4 Count (Pack of 1)` |  |
| `reviews[].language` | string | `en` |  |
| `reviews[].original_language` | string | `en` |  |
| `reviews[].translated` | boolean | `false` |  |
| `reviews[].images` | null | `null` |  |
| `reviews[].responses` | null | `null` |  |
| `reviews[].published_at` | string | `2026-09-20T00:00:00.000Z` |  |
| `reviews[].product` | object | `{…}` |  |
| `reviews[].computed` | object | `{…}` | Labels derived from the review, such as sentiment. |
| `reviews[].scraped_at` | string | `2026-09-24T17:00:00.000Z` |  |

## Pagination

Single lookup: everything comes back in one call and `next_cursor` is always `null`.

## Errors

Failed calls are free. Branch on HTTP status; the message is in `error` (or `detail`). See https://docs.scrapier.io/errors.md

- **400** Bad input. The exact message varies by endpoint. `{"success":false,"error":"…"}`
- **402** Balance below the endpoint's price. `{"error":"Insufficient credits. Buy more to scrape more.","balance":1,"required":2}`
- **403** Invalid or unknown API key. `{"detail":"Authentication service unavailable or invalid API key."}`
- **429** Throttled — wait for Retry-After. `{"detail":"Request was throttled. Expected available in N seconds."}`
- **404** unknown slug · **503** busy (retry after `Retry-After`) · **5xx** upstream failure or timeout (retry with backoff).

## Notes

- Only the product page's Top reviews card is available logged out: up to 8 US reviews plus up to about 5 international ones. The full paginated list needs a sign-in and is not offered; the `warning` field states the cap.
- An unknown ASIN or a product with no reviews returns 404; a bad input returns 400.
- `asins` takes one ASIN or product URL per call.
- `rating` is an object with `value` and `max`.

## Related

- [Amazon Products](https://docs.scrapier.io/api-reference/amazon/amazon-product.md): Search Amazon by keyword or URL and get product listings, or send a product URL to get that single product.
- [Amazon Search](https://docs.scrapier.io/api-reference/amazon/amazon-search.md): Search Amazon by keyword and get product results with price, rating and position, with marketplace and sort order options.
- [Amazon Sellers](https://docs.scrapier.io/api-reference/amazon/amazon-seller-scraper.md): Find who sells the products for a search term, search URL, product URL or ASIN, with seller business name, phone, address and offers.
