Yelp API

用 Yelp 商户链接读取经营资料、评分与点评，保留 useful、funny、cool 三类反馈票数和商户归属，便于逐店整理顾客意见。

请求发到 POST https://api.everyinfra.com/api/v1/social，platform 填 yelp，action 填下方列表里的能力名，例如 search。

3 个能力
$1.39 / 千次
失败和空结果都不收费

免费开始文档

平台运行状态

24h 健康值: 正常

30 天趋势

Yelp 能力清单

能力	做什么	24 小时运行状态 · 全部正常
关键词搜索`search`	从 coffee 等商户或服务词开始搜索，核对返回商户的实际地区。	正常
主页或对象详情`profile`	用 profile 读取一个商户的地址、分类与页面认领状态。	正常
评价`reviews`	用 reviews 阅读指定商户的点评样本，保留商户归属与原始日期。	正常

Yelp 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。请求都发到 POST /api/v1/social，切换 action 时，也要按对应接口调整参数。同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

所有能力都是同步调用。

能力	必填参数	可选参数	单次条数	返回字段
search	keyword	location	默认 10 · 最多 50	id · name · url · rating · rating_scale · review_count · price_range · categories · image_url · platform · phone · website · cuisine · description · address · city · region · postal_code · country · is_claimed · is_verified · health_score · established_year · images · amenities · highlights · hours
profile	url	—	—	id · name · url · rating · rating_scale · review_count · price_range · phone · website · categories · cuisine · description · address · city · region · postal_code · country · is_claimed · is_verified · health_score · established_year · image_url · platform · images · amenities · highlights · hours
reviews	url	page_token	默认 10 · 最多 10	id · text · rating · rating_scale · posted_at · author_name · useful_count · photo_count · business_name · business_url · platform · funny_count · cool_count

怎么调用 Yelp 关键词搜索 API？

search

使用 platform="yelp"、action="search" 调用“关键词搜索”能力；返回列表，默认 10 条、单次最多 50 条，主要包含 id、name、url、rating、rating_scale、review_count 等 27 个字段。

查看完整接口文档：参数、代码示例、响应样例与健康状态

Yelp search 的参数分别是什么意思？

keyword必填: 本地商户或服务关键词，例如 coffee；需要结合 location，否则默认在 New York 搜索，并非全球检索。
官方 Business Search 的 term 可为品类、商户名或关键词，location 可为城市、地区缩写或完整地址，并定义 best_match、rating、review_count、distance 四种排序；location 和 radius 都不是严格地理边界，且官方结果不包含零评论商户。EveryInfra 当前没有公开 sort。官方来源：Yelp Places API：Business Search 的 term 与 location来源核查：2026-09-05
location可选: 城市、街区或邮编位置，例如 Austin, TX 或 78701；这是商户所在地，不是评论作者位置。

Yelp 返回字段与含义（11）

categories: 商家分类。
cuisine: 菜系。
price_range: 价位档（$ 到 $$$$）。
health_score: 卫生检查评分（政府数据，餐厅类才有）。
is_claimed: 商家是否已认领主页。未认领说明店家不运营 Yelp，信息可能过时。
established_year: 开业年份。
postal_code: 邮编。
region: 区域。
hours: 营业时间，键是星期几的缩写（如 Mon），值是当天的营业时段原文；没有时不出现这个字段。
amenities: 设施与服务列表，按 Yelp 页面原文；没有时不出现这个字段。
highlights: Yelp 页面上的商家亮点标签，按页面原文；没有时不出现这个字段。

怎么调用 Yelp 主页或对象详情 API？

profile

使用 platform="yelp"、action="profile" 调用“主页或对象详情”能力；返回单个对象，主要包含 id、name、url、rating、rating_scale、review_count 等 27 个字段。

查看完整接口文档：参数、代码示例、响应样例与健康状态

Yelp profile 的参数分别是什么意思？

url必填: Yelp /biz/商户短名页面链接，用于读取商户资料；不是 Yelp 用户主页。
官方 Business Details 按 business ID 或 alias 获取名称、地址、电话、图片、rating、price 和 hours 等资料；官方 endpoint 不接收完整 /biz/ URL，也不保证零评论商户或完整评论正文。官方来源：Yelp：Business ID、alias 与商户详情来源核查：2026-09-05

Yelp 返回字段与含义（11）

categories: 商家分类。
cuisine: 菜系。
price_range: 价位档（$ 到 $$$$）。
health_score: 卫生检查评分（政府数据，餐厅类才有）。
is_claimed: 商家是否已认领主页。未认领说明店家不运营 Yelp，信息可能过时。
established_year: 开业年份。
postal_code: 邮编。
region: 区域。
hours: 营业时间，键是星期几的缩写（如 Mon），值是当天的营业时段原文；没有时不出现这个字段。
amenities: 设施与服务列表，按 Yelp 页面原文；没有时不出现这个字段。
highlights: Yelp 页面上的商家亮点标签，按页面原文；没有时不出现这个字段。

怎么调用 Yelp 评价 API？

reviews

