# Yelp Business Search API via fetcher.sh

> Yelp Business Search API via fetcher.sh is a paid API for AI agents from yelp.fetcher.sh, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-20).

Search for local businesses on Yelp by keyword and location, returning matching listings with ratings, categories, and metadata.

## Facts

- Endpoint: GET https://yelp.fetcher.sh/api/search?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/yelp-business-search-api-via-fetcher-sh-3c9be45e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8v_1UfsVum6pz9x07uMeq

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-search-api-via-fetcher-sh-3c9be45e
```

Example prompt: Search Yelp for the top-rated Thai restaurants in Austin, TX — I want a list with their ratings and addresses.

## When to prefer this

Choose this endpoint when you need Yelp-specific local business search without a Yelp developer account or OAuth setup, and want to pay per call in USDC with no subscription. Ideal for agents that need on-demand, low-frequency business lookups billed micropayment-style via x402 protocol on Base, Polygon, Arbitrum, Monad, or Solana.

## Known failure modes

- No results found for a very specific or misspelled query — returns empty results list
- Location not recognized or too vague — may return an error or off-target results
- Payment failure via x402 if wallet has insufficient USDC — HTTP 402 response
- Rate limiting or upstream Yelp data unavailability — may return 503 or timeout
- Query too broad returns irrelevant results across unintended categories

## How this service works

Yelp (yelp.com) data and scraping API: Business search by query and location, place details, and reviews. 4 REST endpoints from $0.003 per call — no account, no OAuth, no subscription. Pay with x402 (USDC on Base, Polygon, Arbitrum, Monad or Solana) or prepaid credits.

## Output

Returns a list of Yelp business listings matching the search query and location, including business name, address, phone number, rating, review count, categories, and potentially hours of operation and a Yelp URL for each result.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yelp-business-search-api-via-fetcher-sh-3c9be45e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from yelp.fetcher.sh](https://www.zero.xyz/host/yelp.fetcher.sh/llms.txt)