{"uid":"cap_Mx-DQXEvqNWJDDDpfHVLd","slug":"agents-openwebninja-com-amazon-product-reviews-42cd4fd9","name":"Amazon Product Reviews","description":"Get and paginate through product reviews on Amazon. Each page contains up to 10 reviews.","url":"https://agents.openwebninja.com/realtime-amazon-data/product-reviews?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["asin","cookie"],"properties":{"asin":{"type":"string","description":"Product asin for which to get reviews."},"query":{"type":"string","description":"Find reviews matching a search query."},"cookie":{"type":"string","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}"},"cursor":{"type":"string","default":1,"description":"A cursor used to retrieve the next set of results for pagination. The value for the next page is returned in the \"cursor\" response field."},"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."},"sort_by":{"type":"string","default":"TOP_REVIEWS","description":"Return reviews in a specific sort order."},"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   "},"star_rating":{"enum":["ALL","5_STARS","4_STARS","3_STARS","2_STARS","1_STARS","POSITIVE","CRITICAL"],"type":"string","default":"ALL","description":"Only return reviews with a specific star rating or positive / negative sentiment."},"current_format_only":{"type":"boolean","description":"Only return reviews of the current format (product variant - e.g. Color).  \n  By default reviews are returned for all product variants"},"images_or_videos_only":{"type":"boolean","description":"Only return reviews containing images and / or videos."},"verified_purchases_only":{"type":"boolean","description":"Only return reviews by reviewers who made a verified purchase."}}},"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":"URL of a video attached to the review. Null when there is none."},"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."}}}}},"description":"Reviews for the product."},"total_ratings":{"type":"integer","description":"Total number of ratings for the product."},"total_reviews":{"type":"integer","description":"Total number of reviews matching the given filters."},"rating_distribution":{"type":"object","properties":{"1":{"type":"string","description":"Percentage or count of 1-star ratings."},"2":{"type":"string","description":"Percentage or count of 2-star ratings."},"3":{"type":"string","description":"Percentage or count of 3-star ratings."},"4":{"type":"string","description":"Percentage or count of 4-star ratings."},"5":{"type":"string","description":"Percentage or count 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."},"page":{"type":"integer","description":"Page number of the reviews to fetch."},"country":{"type":"string","description":"Country code of the Amazon marketplace."},"sort_by":{"type":"string","description":"Sorting method for the reviews (e.g., recent, top)."},"language":{"type":"string","description":"Language code used to parse and return review content."},"star_rating":{"type":"string","description":"Filter specifying which star rating(s) to include."},"current_format_only":{"type":"boolean","description":"Whether to restrict reviews to the currently selected product format/variation."},"images_or_videos_only":{"type":"boolean","description":"Whether to include only reviews that contain images or videos."},"verified_purchases_only":{"type":"boolean","description":"Whether to include only reviews marked as verified purchases."}}},"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_iLb3cv4HAi0fhVuJynhAo","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":"Fetches and paginates through up to 10 customer reviews per page for a specific Amazon product by ASIN, with filtering and sorting options.","exampleAgentPrompt":"Can you pull the top Amazon reviews for ASIN B09G9FPHY6 on the US marketplace? I want to see the most helpful ones first — grab the first page using my session cookies.","exampleUseCases":[{"title":"Competitor product sentiment analysis","prompt":"Fetch the top 10 most helpful Amazon reviews for ASIN B08N5KWB9H in the US so I can analyze what customers love or hate about this competitor's product."},{"title":"Negative review monitoring for a listing","prompt":"Get all 1-star and 2-star verified-purchase reviews for Amazon product B07XJ8C8F5 — I want to see what complaints are coming in for my own listing."},{"title":"Keyword-specific review search","prompt":"Search through Amazon reviews for ASIN B0BDHX8Z63 and find only reviews that mention 'battery life' — pull from the US marketplace sorted by top reviews."}],"resultDescription":"Returns a paginated list of up to 10 Amazon customer reviews for the specified ASIN, including review text, title, author name and ID, star rating, date (human-readable and ISO 8601), helpful vote count, attached images/videos, verified purchase status, Vine program flag, review language, country, and a cursor for fetching the next page. Also returns the product ASIN, Amazon domain, and marketplace country.","failureModes":["Invalid or expired cookie causes authentication failure or empty results","ASIN not found on the specified Amazon marketplace returns empty review list","Invalid cursor value breaks pagination and returns an error","Unsupported country code returns a validation error","Rate limiting or IP blocking by Amazon returns no data","Cookie format mismatch for non-US country codes (wrong ubid/x/at prefix) causes auth failure"],"whenToPreferThis":"Choose this endpoint when you need structured, paginated Amazon customer review data for a specific product ASIN, especially when you need filtering by star rating, verified purchase status, keyword search within reviews, or multi-country Amazon marketplace support. It is particularly useful for competitive research, product sentiment analysis, and listing quality monitoring. Prefer this over web scraping when you need clean JSON output with metadata like helpful votes, ISO dates, and Vine status.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:26.589Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-amazon-product-reviews-42cd4fd9"}