使用 platform="yelp"、action="reviews" 调用“评价”能力；返回列表，默认 10 条、单次最多 10 条，主要包含 id、text、rating、rating_scale、posted_at、author_name 等 13 个字段。

查看完整接口文档：参数、代码示例、响应样例与健康状态

Yelp 说明当前未推荐的评论不计入商户整体星级或评论数量；因此任意抓取样本的条数与均分不能直接冒称网站汇总数字。官方来源：Yelp：未推荐评论与总评分的关系来源核查：2026-09-04

Yelp reviews 的参数分别是什么意思？

url必填: Yelp /biz/商户短名页面链接，用于读取该商户的评价；不是单条评价或用户主页链接。
page_token可选: 翻页令牌：把上一页响应里的 next_page_token 原样传回，拿这家商户的下一页评价（每页最多 10 条）；不传从第一页开始。url 须与上一页一致，令牌 24 小时有效，每页算一次调用。

Yelp 返回字段与含义（6）

business_name: 商家名称。
business_url: 商家页链接。
photo_count: 照片数。
useful_count: 评价被标 useful 次数。
funny_count: 评价被标 funny 次数。
cool_count: 评价被标 cool 次数（Yelp 特有的三维评价反馈）。

一次 Yelp search 调用的全过程：向 POST /api/v1/social 发送 platform="yelp"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、name、url、rating、rating_scale 等字段；返回列表，单次最多 50 条，计费 $1.39 / 千次，失败与空结果不计费。

Yelp 原始字段名

EveryInfra 统一字段名

左边是 Yelp 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。106 个平台复用通用字段命名，减少重复适配；切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

Yelp 的独有字段名（当前目录）

全站 106 个平台的当前目录中，这 8 个字段名只在 Yelp 出现。这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

price_range
cuisine
health_score
established_year
hours
business_url
funny_count
cool_count

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。机器可读版：/api/v1/social/fields

id: 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
name: 名称。用于账号/商品/商家类能力，指该对象本身的名字。
url: 该记录在原平台上的可访问链接。
rating: 评分。分制随平台而异，同一行的 rating_scale 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算。直接比数字会得出反的结论。
rating_scale: 上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
review_count: 评价条数，用于商品/商家类能力。null 表示不公开，不等于 0。
price_range: 价位档（$ 到 $$$$）。
categories: 商家分类。
image_url: 图片链接。多图能力可能返回 image_urls 数组。
platform: 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
phone: 联系电话，原文透传，未做号码格式归一。
website: 账号或商家填写的外链网址。
cuisine: 菜系。
description: 简介或描述，通常比 text 短。
address: 详细地址，原文透传。
city: 城市名，用原平台的语言书写，未做中英归一。
region: 区域。
postal_code: 邮编。
country: 国家或地区。可能是全称也可能是 ISO 代码，取决于平台，未归一。
is_claimed: 商家是否已认领主页。未认领说明店家不运营 Yelp，信息可能过时。
is_verified: 是否为平台认证账号（蓝V等）。null 表示无法判定。
health_score: 卫生检查评分（政府数据，餐厅类才有）。
established_year: 开业年份。
images: 图片链接数组，按平台展示顺序；没有图片时不出现这个字段。
amenities: 设施与服务列表，按 Yelp 页面原文；没有时不出现这个字段。
highlights: Yelp 页面上的商家亮点标签，按页面原文；没有时不出现这个字段。
hours: 营业时间，键是星期几的缩写（如 Mon），值是当天的营业时段原文；没有时不出现这个字段。
text: 正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。
posted_at: 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
author_name: 作者昵称（显示名）。
useful_count: 评价被标 useful 次数。
photo_count: 照片数。
business_name: 商家名称。
business_url: 商家页链接。
funny_count: 评价被标 funny 次数。
cool_count: 评价被标 cool 次数（Yelp 特有的三维评价反馈）。

请求填写示例

这里填写商家类别或名称；地点条件按该接口的地区参数设置。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

yelp_search.sh

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"yelp","action":"search","params":{"keyword":"coffee"}}'

记录字段预览（非真实响应）

仅展示 search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json

