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