# Yelp Business Scraper (x402)

> Yelp Business 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 structured business profile data from Yelp by search term and location or direct URL, returning name, address, phone, coordinates, and photos.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/yelp?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-business-scraper-x402-30efd598
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HmJk5Cwr8lDUQWmEdKBFM

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-business-scraper-x402-30efd598 -d '<json body>'
```

Example prompt: Find me up to 20 Italian restaurants in Chicago and Boston from Yelp, including their phone numbers, addresses, and up to 5 photos each.

## When to prefer this

Choose this endpoint when you need structured Yelp business data (addresses, phones, coordinates, photos) for one or more cities or business types without managing a browser or Yelp API credentials. Ideal for lead generation, competitive research, local business aggregation, or feeding downstream workflows. The pay-per-successful-call model makes it cost-safe for exploratory queries. Prefer over generic web scrapers when Yelp-specific fields (bizId, alternateNames, Yelp URL) are needed.

## Known failure modes

- No results found for the given search term and location combination — empty items array returned, no charge applied
- Invalid or inaccessible direct URL provided — item may be skipped or return null fields
- Rate limiting or blocking by Yelp during scrape — run may fail with no charge
- maxItems cap reached before all searches are processed — partial results returned
- Malformed input schema (e.g. missing both searchTerms/locations and directUrls) — likely 400 error

## 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 matched businesses and an array of items, each containing the business name, Yelp business ID, phone number, street address, latitude, longitude, direct Yelp URL, and alternate names. Photo URLs are included up to the configured maxImages limit. Failed or empty runs are not billed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "maxItems": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Hard cap across all searches and direct URLs. Zero means no additional cap."
  },
  "locations": {
   "type": "array",
   "description": "Cities or areas for each search term, such as London or New York, NY."
  },
  "maxImages": {
   "type": "integer",
   "default": 20,
   "maximum": 1000,
   "minimum": 0,
   "description": "Maximum photo links per profile. Zero skips photos; higher limits may require extra gallery pages."
  },
  "directUrls": {
   "type": "array",
   "default": [],
   "description": "Business or search URLs. These can be combined with search terms and locations."
  },
  "searchLimit": {
   "type": "integer",
   "default": 10,
   "maximum": 240,
   "minimum": 1,
   "description": "Maximum business profiles to process for each term and location pair. Yelp exposes about 240 per search."
  },
  "searchTerms": {
   "type": "array",
   "description": "Keywords or business types. Each term is searched in every location."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "name": null,
    "bizId": null,
    "phone": null,
    "address": null,
    "latitude": null,
    "directUrl": null,
    "longitude": null,
    "alternateNames": null
   }
  ],
  "product": "yelp"
 }
}
```

## More

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