按主题获取 Yelp 商家评论
查看 Yelp 商家、评论与餐厅数据 的全部接口 →获取一家 Yelp 商家与指定主题相关的评论。需提供商家别名、22 位商家 ID 或 Yelp 商家页面网址，以及从该商家的“评论主题”接口获取的主题名称。文档说明结果包含所选主题的相关评论及匹配片段，每页 20 条。page 默认值为 1，文档规定范围为 1–1000；本接口不提供 page_size 参数。 本接口没有已保存的响应实测记录，提供的响应示例也仅为空对象。主题相关评论和匹配片段属于文档描述的内容，尚无独立观察结果确认具体字段。现有证据无法确定 JSON 属性名称、片段结构、分页元数据、评论标识或无匹配结果时的行为，不要据此推断本接口沿用普通商家评论接口的响应结构。可用片段核查主题所依据的评论内容，但不要将主题标签视为顾客体验的完整概括或情感评分。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/yelp/reviews-by-topic API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/yelp/reviews-by-topic?key=<API_KEY>&business=gary-danko-san-francisco&page=1&topic=<topic>'
查询结果
使用场景
- 选择餐厅返回的服务主题，整理匹配评论片段，作为服务质量复盘的专题证据材料。
- 让门店运营人员在分享内部问题摘要前，核查主题标签背后的片段是否真正支持摘要中的表述。
- 比较指定门店中相同返回主题的支撑评论片段，保留各门店自己的主题名称，不将其当作情感评分。
- 建立人工审核的主题调查队列，记录请求的商家、主题和页码，仅在确认实际响应结构后定稿解析逻辑。
常见问题
topic 的值应从哪里获取？
请使用同一家商家的“评论主题”接口返回的主题名称。service 是文档中的示例，不代表每家商家都一定提供这一主题。
主题筛选与关键词搜索是一回事吗？
不是。topic 用于选择“评论主题”接口提供的名称。本接口没有普通评论接口中的 query 参数，因此不要假定任意关键词都能匹配到一个主题。
可以调整每页主题评论的条数吗？
文档规定每页 20 条，本接口提供 page，但不提供 page_size。page 默认值为 1，文档规定范围为 1–1000。实际返回条数及各页是否可获取尚未独立验证。
哪些响应字段和片段格式已经验证？
本接口尚无经过独立验证的响应字段。文档说明会返回所选主题的相关评论及匹配片段，但没有已保存的实测记录，提供的示例也仅为空对象。依赖解析逻辑前，请先确认实际字段名、分页元数据和片段结构。
主题匹配片段能说明顾客的整体情感倾向吗？
不能。匹配片段只是所选主题的支撑内容，文档并未将其定义为情感评分，也不能据此证明该主题代表所有评论。请阅读返回片段，并保留对应的商家和主题信息。