Back to Details

yelp

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Yelp API

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
本地商家搜索、商家详情及评论以简洁JSON格式返回——每次调用仅需一个简单的HTTP GET请求，按需付费。无需Yelp Fusion API应用审批，无每日调用上限，无需填写API密钥申请表单。
Base URL: 
https://yelp.fetcher.sh

Authentication

Authentication

Two ways to pay, same data — full mechanics in the 
fetcher
skill:
bash
undefined
两种付费方式，获取相同数据——完整机制详见
fetcher
技能：
bash
undefined

1. Prepaid credits (recommended — get a key at https://fetcher.sh/topup

1. 预付费额度（推荐——前往https://fetcher.sh/topup获取密钥

or via POST /api/credits/topup, see the fetcher skill)

或通过POST /api/credits/topup，详见fetcher技能）

export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx" curl -H "Authorization: Bearer $FETCHER_API_KEY"
"https://yelp.fetcher.sh/api/search?query=ramen&location=San+Francisco"
export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx" curl -H "Authorization: Bearer $FETCHER_API_KEY"
"https://yelp.fetcher.sh/api/search?query=ramen&location=San+Francisco"

2. x402 pay-per-call — omit the header; a GET with no payment returns 402

2. x402按调用付费——省略请求头；未付费的GET请求会返回402状态码，

with machine-readable payment requirements (USDC on Base, Polygon,

附带机器可读的支付要求（基于Base、Polygon、Arbitrum、Monad或Solana网络的USDC）。@x402/fetch会自动签名并重试请求。

Arbitrum, Monad, or Solana). @x402/fetch signs and retries automatically.

—

Every response is `{ "status": number, "message": string, "data": ... }`; the
HTTP status mirrors `status`.

所有响应格式均为`{ "status": number, "message": string, "data": ... }`；HTTP状态码与`status`字段值一致。

Endpoints (4 — all GET, $0.003/call)

Endpoints (4 — all GET, $0.003/call)

EndpointWhat 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
.
接口返回内容
/api/search
匹配查询内容和地点的商家列表
/api/place/{id}
通过ID获取商家的完整详情
/api/place/handle/{handle}
通过Yelp URL别名/短链接获取商家的完整详情
/api/place/{id}/reviews
商家的评论列表
搜索接口必填参数：
query
、
location
。可选参数：
sortBy
（
recommended
、
rating
、
reviewCount
）、
page
。评论接口支持
page
参数。

Scenarios

Scenarios

Highest rated first:
bash
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=ramen" -G \
  --data-urlencode "location=San Francisco" \
  --data-urlencode "sortBy=rating" \
  "https://yelp.fetcher.sh/api/search"
Most reviewed first:
bash
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=tacos" -G \
  --data-urlencode "location=Austin, TX" \
  --data-urlencode "sortBy=reviewCount" \
  "https://yelp.fetcher.sh/api/search"
A business's details by ID, or by its Yelp URL handle/slug:
bash
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://yelp.fetcher.sh/api/place/gary-danko-san-francisco"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://yelp.fetcher.sh/api/place/handle/gary-danko-san-francisco"
A business's reviews, paginated:
bash
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "page=2" -G \
  "https://yelp.fetcher.sh/api/place/gary-danko-san-francisco/reviews"
按评分从高到低排序：
bash
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=ramen" -G \
  --data-urlencode "location=San Francisco" \
  --data-urlencode "sortBy=rating" \
  "https://yelp.fetcher.sh/api/search"
按评论数从多到少排序：
bash
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=tacos" -G \
  --data-urlencode "location=Austin, TX" \
  --data-urlencode "sortBy=reviewCount" \
  "https://yelp.fetcher.sh/api/search"
通过ID或Yelp URL别名/短链接获取商家详情：
bash
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://yelp.fetcher.sh/api/place/gary-danko-san-francisco"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://yelp.fetcher.sh/api/place/handle/gary-danko-san-francisco"
分页获取商家评论：
bash
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "page=2" -G \
  "https://yelp.fetcher.sh/api/place/gary-danko-san-francisco/reviews"

MCP

MCP

json
{
  "mcpServers": {
    "yelp": {
      "url": "https://yelp.fetcher.sh/mcp",
      "headers": { "Authorization": "Bearer bby_live_..." }
    }
  }
}
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 for the full flow.
json
{
  "mcpServers": {
    "yelp": {
      "url": "https://yelp.fetcher.sh/mcp",
      "headers": { "Authorization": "Bearer bby_live_..." }
    }
  }
}
免费接口：
search_endpoints
、
describe_endpoint
、
check_balance
。付费接口：
fetch_data
（上述任意接口）、
topup_credits
，以及命名快捷方式
yelp_search
。若要改用x402按调用付费，可移除
headers
配置块——完整流程详见
fetcher
技能。

Errors

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)
  • 400
    — 参数缺失/无效（返回信息会指明具体参数）
  • 401
    — 密钥未知或已过期
  • 402
    — 需要支付（x402验证挑战）或
    topup_required
    （额度耗尽）
  • 404
    — 路径未定价
  • 无速率限制；上游服务故障时不予退款（结算优先于交付）

Reference

Reference