# Yelp Reviews Scraper (x402)

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

Scrapes and returns structured Yelp reviews for one or more businesses, filterable by rating, keyword, language, and sort order, billed per successful call via x402.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/yelp-reviews?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/yelp-reviews-scraper-x402-119fdaf1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hTu-UoFoA22bTvVrQv2fj

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 yelp-reviews-scraper-x402-119fdaf1 -d '<json body>'
```

Example prompt: Pull the 50 most recent Yelp reviews for https://www.yelp.com/biz/nobu-new-york — only include 1 and 2-star reviews mentioning 'service', sorted by newest first.

## When to prefer this

Use this endpoint when you need structured Yelp review data for one or more businesses, especially when you want to filter by star rating, keyword, or language, or when you need to fan out from a Yelp search results page to multiple businesses automatically. Prefer this over generic web scrapers because it returns clean, typed JSON fields (rating, date, text, URL) rather than raw HTML. The pay-per-successful-call model makes it cost-efficient since failed or empty runs are free.

## Known failure modes

- Business URL not found or Yelp page structure changed — returns empty items array (not charged)
- Invalid or inaccessible search URL — returns empty result
- Yelp rate-limiting or anti-scraping measures blocking request — may return empty or partial results
- Unsupported language code passed — may return all reviews or empty depending on feed
- maxItems set too low relative to reviewsLimit — may truncate results unexpectedly

## How this service works

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

## Output

Returns a JSON object with a count of items and an array of review objects, each containing review text, star rating, language, review ID, review URL, review date, position in the feed, and optionally translated text. Failed or empty scrapes are not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "domain": {
   "type": "string",
   "default": "www.yelp.com",
   "description": "Regional Yelp host for business IDs. Business URLs keep their own domain."
  },
  "keyword": {
   "type": "string",
   "default": "",
   "description": "Keep reviews containing this text, ignoring case."
  },
  "ratings": {
   "type": "array",
   "items": {
    "type": "integer"
   },
   "default": [],
   "description": "Keep only reviews with these star ratings; empty means all ratings."
  },
  "language": {
   "type": "string",
   "default": "",
   "description": "Two-letter language filter when supported by the review feed; empty means all languages."
  },
  "maxItems": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Hard cap across all businesses. Zero means no total cap."
  },
  "searchUrls": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Yelp search result URLs whose visible business listings should be expanded."
  },
  "businessIds": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Business URL aliases or encoded IDs to use when URLs are unavailable."
  },
  "reviewsSort": {
   "enum": [
    "recommended",
    "newest",
    "oldest",
    "highest",
    "lowest"
   ],
   "type": "string",
   "default": "recommended",
   "description": "Order used when requesting review pages."
  },
  "businessUrls": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Public Yelp business page URLs to collect reviews from."
  },
  "reviewsLimit": {
   "type": "integer",
   "default": 100,
   "minimum": 1,
   "description": "Maximum number of reviews to collect from each business."
  },
  "includePersonalData": {
   "type": "boolean",
   "default": false,
   "description": "Include public reviewer name, profile URL, photo URL, and review count. Disabled by default."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "text": null,
    "rating": null,
    "language": null,
    "reviewId": null,
    "reviewUrl": null,
    "reviewDate": null,
    "reviewPosition": null,
    "translatedText": null
   }
  ],
  "product": "yelp-reviews"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yelp-reviews-scraper-x402-119fdaf1/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)