# Top Product Reviews

> Top Product Reviews is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Retrieve the top customer reviews for an Amazon product by ASIN, with support for multiple marketplaces and languages.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-amazon-data/top-product-reviews?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-top-product-reviews-54cfd7a8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZOFFaGo075IjCiZ6lElEN

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-openwebninja-com-top-product-reviews-54cfd7a8
```

Example prompt: Can you pull the top customer reviews for the Amazon product with ASIN B09G9FPHY6 in the US marketplace?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Get top product reviews by ASIN from the Amazon product details page.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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  "
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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,
        "
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-top-product-reviews-54cfd7a8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)
