fetcher.sh
Top up
all services

Yelp businesses and reviews without Yelp Fusion

Business search by query and location, place details, and reviews. Not an official platform API. No account, no OAuth — pay per call with x402 or spend a prepaid credit balance with one API key.

4 endpoints$0.003 per callGET · JSON envelopeUSDC · gas sponsored
pay from any of:BasePolygonArbitrumMonadSolana

Also covers: yelp.com · local businesses · restaurants

compared to

What Yelp is not

Yelp compared to the official path
PathReviewsWhat you set up
Yelp FusionOfficial review endpoints return excerptsFusion API key
Outscraper / ApifyHosted Yelp reads with their own signupTheir account
yelp.fetcher.shPublic reviews as a GET, $0.003 per callNone for x402

Named comparison: Best Yelp business and reviews APIs in 2026. Alternatives: Yelp API alternatives. Compare: Compare Yelp APIs.

prices

4 GETs on this host

$0.003 per call in USDC. Same numbers as /prices on the directory.

Yelp endpoint prices
GETWhat it returnsUSDC / callPage
GET /api/place/handle/{handle}Place handle$0.003docs
GET /api/place/{id}Place$0.003docs
GET /api/place/{id}/reviewsPlace reviews$0.003docs
GET /api/searchSearch$0.003docs

questions

FAQ

Is this the Yelp Fusion API?
No. yelp.fetcher.sh is not Yelp Fusion. Fusion's review endpoints return short excerpts. This host returns public business search, place details, and reviews as JSON via GET.
Do I need a Yelp Fusion API key?
No. Call the URL. Pay that request in USDC via x402, or spend a prepaid credit key. You do not register a Fusion app.
Do I need an official developer account?
No. fetcher.sh is not the official Twitter, YouTube, or Google API. You do not register an app, complete OAuth, or wait for platform review. Call a URL; data comes back as JSON.
Is there a monthly minimum or subscription?
No. There is no monthly plan, no seat fee, and no minimum volume. Pay per call from $0.002. Credits never expire. A $1 credit top-up is only if you want a prepaid API key instead of paying each call.
Can I pay for a single request?
Yes. Call any endpoint with no credential and pay that one request in USDC via x402. No account, no invoice, no leftover plan.

the main one

start here

$0.003 per call

Search

/api/search

Query plus location, sorted by rating or review volume.

try an example

Try it/api/search?query=ramen&location=San+Francisco&sortBy=rating

opens the payment page in a new tab · $0.003 per call

quick start

Call Yelp in 30 seconds

curl — with a credits API key
curl -H 'Authorization: Bearer bby_live_...' \
  'https://yelp.fetcher.sh/api/search?query=ramen&location=San+Francisco'
curl — no key: the x402 challenge
# call without payment to inspect the 402 challenge
curl -i 'https://yelp.fetcher.sh/api/search?query=ramen&location=San+Francisco'
# HTTP/1.1 402 Payment Required
# payment-required: <base64 payment requirements>

No key yet? Top up once (minimum $1) and the first response contains your bby_live_ key — one balance works across every fetcher.sh service. Generate one.

mcp

Add Yelp to Claude or Cursor

This host serves 4 named Yelp tools at /mcp. Catalog discovery (search, describe, fetch any path) lives on mcp.fetcher.sh.

mcp config — this service
{
  "mcpServers": {
    "fetcher": { "url": "https://yelp.fetcher.sh/mcp" }
  }
}

Specialized tools: yelp_place_handle, yelp_place, yelp_place_reviews, yelp_search. Browse every service on mcp.fetcher.sh.

reference

All 4 Yelp endpoints

Click any endpoint to open its console: fill the parameters and try it live — the payable URL opens in a new tab, ready for a browser wallet.

docs
docs
docs
docs

Top up once — then hammer all 4 endpoints with one key

One x402 payment funds a credit balance. Every call after that is a plain Bearer request: no signing, no chain round-trip, more requests per second. The same balance works on every fetcher.sh service.

Generate API key your first top-up creates the key — shown once

Agents: paste Set up https://yelp.fetcher.sh/skill.md into your agent — it reads the skill and sets everything up.