# Yelp Business Scraper via ScrapeForAgents

> Yelp Business Scraper via ScrapeForAgents is a paid API for AI agents from api.scrapeforagents.tech, 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 names, addresses, phone numbers, coordinates, and photo links.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/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-via-scrapeforagents-a45f85c2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5xDBNaFsyAdmQZL9Ucfii

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-via-scrapeforagents-a45f85c2 -d '<json body>'
```

Example prompt: Search Yelp for 'Italian restaurants' in New York, NY and San Francisco, CA — pull up to 20 business profiles each, including their addresses, phone numbers, and up to 10 photos per listing.

## When to prefer this

Choose this endpoint when you need structured Yelp business data at scale — including contact info, coordinates, and photos — without managing your own scraping infrastructure. It's pay-per-call and only charges on successful, non-empty results, making it cost-efficient for both bulk city-wide searches and targeted direct-URL lookups. Prefer it over generic web scrapers when Yelp-specific fields like bizId, alternateNames, and Yelp-hosted photos are important.

## Known failure modes

- Empty results if search terms and locations return no Yelp matches — not charged
- Invalid or expired direct URLs returning null fields
- Search limit exceeding Yelp's exposed ~240 results per query silently capped
- Missing fields (null) if Yelp profile is incomplete or partially scraped
- Rate or anti-bot blocks from Yelp causing failed runs — not charged per pay-per-call model

## How this service works

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

## Output

A JSON object with a count of results and an items array where each entry contains the business name, Yelp business ID, phone number, street address, latitude, longitude, direct Yelp URL, alternate names, and photo link URLs (up to the requested max).

## 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-via-scrapeforagents-a45f85c2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)