> ## 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.

# Top Product Reviews

> Retrieve the most helpful (top) customer reviews for a product by ASIN. Supports field projection to return only the review fields you need.

<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/top-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/top-product-reviews

Description: Top Product Reviews

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

Parameters:
- asin (Required): Product asin for which to get reviews.. Example: B00939I7EK
- 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
- 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": {
"asin": "B00939I7EK",
"country": "US",
"domain": "www.amazon.com",
"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_pu
... (truncated)`)}
    >
      <span>✨</span>
      <span>Copy for AI</span>
    </button>
  </div>
</div>


## OpenAPI

````yaml en/amazon.openapi.json GET /v1/amazon/top-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/top-product-reviews:
    get:
      tags: []
      summary: Top Product Reviews
      description: >-
        Retrieve the most helpful (top) customer reviews for a product by ASIN.
        Supports field projection to return only the review fields you need.
      parameters:
        - name: asin
          in: query
          description: Product asin for which to get reviews.
          required: true
          example: B00939I7EK
          schema:
            type: string
            example: B00939I7EK
        - 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: 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
                  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: 2 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: 2 people found this helpful
                      reviewed_product_asin: B00939I7EK
                      reviewed_product_variant:
                        Style: Pitcher + Bowl + (2) 16-oz. Cups
                      is_vine: false
                    - review_id: R39OW6I0UKJ8G7
                      review_title: Very strong blender
                      review_comment: >-
                        The Ninja Mega Kitchen System is excellent quality and
                        feels very well made. The blades are extremely strong
                        and handle everything from smoothies to tougher
                        ingredients with ease. I really appreciate the variety
                        of accessories and sizes that come with it. Having
                        different options makes it very versatile, and the
                        smoothie cup is especially convenient for quick,
                        single-serve drinks. Everything works efficiently and
                        consistently. Overall, this is a powerful, reliable
                        kitchen system that offers great value and flexibility.
                        Highly recommend for everyday use.
                      review_star_rating: '5'
                      review_link: >-
                        https://www.amazon.com/gp/customer-reviews/R39OW6I0UKJ8G7
                      review_author_id: AFLDFMZWNQX7VLW6FARDEQ5NUPWQ
                      review_author: Cortney Vanhook
                      review_author_url: >-
                        https://www.amazon.com/gp/profile/amzn1.account.AFLDFMZWNQX7VLW6FARDEQ5NUPWQ
                      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 December 29, 2025
                      is_verified_purchase: true
                      helpful_vote_statement: 10 people found this helpful
                      reviewed_product_asin: B00939I7EK
                      reviewed_product_variant:
                        Style: Pitcher + Bowl + (2) 16-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: 3 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: 3 people found this helpful
                      reviewed_product_asin: B00939I7EK
                      reviewed_product_variant:
                        Style: Pitcher + Bowl + (2) 18-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: 2 people found this helpful
                      reviewed_product_asin: B00939I7EK
                      reviewed_product_variant:
                        Style: Pitcher + Bowl + (2) 16-oz. Cups
                      is_vine: false
                    - review_id: R2VGV1734CF2RP
                      review_title: Fantastic, powerful blender!
                      review_comment: >-
                        Very powerful blender. Makes smoothies, shakes, soups,
                        and batters quickly and effortlessly. I love this thing!
                      review_star_rating: '5'
                      review_link: >-
                        https://www.amazon.com/gp/customer-reviews/R2VGV1734CF2RP
                      review_author_id: AGIEGWIZVKIGHYQWZIAWYPGNMSVA
                      review_author: Eric B
                      review_author_url: >-
                        https://www.amazon.com/gp/profile/amzn1.account.AGIEGWIZVKIGHYQWZIAWYPGNMSVA
                      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 1, 2026
                      is_verified_purchase: true
                      helpful_vote_statement: 3 people found this helpful
                      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: 2 people found this helpful
                      reviewed_product_asin: B00939I7EK
                      reviewed_product_variant:
                        Style: Pitcher + Bowl + (2) 16-oz. Cups
                      is_vine: false
                requestId: 1a822d10-4084-48e9-b3fe-3a449e3f8f6c
          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/top-product-reviews?asin=B00939I7EK&country=us' \
              --header 'Authorization: Bearer <YOUR_API_KEY>'
        - lang: python
          label: Python
          source: |-
            import requests

            response = requests.get(
                'https://api.keyapi.ai/v1/amazon/top-product-reviews',
                params={"asin": "B00939I7EK", "country": "us"},
                headers={'Authorization': 'Bearer <YOUR_API_KEY>'}
            )
            print(response.json())
        - lang: javascript
          label: JavaScript
          source: >-
            const params = new URLSearchParams({"asin": "B00939I7EK", "country":
            "us"});


            const response = await
            fetch(`https://api.keyapi.ai/v1/amazon/top-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).

````