获取 Yelp 搜索词与商家联想建议
查看 Yelp 商家、评论与餐厅数据 的全部接口 →根据必填的 query 获取搜索联想建议，可输入 piz 这样的部分搜索词。可选的 location 用于提供地理位置上下文，让建议更贴近目标地区。文档列出的建议类型包括分类、热门搜索短语和匹配商家。目前没有该接口的非空响应独立验证记录，提供的响应示例也是空对象，因此尚未确认建议的属性名、分组键或商家标识符字段。应将这些建议类型视为文档描述的能力，而不是已经确认的响应结构。联想建议不构成完整商家名录，热门搜索建议也不能证明实际搜索量。
API 功能
从部分词语生成联想 必填的 query 可使用 piz 这样的词语片段，无须输入完整商家名称或完整搜索短语。
按地点提供补全上下文 可选填 San Francisco, CA 等地点，为文档所述的联想查询提供本地上下文。
探索分类与搜索措辞 文档描述了分类建议和热门搜索短语，但其响应键名及分组方式尚未经过独立验证。
提供商家名称匹配线索 匹配商家是文档列出的建议类型之一。将建议视为已确认商家之前，应先核实实际响应结构及对应门店。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/yelp/search-autocomplete API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/yelp/search-autocomplete?key=<API_KEY>&query=piz'
curl -X GET 'https://api.opendata-api.com/api/project/yelp/search-autocomplete?key=<API_KEY>&query=piz'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 确认实际返回结构后，在输入联想菜单中分别展示分类、搜索短语和商家候选项。
- 帮助本地指南编辑为指定城市寻找推荐的菜系或服务用语，但不将这些措辞视为搜索需求量的依据。
- 先根据不完整名称提供建议，再让操作人员通过单独查询确认目标商家的具体门店。
- 为旅行规划工具设计符合目的地的搜索提示，将建议作为候选清单，而非完整商家名录。
常见问题
搜索自动补全必须提供哪个参数？
query 为必填字符串，用于传入 piz 这样的部分搜索词。location 为可选参数。
可以按城市调整联想建议吗？
可以。文档说明 location 用于按地点调整建议，例如 San Francisco, CA。不过，该接口的非空响应尚未经过独立验证。
文档列出了哪些建议类型？
文档列出了分类、热门搜索短语和匹配商家。这些属于文档描述的建议类型，并非已经独立确认的响应分组。
响应属性名是否已经确认？
现有资料尚未确认任何响应属性名。提供的响应示例是空对象，也没有该接口的非空响应记录，因此不要预设具体的分组键或商家标识符字段。
能直接将一条建议保存为唯一商家门店吗？
不能在未经确认的情况下这样做。分类或搜索短语不等于商家，仅凭商家名称也可能无法区分不同门店。保存商家记录前，应先确认建议类型和目标门店。
热门建议是否提供搜索量？
文档未说明搜索量指标，现有响应记录也未体现此类指标。建议仅适合用于寻找搜索措辞，不能作为流量、需求量或排名热度的证据。