获取单家 Yelp 商家的详细档案
查看 Yelp 商家、评论与餐厅数据 的全部接口 →通过必填查询参数 business 获取一家已知 Yelp 商家的档案。参数支持商家别名、22 位商家 ID 或 Yelp 商家页面链接。将资料关联到自己的记录前，请先确认选中的是目标门店。 实际观测到的一次成功响应为商家对象，包含 id、alias、name、rating 和 review_count，以及地址、联系信息、营业时间、设施与服务信息和 popular_dishes。测试中的 Gary Danko 档案返回 rating 为 4.5、review_count 为 6148；这些只是样本观测值，不是固定数值，也不代表数据时效承诺。文档还列出了电话、网站和卫生评分信息，但实际响应摘要未确认是否提供卫生评分。 所给响应示例还包含 about、alternate_links 和 alternate_names。其中可见的 about 字段包括 history、owner、specialties 和 year_established；地址字段包括 city、country_code、formatted、line1、line2、line3、postal_code 和 state。示例中的 amenities 条目还包含 name 和 is_available。这些示例特有的结构未在实际测试摘要中得到独立验证，示例本身也不完整。不要将未返回的属性直接视为否或不可用。针对一个故意构造的不存在商家的查询，测试返回 HTTP 404 和 error 字段，因此调用方应将未找到商家的响应与成功获取档案的响应分开处理。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/yelp/business-details API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/yelp/business-details?key=<API_KEY>&business=gary-danko-san-francisco'
查询结果
使用场景
- 为已确认的餐厅门店补充联系方式、营业时间与设施服务信息，对未返回的服务属性保留未知状态。
- 制作商家目录资料卡，同时保留实际返回的 id、alias、rating 和 review_count，并在应用侧记录获取时间，以便决定后续何时刷新。
- 将现有门店记录与返回的地址和联系信息交叉核对，再关联该门店另行获取的评价或照片。
- 将返回 HTTP 404 的商家查询送入标识修正队列，避免把空档案当作有效商家记录保存。
- 开发场所信息面板原型，展示 popular_dishes 及可选商家背景，仅渲染该场所实际返回的属性。
常见问题
business 参数支持哪些商家标识？
支持 Yelp 商家别名、22 位商家 ID 或 Yelp 商家页面链接。此必填查询参数只指定一家商家，不接收以逗号分隔的批量列表。
哪些商家档案字段经过实际观测？
一次成功响应包含 id、alias、name、rating、review_count、地址与联系信息、营业时间、amenities 和 popular_dishes。这只是单家商家的档案观测，不能据此认定所有商家都会返回全部属性。
一定会返回卫生评分和商家背景信息吗？
不一定。卫生评分仅有文档说明，about、alternate_links 和 alternate_names 出现在不完整的响应示例中。实际响应摘要未独立确认这些字段，也未证明所有商家都提供这些信息。
商家不存在时会返回什么？
针对不存在商家的测试返回了 HTTP 404，并包含说明商家未找到情况的 error 字段。应单独处理这类非成功响应，不要将其视为成功返回但没有属性的商家档案。
示例中的评分和评价数量是每次调用的最新数值吗？
不是。rating 为 4.5、review_count 为 6148 是测试中 Gary Danko 响应的样本数值。现有资料不能确定更新频率，也不保证实时准确性。
某项设施服务未返回，是否表示商家不提供？
不一定。应区分明确返回的可用性值与未返回的属性。所给示例中的设施服务条目包含 name 和 is_available，但仅凭数据缺失不能证明商家不提供某项服务。