# Etsy Shop Reviews Scraper (x402)

> Etsy Shop Reviews Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-02).

Scrapes and returns structured customer reviews from one or more Etsy shops, with configurable per-shop and total review limits, charged per successful call.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/etsy-reviews?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/etsy-shop-reviews-scraper-x402-1493ff06
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gyzEflhRH-GrnTD8nsdLV

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 etsy-shop-reviews-scraper-x402-1493ff06 -d '<json body>'
```

Example prompt: Pull up to 200 reviews from the Etsy shop 'CeramicsByLuna' — no more than 100 per shop — so I can analyze what customers are saying about their products.

## When to prefer this

Choose this endpoint when you need structured review data from specific Etsy shops at scale, especially when you want configurable limits per shop and across all shops. It is pay-per-successful-call, so failed or empty scrapes are free — making it low-risk for exploratory or uncertain targets. Prefer this over manual scraping or generic web scrapers when you need clean, structured review fields (rating, reviewer identity, timestamps) rather than raw HTML.

## Known failure modes

- Shop name not found or misspelled — returns empty result set (not charged)
- Etsy rate limiting or anti-scraping measures may result in partial or empty results (not charged)
- Invalid input schema (e.g. negative itemLimit) returns a validation error
- Private or suspended Etsy shops may return no reviews
- Network or provider-side timeout results in a failed call (not charged)

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

A JSON object containing a count of results and an array of review items, each with fields for rating, review text, review ID, receipt ID, review key, reviewed-at timestamp, buyer user ID, and buyer real name. Empty or failed runs are not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "itemLimit": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Maximum reviews across all shops; 0 means no limit."
  },
  "shop_name": {
   "type": "array",
   "description": "Public shop names or shop URLs to collect reviews from."
  },
  "maxReviewsPerShop": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Maximum reviews from each shop; 0 means no per-shop limit."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "rating": null,
    "review": null,
    "reviewId": null,
    "receiptId": null,
    "reviewKey": null,
    "reviewedAt": null,
    "buyerUserId": null,
    "buyerRealName": null
   }
  ],
  "product": "etsy-reviews"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/etsy-shop-reviews-scraper-x402-1493ff06/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)