# Amazon Product Reviews API (ASIN/URL)

> Amazon Product Reviews API (ASIN/URL) is a paid API for AI agents from api.cn402.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-16).

Fetches Amazon product reviews by ASIN or product URL, returning review text, ratings, author details, and product-level star-rating breakdown via an async snapshot pattern.

## Facts

- Endpoint: GET https://api.cn402.com/ecom/reviews
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/amazon-product-reviews-api-asin-url-66a4009d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VYvnDWVOJRvm2tufUsVSk

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 amazon-product-reviews-api-asin-url-66a4009d
```

Example prompt: Pull the Amazon customer reviews for ASIN B09G9FPHY6 — I want the review text, star ratings, verified purchase flags, and the overall rating breakdown so I can find the most common complaints.

## When to prefer this

Use this endpoint when you need structured Amazon review data including text, ratings, author metadata, verified/Vine flags, and star-rating breakdowns for a specific product ASIN or URL. Ideal for review mining, sentiment analysis, complaint detection, and competitive product research on Amazon. Prefer over general web scraping when you need clean, structured review fields with helpful vote counts and variant info.

## Known failure modes

- Invalid or non-existent ASIN returns empty results or error
- Snapshot not yet ready returns status 'pending' — agent must poll again after ~40 seconds
- Product with no reviews returns empty reviews array
- Rate limiting or payment failure returns 402 or 429 error
- Network timeout on long-running snapshot collection

## How this service works

Get Amazon product reviews by ASIN or URL: review text, star rating, title, author, date, verified-purchase and Vine flags, helpful votes and variant, plus the product star-rating breakdown. Async: a first call with asin returns a snapshot id (collection ~40s); call again with that snapshot to fetch reviews. For review mining, sentiment, complaint detection and competitor weakness analysis. 亚马逊评论挖掘与差评分析。

## Output

Returns an array of reviews (rating, title, text, author, date, verified, vine, helpful votes, country, variant, review_id), plus product name, total review count, overall star rating, and a 1–5 star count breakdown. On the first call, returns a snapshot ID with status 'pending'; call again with the snapshot ID ~40 seconds later to retrieve the full results with status 'ready'.

## Example request

```json
{
 "raw": "false",
 "url": "https://www.amazon.com/sp?seller=A2XPYBBX7QV442",
 "max_feedback": "20"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "Full Amazon product URL (alternative to asin)."
  },
  "asin": {
   "type": "string",
   "description": "Amazon ASIN, 10 chars (provide asin OR url for the first call)."
  },
  "domain": {
   "type": "string",
   "description": "Marketplace domain when using asin, e.g. amazon.com (default), amazon.co.uk."
  },
  "snapshot": {
   "type": "string",
   "description": "Snapshot id (sd_...) from the first call; pass it on the second call to fetch results."
  },
  "max_reviews": {
   "type": "string",
   "description": "Number of reviews to collect, 1-50 (default 10)."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/amazon-product-reviews-api-asin-url-66a4009d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.cn402.com](https://www.zero.xyz/host/api.cn402.com/llms.txt)