查询 Yelp 商家分类
查看 Yelp 商家、评论与餐厅数据 的全部接口 →查询 Yelp 商家分类的名称、别名及父级关系。三个查询参数均为可选：country 使用 US 等两位国家代码，限定该国家使用的分类；parent 使用 restaurants 等父级分类别名，筛选该父级下的分类；query 按分类名称或别名中的文本匹配，例如 pizza。这些条件筛选的是分类定义，不是商家列表。 一次使用 country=US 和 query=pizza 的成功请求返回了一个对象，其中 count=1，categories 数组包含一项。已观测到的条目字段为 alias（pizza）、title（Pizza）、parent_aliases（包含 restaurants 的数组）和 countries（null）。应将 countries=null 视为国家元数据未指定，而不是全球支持的证据。这次单分类结果只确认了该示例中的父子关系，并未验证整个分类体系的覆盖范围。 文档称分类目录包含超过 1,500 个分类，并提供父级与支持国家的元数据。这一总量以及 countries 非空值的结构尚未独立验证。无匹配时的行为、观测结果以外的 count 含义，以及其他国家或父级筛选条件的覆盖范围也仍未验证。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/yelp/categories API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/yelp/categories?key=<API_KEY>'
查询结果
使用场景
- 构建显示返回分类名称、存储 Yelp 分类别名的选择器，并将已观测的 Pizza 归属 restaurants 关系作为测试示例。
- 通过匹配分类名称或别名规范内部商家目录的分类标签，不将分类查询接口误用为商家搜索。
- 依据返回的 parent_aliases 组织分类导航树，并使用文档中的 parent 筛选条件请求 restaurants 下的分类。
- 为本地商家数据集成准备按国家划分的分类映射，同时将 countries=null 保留为未指定，不把该分类标为全球支持。
常见问题
可以使用哪些分类筛选条件？
所有参数均为可选。country 是 US 等两位国家代码，parent 是 restaurants 等父级分类别名，query 用于匹配分类名称或别名中的文本，例如 pizza。无需使用特定的参数组合。
成功的分类响应中已观测到哪些字段？
country=US、query=pizza 的请求返回了 count=1，以及只含一项的 categories 数组。该条目中 alias=pizza、title=Pizza，parent_aliases 包含 restaurants，countries=null。其他结果以及 countries 非空值的结构尚未验证。
countries=null 是否代表该分类支持全球？
不是。应将 null 保留为国家元数据未指定。在 US 筛选条件下返回 Pizza 分类，并不能证明该分类在所有国家均受支持。
query=pizza 返回披萨餐厅，还是分类定义？
返回的是分类定义，不是商家列表。已观测结果为 Pizza 分类，其 alias 为 pizza，parent_aliases 包含 restaurants。
这次观测结果是否验证了完整分类目录？
没有。文档称目录包含超过 1,500 个分类，但已观测的筛选请求只返回一个分类。完整覆盖范围、无匹配时的行为及其他筛选条件下 count 的含义尚未独立验证。