{
  "id": null,
  "name": null,
  "url": null,
  "rating": null,
  "rating_scale": null,
  "review_count": null,
  "price_range": null,
  "categories": null,
  "image_url": null,
  "platform": null,
  "phone": null,
  "website": null,
  "cuisine": null,
  "description": null,
  "address": null,
  "city": null,
  "region": null,
  "postal_code": null,
  "country": null,
  "is_claimed": null,
  "is_verified": null,
  "health_score": null,
  "established_year": null,
  "images": null,
  "amenities": null,
  "highlights": null,
  "hours": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

用 Yelp 发现本地商户与服务

从 coffee 等商户或服务词开始搜索，核对返回商户的实际地区。

查看 search 的 keyword 参数

keyword 不是评论全文搜索；结合 name、categories、address、city 与 region 确认商户，不把不同城市的同名商户合并。
当前公开参数目录未列 location、locations 或 region，不能承诺通过这些参数切换地区；现有实现缺省地点为 New York，本页不将它写成全球搜索。

按 Yelp 商户链接核对公开经营资料

用 profile 读取一个商户的地址、分类与页面认领状态。

查看 profile 的 url 参数

url 使用 /biz/ 商户短名链接；结合 name、address、categories、website、is_claimed 与 is_verified 核对资料，它不是 Yelp 用户主页。
认领页面不等于我们已核验商户资质，price_range 也不是具体服务报价；资料缺失不代表商户没有该项服务或已经停业。

整理 Yelp 点评正文与反馈票数

用 reviews 阅读指定商户的点评样本，保留商户归属与原始日期。

查看 reviews 的 url 参数

url 使用商户页面，结合 business_name、business_url、text、posted_at、useful_count、funny_count 与 cool_count 阅读；三种反馈票数不是同一种点赞。
作者姓名可能缺失，不据此编造身份；一次评论样本不等于商户总评论数，也不保证覆盖 Yelp 未推荐评论，不能据此重算并冒称官方总评分。

Yelp API 常见问题

Yelp API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="yelp"、action 和 params。以 search 为例，必填 keyword，可选 location。这里填写商家类别或名称；地点条件按该接口的地区参数设置。 Yelp 共 3 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 106 个平台。

Yelp API 怎么收费？

$1.39 / 千次，Yelp 全部 3 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 719 次 Yelp 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

Yelp API 一次能返回多少条数据？

Yelp 有 2 个列表接口，包括 search、reviews。其余 1 个接口返回单个对象；对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

Yelp API 返回哪些字段？

当前目录为 search 列出 id、name、url、rating、rating_scale、review_count 等 27 个字段名。按全站当前目录统计，8 个字段名只在 Yelp 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

「用 Yelp 发现本地商户与服务」怎样接入 Yelp API？

从 coffee 等商户或服务词开始搜索，核对返回商户的实际地区。 keyword 不是评论全文搜索；结合 name、categories、address、city 与 region 确认商户，不把不同城市的同名商户合并。当前公开参数目录未列 location、locations 或 region，不能承诺通过这些参数切换地区；现有实现缺省地点为 New York，本页不将它写成全球搜索。

「按 Yelp 商户链接核对公开经营资料」怎样接入 Yelp API？

用 profile 读取一个商户的地址、分类与页面认领状态。 url 使用 /biz/ 商户短名链接；结合 name、address、categories、website、is_claimed 与 is_verified 核对资料，它不是 Yelp 用户主页。认领页面不等于我们已核验商户资质，price_range 也不是具体服务报价；资料缺失不代表商户没有该项服务或已经停业。

「整理 Yelp 点评正文与反馈票数」怎样接入 Yelp API？

用 reviews 阅读指定商户的点评样本，保留商户归属与原始日期。 url 使用商户页面，结合 business_name、business_url、text、posted_at、useful_count、funny_count 与 cool_count 阅读；三种反馈票数不是同一种点赞。作者姓名可能缺失，不据此编造身份；一次评论样本不等于商户总评论数，也不保证覆盖 Yelp 未推荐评论，不能据此重算并冒称官方总评分。

可以先免费试用 Yelp API 吗？

可以。注册免费，在 GitHub 给 everyinfra/everyinfra-agent-plugins 和 everyinfra/seo-skills 两个仓库都点星，就能在控制台「余额与充值」领取 $1 额度（≈720 次数据调用），直接进赠送余额，不用输码，24 小⁠时内有效。请先选择 Yelp 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 3 个能力。无需信用卡。

Airbnb API App Store API Booking API Capterra API Clutch API Crexi API Dice API Expedia API 全部 106 平台 ↗

开始调用 Yelp API

在 GitHub 给两个仓库点星领 $1 额度，注册后在控制台领取，24 小⁠时内有效，先选一个 Yelp 接口验证结果。

免费开始

Yelp API

平台运行状态

Yelp 能力清单

Yelp 每个接口分别做什么

怎么调用 Yelp 关键词搜索 API？

Yelp search 的参数分别是什么意思？

怎么调用 Yelp 主页或对象详情 API？

Yelp profile 的参数分别是什么意思？

怎么调用 Yelp 评价 API？

Yelp reviews 的参数分别是什么意思？

Yelp 的独有字段名（当前目录）

返回字段含义

请求填写示例

记录字段预览（非真实响应）

常见用例

用 Yelp 发现本地商户与服务

按 Yelp 商户链接核对公开经营资料

整理 Yelp 点评正文与反馈票数

Yelp API 常见问题

Yelp API 怎么调用？

Yelp API 怎么收费？

Yelp API 一次能返回多少条数据？

Yelp API 返回哪些字段？

「用 Yelp 发现本地商户与服务」怎样接入 Yelp API？

「按 Yelp 商户链接核对公开经营资料」怎样接入 Yelp API？

「整理 Yelp 点评正文与反馈票数」怎样接入 Yelp API？

可以先免费试用 Yelp API 吗？

更多点评口碑 API

开始调用 Yelp API