# Yelp Place Details by Handle — fetcher.sh

> Yelp Place Details by Handle — 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-19).

Fetch detailed information about a specific Yelp business using its Yelp handle/alias, with pay-per-call USDC pricing via x402.

## Facts

- Endpoint: GET https://yelp.fetcher.sh/api/place/handle/%7Bhandle%7D?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/yelp-place-details-by-handle-fetcher-sh-a4295d2b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HN45pLpmu4yWLW9CAnBn6

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-place-details-by-handle-fetcher-sh-a4295d2b
```

Example prompt: Pull up the full Yelp details for the business with handle 'gary-danko-san-francisco' — I need its address, phone number, hours, and star rating.

## When to prefer this

Use this endpoint when you already have a specific Yelp business handle/alias and need full place details without setting up a Yelp Developer account, OAuth flow, or subscription. It is ideal for one-off lookups, agent workflows that need to enrich a known business identifier, or situations where you want to pay per call in USDC rather than maintain API credentials.

## Known failure modes

- Invalid or non-existent Yelp handle returns a 404 or empty result
- Payment failure via x402 if wallet has insufficient USDC balance
- Rate limiting or blocking from Yelp's underlying data source
- Handle format errors (e.g. spaces instead of hyphens) causing lookup failure
- Stale or incomplete data if Yelp's listing has been recently updated

## 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 structured data for the requested Yelp business including name, address, phone number, business hours, star rating, review count, price range, categories, photos, and any other profile fields available from Yelp's listing for that handle.

## Request schema (JSON Schema)

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

## More

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