GET /api/amazon/product/reviews — Fetch Product Reviews

Retrieve customer reviews for any Amazon product, with full control over filtering and pagination. You can narrow results by star rating, limit to verified purchases only, or search for a keyword within review text. The response includes both Amazon’s hand-picked top reviews and a paginated list of all matching reviews — each with rating, body text, images, videos, and reviewer metadata.

Request

GET https://api.glade.dev/api/amazon/product/reviews

Query Parameters

string

default:"US"

The Amazon marketplace to query. Accepted values: US UK CA DE FR IT ES AU IN MX BR JP PL. Defaults to US when omitted.

string

The Amazon Standard Identification Number (e.g. B09XS7JWHH). Provide at least one of asin, url, or gtin.

string

A full Amazon product URL. Provide at least one of asin, url, or gtin.

string

A Global Trade Item Number (barcode). Provide at least one of asin, url, or gtin.

integer

default:"1"

Page number of reviews to return. Minimum value is 1.

boolean

When true, only reviews from verified purchasers are returned.

string

default:"ALL"

Filter reviews by star rating. Accepted values: ALL FIVE_STAR FOUR_STAR THREE_STAR TWO_STAR ONE_STAR.

string

Keyword to search for within review text. Returns only reviews that contain the search term.

Response

The response is nested under data.amazonProduct and contains two distinct review lists.

object

Hide amazonProduct fields

object[]

Amazon’s featured reviews for this product, independent of pagination. Each item shares the same shape as a paginated review.

Show review item fields

string

Unique identifier for the review.

string

Review headline.

string

Full review text.

string[]

Array of image URLs attached to the review.

object[]

Show video item

string

Thumbnail image URL for the video.

string

Direct URL to the video content.

number

Star rating given by the reviewer, 1–5.

integer

Number of customers who marked this review as helpful.

boolean

true if Amazon has verified the reviewer purchased the product.

object

Show reviewer fields

string

Reviewer’s Amazon profile ID.

string

Reviewer’s display name.

string

URL to the reviewer’s Amazon profile.

object

Show reviewsPaginated fields

object[]

Paginated list of reviews matching any applied filters. Each item has the same shape as a topReviews item.

object

Show pageInfo fields

integer

The page number returned.

integer

Total number of pages available.

integer

Total number of matching reviews.

boolean

true if a subsequent page exists.

boolean

true if a previous page exists.

Example Response

{
  "data": {
    "amazonProduct": {
      "topReviews": [
        {
          "id": "R2YX5V9KABC123",
          "title": "Best noise canceling headphones I've ever owned",
          "body": "I've gone through a lot of headphones over the years and these are absolutely the best. The noise canceling is leagues ahead of the previous generation — I tested them on a transatlantic flight and barely heard the engines. Battery life is stellar too.",
          "imageUrls": [
            "https://images-na.ssl-images-amazon.com/images/I/71example1.jpg"
          ],
          "videos": [],
          "rating": 5,
          "helpfulVotes": 312,
          "verifiedPurchase": true,
          "reviewer": {
            "id": "AHBGJXP4EXAMPLE",
            "name": "TravellingAudiophile",
            "url": "https://www.amazon.com/gp/profile/amzn1.account.AHBGJXP4EXAMPLE"
          }
        }
      ],
      "reviewsPaginated": {
        "reviews": [
          {
            "id": "R2YX5V9KABC123",
            "title": "Best noise canceling headphones I've ever owned",
            "body": "I've gone through a lot of headphones over the years and these are absolutely the best. The noise canceling is leagues ahead of the previous generation — I tested them on a transatlantic flight and barely heard the engines. Battery life is stellar too.",
            "imageUrls": [
              "https://images-na.ssl-images-amazon.com/images/I/71example1.jpg"
            ],
            "videos": [],
            "rating": 5,
            "helpfulVotes": 312,
            "verifiedPurchase": true,
            "reviewer": {
              "id": "AHBGJXP4EXAMPLE",
              "name": "TravellingAudiophile",
              "url": "https://www.amazon.com/gp/profile/amzn1.account.AHBGJXP4EXAMPLE"
            }
          },
          {
            "id": "R1MKNZ3DXYZ789",
            "title": "Great sound, slightly tight fit",
            "body": "Sound quality is excellent and the app integration works really well. My only gripe is they clamp a little firmly during long sessions. After a few weeks they've loosened up and it's no longer an issue. Would still recommend to anyone.",
            "imageUrls": [],
            "videos": [
              {
                "posterImageUrl": "https://images-na.ssl-images-amazon.com/images/I/71videoposter.jpg",
                "url": "https://www.amazon.com/vdp/B09XS7JWHH/ref=cm_cr_arp_d_rv_vid_1"
              }
            ],
            "rating": 4,
            "helpfulVotes": 87,
            "verifiedPurchase": true,
            "reviewer": {
              "id": "BKZQJRT9EXAMPLE",
              "name": "HeadphoneHobbyist",
              "url": "https://www.amazon.com/gp/profile/amzn1.account.BKZQJRT9EXAMPLE"
            }
          }
        ],
        "pageInfo": {
          "currentPage": 1,
          "totalPages": 922,
          "totalResults": 18423,
          "hasNextPage": true,
          "hasPrevPage": false
        }
      }
    }
  }
}

Error Handling

All errors follow a consistent envelope. The HTTP status code mirrors the code field inside the errors array.

Status	Meaning
`400`	Bad request — a required parameter is missing or malformed.
`401`	Unauthorized — your API key is missing or invalid.
`402`	Payment required — your plan limit has been reached.
`429`	Too many requests — you have exceeded the rate limit for your plan.
`502`	Bad gateway — Amazon returned an unexpected response; retry with exponential back-off.

{
  "success": false,
  "errors": [
    {
      "code": 400,
      "message": "Missing required parameter: asin, url, or gtin must be provided"
    }
  ]
}

curl Example

curl --request GET \
  --url 'https://api.glade.dev/api/amazon/product/reviews?asin=B09XS7JWHH&domain=US&rating=FIVE_STAR&onlyVerifiedReviews=true&page=1' \
  --header 'API-KEY: YOUR_API_KEY'

Products

Search & Discovery

Sellers & Categories

GET /api/amazon/product/reviews — Fetch Product Reviews

Request

Query Parameters

Response

Example Response

Error Handling

curl Example

​Request

​Query Parameters

​Response

​Example Response

​Error Handling

​curl Example

Request

Query Parameters

Response

Example Response

Error Handling

curl Example