Amazon Reviews API

Read customer review text for any ASIN: title, body, stars, verified purchase, images, videos, and helpful votes. Start with the top reviews, or page through the list Amazon exposes.

100 free requests/month, then $0.01/request. Premium $99/mo for 20K.

Why Use This API?

Everything you need to integrate Amazon data into your application

Top reviews, no extra header

GET /api/amazon/product/top-reviews returns the most helpful reviews shown on the product page. Most marketplaces need only your API key; the US domain also needs an AMAZON_COOKIE header.

Filter the full list

The paginated reviews endpoint filters by star rating, verified purchase, or a search string. Amazon typically exposes up to 500 reviews, about 10 per page.

Text, media, and votes

Each review includes body text, helpfulVotes, imageUrls, and videos with a poster image and source URL when the reviewer attached them.

Current feedback

Reviews are read from Amazon at request time, so new posts and helpful-vote counts are the ones on the listing now.

Try It Out

See how easy it is to fetch Amazon data with our API

bash
curl -G "https://rest.canopyapi.co/api/amazon/product/top-reviews" \
  -H "API-KEY: YOUR_API_KEY" \
  -H "AMAZON_COOKIE: YOUR_AMAZON_COOKIE" \
  --data-urlencode "asin=B08N5WRWNW" \
  --data-urlencode "domain=US"
Response
{
  "data": {
    "amazonProduct": {
      "topReviews": [
        {
          "id": "R1EXAMPLE00001",
          "title": "Example review title",
          "body": "Example review body. Live text comes from the listing.",
          "rating": 5,
          "helpfulVotes": 12,
          "verifiedPurchase": true,
          "imageUrls": [],
          "videos": [],
          "reviewer": {
            "id": "EXAMPLE",
            "name": "Example shopper",
            "url": "https://www.amazon.com/gp/profile/example"
          }
        }
      ]
    }
  }
}

What Can You Build?

Here are some popular use cases for this API

1

Read the top reviews before you summarize a listing

2

Filter to one-star and two-star reviews when you study complaints

3

Search review text for a feature name such as battery or size

Understanding the Response

Key fields returned by the API

id, title, body

Review id, headline, and plain-text body. body does not include HTML.

rating, verifiedPurchase, helpfulVotes

Star rating from 1 to 5, whether Amazon marked it a verified purchase, and how many shoppers marked it helpful.

imageUrls, videos

Image URLs the reviewer attached. videos includes posterImageUrl and the video url when a clip is attached.

reviewer

The reviewer id, display name, and profile URL when Amazon includes them. This is not a separate seller profile.

rating, ratingsTotal, reviewsTotal

On the product itself: average stars, total ratings (with or without text), and total written reviews. Ask for these on amazonProduct alongside topReviews.

reviewsPaginated.pageInfo

On the paginated endpoint: currentPage, totalPages, hasNextPage, hasPrevPage, and totalResults when Amazon provides it. A page usually holds about 10 reviews.

Top reviews and the paginated Amazon reviews API

Two REST routes share this data. GET /api/amazon/product/top-reviews returns the most helpful reviews from the product page. Pass asin, url, or gtin, plus an optional domain. Most marketplaces need only the API-KEY header. Amazon.com no longer shows reviews to signed-out visitors, so the US domain (the default) also needs an AMAZON_COOKIE header from a signed-in Amazon.com session.

The full list is GET /api/amazon/product/reviews. Amazon requires a signed-in session to view that list, so this route also needs an AMAZON_COOKIE header: the Cookie value from a signed-in Amazon page on the same marketplace. GraphQL reviewsPaginated has the same requirement. Without the cookie, the call fails with a clear error instead of an empty list.

Optional filters on the paginated route: page, onlyVerifiedReviews, search, and rating. rating is one of ALL, FIVE_STAR, FOUR_STAR, THREE_STAR, TWO_STAR, ONE_STAR, ALL_POSITIVE, or ALL_CRITICAL. Amazon typically stops the public list at 500 reviews.

What the review payload is for

Sentiment and QA work needs body, not just the average. verifiedPurchase and helpfulVotes tell you which rows shoppers marked as a real purchase and which ones other shoppers found useful. Media fields are there when you want the photos attached to a complaint.

The star average and rating counts also come back on the product. For title, price, and images of the same ASIN, use the Amazon product API. To check rating patterns on a single ASIN in the browser, try the review checker free.

Pricing

100 free requests a month, then $0.01 per request with automatic volume discounts. A page of reviews counts as its own request. Sign in for a key. Field details are in the docs.

Frequently Asked Questions

What does the Amazon reviews API return?

Each review includes id, title, plain-text body, rating, helpfulVotes, verifiedPurchase, imageUrls, videos (posterImageUrl and url), and reviewer id, name, and url when Amazon provides them. The product also exposes rating, ratingsTotal, and reviewsTotal.

Do I need an Amazon cookie?

For top reviews, only on the US domain. GET /api/amazon/product/top-reviews works with just your API key on every other marketplace, and needs an AMAZON_COOKIE header from a signed-in Amazon.com session for US products. The paginated list, GET /api/amazon/product/reviews and the reviewsPaginated GraphQL field, requires an AMAZON_COOKIE header from a signed-in Amazon session on the same marketplace.

How many reviews can I fetch?

Amazon typically exposes at most 500 reviews for a product. Paginated pages usually contain about 10 reviews. Top reviews are the shorter most-helpful set from the product page, with no page parameter.

How do I filter by stars, verified purchase, or keyword?

On the paginated endpoint, set rating to FIVE_STAR, FOUR_STAR, THREE_STAR, TWO_STAR, ONE_STAR, ALL_POSITIVE, ALL_CRITICAL, or ALL. Set onlyVerifiedReviews to true for verified purchases. Set search to keep reviews whose text matches a term.

Which marketplaces are supported?

The same domains as the rest of the API: US, UK, DE, FR, IT, ES, CA, MX, BR, IN, JP, AU, AE, NL, PL, SE, and SG. Reviews are marketplace-specific, so query each domain you care about.

Is the Amazon reviews API free?

You can start free. Each account includes 100 requests a month, then $0.01 per request with automatic volume discounts. One page of reviews counts as one request.

Ready to Get Started?

Start building with our Amazon API today. Get 100 free requests every month.