> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Reviews

> Customer reviews for an ASIN (featured + paginated, with filters).

## Path Parameters

<ParamField path="asin" type="string" required>
  The ASIN of the product to fetch reviews for.
</ParamField>

## Query Parameters

<ParamField query="domain" type="string" default="com">
  Amazon marketplace TLD or code where the product is listed.

  Examples: `com`, `co.uk`, `de`
</ParamField>

<ParamField query="page" type="integer" default={1}>
  Page number for paginated reviews. Starts at `1` and is capped at `20`.

  Amazon exposes roughly 10 reviews per page, so this endpoint returns at most **\~200 reviews per product** (20 pages). Requesting a `page` beyond `20` returns no additional reviews.
</ParamField>

<ParamField query="sort_by" type="string" default="helpful">
  Sort order for reviews.

  | Value     | Description                  |
  | --------- | ---------------------------- |
  | `helpful` | Most helpful first (default) |
  | `recent`  | Most recent first            |
</ParamField>

<ParamField query="star" type="string">
  Filter reviews by star rating or sentiment.

  | Value                      | Description                         |
  | -------------------------- | ----------------------------------- |
  | `one_star` ... `five_star` | Reviews with that exact star rating |
  | `positive`                 | Positive reviews (4-5 stars)        |
  | `critical`                 | Critical reviews (1-3 stars)        |
</ParamField>

<ParamField query="verified_only" type="boolean" default={false}>
  Only return reviews from verified purchases.
</ParamField>

<ParamField query="media_only" type="boolean" default={false}>
  Only return reviews that include images or video.
</ParamField>

## Response

<ResponseField name="asin" type="string">The ASIN the reviews belong to.</ResponseField>
<ResponseField name="domain" type="string">Marketplace domain.</ResponseField>
<ResponseField name="rating" type="number">Overall average product rating.</ResponseField>
<ResponseField name="ratings_total" type="integer">Total number of ratings for the product.</ResponseField>
<ResponseField name="rating_breakdown" type="object">Percentage of ratings per star bucket (`five_star` ... `one_star`).</ResponseField>

<ResponseField name="reviews" type="array">
  Array of reviews.

  <Expandable title="Review object">
    <ResponseField name="id" type="string">Review ID.</ResponseField>
    <ResponseField name="title" type="string">Review title.</ResponseField>
    <ResponseField name="body" type="string">Full review text.</ResponseField>
    <ResponseField name="rating" type="integer">Star rating left by the reviewer (1-5).</ResponseField>
    <ResponseField name="date_raw" type="string">Raw date string as shown on Amazon.</ResponseField>
    <ResponseField name="date_at" type="string">ISO 8601 timestamp of the review.</ResponseField>
    <ResponseField name="review_country" type="string">Country the review was written in.</ResponseField>
    <ResponseField name="profile" type="object">Reviewer profile: `name`, `link`, `id`, `image`.</ResponseField>
    <ResponseField name="verified_purchase" type="boolean">Whether the review is from a verified purchase.</ResponseField>
    <ResponseField name="vine_program" type="boolean">Whether the review is part of the Vine program.</ResponseField>
    <ResponseField name="helpful_votes" type="integer">Number of helpful votes.</ResponseField>
    <ResponseField name="variant" type="string">Variant the review applies to (nullable).</ResponseField>
    <ResponseField name="images" type="array">Review image URLs.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  Pagination metadata with `current_page`, `total_pages`, `total_results`.
</ResponseField>

### Example Response

```json theme={null}
{
  "asin": "B08N5WRWNW",
  "domain": "com",
  "rating": 4.7,
  "ratings_total": 184231,
  "rating_breakdown": { "five_star": 78, "four_star": 13, "three_star": 4, "two_star": 2, "one_star": 3 },
  "reviews": [
    {
      "id": "R1ABCDEF123456",
      "title": "Great little speaker",
      "body": "Sound quality is excellent for the size. Setup was quick and Alexa is responsive.",
      "rating": 5,
      "date_raw": "Reviewed in the United States on May 28, 2026",
      "date_at": "2026-05-28T00:00:00Z",
      "review_country": "United States",
      "profile": { "name": "Jane D.", "link": "https://www.amazon.com/gp/profile/amzn1.account.ABC", "id": "amzn1.account.ABC", "image": "https://m.media-amazon.com/images/S/amazon-avatars/abc.png" },
      "verified_purchase": true,
      "vine_program": false,
      "helpful_votes": 42,
      "variant": "Color: Charcoal",
      "images": ["https://m.media-amazon.com/images/I/71review1.jpg"]
    }
  ],
  "pagination": { "current_page": 1, "total_pages": 20, "total_results": 200 }
}
```

