获取 Yelp 评价主题与情感占比
查看 Yelp 商家、评论与餐厅数据 的全部接口 →查询某家 Yelp 商家的评价讨论主题，例如餐食、服务或环境。必填参数 business 支持 Yelp 商家别名、22 位商家 ID 或 Yelp 商家页面 URL。文档未列出主题筛选或分页参数。 文档描述的返回内容包括评价主题、各主题的评价数量及情感占比。目前没有包含实际主题数据的响应示例，也没有该接口的成功响应观测记录。因此，具体 JSON 字段名、情感标签、占比单位、聚合覆盖范围及空结果行为均未验证；不要预设占比采用百分比，也不要假定存在某种固定的情感分类。 应将这些结果视为接口报告的主题汇总数据，而非基于本地完整评价语料计算出的情感分析。若要通过单独的 reviews-by-topic 接口获取某个主题的评价，请使用本接口实际返回的主题值，不要自行构造主题标识，也不要用商家分类别名替代。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/yelp/review-topics API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/yelp/review-topics?key=<API_KEY>&business=gary-danko-san-francisco'
查询结果
使用场景
- 比较选定门店的餐食、服务或环境主题讨论量，同时保留各自的商家标识和采集日期。
- 先向分析人员展示实际返回的评价主题，再由其选择主题获取相关评价，避免使用虚构的主题标识。
- 编写门店简报时，将接口报告的主题情感汇总与基于独立采集评价语料计算的情感分析明确区分。
- 通过已保存快照跟踪某家商家的主题评价数量及情感占比变化，不宣称覆盖全部评价，也不据此推断变化原因。
常见问题
查询评价主题时如何指定商家？
将 business 设为 Yelp 商家别名、22 位商家 ID 或 Yelp 商家页面 URL。该接口查询的是某一家商家的主题，不用于搜索商家。
可用主题只有餐食、服务和环境吗？
文档没有提供固定主题清单。这些只是文档中的评价主题示例，请以所选商家实际返回的主题为准。
文档中的评价数量和情感占比分别表示什么？
它们是与评价主题关联的汇总数据。具体字段名、情感标签、占比单位及聚合覆盖范围均未验证，因此不要假设占比采用百分比，也不要假设各主题评价数之和等于商家的评价总数。
能否获取这里返回的某个主题下的评价？
单独的 reviews-by-topic 接口用于按主题获取评价。请求时应使用这里实际返回的主题值，不要自行构造标识，也不要用商家分类别名代替。本接口只获取主题汇总数据，不返回可分页浏览的评价列表。
是否已观测到包含实际主题数据的响应？
目前没有包含实际主题数据的响应示例，也没有该接口的成功响应观测记录。主题、评价数量和情感占比属于文档描述的能力，其具体 JSON 结构和空结果行为尚未独立确认。