Get Reviews

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

GET /v1/amazon/products/{asin}/reviews

Get Reviews

cURL

curl --request GET \
  --url https://scrapebadger.com/v1/amazon/products/{asin}/reviews \
  --header 'x-api-key: <api-key>'

200

{
  "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
  }
}

Path Parameters

asin · string · required

The ASIN of the product to fetch reviews for.

Query Parameters

domain · string · default: "com"

Amazon marketplace TLD or code where the product is listed.

Examples: com, co.uk, de

page · integer · default: 1

Page number for paginated reviews. Starts at 1.

sort_by · string · default: "helpful"

Sort order for reviews.

Value	Description
helpful	Most helpful first (default)
recent	Most recent first

star · 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)

verified_only · boolean · default: false

Only return reviews from verified purchases.

media_only · boolean · default: false

Only return reviews that include images or video.

Response

asin · string

The ASIN the reviews belong to.

domain · string

Marketplace domain.

rating · number

Overall average product rating.

ratings_total · integer

Total number of ratings for the product.

rating_breakdown · object

Percentage of ratings per star bucket (five_star … one_star).

reviews · array

Array of reviews.

Show Review object

id · string

Review ID.

title · string

Review title.

body · string

Full review text.

rating · integer

Star rating left by the reviewer (1-5).

date_raw · string

Raw date string as shown on Amazon.

date_at · string

ISO 8601 timestamp of the review.

review_country · string

Country the review was written in.

profile · object

Reviewer profile: name, link, id, image.

verified_purchase · boolean

Whether the review is from a verified purchase.

vine_program · boolean

Whether the review is part of the Vine program.

helpful_votes · integer

Number of helpful votes.

variant · string

Variant the review applies to (nullable).

images · array

Review image URLs.

pagination · object

Pagination metadata with current_page, total_pages, total_results.

Example Response

{
  "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": 100, "total_results": 1000 }
}

Each reviews request costs 10 credits. Amazon exposes a public featured subset of reviews; full review history is login-gated. Failed requests are not charged.

Authorizations

x-api-key · string · header · required

Path Parameters

asin · string · required

The ASIN of the product to fetch reviews for.

Query Parameters

domain · string · default: com

Amazon marketplace TLD or code (com, co.uk, de, ...).

page · integer · default: 1

Page number for paginated reviews.

Required range: x >= 1

sort_by · enum<string> · default: helpful

Sort order for reviews.

Available options: helpful, recent

star · enum<string>

Filter reviews by star rating or sentiment.

Available options: one_star, two_star, three_star, four_star, five_star, positive, critical

verified_only · boolean · default: false

Only return reviews from verified purchases.

media_only · boolean · default: false

Only return reviews that include images or video.

Response

200 - application/json

Product reviews

asin · string

domain · string

rating · number

Overall average product rating.

ratings_total · integer

Total number of ratings for the product.

rating_breakdown · object

Show child attributes

reviews · object[]

Show child attributes

pagination · object

Show child attributes