按名称和地点查找 Yelp 候选商家
查看 Yelp 商家、评论与餐厅数据 的全部接口 →通过必填的 query 和 location 字符串查找少量 Yelp 候选商家。query 支持商家名称或关键词，文档默认值为 coffee；location 支持城市、街区、地址或邮政编码。可选的整数参数 limit 在文档中的默认值为 10，允许范围为 1 至 25。已有一条 HTTP 200 响应记录：以 Golden Boy Pizza 为搜索词、San Francisco, CA 为地点并设置 limit=3，请求返回了一个包含 results 的对象，其中有三个商家地点，包括两家旧金山门店。记录中的商家数据包含标识符、别名、评分、电话、网站和结构化地址。上述字段由该次响应记录支持；单独提供的静态响应示例为空对象，不能据此确认其他属性名、地址子字段、分页字段或可用性保证。1 至 25 的范围及默认值 10 来自文档，尚未独立测试边界行为。选择用于后续详情、菜单或评论查询的标识符前，应先比较门店地址和电话。此接口用于查找候选商家，不是完整城市商家名录，不保证名称精确匹配，也不能替代完整商家搜索；它不接受分类、价格、距离或服务筛选条件。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/yelp/quick-search API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/yelp/quick-search?key=<API_KEY>&location=<location>&query=coffee'
查询结果
使用场景
- 按已知餐厅名称和城市查找候选项，比较返回的地址与电话后，再选定用于详情、菜单或评论请求的标识符。
- 将已观察到的 Golden Boy Pizza 结果用于同名歧义测试，在两个候选项名称和城市均相同时要求明确选择门店。
- 按文档规定的最多 25 个候选项建立小规模、由操作人员审核的门店清单，而不声称覆盖全城商家。
- 结合候选商家的评分、网站和结构化地址核对本地场所记录，将无法确定的匹配交由人工复核。
常见问题
快速搜索需要哪些必填参数？
query 和 location 都是必填字符串。query 可填写商家名称或 coffee 等关键词；location 支持城市、街区、地址或邮政编码。limit 为可选参数，类型必须是整数。
一次可以请求多少家商家？
文档规定 limit 的取值范围为 1 至 25，省略时默认值为 10。已有成功请求记录使用了 limit=3，但范围边界和省略 limit 时的行为尚未经过独立测试。
实际观察到了哪些响应字段？
已有响应记录是一个包含 results 的对象，其中的商家记录含标识符、别名、评分、电话、网站和结构化地址。另行提供的静态响应示例为空，因此不能补充确认其他字段名或地址子字段。某字段出现在这次记录中，也不代表所有商家都会提供该字段的值。
同一个商家名称可能对应多家门店吗？
可能。以 Golden Boy Pizza 为搜索词、San Francisco, CA 为地点的请求返回了三个地点，其中两家在旧金山。应根据返回的地址和其他身份信息明确选择门店，而不是自动采用第一条结果。
返回的标识符可以用于获取更多商家数据吗？
可以将选定商家的标识符用于后续独立的详情、菜单或评论查询，并遵守相应接口的输入要求。请先确认目标门店；菜单是否可用、评论历史是否完整均不保证。
快速搜索支持分类或距离筛选吗？
不支持。此接口仅有 limit、location 和 query 三个参数，不能将搜索筛选选项接口描述的条件传入快速搜索。
此接口是完整商家名录或精确匹配工具吗？
不是。它根据名称或关键词与地点返回数量有限的候选商家。应核对返回的身份信息和地址，不要假定结果涵盖全部本地商家，也不要默认第一条候选项就是目标门店。