{"uid":"cap_ZOFFaGo075IjCiZ6lElEN","slug":"agents-openwebninja-com-top-product-reviews-54cfd7a8","name":"Top Product Reviews","description":"Get top product reviews by ASIN from the Amazon product details page.","url":"https://agents.openwebninja.com/realtime-amazon-data/top-product-reviews?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["asin"],"properties":{"asin":{"type":"string","description":"Product asin for which to get reviews."},"fields":{"type":"string","description":"A comma separated list of product fields to include in the response (field projection).  \n  By default all fields are returned."},"country":{"enum":["US","AU","BR","CA","CN","FR","DE","IN","IT","MX","NL","SG","ES","TR","AE","GB","JP","SA","PL","SE","BE","EG","ZA","IE"],"type":"string","default":"US","description":"Sets the Amazon domain, marketplace country, language and currency."},"language":{"type":"string","description":"The language of the results. In case not specified, results will be returned in the default domain language.  \n\n  **Supported languages per country:**  \n  `US`: en_US, es_US  \n  `AU`: en_AU  \n  `BR`: pt_BR  \n  `CA`: en_CA, fr_CA  \n  `FR`: fr_FR, en_GB  \n  `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK  \n  `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN  \n  `IT`: it_IT, en_GB  \n  `MX`: es_MX  \n  `NL`: nl_NL, en_GB  \n  `SG`: en_SG  \n  `ES`: es_ES, pt_PT, en_GB  \n  `TR`: tr_TR  \n  `AE`: en_AE, ar_AE  \n  `GB`: en_GB  \n  `JP`: ja_JP, en_US, zh_CN  \n  `SA`: ar_AE, en_AE  \n  `PL`: pl_PL  \n  `SE`: sv_SE, en_GB  \n  `BE`: fr_BE, nl_BE, en_GB  \n  `EG`: ar_AE, en_AE  \n  `ZA`: en_ZA  \n  `IE`: en_IE  "}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"asin":{"type":"string","description":"ASIN of the product whose reviews are returned."},"domain":{"type":"string","description":"Amazon domain corresponding to the marketplace."},"country":{"type":"string","description":"Country code of the marketplace from which reviews were collected."},"reviews":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string","nullable":true,"description":"Country code (ISO 3166-1 alpha-2) of the Amazon marketplace the review was written on. Omitted when it cannot be determined."},"is_vine":{"type":"boolean","description":"Indicates whether the review is part of the Amazon Vine program."},"review_id":{"type":"string","description":"Unique identifier of the review on Amazon."},"review_date":{"type":"string","description":"Human-readable date string for when the review was posted."},"review_link":{"type":"string","description":"Direct URL to the review on Amazon."},"review_title":{"type":"string","description":"Title or headline of the review."},"review_video":{"type":"string","nullable":true,"description":"Review video field which is null when no video is attached."},"helpful_votes":{"type":"integer","nullable":true,"description":"Number of people who found the review helpful. Null when not shown."},"review_author":{"type":"string","description":"Display name of the review author."},"review_images":{"type":"array","items":{"type":"string"},"description":"Photos attached to the review."},"review_comment":{"type":"string","description":"Full text content of the review."},"review_date_iso":{"type":"string","nullable":true,"description":"Review date in ISO 8601 format (YYYY-MM-DD). Null when the date cannot be read."},"review_language":{"type":"string","nullable":true,"description":"Language code (ISO 639-1) of the review text. Omitted when it cannot be determined."},"review_author_id":{"type":"string","description":"Internal Amazon identifier of the review author."},"is_different_asin":{"type":"boolean","nullable":true,"description":"True when the review was written for a different ASIN than the requested one (another variant of the listing, or the product on another marketplace). Null when the reviewed ASIN is not shown."},"review_author_url":{"type":"string","description":"URL to the review author's Amazon profile."},"review_star_rating":{"type":"string","description":"Star rating given by the reviewer as a string."},"is_verified_purchase":{"type":"boolean","description":"Indicates whether the review is marked as a verified purchase."},"review_author_avatar":{"type":"string","description":"URL of the review author's avatar image."},"reviewed_product_asin":{"type":"string","description":"ASIN of the specific product/variation that was reviewed."},"helpful_vote_statement":{"type":"string","description":"Text describing how many users found the review helpful."},"reviewed_product_variant":{"type":"object","properties":{"Size":{"type":"string","description":"Size option of the product variant reviewed."},"Color":{"type":"string","description":"Color of the product variant reviewed."},"Product grade":{"type":"string","description":"Condition or grading of the renewed/refurbished product."},"Service provider":{"type":"string","description":"Service provider or carrier associated with the device."}}}}}},"rating_distribution":{"type":"object","properties":{"1":{"type":"integer","description":"Count or percentage of 1-star ratings."},"2":{"type":"integer","description":"Count or percentage of 2-star ratings."},"3":{"type":"integer","description":"Count or percentage of 3-star ratings."},"4":{"type":"integer","description":"Count or percentage of 4-star ratings."},"5":{"type":"integer","description":"Count or percentage of 5-star ratings."}}}}},"status":{"type":"string","description":"Overall status of the API request."},"parameters":{"type":"object","properties":{"asin":{"type":"string","description":"Amazon ASIN of the product whose reviews are requested."},"country":{"type":"string","description":"Country code of the Amazon marketplace."},"language":{"type":"string","description":"Locale/language used to fetch and format review content."}}},"request_id":{"type":"string","description":"Unique identifier assigned to this API request."}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_UBPcGZRtPeVsgMC1vqjpp","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Retrieve the top customer reviews for an Amazon product by ASIN, with support for multiple marketplaces and languages.","exampleAgentPrompt":"Can you pull the top customer reviews for the Amazon product with ASIN B09G9FPHY6 in the US marketplace?","exampleUseCases":[{"title":"Competitive product research","prompt":"Get me the top customer reviews for ASIN B08N5WRWNW on Amazon US — I want to see what buyers are saying, including the review titles, full text, star ratings, and how many people found each one helpful."},{"title":"International market sentiment check","prompt":"Fetch the top Amazon reviews for ASIN B07XJ8C8F5 in the UK marketplace in English so I can compare how British customers feel about this product versus US customers."},{"title":"Multilingual review analysis","prompt":"Pull the top reviews for Amazon product ASIN B09V3KXJPW from the German marketplace in German — I want the review text, author names, dates, and star ratings."}],"resultDescription":"Returns a structured JSON object containing the ASIN, Amazon domain, country code, and an array of top review objects. Each review includes: review ID, title, full comment text, star rating, author name and ID, review date (human-readable and ISO 8601), helpful vote count, direct review URL, attached images, video field, Vine program status, review language, and country of origin.","failureModes":["Invalid or non-existent ASIN returns empty reviews array or error","Unsupported country code returns validation error","Unsupported language for the selected country returns error","Rate limiting or quota exhaustion returns 402 or 429 error","Amazon page temporarily unavailable may cause timeout or partial data","Some fields (helpful_votes, review_date_iso, country) may be null when Amazon does not expose them"],"whenToPreferThis":"Choose this endpoint when you need real-time, structured Amazon product review data — including review text, ratings, helpful votes, images, and Vine status — across 24 supported Amazon marketplaces and multiple languages. It is ideal for product research, sentiment analysis, competitive intelligence, and listing optimization workflows that require fresh data directly from Amazon's product detail pages.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:12.501Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-top-product-reviews-54cfd7a8"}