Yelp 搜索 API

按关键词和地点在 Yelp 上搜索商家：每次请求最多返回 20 个商家，包含评分、类别和核心商家信息。

免费开始下载示例或 JSON

US$2.50/千次请求，按请求付费，无需订阅。

Best pizza Near Chicago, IL - Yelp

yelp.com/search?find_desc=pizza&find_loc=Chicago%2C%20IL

yelp

pizza

Chicago, IL

AllDeliveryTakeoutPriceOpen Now

Best pizza Near Chicago, IL

Lou's Deep Dish Kitchen

2,418

$$ · Pizza, American (Traditional)

Lincoln Park

Lou's Deep Dish Kitchen

Yelp

API 返回的内容items[0]

{
"id": "abc123XyzChicagoDeepDish",
"name": "Lou's Deep Dish Kitchen",
"alias": "lous-deep-dish-kitchen-chicago",
"address1": "2145 N Halsted St",
"address2": "",
"address3": "",
"city": "Chicago",
"state": "IL",
... 还有 18 个字段}

可用率

93.85%

30d · 65 次调用

请求数

30d · 按周，近 12 周

响应时间

18.6s

中位数 · 30d

价格与服务商

Yelp 搜索 API 价格：一个 API，2 个可互换的服务商

最便宜的服务商优先响应。如果它失败，下一个会在同一次调用中接手。

服务商，按调用顺序

1Badger优先响应可用率 100.00%p50 1660ms占调用的 6.6%6.6%4 次调用100.00%1660msUS$2.50/千次请求flat 2Octopus备用 1可用率 100.00%p50 4738ms占调用的 44.3%44.3%27 次调用100.00%4738msUS$1.38/千条结果每次请求最多 US$0.0275 Ibex暂停服务可用率 30.00%p50 19190ms占调用的 49.2%49.2%30 次调用30.00%19190msUS$2.00/千次请求flat

标记为暂停服务的服务商因响应不稳定，已移出轮换，你的调用会转到其他服务商。它恢复稳定响应后会自动重新加入。

我需要次请求

你需支付

US$25.00

US$2.50/千次请求，只为实际用量付费。没有月度套餐。

有了 US$0.10 的初始余额，你的前 40 次请求免费。

试一试

一个请求获取 Yelp 搜索

location*string定义搜索区域的城市和州（例如 San Francisco, CA）。query*string要搜索的关键词或类别（例如 sushi）。limitinteger 1-20最多返回的结果数（1 到 20，默认 20）。

requireFieldsarray可选；省略时路由不变，由最便宜的数据源处理。列出本次请求必须能返回的输出字段，例如 `is_closed` 或 `price`，请求就只会由能返回全部这些字段的数据源处理。未列出的字段，只要处理请求的数据源有，仍会照常返回。这可能提高你的价格：最便宜的数据源无法返回某个列出的字段时，会改由更贵的数据源处理，并按它的价格报价和扣费。如果某个地点确实没有某个列出的字段，该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回，请求会作为无效输入被拒绝，不扣费。

import os, requests

res = requests.post(
    "https://api.getanyapi.com/v1/run/yelp.search",
    headers={"Authorization": f"Bearer {os.environ['ANYAPI_KEY']}"},
    json={
        "location": "Chicago, IL",
        "query": "pizza",
        "limit": 20
    },
)
print(res.json())

const res = await fetch("https://api.getanyapi.com/v1/run/yelp.search", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ANYAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "location": "Chicago, IL",
    "query": "pizza",
    "limit": 20
  }),
});
const data = await res.json();
console.log(data);

curl -X POST https://api.getanyapi.com/v1/run/yelp.search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"Chicago, IL","query":"pizza","limit":20}'

打开于提示词已复制

获取免费密钥

示例响应

免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。

这个示例展示了 30 个字段中的 29 个。查看全部字段

