点评口碑 · 数据 API

Yelp API

用 Yelp 商户链接读取经营资料、评分与点评，保留 useful、funny、cool 三类反馈票数和商户归属，便于逐店整理顾客意见。调用 POST /api/v1/social ；返回结构化 JSON，$1.39 / 千次；失败不计费。

免费开始看文档

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Yelp 能力清单

action	必填参数	可选参数	单次条数	模式	单价	返回字段
search	keyword	location	默认 10 · 最多 50	同步	$1.39 / 千次	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
profile	url	—	—	同步	$1.39 / 千次	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	—	默认 10 · 最多 50	同步	$1.39 / 千次	text · rating · rating_scale · posted_at · author_name · useful_count · funny_count · cool_count · photo_count · business_name · business_url · platform

Yelp 每个接口分别做什么

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

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

怎么调用 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 特有返回字段与含义（8）

categories: 商家分类。
cuisine: 菜系。
price_range: 价位档（$ 到 $$$$）。
health_score: 卫生检查评分（政府数据，餐厅类才有）。
is_claimed: 商家是否已认领主页。未认领说明店家不运营 Yelp，信息可能过时。
established_year: 开业年份。
postal_code: 邮编。
region: 区域。

怎么调用 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 特有返回字段与含义（8）

categories: 商家分类。
cuisine: 菜系。
price_range: 价位档（$ 到 $$$$）。
health_score: 卫生检查评分（政府数据，餐厅类才有）。
is_claimed: 商家是否已认领主页。未认领说明店家不运营 Yelp，信息可能过时。
established_year: 开业年份。
postal_code: 邮编。
region: 区域。

怎么调用 Yelp 评价 API？

reviews

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

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

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

url必填: Yelp /biz/商户短名页面链接，用于读取该商户的评价；不是单条评价或用户主页链接。

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

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

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

price_range
cuisine
health_score
established_year
hours
funny_count
cool_count
business_url

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。机器可读版：/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: 价位档（$ 到 $$$$）。
phone: 联系电话，原文透传，未做号码格式归一。
website: 账号或商家填写的外链网址。
categories: 商家分类。
cuisine: 菜系。
description: 简介或描述，通常比 text 短。
address: 详细地址，原文透传。
city: 城市名，用原平台的语言书写，未做中英归一。
region: 区域。
postal_code: 邮编。
country: 国家或地区。可能是全称也可能是 ISO 代码，取决于平台，未归一。
is_claimed: 商家是否已认领主页。未认领说明店家不运营 Yelp，信息可能过时。
is_verified: 是否为平台认证账号（蓝V等）。null 表示无法判定。
health_score: 卫生检查评分（政府数据，餐厅类才有）。
established_year: 开业年份。
image_url: 图片链接。多图能力可能返回 image_urls 数组。
platform: 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
text: 正文内容，已去除 HTML 标签。长文可能被截断。
posted_at: 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
author_name: 作者昵称（显示名）。
useful_count: 评价被标 useful 次数。
funny_count: 评价被标 funny 次数。
cool_count: 评价被标 cool 次数（Yelp 特有的三维评价反馈）。
photo_count: 照片数。
business_name: 商家名称。
business_url: 商家页链接。

当前目录另列出 images · amenities · highlights · hours，这些字段尚无逐项释义；请先核对 Yelp 对应接口的用例与实际响应，不按字段名猜测类型或含义。

请求填写示例

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

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

yelp_search.sh

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的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,
  "phone": null,
  "website": null,
  "categories": 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,
  "image_url": null,
  "platform": 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 通 89 个平台。

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 吗？

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 Yelp 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 3 个能力。无需信用卡。

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

开始调用 Yelp API

加微信领 $1 免费额度，先选一个 Yelp 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始