# fetcher.sh Yelp Place by Handle

> fetcher.sh Yelp Place by Handle 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).

Fetches detailed Yelp business profile data for a given Yelp business handle/alias, paid per call in USDC via x402.

## Facts

- Endpoint: GET https://fetcher.sh/api/yelp/place/handle/%7Bhandle%7D
- 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-place-by-handle-d42dd7b6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pnwf1nAcoMTJoqbBQReeM

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-place-by-handle-d42dd7b6
```

Example prompt: Pull the Yelp business profile for 'gary-danko-san-francisco' — I need their address, phone number, rating, and hours.

## When to prefer this

Use this endpoint when you already know the Yelp business handle/alias (the slug in the Yelp URL) and need structured profile data without setting up OAuth, a Yelp developer account, or managing API keys. Ideal for AI agents that need pay-per-call access to Yelp data in USDC with no subscriptions.

## Known failure modes

- Invalid or non-existent Yelp handle returns 404 or empty result
- Payment failure if USDC balance is insufficient (x402 payment required)
- Rate limiting or temporary Yelp scraping blocks may return errors
- Business may have been closed or removed from Yelp, returning no data
- Handle with special characters may need URL encoding

## 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 structured Yelp business profile including the business name, address, phone number, star rating, total review count, price range, categories, hours of operation, photos, and other publicly available attributes from the Yelp listing for the specified handle.

## Request schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fetcher-sh-yelp-place-by-handle-d42dd7b6/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)