按分类与关键词筛选 Yelp 用户点评
查看 Yelp 商家、评论与餐厅数据 的全部接口 →分页查询指定 Yelp 贡献者撰写的点评，可选用分类、关键词和排序条件。必填参数 user 支持 22 个字符的 Yelp 用户 ID 或 Yelp 个人主页链接。category 支持 Yelp 分类别名（如 pizza）、分类名称（如 Coffee & Tea），或包含 cflt= 的 Yelp 搜索链接。query 用于请求提及指定关键词（如 noodles）的点评，文档未进一步说明匹配规则。sort_by 支持 newest、oldest、highest_rated 和 lowest_rated；不传时使用 Yelp 默认排序，文档未说明该默认排序是否对应上述某个选项。page 的取值范围为 1–1000，文档默认值为 1；page_size 的取值范围为 1–50，文档默认值为 20。 接口文档描述了用户撰写的点评及其所评商家。该接口尚无已观测响应，提供的成功示例仅为空对象（{}）。点评与商家的关联属于文档描述的能力，并非已验证的 JSON 字段。确切的点评及商家字段名、是否提供评分、日期或正文、分页元数据及缺失值的处理方式均未确认。请将结果视为限定范围的点评历史快照，不承诺获取全部点评，不据此推断实际到访，也不根据返回内容作出身份或欺诈判定。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/yelp/user-reviews API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/yelp/user-reviews?key=<API_KEY>&user=CHV3OXUzMbMDZ5A07UGO5A'
查询结果
使用场景
- 应贡献者要求整理其点评历史快照，记录分类、关键词、排序和页码条件，明确标记缺失页面，不宣称是完整的账号数据导出。
- 为已知贡献者建立披萨相关点评阅读清单，使用 category=pizza，并在数据可用时保留每条点评与所评商家的关联。
- 应用户要求查找某位贡献者提及 noodles 的点评，用于专题内容查看，不假设文档未说明的搜索匹配规则。
- 在经批准的贡献者研究中，对比 highest_rated 与 lowest_rated 两种排序下的点评样本，说明排序条件，不推断实际到访或欺诈行为。
常见问题
查询用户点评时，支持哪些贡献者标识？
必填参数 user 支持 22 个字符的 Yelp 用户 ID 或 Yelp 个人主页链接。该接口请求的是这位贡献者撰写的点评，而不是某家商家的全部点评。
category 可以传入哪些值来筛选用户点评？
根据文档，可以传入 pizza、italian 等 Yelp 分类别名，Coffee & Tea 等分类名称，或包含 cflt= 的 Yelp 搜索链接。不需要这一筛选条件时，可不传 category。
关键词筛选如何使用？
将 query 设为 noodles 等关键词，即可请求提及该词的点评。文档未明确是否区分大小写、是否进行词干匹配以及其他匹配规则，因此不应假设这些行为。
能否按日期或评分排列用户点评？
sort_by 支持 newest、oldest、highest_rated 和 lowest_rated。不传时使用 Yelp 默认排序；文档未说明其默认值是 newest 或其他任何已列出的选项。
分页设置能保证获取完整的点评历史吗？
不能。page 支持 1–1000，文档默认值为 1；page_size 支持 1–50，文档默认值为 20。这些范围不代表所有点评或页面均可获取，请在快照中记录筛选条件及缺失页面。
哪些点评响应字段已经过验证？
该接口尚无已观测响应，因此没有已验证的响应字段。文档描述了点评及其所评商家，但提供的成功示例仅为 {}。确切 JSON 字段名、是否提供评分、日期或正文、分页元数据和缺失值的处理方式仍未确认。