# Product Reviews

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

Fetches paginated customer reviews for a specific product, including ratings breakdown and aggregate rating data.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-product-search/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-product-reviews-b60318db
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_L6WCIfY2xgzmlHAQoSurj

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-product-reviews-b60318db
```

Example prompt: Pull up to 25 of the most recent customer reviews for product ID B09G9FPHY6 from US shoppers in English — I want to see what people are saying about it lately.

## When to prefer this

Use this endpoint when you need real-time customer review data for a specific product identified by its product ID. It is ideal for sentiment analysis, competitive research, reputation monitoring, or displaying reviews in an application. Prefer this over scraping product pages directly since it returns structured JSON with aggregate stats and pagination support. Best suited for use cases requiring filtering by rating or sorting by recency vs. relevance.

## Known failure modes

- Missing or invalid product_id returns an error response
- Invalid cursor value may return empty results or an error
- Rating filter value outside 1–5 range returns a validation error
- Unsupported country or language code may return no results or an error
- Product with no reviews returns empty review list with zero counts
- Rate limiting or quota exhaustion returns a 402 or 429 status

## How this service works

Get all product reviews. Pagination/scrolling is supported using the *cursor* and *limit* parameters.

## Output

Returns a JSON object containing: a list of product reviews (with text, author, rating, date, etc.), the average product rating, a breakdown of review counts per star rating (1–5), the total number of reviews, and a pagination cursor for fetching additional pages.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "product_id"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 100,
   "minimum": 1,
   "description": "Maximum number of product reviews to return."
  },
  "cursor": {
   "type": "string",
   "description": "A cursor to get the next set of results, it can be used for for paging purposes.  Note: the cursor value for the next set of results is returned by this endpoint under data.cursor."
  },
  "rating": {
   "type": "string",
   "default": 0,
   "description": "Only return reviews with user rating greater than the specified value. Allowed values: 1-5."
  },
  "country": {
   "type": "string",
   "default": "us",
   "description": "Country code of the region/country to return offers for. Allowed values: See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2."
  },
  "sort_by": {
   "enum": [
    "MOST_RELEVANT",
    "MOST_RECENT"
   ],
   "type": "string",
   "default": "MOST_RELEVANT",
   "description": "Return reviews in a specific sort order."
  },
  "language": {
   "type": "string",
   "default": "en",
   "description": "The language of the results. Allowed values: See https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes."
  },
  "product_id": {
   "type": "string",
   "description": "Product id of the product for which to fetch reviews."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "cursor": {
     "type": "string",
     "description": "A pagination cursor for fetching additional reviews."
    },
    "product_rating": {
     "type": "number",
     "description": "The average rating of the product."
    },
    "reviews_per_rating": {
     "type": "object",
     "properties": {
      "1": {
       "type": "integer",
       "description": "The number of one-star reviews."
      },
      "2": {
       "type": "integer",
       "description": "The number of two-star reviews."
      },
      "3": {
       "type": "integer",
       "description": "The number of three-star reviews."
      },
      "4": {
       "type": "integer",
       "description": "The number of four-star reviews."
      },
      "5": {
       "type": "integer",
       "description": "The number of five-star reviews."
      }
     }
    },
    "product_num_reviews": {
     "type": "integer",
     "description": "The total number of reviews for the product."
    }
   }
  },
  "status": {
   "type": "string",
   "description": "The status of the response, indicating success or failure."
  },
  "request_id": {
   "type": "string",
   "description": "A unique identifier for the request."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-product-reviews-b60318db/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)