查询 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 功能

按商品 ID 匹配数组结果 解析已验证的根层级数组响应,以 productId 识别各条记录。单商品请求返回了一条记录,多商品批量查询的约定尚未验证。
同市场同币种价格核对 查看所选市场下的 productPrice.current.value 和 productPrice.currency。已验证的美国市场、美元请求返回 94.99 USD;比较多次查询结果时应保持店铺市场与币种一致。
商品库存与规格列表联合查看 读取已确认的商品层级 isInStock 标记及 variants 数组,已验证响应包含八个规格。判断具体尺码是否有货前,需先确认规格标识和可售状态字段。
库存更新时间与查询时间留存 同时保存返回的 stockLastUpdatedDate 和应用自身的获取时间,区分库存更新信息与请求成功时间;两者均不代表接口有保证的刷新周期。

在线 API 演示

GET /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>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

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。成功获取响应不代表库存刚刚更新,也不保证轮询间隔或提供精确的剩余件数。

接口自带补货提醒和价格历史吗?

现有信息未证明接口内置通知或历史存储功能。应用可以自行定时查询、保存可比较的价格记录,并在确认规格字段后,对已核实的规格状态变化发送提醒。本接口不会预留库存或创建订单。

相关接口

相关指南

查看订阅方案 →