yelp
A Yelp API alternative on fetcher.sh — pay-per-call in USDC via x402, or prepaid credits with a Bearer key, no Yelp Fusion API app approval. Use when the user wants to search local businesses by query and location sorted by rating or review count, fetch a business's full details by ID or by its Yelp
By fetcher-sh · 979 installs
npx skills add fetcher-sh/fetcher-skills --skill yelp
Source repository · Upstream listing
Yelp API
Local business search, business details, and reviews as clean JSON — one
plain HTTP GET per call, paid as you go. No Yelp Fusion API app approval, no
daily call cap, no API key request form.
Base URL: https://yelp.fetcher.sh
Authentication
Two ways to pay, same data — full mechanics in the [ fetcher
skill](../fetcher/SKILL.md):
Every response is { "status": number, "message": string, "data": ... } ; the
HTTP status mirrors status .
Endpoints (4 — all GET, $0.003/call)
Endpoint What it returns
/api/search Businesses matching a query and location
/api/place/{id} A business's full details by ID
/api/place/handle/{handle} A business's full details by its Yelp URL handle/slug
/api/place/{id}/reviews A business's reviews
Required on search: query , location . Optional: sortBy ( recommended ,
rating , reviewCount ), page . Reviews support page .
Scenarios
Highest rated first:
Most reviewed first:
A business's details by ID, or by its Yelp URL handle/slug:
A business's reviews, paginated:
MCP
Free: search endpoints , describe endpoint , check balance . Paid:
fetch data (any endpoint above), topup credits , plus the named shortcut
yelp search . Drop the headers block to pay per call with x402 instead —
see the [ fetcher skill](../fetcher/SKILL.md) for the full flow.
Errors
400 — missing/invalid parameter (message names it)
401 — unknown or rotated key
402 — payment required (x402 challenge) or topup required (credits
exhausted)
404 — not a priced path
No rate limits; no refunds on upstream failures (settlement precedes
delivery)
Reference
Full agent setup: <https://yelp.fetcher.sh/skill.md
OpenAPI 3.1 contract: <https://yelp.fetcher.sh/openapi.json
Condensed catalog: <https://yelp.fetcher.sh/llms.txt
Payment, credits, and MCP deep dive: [ fetcher skill](../fetcher/SKILL.md)
Site: <https://yelp.fetcher.sh