查询 ASOS 分类导航
查看 ASOS 商品搜索、价格与尺码库存 API 的全部接口 →获取 ASOS 分类导航,可通过 country 和 lang 指定国家及语言环境。文档示例为 country=US、lang=en-US,未说明省略参数时的默认值。一次成功的 US/en-US 观测返回了一个对象,其中 navigation、brands、footer 三个数组分别包含 2、5、3 个条目,并带有嵌套的 children;这些数量仅代表该次观测,并非固定限制。需要递归检查 children,才能找到指向商品列表的链接:已观测到的“查看全部”节点通过 link.categoryId=4209 指向美国市场的男士鞋靴及运动鞋分类。用于查询商品列表的分类 ID 与导航节点自身的标识符不同,应分别保存。未经验证的文档示例还列出了 alias、id、type、content、display、link 等节点字段,以及标题、图片元数据和 webUrl、appUrl、linkType 等链接字段;现有观测摘要并未逐一确认这些附加字段。本接口提供导航元数据,不直接返回商品列表或库存。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/asos/categories-list API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/asos/categories-list?key=<API_KEY>'
查询结果
使用场景
- 递归遍历 children,仅保留带有商品列表分类引用的节点,构建面向指定市场的分类选择器。
- 以已观测到的 link.categoryId 4209 为起点,定期采集美国男鞋品类的商品范围,并单独保存其导航路径。
- 对比已保存的导航快照,识别分类名称或分支位置变化,而不擅自替换采集任务使用的分类 ID。
- 先对三类导航分区进行归类,再提取目标链接,避免品牌及页脚链接混入纯商品分类索引。
常见问题
country 和 lang 应如何填写?
两个参数均为可选。country 使用两位国家代码,lang 使用语言代码。文档示例 US 和 en-US 已用于一次成功观测,但未确认省略参数后的行为,也没有完整验证所有可用组合。
返回结果是扁平的 ASOS 分类列表吗?
不是。已观测到的响应是包含 navigation、brands 和 footer 数组的对象,内部还有嵌套的 children。应遍历层级并检查各节点的链接,再判断它是否属于商品分类。
查询分类下的商品时应该使用哪个 ID?
应使用指向商品列表的节点中的 link.categoryId,而不是导航节点自身的标识符。一次观测中,“查看全部”节点提供了 categoryId 4209,对应美国市场的男士鞋靴及运动鞋。这个示例不能证明其他市场也使用相同的分类 ID。
导航分区的条目数量和示例中的附加字段有保证吗?
没有。navigation 为 2 条、brands 为 5 条、footer 为 3 条,仅是一次 US/en-US 观测的结果。未经验证的文档示例中出现的其他节点元数据,不构成已完整验证的响应约定。本接口本身也不提供商品价格或库存。