{
  "found": true,
  "data": {
    "items": [
      {
        "id": "abc123XyzChicagoDeepDish",
        "name": "Lou's Deep Dish Kitchen",
        "alias": "lous-deep-dish-kitchen-chicago",
        "address1": "2145 N Halsted St",
        "address2": "",
        "address3": "",
        "city": "Chicago",
        "state": "IL",
        "zip": "60614",
        "country": "US",
        "latitude": 41.9214,
        "longitude": -87.6486,
        "neighborhoods": [
          "Lincoln Park"
        ],
        "phone": "+13125550142",
        "localized_phone": "(312) 555-0142",
        "dialable_phone": "+13125550142",
        "review_count": 2418,
        "avg_rating": 4.5,
        "unrounded_avg_rating": 4.47,
        "is_closed": false,
        "price": 2,
        "localized_price": "$$",
        "categories": [
          {
            "alias": "pizza",
            "title": "Pizza"
          },
          {
            "alias": "tradamerican",
            "title": "American (Traditional)"
          }
        ],
        "photo_url": "https://s3-media0.fl.yelpcdn.com/bphoto/9f2a1b7c6e4d8a3b5c1f0e2d4a6b8c9d/o.jpg",
        "photo_count": 384,
        "url": "https://www.yelp.com/biz/lous-deep-dish-kitchen-chicago"
      },
      {
        "id": "def456UptownSlice",
        "name": "Uptown Slice House",
        "alias": "uptown-slice-house-chicago",
        "address1": "4560 N Broadway St",
        "address2": "",
        "address3": "",
        "city": "Chicago",
        "state": "IL",
        "zip": "60640",
        "country": "US",
        "latitude": 41.9647,
        "longitude": -87.6558,
        "neighborhoods": [
          "Uptown"
        ],
        "phone": "+17735550198",
        "localized_phone": "(773) 555-0198",
        "dialable_phone": "+17735550198",
        "review_count": 967,
        "avg_rating": 4,
        "unrounded_avg_rating": 4.02,
        "is_closed": false,
        "price": 1,
        "localized_price": "$",
        "categories": [
          {
            "alias": "pizza",
            "title": "Pizza"
          }
        ],
        "photo_url": "https://s3-media0.fl.yelpcdn.com/bphoto/2c4e6a8b0d1f3e5a7c9b1d3f5e7a9c0b/o.jpg",
        "photo_count": 156,
        "url": "https://www.yelp.com/biz/uptown-slice-house-chicago"
      },
      {
        "id": "ghi789WickerParkPie",
        "name": "Wicker Park Pie Co.",
        "alias": "wicker-park-pie-co-chicago",
        "address1": "1780 N Milwaukee Ave",
        "address2": "Suite 2",
        "address3": "",
        "city": "Chicago",
        "state": "IL",
        "zip": "60622",
        "country": "US",
        "latitude": 41.9127,
        "longitude": -87.6763,
        "neighborhoods": [
          "Wicker Park"
        ],
        "phone": "+17735550176",
        "localized_phone": "(773) 555-0176",
        "dialable_phone": "+17735550176",
        "review_count": 512,
        "avg_rating": 4.5,
        "unrounded_avg_rating": 4.46,
        "is_closed": false,
        "price": 2,
        "localized_price": "$$",
        "categories": [
          {
            "alias": "pizza",
            "title": "Pizza"
          },
          {
            "alias": "italian",
            "title": "Italian"
          }
        ],
        "photo_url": "https://s3-media0.fl.yelpcdn.com/bphoto/5a7c9e1b3d5f7a9c1e3b5d7f9a1c3e5b/o.jpg",
        "photo_count": 92,
        "url": "https://www.yelp.com/biz/wicker-park-pie-co-chicago"
      }
    ]
  }
}

完整的参数与响应参考：这个接口的每个字段、类型和示例。

参考

一个请求，一种响应结构。

你发送的每个字段和收到的每个字段，都附有真实示例。

最近验证于 2026-11-14 · 可用率和延迟按 30d 统计

请求体

JSON，POST 到这个接口。

locationstring
Chicago, IL
定义搜索区域的城市和州（例如 San Francisco, CA）。
querystring
pizza
要搜索的关键词或类别（例如 sushi）。
limitinteger
3
最多返回的结果数（1 到 20，默认 20）。
requireFieldsarray
可选；省略时路由不变，由最便宜的数据源处理。列出本次请求必须能返回的输出字段，例如 `is_closed` 或 `price`，请求就只会由能返回全部这些字段的数据源处理。未列出的字段，只要处理请求的数据源有，仍会照常返回。这可能提高你的价格：最便宜的数据源无法返回某个列出的字段时，会改由更贵的数据源处理，并按它的价格报价和扣费。如果某个地点确实没有某个列出的字段，该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回，请求会作为无效输入被拒绝，不扣费。

你发送。 一个简短的 JSON 请求体。显示的值只是示例，请换成你自己的。

响应

JSON，每个字段一个示例值。

each itemdata.items[]

Business listing records: name, categories, rating, review count, address, and core business info. Populated whenever the provider has data for the entity.

