按地区、分类和筛选条件分页浏览 ASOS 商品

查看 ASOS 商品搜索、价格与尺码库存 API 的全部接口 →

查询指定分类下的商品,必须提供数值型 categoryId、offset、limit,以及取自国家查询结果的字符串型 store。可选的 country、currency、lang 和 sizeSchema 用于指定地区环境。文档列出的筛选项包括以逗号分隔的品牌、尺码、颜色及属性 ID,整数价格边界 priceMin/priceMax,以及 range;排序值为 freshness、priceasc 和 pricedesc。所提供的美国分类测试使用 categoryId=4209、offset=0、limit=10 和 freshness 排序,获得 HTTP 200,返回 categoryName='Shoes, Boots & Sneakers'、itemCount=1523、10 件商品和 10 个分面筛选项。首件商品为 ID 210916181 的 ASOS DESIGN 双扣带孟克鞋,当时的美元现价为 94.99。itemCount 只是响应报告的数量,不等于当前页行数,也不能证明可完整采集所有商品。另一次关键词测试同样返回 HTTP 200,但 itemCount=0、products=[]、facets=[]、categoryName=null,且 searchPassMeta.isPartial 和 isSpellcheck 均为 false;searchTerm 将传入词重复回显了两次,中间以逗号分隔。单次结果不足以解释所有空搜索的原因。q 的说明要求不要与 categoryId 同时使用,但此接口定义仍将 categoryId 列为必填;仅传关键词的测试不能取消这一约束。所提供的截断示例还列出了 diagnostics,以及 facets[].facetValues[] 中的 id、name、count、isSelected 和分面元数据 displayStyle、facetType、hasSelectedValues。这些嵌套示例字段和可选筛选组合未由测试摘要独立证实。可保存商品 ID,后续另行查询详情或库存;列表数据不提供精确库存件数、销量排名或内置价格历史。

API 功能

美国鞋履分类的实测商品页 所提供的分类 4209 测试返回 10 件商品,报告 itemCount 为 1523;其中商品 ID 210916181 可用于后续详情与库存查询。
新版逗号分隔多选筛选 文档将品牌、颜色、尺码和属性筛选定义为逗号分隔的 ID 字符串。应从分类元数据中获取可选值,而不是自行假设枚举值。
固定地区环境的分页采样 使用 offset 和 limit 采集有数量上限的分类样本时,保持 store、country、currency、lang 和 sizeSchema 一致。
保留空搜索的诊断信号 所提供的无匹配关键词测试返回空的 products 和 facets,itemCount 为 0。排查空结果时,应同时保留 searchTerm 和 searchPassMeta 标记。
区分报告总数与本页条数 分别记录 itemCount 和 products.length,并按商品 ID 去重;报告数量和列表位置都不能用来证明销量或热度。

在线 API 演示

GET /api/project/asos/products-v2-list

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/asos/products-v2-list?key=<API_KEY>&categoryId=<categoryId>&limit=<limit>&offset=<offset>&store=<store>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

itemCount 与 products 数组长度有什么区别?

itemCount 是当前查询条件下响应报告的数量,products 则是本次返回的商品页。所提供的分类测试中,itemCount=1523,但 limit=10 时只返回了 10 件商品。这不能证明报告中的每一件商品都能被完整采集。

分类查询应保持哪些地区和分页参数一致?

必须提供 store、categoryId、offset 和 limit;若国家查询提供了相应选项,还应选择彼此匹配的 country、currency、lang 和 sizeSchema。成功样例使用 store=US、country=US、currency=USD、lang=en-US、sizeSchema=US、categoryId=4209、offset=0、limit=10。

q 能与 categoryId 同时使用吗?关键词搜索能省略 categoryId 吗?

q 的文档说明要求不要与 categoryId 同时使用,但此接口定义仍将 categoryId 设为必填。所提供的仅关键词测试省略了 categoryId,返回结果为空;这不能使 categoryId 在此定义下变成可选项,也不能证明仅关键词请求符合该接口约束。

多选筛选条件和价格范围应如何传入?

新版列表文档规定,brand、size、base_colour 和属性筛选使用逗号分隔的 ID。priceMin 和 priceMax 为数值字段,文档将其定义为整数价格边界。分类测试没有独立验证这些筛选组合,因此应使用实际分面 ID,并核对返回结果对应的查询条件。

products 数组为空是否表示关键词搜索失效?

不是。所提供的无匹配关键词测试返回 HTTP 200、itemCount=0,products 和 facets 为空,categoryName=null,searchPassMeta 中的 isPartial、isSpellcheck 均为 false。其 searchTerm 将传入词重复了两次,但单次观察不足以说明所有空搜索的共同原因。

商品列表能确定库存件数或历史价格吗?

不能。所提供的分类观察包含商品 ID、名称和当时的美元价格,不含精确库存件数或内置历史价格序列。应使用独立的详情或库存接口查询各自文档列出的字段;如需跨时间比较,应自行保存带时间戳的观察记录。

相关接口

相关指南

查看订阅方案 →