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

# Product Reviews

> Retrieve paginated customer reviews for a product by ASIN. Sort by top reviews or most recent. Supports filtering by star rating and verified purchase status.

<div className="inline-flex items-center gap-2 px-4 py-2 bg-yellow-50 dark:bg-yellow-900/20 border border-yellow-200 dark:border-yellow-800 rounded-lg">
  <span className="text-base">🪙</span>
  <span className="text-sm font-medium text-yellow-900 dark:text-yellow-100"><span className="font-semibold">3 credits</span><span className="text-yellow-700 dark:text-yellow-300 ml-1">per request</span></span>
</div>

## Copy for AI

<div className="my-6 rounded-xl border border-gray-200 bg-gray-50 p-5 dark:border-gray-800 dark:bg-gray-900/40">
  <div className="min-w-0">
    <p className="text-base font-semibold text-gray-900 dark:text-gray-100">🤖 Why Code When AI Can Do It For You?</p>
    <p className="mt-1 text-sm text-gray-700 dark:text-gray-300">Stop writing code like it's 1970! Let AI do the heavy lifting - click the sparkles to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.</p>
  </div>

  <div className="mt-4">
    <button
      type="button"
      className="inline-flex items-center gap-2 rounded-md border border-emerald-300 bg-emerald-50 px-3 py-2 text-sm font-medium text-emerald-800 hover:bg-emerald-100 dark:border-emerald-700 dark:bg-emerald-900/30 dark:text-emerald-100 dark:hover:bg-emerald-900/50"
      onClick={() => navigator.clipboard.writeText(`I want to make an API call to https://api.keyapi.ai/v1/amazon/product-reviews.

Please help me write code to make this API call and handle the response appropriately. Include error handling and best practices.

Here are the details:

Endpoint: GET https://api.keyapi.ai/v1/amazon/product-reviews

Description: Product Reviews

Required Headers:
--header 'Authorization: Bearer <YOUR_API_KEY>'

Parameters:
- asin (Required): Product asin for which to get reviews.. Example: B00939I7EK
- cookie (Optional): A logged-in user cookie to use for fetching product reviews. Include the following cookies for country=US: session-id, ubid-main, x-main, and at-main. For any other country: session-id, ubid-acb{country code}, x-acb{country code}, at-acb{country code}
- country (Optional): Sets the Amazon domain, marketplace country, language and currency.
Allowed values: US, AU, BR, CA, CN, FR, DE, IN, IT, MX, NL, SG, ES, TR, AE, GB, JP, SA, PL, SE, BE, EG, ZA, IE. Example: us
- page (Optional): Results page to return.. Example: 1
- sort_by (Optional): Return reviews in a specific sort order.
Allowed values: TOP_REVIEWS, MOST_RECENT. Example: TOP_REVIEWS
- star_rating (Optional): Only return reviews with a specific star rating.
Allowed values: ALL, 5_STARS, 4_STARS, 3_STARS, 2_STARS, 1_STARS, POSITIVE, CRITICAL. Example: ALL
- verified_purchases_only (Optional): Only return reviews by reviewers who made a verified purchase.. Example: false
- images_or_videos_only (Optional): Only return reviews containing images and / or videos.. Example: false
- current_format_only (Optional): Only return reviews of the current format (product variant - e.g. Color). By default reviews are returned for all product variants.. Example: false
- query (Optional): Find reviews matching a search query.
- fields (Optional): A comma separated list of review fields to include in the response (field projection). By default all fields are returned.

Example: review_title,review_images,review_date,country
- language (Optional): The language of the results. In case not specified, results will be returned in the default domain language.
Supported languages per country:
US: en_US, es_US
AU: en_AU
BR: pt_BR
CA: en_CA, fr_CA
FR: fr_FR, en_GB
DE: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK
IN: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN
IT: it_IT, en_GB
MX: es_MX
NL: nl_NL, en_GB
SG: en_SG
ES: es_ES, pt_PT, en_GB
TR: tr_TR
AE: en_AE, ar_AE
GB: en_GB
JP: ja_JP, en_US, zh_CN
SA: ar_AE, en_AE
PL: pl_PL
SE: sv_SE, en_GB
BE: fr_BE, nl_BE, en_GB
EG: ar_AE, en_AE
ZA: en_ZA
IE: en_IE

Example Response:
{
"code": 0,
"message": "success",
"data": {},
"requestId": "2ee08896-8b4b-4db3-916c-703176ed9206"
}`)}
    >
      <span>✨</span>
      <span>Copy for AI</span>
    </button>
  </div>
</div>


## OpenAPI