<Note>
  Each reviews request costs **10 credits**. Amazon exposes a public *featured* subset of reviews; full review history is login-gated. The `page` parameter is capped at **20** (\~200 reviews per product) — there is no way to page deeper. Failed requests are not charged.
</Note>


## OpenAPI

````yaml GET /v1/amazon/products/{asin}/reviews
openapi: 3.1.0
info:
  title: ScrapeBadger Amazon API
  version: 1.0.0
  description: >-
    Amazon marketplace scraping API for searching products, fetching product
    details, offers, reviews, listings, sellers, and reference data across 20
    marketplaces.
servers:
  - url: https://scrapebadger.com
    description: Production
security:
  - apiKeyAuth: []
paths:
  /v1/amazon/products/{asin}/reviews:
    get:
      tags:
        - Amazon Products
      summary: Get Reviews
      description: Customer reviews for an ASIN (featured + paginated, with filters).
      operationId: getAmazonReviews
      parameters:
        - name: asin
          in: path
          required: true
          schema:
            type: string
          description: The ASIN of the product to fetch reviews for.
        - name: domain
          in: query
          schema:
            type: string
            default: com
          description: Amazon marketplace TLD or code (com, co.uk, de, ...).
        - name: page
          in: query
          schema:
            type: integer
            default: 1
            minimum: 1
          description: Page number for paginated reviews.
        - name: sort_by
          in: query
          schema:
            type: string
            default: helpful
            enum:
              - helpful
              - recent
          description: Sort order for reviews.
        - name: star
          in: query
          schema:
            type: string
            enum:
              - one_star
              - two_star
              - three_star
              - four_star
              - five_star
              - positive
              - critical
          description: Filter reviews by star rating or sentiment.
        - name: verified_only
          in: query
          schema:
            type: boolean
            default: false
          description: Only return reviews from verified purchases.
        - name: media_only
          in: query
          schema:
            type: boolean
            default: false
          description: Only return reviews that include images or video.
      responses:
        '200':
          description: Product reviews
          content:
            application/json:
              schema:
                type: object
                properties:
                  asin:
                    type: string
                  domain:
                    type: string
                  rating:
                    type: number
                    description: Overall average product rating.
                  ratings_total:
                    type: integer
                    description: Total number of ratings for the product.
                  rating_breakdown:
                    type: object
                    properties:
                      five_star:
                        type: integer
                      four_star:
                        type: integer
                      three_star:
                        type: integer
                      two_star:
                        type: integer
                      one_star:
                        type: integer
                  reviews:
                    type: array
                    items:
                      $ref: '#/components/schemas/Review'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
              example:
                asin: B08N5WRWNW
                domain: com
                rating: 4.7
                ratings_total: 184231
                rating_breakdown:
                  five_star: 78
                  four_star: 13
                  three_star: 4
                  two_star: 2
                  one_star: 3
                reviews:
                  - id: R1ABCDEF123456
                    title: Great little speaker
                    body: >-
                      Sound quality is excellent for the size. Setup was quick
                      and Alexa is responsive.
                    rating: 5
                    date_raw: Reviewed in the United States on May 28, 2026
                    date_utc: 1780012800
                    date_at: '2026-05-28T00:00:00Z'
                    review_country: United States
                    is_global_review: false
                    profile:
                      name: Jane D.
                      link: https://www.amazon.com/gp/profile/amzn1.account.ABC
                      id: amzn1.account.ABC
                      image: >-
                        https://m.media-amazon.com/images/S/amazon-avatars/abc.png
                    verified_purchase: true
                    vine_program: false
                    helpful_votes: 42
                    variant: 'Color: Charcoal'
                    images:
                      - https://m.media-amazon.com/images/I/71review1.jpg
                pagination:
                  current_page: 1
                  total_pages: 100
                  total_results: 1000
components:
  schemas:
    Review:
      type: object
      properties:
        id:
          type: string
        title:
          type: string
        body:
          type: string
        rating:
          type: integer
          description: Star rating left by the reviewer (1-5).
        date_raw:
          type: string
          nullable: true
        date_utc:
          type: number
          nullable: true
        date_at:
          type: string
          nullable: true
        review_country:
          type: string
          nullable: true
        is_global_review:
          type: boolean
        profile:
          type: object
          description: 'Reviewer profile: name, link, id, image.'
        verified_purchase:
          type: boolean
        vine_program:
          type: boolean
        helpful_votes:
          type: integer
          nullable: true
        variant:
          type: string
          nullable: true
        images:
          type: array
          items:
            type: string
    Pagination:
      type: object
      properties:
        current_page:
          type: integer
          description: Current page number.
        total_pages:
          type: integer
          description: Total number of pages available.
        total_results:
          type: integer
          description: Total number of results across all pages.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````