# Store Reviews

> Store 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 online store or merchant by domain name.

## Facts

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

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-store-reviews-0bb0d59c
```

Example prompt: Can you pull up the 20 most recent one-star reviews for amazon.com from the past year in English?

## When to prefer this

Use this endpoint when you need real-time, paginated customer review data for a specific online store or merchant identified by its domain name. It is ideal for reputation analysis, competitive research, sentiment monitoring, or due diligence on e-commerce merchants. Prefer this over product-level review endpoints when the subject is the store or merchant as a whole rather than a specific product. Its filtering by star rating, time frame, sort order, country, and language makes it well-suited for targeted review analysis workflows.

## Known failure modes

- Invalid or unrecognized store domain returns empty results or error status
- Invalid cursor value causes pagination failure or empty response
- Unsupported country or language code may return no results or default to US/English
- Rating or time_frame enum value mismatch causes parameter rejection
- Store with no reviews returns zero results with empty cursor
- Rate limiting or payment/credit exhaustion returns 402 or 429 error

## How this service works

Get all store / merchant reviews with pagination/scrolling support using the cursor and limit parameters.

## Output

Returns a JSON object containing: the store's average rating, total number of reviews, a list of customer reviews (with text, rating, date, and reviewer info), and a pagination cursor for fetching additional pages of results. Also includes a status string and a unique request ID.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "store_domain"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 100,
   "minimum": 1,
   "description": "Maximum number of store reviews to return."
  },
  "cursor": {
   "type": "string",
   "description": "A cursor to get the next set of results, 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",
   "description": "Only return reviews with specific rating. Default: ALL Allowed values: ALL, FIVE_STARS, FOUR_STARS, THREE_STARS, TWO_STARS, ONE_STAR"
  },
  "country": {
   "type": "string",
   "default": "us",
   "description": "Country code of the region/country. Allowed values: See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2."
  },
  "sort_by": {
   "enum": [
    "MOST_HELPFUL",
    "MOST_RECENT"
   ],
   "type": "string",
   "default": "MOST_HELPFUL",
   "description": "Return store 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."
  },
  "time_frame": {
   "enum": [
    "ALL",
    "ONE_YEAR",
    "TWO_YEARS",
    "SIX_MONTHS",
    "THREE_MONTHS"
   ],
   "type": "string",
   "default": "ALL",
   "description": "Only return reviews posted in a specific time range."
  },
  "store_domain": {
   "type": "string",
   "description": "The domain of the (TLD) of the store for which to get reviews (e.g. amazon.com)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "cursor": {
     "type": "string",
     "description": "A pagination cursor for fetching additional reviews."
    },
    "store_rating": {
     "type": "number",
     "description": "The average rating of the store."
    },
    "store_num_reviews": {
     "type": "integer",
     "description": "The total number of reviews for the store."
    }
   }
  },
  "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-store-reviews-0bb0d59c/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)