````yaml en/amazon.openapi.json GET /v1/amazon/product-reviews
openapi: 3.0.1
info:
  title: Amazon API english documentation
  description: >-
    The english reference documentation of the Amazon API includes the
    interface's purpose, parameter description, response status, and sample
    structure.
  version: 1.0.0
servers:
  - url: https://api.keyapi.ai
    description: Production
security: []
tags: []
paths:
  /v1/amazon/product-reviews:
    get:
      tags: []
      summary: Product Reviews
      description: >-
        Retrieve paginated customer reviews for a product by ASIN. Sort by top
        reviews or most recent. Supports filtering by star rating and verified
        purchase status.
      parameters:
        - name: asin
          in: query
          description: Product asin for which to get reviews.
          required: true
          example: B00939I7EK
          schema:
            type: string
            example: B00939I7EK
        - name: cookie
          in: query
          description: >-
            A logged-in user cookie to use for fetching product reviews. Include
            the following cookies for country=US: session-id, ubid-main, x-main,
            and at-main. For any other country: session-id, ubid-acb{country
            code}, x-acb{country code}, at-acb{country code}
          required: false
          example: ''
          schema:
            type: string
        - name: country
          in: query
          description: >-
            Sets the Amazon domain, marketplace country, language and currency.

            Allowed values: US, AU, BR, CA, CN, FR, DE, IN, IT, MX, NL, SG, ES,
            TR, AE, GB, JP, SA, PL, SE, BE, EG, ZA, IE
          required: false
          example: us
          schema:
            type: string
            default: us
        - name: cursor
          in: query
          description: 'A cursor used to retrieve the next set of results for pagination. '
          required: false
          schema:
            type: string
        - name: sort_by
          in: query
          description: |-
            Return reviews in a specific sort order.
            Allowed values: TOP_REVIEWS, MOST_RECENT
          required: false
          example: TOP_REVIEWS
          schema:
            type: string
            default: TOP_REVIEWS
        - name: star_rating
          in: query
          description: >-
            Only return reviews with a specific star rating.

            Allowed values: ALL, 5_STARS, 4_STARS, 3_STARS, 2_STARS, 1_STARS,
            POSITIVE, CRITICAL
          required: false
          example: ALL
          schema:
            type: string
            default: ALL
        - name: verified_purchases_only
          in: query
          description: Only return reviews by reviewers who made a verified purchase.
          required: false
          example: 'false'
          schema:
            type: boolean
            default: false
        - name: images_or_videos_only
          in: query
          description: Only return reviews containing images and / or videos.
          required: false
          example: 'false'
          schema:
            type: boolean
        - name: current_format_only
          in: query
          description: >-
            Only return reviews of the current format (product variant - e.g.
            Color). By default reviews are returned for all product variants.
          required: false
          example: 'false'
          schema:
            type: boolean
        - name: query
          in: query
          description: Find reviews matching a search query.
          required: false
          schema:
            type: string
        - name: fields
          in: query
          description: >-
            A comma separated list of review fields to include in the response
            (field projection). By default all fields are returned.


            Example: review_title,review_images,review_date,country
          required: false
          schema:
            type: string
        - name: language
          in: query
          description: >-
            The language of the results. In case not specified, results will be
            returned in the default domain language.

            Supported languages per country:

            US: en_US, es_US

            AU: en_AU

            BR: pt_BR

            CA: en_CA, fr_CA

            FR: fr_FR, en_GB

            DE: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK

            IN: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN

            IT: it_IT, en_GB

            MX: es_MX

            NL: nl_NL, en_GB

            SG: en_SG

            ES: es_ES, pt_PT, en_GB

            TR: tr_TR

            AE: en_AE, ar_AE

            GB: en_GB

            JP: ja_JP, en_US, zh_CN

            SA: ar_AE, en_AE

            PL: pl_PL

            SE: sv_SE, en_GB

            BE: fr_BE, nl_BE, en_GB

            EG: ar_AE, en_AE

            ZA: en_ZA

            IE: en_IE
          required: false
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
              example:
                code: 0
                message: success
                data:
                  asin: B00939I7EK
                  country: US
                  domain: www.amazon.com
                  total_ratings: 92131
                  rating_distribution:
                    '1': 3
                    '2': 2
                    '3': 3
                    '4': 8
                    '5': 84
                  reviews:
                    - review_id: R3HIEYXVQFRUBV
                      review_title: Powerful, Versatile & Worth Every Penny!
                      review_comment: >-
                        I absolutely love this Ninja Kitchen System! It’s very
                        powerful and blends everything smoothly in seconds. I
                        use it for smoothies, sauces, chopping vegetables, and
                        even making dough — and it handles everything perfectly.
                        The 8-cup food processor bowl is a great size for family
                        meals. It’s easy to clean, sturdy, and feels high
                        quality. The blades are super sharp, so be careful when
                        washing. Definitely a great investment for any kitchen.
                        Highly recommend!
                      review_star_rating: '5'
                      review_link: >-
                        https://www.amazon.com/gp/customer-reviews/R3HIEYXVQFRUBV
                      review_author_id: AGIYMLDXELN6NGPUDUKSQIM5V4ZQ
                      review_author: Samira
                      review_author_url: >-
                        https://www.amazon.com/gp/profile/amzn1.account.AGIYMLDXELN6NGPUDUKSQIM5V4ZQ
                      review_author_avatar: >-
                        https://m.media-amazon.com/images/S/amazon-avatars-global/c865adad-9554-4118-bb2c-f8f700c91346._CR0%2C26%2C281%2C281_UX460_.jpg
                      review_images: []
                      review_video: null
                      review_date: Reviewed in the United States on February 27, 2026
                      is_verified_purchase: true
                      helpful_vote_statement: 4 people found this helpful
                      reviewed_product_asin: B00939I7EK
                      reviewed_product_variant:
                        Style: Pitcher + Bowl + (2) 16-oz. Cups
                      is_vine: false
                    - review_id: RYDWBH5RPKGBH
                      review_title: Powerful and versatile — love it!
                      review_comment: >-
                        The Ninja Kitchen System has been an amazing addition to
                        my kitchen. The 72 oz. blender is incredibly powerful
                        and handles smoothies, frozen fruit, and even ice with
                        no problem at all. The 8-cup food processor bowl is also
                        fantastic, it chops and mixes evenly, making meal prep
                        so much faster and easier. I love how versatile it is.
                        Having the blender, food processor, and individual cups
                        all in one system saves space and does everything I
                        need. The only small downside is that when using the
                        individual cups, it’s pretty loud. It’s not a deal
                        breaker for me because it works so well, but just
                        something to be aware of. Overall, it’s a strong,
                        reliable machine that delivers great results.
                      review_star_rating: '5'
                      review_link: https://www.amazon.com/gp/customer-reviews/RYDWBH5RPKGBH
                      review_author_id: AH2I2FNZLBC2YZGU76HSULW6E2FQ
                      review_author: Poenix33
                      review_author_url: >-
                        https://www.amazon.com/gp/profile/amzn1.account.AH2I2FNZLBC2YZGU76HSULW6E2FQ
                      review_author_avatar: >-
                        https://m.media-amazon.com/images/S/amazon-avatars-global/default.png
                      review_images: []
                      review_video: null
                      review_date: Reviewed in the United States on February 24, 2026
                      is_verified_purchase: true
                      helpful_vote_statement: 5 people found this helpful
                      reviewed_product_asin: B00939I7EK
                      reviewed_product_variant:
                        Style: Pitcher + Bowl + (2) 16-oz. Cups
                      is_vine: false
                    - review_id: R1TARV7OKJ78VA
                      review_title: 100% would recommend
                      review_comment: >-
                        Such a good blender. Smoothie cups are a go-to in our
                        house. The dough "blade" for the food processor is
                        clutch for so many things. Used it multiple times to
                        shred meat - works like a charm. No leaks. Kinda loud,
                        but what blender isn't tbf
                      review_star_rating: '5'
                      review_link: >-
                        https://www.amazon.com/gp/customer-reviews/R1TARV7OKJ78VA
                      review_author_id: AFN5SGRGQDE6PNQLZTLOE7ZVUCEA
                      review_author: John Q Reviewer
                      review_author_url: >-
                        https://www.amazon.com/gp/profile/amzn1.account.AFN5SGRGQDE6PNQLZTLOE7ZVUCEA
                      review_author_avatar: >-
                        https://m.media-amazon.com/images/S/amazon-avatars-global/default.png
                      review_images: []
                      review_video: null
                      review_date: Reviewed in the United States on February 19, 2026
                      is_verified_purchase: true
                      helpful_vote_statement: 6 people found this helpful
                      reviewed_product_asin: B00939I7EK
                      reviewed_product_variant:
                        Style: Pitcher + Bowl + (2) 18-oz. Cups
                      is_vine: false
                    - review_id: R1US3JR30EI3OL
                      review_title: Does It All – Smoothies to Chopping
                      review_comment: >-
                        We love this blender and food processor. It’s great for
                        smoothies, chopping veggies, and even baking prep like
                        carrot cake. The motor is powerful, and it does a really
                        good job with chopping and blending without leaving
                        chunks behind. Having the food processor and blender in
                        one system saves counter space and actually gets used
                        regularly in our kitchen. Very happy with this purchase.
                      review_star_rating: '5'
                      review_link: >-
                        https://www.amazon.com/gp/customer-reviews/R1US3JR30EI3OL
                      review_author_id: AGJOJ5AS7NJ5BEYUXLBYD7K4NAJA
                      review_author: Amazon Customer
                      review_author_url: >-
                        https://www.amazon.com/gp/profile/amzn1.account.AGJOJ5AS7NJ5BEYUXLBYD7K4NAJA
                      review_author_avatar: >-
                        https://m.media-amazon.com/images/S/amazon-avatars-global/default.png
                      review_images: []
                      review_video: null
                      review_date: Reviewed in the United States on February 17, 2026
                      is_verified_purchase: true
                      helpful_vote_statement: 4 people found this helpful
                      reviewed_product_asin: B00939I7EK
                      reviewed_product_variant:
                        Style: Pitcher + Bowl + (2) 16-oz. Cups
                      is_vine: false
                    - review_id: R36FNMX5YZ44Z8
                      review_title: Great product
                      review_comment: Powerful motor for the price! Easy to use and clean.
                      review_star_rating: '5'
                      review_link: >-
                        https://www.amazon.com/gp/customer-reviews/R36FNMX5YZ44Z8
                      review_author_id: AEKM24EXRYTVGSX7ZWL4TGCEQVRQ
                      review_author: Dkss
                      review_author_url: >-
                        https://www.amazon.com/gp/profile/amzn1.account.AEKM24EXRYTVGSX7ZWL4TGCEQVRQ
                      review_author_avatar: >-
                        https://m.media-amazon.com/images/S/amazon-avatars-global/f26105c2-d50d-44c0-b386-946325b779e7._CR40%2C0%2C240%2C240_UX460_.jpg
                      review_images: []
                      review_video: null
                      review_date: Reviewed in the United States on March 9, 2026
                      is_verified_purchase: true
                      helpful_vote_statement: One person found this helpful
                      reviewed_product_asin: B00939I7EK
                      reviewed_product_variant:
                        Style: Pitcher + Bowl + (2) 16-oz. Cups
                      is_vine: false
                    - review_id: REULXRRQQ7CRE
                      review_title: Blender is better than my Vitamix!
                      review_comment: >-
                        Maturity is being able to admit that the Ninja blender
                        works way better than the Vitamix. I bought a Vitamix a
                        few years ago, but my roommate at the time had a Ninja
                        also, and I remember the Ninja working really well. So I
                        bought myself a Ninja, and I’m LOVING it! No more
                        “bumping the bubble” (what we called it when I worked at
                        Jamba Juice a million years ago) because the blades that
                        run all the way up the cup seem to really prevent that
                        phenomenon. I also love that the blade is removable so I
                        can clean everything really well. So far I’ve only used
                        the large blender, not the individual cups or the food
                        processor. I will say that I already have a Ninja food
                        processor that I love, and (sadly) the separate
                        processor has/does more than this one. Had I realized
                        that, I probably would have bought just the blender
                        since I’m hesitant to replace the bigger/better
                        processor with this one simply for the sake of saving
                        space. Nevertheless, this entire system was less than my
                        single Vitamix AND it works better for me, so overall
                        I’m extremely happy with this purchase. Removed one star
                        for the lack of attachments/limited usability of the
                        processor.
                      review_star_rating: '4'
                      review_link: https://www.amazon.com/gp/customer-reviews/REULXRRQQ7CRE
                      review_author_id: AFFWRT7DUS5JV6NXHGQQD3FNRNZQ
                      review_author: LESLIE H.
                      review_author_url: >-
                        https://www.amazon.com/gp/profile/amzn1.account.AFFWRT7DUS5JV6NXHGQQD3FNRNZQ
                      review_author_avatar: >-
                        https://m.media-amazon.com/images/S/amazon-avatars-global/default.png
                      review_images: []
                      review_video: null
                      review_date: Reviewed in the United States on February 26, 2026
                      is_verified_purchase: true
                      helpful_vote_statement: 4 people found this helpful
                      reviewed_product_asin: B00939I7EK
                      reviewed_product_variant:
                        Style: Pitcher + Bowl + (2) 16-oz. Cups
                      is_vine: false
                    - review_id: R3T92Y0PZK4V8P
                      review_title: Best blender on the market
                      review_comment: >-
                        I’ve had this blender for four years and I purchased it
                        as a gift for my cousins. It works great, you can blend
                        up ice frozen fruit. I never have any issues.
                      review_star_rating: '5'
                      review_link: >-
                        https://www.amazon.com/gp/customer-reviews/R3T92Y0PZK4V8P
                      review_author_id: AGDX72QEIW7BL752L4PVAOSGA4HQ
                      review_author: Grace Gentile
                      review_author_url: >-
                        https://www.amazon.com/gp/profile/amzn1.account.AGDX72QEIW7BL752L4PVAOSGA4HQ
                      review_author_avatar: >-
                        https://m.media-amazon.com/images/S/amazon-avatars-global/default.png
                      review_images: []
                      review_video: null
                      review_date: Reviewed in the United States on February 16, 2026
                      is_verified_purchase: true
                      reviewed_product_asin: B00939I7EK
                      reviewed_product_variant:
                        Style: Pitcher + (2) 16 oz. Cups
                      is_vine: false
                    - review_id: R3DAYDJ9WRDQ72
                      review_title: >-
                        Best system or maybe im biased because Ninja makes the
                        BEST!
                      review_comment: >-
                        I specifically buy ninja products because of their
                        sturdiness, they are so durable! This is a whole system,
                        so it's very versatile. No, issues with cleaning,
                        completely dishwasher safe. There is no assembly
                        required, unbox, wash and use!!! I bought it for my
                        husband because we make a lot of smoothies and this goes
                        through frozen fruit the best!!!
                      review_star_rating: '5'
                      review_link: >-
                        https://www.amazon.com/gp/customer-reviews/R3DAYDJ9WRDQ72
                      review_author_id: AH6KJOM4SLY5G2HB5G67FP454SNA
                      review_author: Alisia L.
                      review_author_url: >-
                        https://www.amazon.com/gp/profile/amzn1.account.AH6KJOM4SLY5G2HB5G67FP454SNA
                      review_author_avatar: >-
                        https://m.media-amazon.com/images/S/amazon-avatars-global/default.png
                      review_images: []
                      review_video: null
                      review_date: Reviewed in the United States on February 11, 2026
                      is_verified_purchase: true
                      helpful_vote_statement: 3 people found this helpful
                      reviewed_product_asin: B00939I7EK
                      reviewed_product_variant:
                        Style: Pitcher + Bowl + (2) 16-oz. Cups
                      is_vine: false
                requestId: 2ee08896-8b4b-4db3-916c-703176ed9206
          headers: {}
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 400
                  data: null
                  message: 'Missing required parameter: handle'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 401
                  data: null
                  message: apiKey is null
        '402':
          description: Payment Required
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 402
                  data: null
                  message: apiKey quota is not enough
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 429
                  data: null
                  message: qps limit exceeded
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 500
                  data: null
                  message: Internal server error
      deprecated: false
      security:
        - JWT Bearer: []
      x-codeSamples:
        - lang: curl
          label: cURL
          source: |-
            curl --request GET \
              --url 'https://api.keyapi.ai/v1/amazon/product-reviews?asin=B00939I7EK&cookie=&country=us&page=1&sort_by=TOP_REVIEWS&star_rating=ALL&verified_purchases_only=false&images_or_videos_only=false&current_format_only=false' \
              --header 'Authorization: Bearer <YOUR_API_KEY>'
        - lang: python
          label: Python
          source: |-
            import requests

            response = requests.get(
                'https://api.keyapi.ai/v1/amazon/product-reviews',
                params={"asin": "B00939I7EK", "cookie": "", "country": "us", "page": 1, "sort_by": "TOP_REVIEWS", "star_rating": "ALL", "verified_purchases_only": "false", "images_or_videos_only": "false", "current_format_only": "false"},
                headers={'Authorization': 'Bearer <YOUR_API_KEY>'}
            )
            print(response.json())
        - lang: javascript
          label: JavaScript
          source: >-
            const params = new URLSearchParams({"asin": "B00939I7EK", "cookie":
            "", "country": "us", "page": 1, "sort_by": "TOP_REVIEWS",
            "star_rating": "ALL", "verified_purchases_only": "false",
            "images_or_videos_only": "false", "current_format_only": "false"});


            const response = await
            fetch(`https://api.keyapi.ai/v1/amazon/product-reviews?${params}`, {
              method: 'GET',
              headers: { 'Authorization': 'Bearer <YOUR_API_KEY>' }
            });

            const data = await response.json();

            console.log(data);
components:
  securitySchemes:
    JWT Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: |-
        API key for authentication. Format: `sk_live_xxxxxxxxxxxxx`
        Get your API key from the [Dashboard](http://keyapi.ai/app/dashboard).

````