批量查询最多 20 家已知 Yelp 商家
查看 Yelp 商家、评论与餐厅数据 的全部接口 →根据已知 Yelp 商家标识列表，批量获取精简商家信息。必填查询参数 businesses 是一个以英文逗号分隔的字符串，每次最多包含 20 个商家别名、ID 或 Yelp 商家页面链接。此接口用于按标识补全商家资料，不是按地点搜索或全城商家发现接口。 文档列出的返回信息包括评分、电话、网站、地址、坐标和照片。这些是文档描述的信息类别，并非已确认的 JSON 字段名：目前没有实际批量响应的观测结果，所给响应示例也只有一个空对象。响应外层结构、记录顺序、未匹配输入的表示方式，以及部分查询失败时的处理方式均未验证。将其用于正式数据导入前，应先确认这些细节，不要直接按结果位置与输入逐项匹配。
API 功能
单次最多提交 20 个商家标识 按照文档规定的批量上限，将最多 20 个已知商家标识放入同一个以英文逗号分隔的查询参数值中。
支持别名、ID 与商家链接 使用文档支持的商家别名、商家 ID 或 Yelp 商家页面链接，无需构造商家名称与地点的搜索条件。
面向门店列表的精简资料补全 文档描述了评分、电话、网站、地址、坐标和照片等信息，适合规划商家列表补全；具体响应结构尚未验证。
明确批量结果的匹配验证边界 接入时需验证结果如何对应输入，以及单个商家查询失败时如何表示；所给空对象示例无法说明结果顺序或部分成功规则。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/yelp/batch-business-lookup API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/yelp/batch-business-lookup?key=<API_KEY>&businesses=gary-danko-san-francisco%2Ctonys-pizza-napoletana-san-francisco'
curl -X GET 'https://api.opendata-api.com/api/project/yelp/batch-business-lookup?key=<API_KEY>&businesses=gary-danko-san-francisco%2Ctonys-pizza-napoletana-san-francisco'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 将已匹配 Yelp 标识的 CRM 商家清单按每组最多 20 家更新，合并单个商家记录前先检查实际返回结构。
- 将文档描述的电话、网站、地址和坐标与内部门店主数据比对，标记需要进一步查询完整档案的记录。
- 为已知商家候选清单整理精简对比数据，不将该查询当作覆盖全城的潜在客户搜索。
- 设计保留每个提交标识的资料补全导入流程，确认实际批量结果匹配方式后，再核对未能解析的条目。
常见问题
businesses 参数应该填写什么？
填写一个以英文逗号分隔的字符串，内容为已知 Yelp 商家的别名、ID 或商家页面链接。文档规定每次最多提交 20 个标识；此参数是字符串，不是 JSON 数组。
此接口能发现某个城市的所有商家吗？
不能。它仅接收已知商家标识，不提供地点、分类或全城商家发现的输入参数。
哪些返回信息仅有文档说明，哪些经过实际观测？
文档列出了评分、电话、网站、地址、坐标和照片信息。目前没有实际批量响应的观测结果，所给响应示例也只是空对象，因此具体 JSON 字段名和响应外层结构仍未验证。
可以按数组位置将结果与输入对应吗？
不要假定可以按位置匹配。现有资料无法确定结果顺序、未匹配标识的表示方式或部分失败的处理方式；更新自身记录前，应先验证这些行为。