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

Retrieve paginated customer reviews for any online store or merchant by domain name, with filtering by rating, time frame, and sort order.

## Facts

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

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-880d51bb
```

Example prompt: Can you pull the 20 most recent five-star reviews for amazon.com from the past year, sorted by most recent, for the US region?

## When to prefer this

Use this endpoint when you need structured, paginated customer review data for a specific online merchant or store by domain name. It is ideal for reputation research, competitive analysis, or monitoring customer sentiment about a retailer. Prefer this over product-level review endpoints when you want store-wide merchant feedback rather than reviews of individual products.

## Known failure modes

- Invalid or non-existent store_domain returns empty results or error status
- Invalid country or language code may return no results or default to fallback locale
- Expired or malformed cursor value causes pagination failure
- Rating or time_frame enum value mismatch returns validation error
- Reaching end of reviews returns empty data with no cursor
- Rate limiting or payment failures return 402 or 429 status codes

## How this service works

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

## Output

Returns a paginated list of store/merchant reviews including individual review content, a pagination cursor for fetching the next page, the store's average rating, and the total number of reviews. The status and a unique request ID are also included in the response.

## 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-880d51bb/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)