address1string
2145 N Halsted St
Primary street address line.
address2string可设为必填
Secondary address line.
address3string可设为必填
Tertiary address line.
aliasstring
lous-deep-dish-kitchen-chicago
URL slug for the business. Populated whenever the provider has data for the entity.
avg_ratingnumber
4.5
Rounded average star rating.
categoriesobject[]
Business category tags.
citystring
Chicago
City name.
countrystring
US
ISO country code.
dialable_phonestring可设为必填
+13125550142
Dialable phone number.
idstring
abc123XyzChicagoDeepDish
Stable Yelp business identifier. Populated whenever the provider has data for the entity.
is_closedboolean可设为必填
false
Whether the business is permanently closed.
latitudenumber
41.9214
Latitude of the business.
localized_phonestring可设为必填
(312) 555-0142
Formatted local phone number.
localized_pricestring
$$
Localized price tier (e.g. $$).
longitudenumber
-87.6486
Longitude of the business.
namestring
Lou's Deep Dish Kitchen
Business display name. Populated whenever the provider has data for the entity.
neighborhoodsstring[]可设为必填
Neighborhood labels for the location.
phonestring
+13125550142
Raw phone number.
photo_countinteger可设为必填
384
Total photo count.
photo_urlstring
https://s3-media0.fl.yelpcdn.com/bphoto/9f2a1b7c6e4d8a3b5c1f0e2d4a6b8c9d/o.jpg
Primary photo URL. Populated whenever the provider has data for the entity.
priceinteger可设为必填
2
Numeric price tier.
review_countinteger
2418
Number of reviews.
statestring
IL
State or region code.
unrounded_avg_ratingnumber可设为必填
4.47
Unrounded average star rating.
urlstring
https://www.yelp.com/biz/lous-deep-dish-kitchen-chicago
Public Yelp business page URL.
zipstring
60614
Postal code.

top level

foundboolean
true
reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

你收到。 字段有名称、有类型，无论哪个数据源响应，结构都一样。

常见问题

关于 Yelp 搜索 API

AnyAPI 的 Yelp 搜索 API 只需一次 POST 请求 /v1/run/yelp.search，就以统一格式的 JSON 返回 Yelp 数据。按关键词和地点在 Yelp 上搜索商家：每次请求最多返回 20 个商家，包含评分、类别和核心商家信息。AnyAPI 会在 2 个数据源之间路由每个请求，某个数据源失败时自动切换。费用：每千次请求 US$2.50 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 Yelp 搜索 API 调用中有 93.8% 成功，响应时间中位数为 18.6 秒，共测量 65 次调用。

费用：每千次请求 US$2.50 起，以美元计价，无需订阅，也没有每月最低消费。你只需为一个美元钱包充值，每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用，我们按成本原价转嫁，不加价；错误响应会显示收取的金额。

按关键词和地点在 Yelp 上搜索商家：每次请求最多返回 20 个商家，包含评分、类别和核心商家信息。响应是统一格式的 JSON，外层结构与每个 AnyAPI 接口相同，所以解析另一个接口只需换一个 URL，别的都不用改。

过去 30 天，通过 AnyAPI 发起的 Yelp 搜索 API 调用中有 93.8% 成功，响应时间中位数为 18.6 秒，共测量 65 次调用。这些是 AnyAPI 对经过网关的流量的自有测量，持续重新计算，并非公开承诺的服务等级目标。

可以。新的 AnyAPI 账户自带 US$0.10 免费余额，无需绑卡，足够调用 40 次 Yelp 搜索，每次 US$0.0025。

AnyAPI 会在同一个请求中依次尝试它的 2 个数据源，从最便宜的开始，所以一个数据源宕机不会让你的调用失败。

向 https://api.getanyapi.com/v1/run/yelp.search 发送 POST 请求，在 “Authorization: Bearer” 请求头中放入你的 AnyAPI 密钥，并以 JSON 请求体传入参数。同一个密钥和同一个钱包适用于所有 AnyAPI 接口。

不需要。你向一个预付费的 AnyAPI 余额充值美元，每个请求从中扣费。没有月度套餐，也没有最低消费，同一个余额可用于所有 AnyAPI 接口。

有。TypeScript 用 npm 安装 @getanyapi/sdk，Python 用 pip 安装 getanyapi。两者都用同一个密钥调用所有 AnyAPI 接口，任何 HTTP 客户端也都可以。

可以。智能体可以连接 https://api.getanyapi.com/mcp 上的 AnyAPI MCP 服务器，或者向 https://api.getanyapi.com/agent/signup 发送一次无需认证的 POST 来创建自己的免费试用密钥，再通过 HTTP 调用这个接口。

一个密钥，一个钱包，
开始你的第一次 Yelp 调用。

领取 ~160 次免费请求

Yelp 搜索 API

Yelp 搜索 API 价格：一个 API，2 个可互换的服务商

一个请求获取 Yelp 搜索

一个请求，一种响应结构。

关于 Yelp 搜索 API

Yelp 搜索 API 怎么收费？

Yelp 搜索 API 返回什么？

Yelp 搜索 API 的可靠性如何？

Yelp 搜索 API 可以免费试用吗？

Yelp 搜索 API 的某个数据源失败时会怎样？

如何调用 Yelp 搜索 API？

使用 Yelp 搜索 API 需要订阅吗？

Yelp 搜索 API 有 SDK 吗？

AI 智能体可以使用 Yelp 搜索 API 吗？

一个密钥，一个钱包，开始你的第一次 Yelp 调用。

一个密钥，一个钱包，
开始你的第一次 Yelp 调用。