查看 Yelp 搜索筛选选项
查看 Yelp 商家、评论与餐厅数据 的全部接口 →查看文档中针对特定 Yelp 搜索场景提供的筛选选项。location 为必填参数，支持城市、街区、地址或邮政编码，文档默认值为 Austin, TX。还可通过 query 指定搜索词，或通过 category 指定 Yelp 分类别名、分类名称，或含有 cflt= 的 Yelp 搜索网址。文档列出的筛选分组涵盖价格、特色、分类、距离和服务类型。该接口没有非空响应记录，提供的响应示例也是空对象，因此尚未确认具体响应字段名、选项标识符、分组结构以及各筛选项是否可用。此接口仅用于了解筛选选项，不执行带筛选条件的商家搜索。本项目未包含主要商家搜索接口，快速搜索也不接受这些筛选选项。
API 功能
按地理范围查看筛选能力 通过必填的 location 指定城市、街区、地址或邮政编码，确定需要查看筛选选项的搜索场景。
支持多种分类上下文输入 可选的 category 支持 Yelp 分类别名、分类名称或含有 cflt= 的 Yelp 搜索网址，用于进一步限定文档描述的筛选场景。
针对关键词检查可选条件 可选填 plumbers 等 query 搜索词，查看文档针对相应服务或商家搜索场景描述的筛选能力。
涵盖价格距离等筛选分组 文档列出了价格、特色、分类、距离和服务类型分组，但具体选项值和响应字段名尚未验证。
明确选项查看与搜索执行边界 此接口仅查看筛选选项。本项目没有主要商家搜索接口，快速搜索也没有可用于应用这些筛选条件的输入参数。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/yelp/search-filters API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/yelp/search-filters?key=<API_KEY>&location=Austin%2C+TX'
curl -X GET 'https://api.opendata-api.com/api/project/yelp/search-filters?key=<API_KEY>&location=Austin%2C+TX'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 为本地搜索产品设计核对文档描述的价格、距离与服务筛选能力，但不承诺这些条件可以用于执行搜索。
- 在确认响应结构后，建立包含搜索词和地点的测试样例，保留返回筛选标签的查询上下文，供后续兼容性检查使用。
- 为拟建的分类专属界面核查各筛选分组是否有资料支持，再决定是否启用对应控件。
- 在搜索接入说明中单独呈现筛选选项查看功能，并保持筛选搜索功能关闭，因为快速搜索不接受这些选项。
常见问题
哪些参数用于确定筛选场景？
location 为必填参数。query 和 category 为可选字符串，可进一步描述搜索场景。文档给出的默认地点是 Austin, TX。
category 可以填写哪些内容？
文档支持 pizza、italian 等 Yelp 分类别名，Coffee & Tea 等分类名称，或含有 cflt= 的 Yelp 搜索网址。现有资料未提供固定的分类枚举。
文档列出了哪些筛选分组？
文档列出了价格、特色、分类、距离和服务类型。该接口没有非空响应记录，因此现有资料不能确认某个具体场景会返回哪些分组或选项。
响应键名和选项值是否经过验证？
没有。提供的响应示例是空对象，也没有该接口的非空响应记录。在编写响应解析逻辑前，需要先确认属性名、选项标识符和分组结构。
此接口是否返回筛选后的商家？
现有文档未描述筛选后的商家结果响应。此接口用于查看筛选选项，而不是执行带筛选条件的商家搜索。
可以将这些选项用于快速搜索吗？
不可以。快速搜索只接受 limit、location 和 query，不接受分类、价格、距离、特色或服务类型筛选条件。本项目也未包含主要商家搜索接口。