# fetcher.sh Yelp Search API

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

Search Yelp for local businesses by keyword and location, returning listings, ratings, reviews, and contact details

## Facts

- Endpoint: GET https://fetcher.sh/api/yelp/search
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fetcher-sh-yelp-search-api-f5b173b7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8lMD0jVZLc-3A7MPZecZ_

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 fetcher-sh-yelp-search-api-f5b173b7
```

Example prompt: Search Yelp for the top-rated sushi restaurants in Brooklyn, NY and give me their names, ratings, addresses, and phone numbers.

## When to prefer this

Choose this endpoint when you need to search Yelp specifically for local business discovery, ratings, and reviews — especially for restaurants, home services, or consumer-facing businesses. Prefer this over generic web scraping when you want structured Yelp data (ratings, hours, phone) without needing an OAuth token or Yelp developer account. It's ideal for AI agents that need to pay per-call in USDC with no subscription overhead.

## Known failure modes

- Missing required query or location parameter returns a 400 error
- No results found for obscure location or niche category returns empty list
- Rate limiting or payment failure returns 402 if USDC payment is insufficient
- Yelp data may be stale or incomplete for newer or less-reviewed businesses
- Geographic queries for very small towns may return sparse results

## How this service works

fetcher.sh is an x402 web-data and scraping API: 111 endpoints for Twitter/X, YouTube, TikTok, Instagram, Reddit, Google, App Store, and Yelp — paid per call in USDC on Base, Polygon, Arbitrum, Monad or Solana, or with prepaid credits. Built for AI agents: no accounts, no OAuth, no subscriptions.

## Output

Returns a list of Yelp business listings matching the search query and location, including business names, star ratings, review counts, addresses, phone numbers, price range indicators, categories, and hours of operation where available.

## 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/fetcher-sh-yelp-search-api-f5b173b7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fetcher.sh](https://www.zero.xyz/host/fetcher.sh/llms.txt)