---
title: "Get Amazon product reviews"
method: GET
path: "/v1/amazon/reviews"
tags: ["Amazon"]
---

# Get Amazon product reviews

`GET /v1/amazon/reviews`

## Request

- Base URL: `https://api.scrapeatlas.com`
- URL: `https://api.scrapeatlas.com/v1/amazon/reviews`
- Auth: API key in header `x-api-key`

Read the customer reviews embedded in the public product page (typically the top reviews, about eight). Each row carries id, title, text, stars, author, verified flag, helpful votes, images and the review date. Sibling variants can contribute reviews; entity_id is always the requested ASIN. Up to five equivalent mobile and desktop views are read to collect the embedded list; reviews_not_embedded marks a response whose page views carried none. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.

## Query parameters

- `asin` string, required
- `country` 'US' | 'GB' | 'CA' | 'DE' | 'FR' | 'IT' | 'ES' | 'JP' | 'IN' | 'MX' | 'BR' | 'AU' | 'NL'

## Response `200`

Inspect the response status and failure or coverage fields.

- union
  - object
    - `requestId` string, uuid, required
    - `accounting` object, required
      - `upstreamRequests` integer, required
      - `responseBytes` integer, required
      - `durationMs` number, required
    - `success` true, required
    - `status` 'success' | 'partial', required
    - `sourceUrl` string, uri, required
    - `fetchedAt` string, date-time, required
    - `coverage` object, required
      - `source` 'public_page', required
      - `complete` boolean, required
      - `warnings` string[], required
    - `items` object[], required
      - `review` object, required
        - `id` string, required
        - `entity_id` string, required
        - `url` string, uri, required
        - `title` string, nullable, required
        - `text` string, nullable, required
        - `rating` object, required
          - `value` number, nullable, required
          - `max` number, required
        - `author` object, required
          - `name` string, nullable, required
          - `avatar_url` string, nullable, required
          - `url` string, nullable, required
          - `location` string, nullable, required
          - `reviews_count` integer, nullable, required
        - `helpful_votes` integer, nullable, required
        - `verified` boolean, nullable, required
        - `source` string, nullable, required
        - `language` string, nullable, required
        - `original_language` string, nullable, required
        - `translated` boolean, nullable, required
        - `images` string[], nullable, required
        - `responses` object[], nullable, required
        - `published_at` string, nullable, required
    - `total` integer, nullable, required
    - `dropped` integer, required
    - `pagination` object, required
      - `next_cursor` string, nullable, required
      - `has_more` boolean, required
      - `page_size` integer, required
  - object
    - `requestId` string, uuid, required
    - `accounting` object, required
      - `upstreamRequests` integer, required
      - `responseBytes` integer, required
      - `durationMs` number, required
    - `success` false, required
    - `status` 'failed' | 'challenged', required
    - `failure` object, required
      - `code` 'invalid_request' | 'unauthorized' | 'not_found' | 'upstream_challenged' | 'upstream_rate_limited' | 'upstream_error' | 'unsupported_page' | 'response_too_large' | 'unsafe_redirect' | 'request_limit' | 'timeout' | 'busy' | 'payload_too_complex', required
      - `message` string, required

## Other responses

- `400`: Request could not complete; inspect error or failure.code.
- `401`: Request could not complete; inspect error or failure.code.
- `402`: Request could not complete; inspect error or failure.code.
- `403`: Request could not complete; inspect error or failure.code.
- `404`: Request could not complete; inspect error or failure.code.
- `408`: Request could not complete; inspect error or failure.code.
- `413`: Request could not complete; inspect error or failure.code.
- `429`: Request could not complete; inspect error or failure.code.
- `500`: Request could not complete; inspect error or failure.code.
- `502`: Request could not complete; inspect error or failure.code.
- `503`: Request could not complete; inspect error or failure.code.
- `504`: Request could not complete; inspect error or failure.code.

---

[API](https://skmtc.dev/scrapeatlas/apis/scrapeatlas-api.md) · [All operations](https://skmtc.dev/scrapeatlas/apis/scrapeatlas-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeatlas/apis/scrapeatlas-api/revisions/9ba049316894?raw)