查询 ASOS 商品库存状态与当前价格
查看 ASOS 商品搜索、价格与尺码库存 API 的全部接口 →使用必填的数字查询参数 productIds,获取 ASOS 商品的库存与价格快照。商品 ID 可从 products/v2/list 获取。虽然参数名为复数,但文档类型为数字,且目前只验证过单个商品请求;多个 ID 的传参格式和批量上限尚未确认。可选的 currency、lang、sizeSchema 和 store 应使用 countries/list 返回的对应值。store 需要填写店铺市场代码,不要使用商品列表的 site 站点标识。已验证的组合为 store=US、currency=USD、lang=en-US 和 sizeSchema=US。 一次 HTTP 200 响应的根层级为数组,其中包含一条商品记录,而非外层对象包装。应通过 productId 匹配记录,不要依赖数组位置。对于 productId=210916181,已确认的字段为 productPrice.current.value=94.99、productPrice.currency=USD、isInStock=true,以及包含八条记录的 variants 数组。返回的规格库存更新时间 stockLastUpdatedDate 包括 2026-10-23T01:53:27.387Z。这些值仅反映当次查询结果,不代表后续请求仍会返回相同价格或库存状态。 现有验证记录未确认规格标识、尺码标签和规格可售状态的确切字段名。商品层级的 isInStock 不代表某个指定尺码一定有货。其他示例中的附加字段尚未验证,不应视为保证返回的字段。本接口未证明支持精确库存数量,也不保证即时更新。请区分应用发起查询的时间与各规格返回的 stockLastUpdatedDate。补货检查调度、提醒和价格历史存储需由应用自行实现;本查询不会预留库存或创建订单。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/asos/products-v4-get-stock-price API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/asos/products-v4-get-stock-price?key=<API_KEY>&productIds=<productIds>'
查询结果
使用场景
- 按商品 ID 维护价格关注列表,保存 productPrice.current.value、productPrice.currency、店铺市场和查询时间,在应用中自行积累价格历史。
- 构建尺码关注诊断工具,先找到返回的 productId 再检查其规格,不把商品层级的 isInStock 直接当作关注尺码有货的证明。
- 确认规格标识与可售状态字段后,由应用定时检查补货,明确区分未知、无货和有货状态,仅在确认状态变化后发送提醒。
- 将各规格返回的 stockLastUpdatedDate 与应用获取响应的时间对比,评估库存信息的新旧程度,避免把每次成功查询都展示为即时库存核验。
常见问题
productIds 从哪里获取,可以一次提交多个 ID 吗?
使用 products/v2/list 返回的数字商品 ID。参数虽然名为 productIds,但文档类型为 number,已验证的成功请求也仅使用了 210916181 一个 ID。多个 ID 的传参格式和批量上限尚未验证,不要假设支持用逗号分隔多个值。
store、currency、lang 和 sizeSchema 应如何选择?
使用 countries/list 返回的对应值。已验证请求使用 store=US、currency=USD、lang=en-US 和 sizeSchema=US。store 参数应填写店铺市场代码,而非部分商品列表请求使用的 site 站点标识。比较价格时,请保持店铺市场与币种一致。
哪些库存与价格响应字段已经过验证?
响应根层级为数组,其中一条记录的 productId=210916181。该记录包含 productPrice.current.value=94.99、productPrice.currency=USD、isInStock=true 和八个规格,也返回了规格的 stockLastUpdatedDate。这些是一次请求中观察到的结果,不是固定值,也不代表所有可能字段都已得到确认。
isInStock=true 是否代表我选择的尺码有货?
不是。已观察到的 isInStock 描述商品整体状态,并未确认对应某个选定尺码。现有验证记录尚未确定规格标识、尺码标签和可售状态的字段名。报告尺码有货前,应先确认这些字段并匹配目标规格;未知状态不等于无货。
请求成功是否保证库存即时更新或数量准确?
不保证。应区分应用的请求时间与各规格返回的 stockLastUpdatedDate。成功获取响应不代表库存刚刚更新,也不保证轮询间隔或提供精确的剩余件数。
接口自带补货提醒和价格历史吗?
现有信息未证明接口内置通知或历史存储功能。应用可以自行定时查询、保存可比较的价格记录,并在确认规格字段后,对已核实的规格状态变化发送提醒。本接口不会预留库存或创建订单。