按地区、分类和筛选条件分页浏览 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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>'
查询结果
使用场景
- 从分类 4209 采集数量受限的美国鞋履商品样本,保留商品 ID,用于后续商品详情和库存状态观察。
- 设计支持分面筛选的分类浏览表单,使用文档规定的逗号分隔品牌、颜色和尺码 ID,并在启用筛选前核对可选值。
- 排查搜索无结果时,记录完整关键词、地区设置、筛选条件、offset、itemCount 和搜索标记,不将所有空页归为同一原因。
- 定期比较分类快照中的商品新增与移除情况,保持地区语言及排序不变,并按商品 ID 去重,而不是从列表位置推断销量。
常见问题
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、名称和当时的美元价格,不含精确库存件数或内置历史价格序列。应使用独立的详情或库存接口查询各自文档列出的字段;如需跨时间比较,应自行保存带时间戳的观察记录。