快速开始:浏览美国站鞋类商品
在平台控制台获取你有权使用的 API 密钥,替换示例中的 <API_KEY>。密钥会出现在请求 URL 中,请勿写入公开链接、截图、代码仓库或未脱敏日志;正式环境请由服务端发起请求。
示例按美国站配置浏览分类 4209:store 和 country 为 US,currency 为 USD,lang 为 en-US,sizeSchema 为 US;以 offset=0、limit=10、sort=freshness 请求第一页。这些是示例指定的公开参数,不是省略参数后的默认值;商品、数量、价格和库存可能变化,也可能返回空列表。打开页面、切换端点、展开说明或复制示例都不会发送数据请求,只有你主动执行时才会调用。
基础 URL https://api.opendata-api.com
curl -X GET 'https://api.opendata-api.com/api/project/asos/products-v2-list?key=<API_KEY>&categoryId=4209&country=US¤cy=USD&lang=en-US&limit=10&offset=0&sizeSchema=US&sort=freshness&store=US'import requests
response = requests.request(
"GET",
"https://api.opendata-api.com/api/project/asos/products-v2-list",
params={
"key": "<API_KEY>",
"categoryId": "4209",
"country": "US",
"currency": "USD",
"lang": "en-US",
"limit": "10",
"offset": "0",
"sizeSchema": "US",
"sort": "freshness",
"store": "US",
},
timeout=30,
)
response.raise_for_status()
print(response.json())const url = new URL("https://api.opendata-api.com/api/project/asos/products-v2-list");
url.search = new URLSearchParams({
"key": "<API_KEY>",
"categoryId": "4209",
"country": "US",
"currency": "USD",
"lang": "en-US",
"limit": "10",
"offset": "0",
"sizeSchema": "US",
"sort": "freshness",
"store": "US",
}).toString();
const response = await fetch(url, {
method: "GET",
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());调用前先确认这些边界
- 先从国家目录确认店铺、语言、币种与尺码体系,再为支持这些参数的请求保持兼容设置。US、USD、en-US 与 US 尺码是本页示例组合,不代表所有地区、币种或尺码组合都有相同商品覆盖。
- 商品列表以分类浏览为起点,使用分类导航链接中的 categoryId。q 的说明要求不要与 categoryId 同用,但本页商品列表的公开契约仍将 categoryId 列为必填;不要把只传 q 的请求当作满足此契约的替代方案。自动补全只提供建议词与商品匹配数量,不保证后续列表一定有结果,也不代表搜索量或销量。
- 商品层级的 isInStock=true 不能证明目标尺码有货。先从详情中识别尺码变体,再核实库存结果中的对应标识和可用状态;字段缺失或无法匹配时保留为未知,不要按数组位置关联,也不要将未知当作缺货。productIds 当前按数值型单个商品 ID 使用,多 ID 编码和批量上限尚未确认。
- 价格和库存是本次查询得到的观察结果,不是历史序列或即时更新保证。建立价格监控或补货提醒时,需自行定时查询并保存结果;将自己的采集时间与返回的 stockLastUpdatedDate 分开记录,不能据此推断剩余件数、预留库存或保证补货。
- 标注为已弃用的五个端点保留供旧集成核对,不代表已验证仍可使用。新项目优先查看当前版本;迁移时分别核对必填参数、店铺标识和响应结构,不假定旧版与新版兼容。
区分请求状态与业务结果
HTTP 状态说明本次请求在 HTTP 层面的结果,不代表商品一定存在或有货。还需检查平台响应中的 code、message 和 data:先确认业务状态,再读取 data 中的商品数据。空数组不等于接口故障,业务失败也不能当作缺货或无匹配商品。
按要完成的任务选择端点
- 查找地区设置与商品分类
-
国家目录和分类导航都没有必填输入;可先指定 en-US 查询国家目录,再用目标国家和语言查看分类。记录兼容的店铺、币种与尺码体系,并从分类链接的 link.categoryId 获取可用于商品列表的分类 ID,不要用导航节点自身的 ID 替代。
- 浏览分类商品与搜索建议
-
商品列表需要分类 ID、store、offset 和 limit,可在此基础上排序和筛选;分类 ID 与店铺设置应先从导航和国家目录取得。自动补全则必须提供 q,返回建议词而非商品记录;不要将建议词直接视为满足商品列表必填条件的请求。
- 核对详情、尺码与当前价格
-
先从商品列表取得商品 ID:详情查询使用 id,库存价格查询使用 productIds。两者都应延续同一店铺、币种、语言和尺码体系;不要传入变体 ID 或尺码 ID。结合详情尺码记录核对目标变体,不能用商品整体有货代替所选尺码的库存判断。
- 检查旧版集成与迁移需求
-
旧版列表、详情和相似商品端点仅供兼容性参考,尚未验证当前可用性。先核对各端点所需的分类或商品 ID 以及店铺参数,再比较新版契约;不要默认版本间参数和返回结构相同,也不要将旧版端点当作可自动切换的备用接口。
分类导航
/api/project/asos/categories-list 查询 ASOS 分类导航
完整文档 →说明
获取 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 等链接字段;现有观测摘要并未逐一确认这些附加字段。本接口提供导航元数据,不直接返回商品列表或库存。
主动发送测试请求 必填 0 项,可选 2 项
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
地区配置
/api/project/asos/countries-list 查询 ASOS 国家及站点配置
完整文档 →说明
获取 ASOS 国家与站点配置元数据,可选填 lang 指定语言。文档示例和成功观测使用的语言均为 en-US,未说明省略参数时的默认值。一次成功响应的根节点是包含 250 条国家记录的数组,而不是带有 results 属性的对象。每条记录提供 country、store、name,以及 languages、currencies、sizeSchemas 集合。已观测到的美国记录中,store 为 US,主要语言为 en-US,货币为 USD,主要尺码体系为 US。配置商品目录请求时,应结合使用这些设置。未经验证的文档示例还包含 imageUrl、region、siteId、siteUrl 等元数据,现有观测摘要并未逐一确认这些附加字段。250 条仅为该次观测的数量,并非固定上限;某个国家出现在结果中,也不代表其商品覆盖、配送资格或所有货币、语言、尺码组合均已得到支持验证。
主动发送测试请求 必填 0 项,可选 1 项
| 参数 | 位置 | 值 |
|---|---|---|
| query |
调用成本暂不可用,未假定任何价格。
旧版商品查询
/api/project/asos/products-detail-deprecated 查询 ASOS 旧版商品详情(已弃用)
完整文档 →说明
此 ASOS 商品详情接口已弃用,仅保留用于识别现有集成及规划迁移,不建议将其用于新建商品资料补全流程。必填参数 id 为从商品列表取得的数字商品 ID。可选的 currency、lang、sizeSchema、store 均注明应参考国家目录,其示例依次为 USD、en-US、US、US。store 使用国家目录中的 store 值,不是商品列表中的 sideId。文档未说明省略参数时的默认值。旧版 currency 字段声明为数字类型,但示例却是 USD;这一输入约定存在冲突且尚未验证,不能假定数字或文本形式的货币值一定可用。本接口没有提供实际请求测试或响应示例。虽然用途是查询商品详情,但现有证据无法确认返回字段、响应结构、当前是否仍可用,以及与新版详情记录是否兼容。迁移时可评估 products-v4-detail,逐项比较字段及区域语言设置,不要假定可以直接替换。
主动发送测试请求 必填 1 项,可选 4 项
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query |
展开可选筛选与地区参数 (1)
| 参数 | 位置 | 值 |
|---|---|---|
| query |
调用成本暂不可用,未假定任何价格。
旧版商品发现
/api/project/asos/products-list-deprecated 查阅 ASOS 已弃用的分类商品列表接口与迁移要求
完整文档 →说明
此分类商品列表接口已弃用,仅供旧版集成迁移参考。categoryId 取自分类查询,store 使用国家记录中的 siteId,同时必须提供 offset 和 limit。可通过 country、currency、lang 和 sizeSchema 指定地区环境,通过 brand、size、base_colour 及属性筛选条件缩小分类范围;min 和 max 是文档中定义为整数的价格上下限。文档列出的排序值为 freshness、priceasc 和 pricedesc。此旧版接口未声明 q 参数,不能据此认为它具备新版列表的关键词搜索能力。系列、颜色、品牌和尺码等筛选值的说明引用了 facetValues[].id。目前没有此已弃用接口的响应示例或成功测试记录,因此商品字段、响应结构、分页元数据及接口是否仍可用均未得到验证。迁移至 /products/v2/list 时,应逐项核对 min/max 与 priceMin/priceMax 的对应关系,并重新检查已保存的筛选条件,不要把新旧路径当作可直接互换的别名。
主动发送测试请求 必填 4 项,可选 13 项
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query |
展开可选筛选与地区参数 (12)
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
商品目录浏览
/api/project/asos/products-v2-list 按地区、分类和筛选条件分页浏览 ASOS 商品
完整文档 →说明
查询指定分类下的商品,必须提供数值型 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,后续另行查询详情或库存;列表数据不提供精确库存件数、销量排名或内置价格历史。
主动发送测试请求 必填 4 项,可选 16 项
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
展开可选筛选与地区参数 (11)
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
旧版相似商品
/api/project/asos/products-v2-list-similarities-deprecated 核查已弃用的 ASOS v2 相似商品查询接口约定
完整文档 →说明
此相似商品查询接口已弃用,保留文档用于排查旧版推荐功能的接口依赖。必填参数 id 为数字,应取自 /products/v2/list 返回的商品;可选字符串参数 store 取自 /countries/list。文档中的 id 示例为 9851612,store 示例为 US,但这些示例不能证明商品目前仍可售。此接口没有成功的实测响应可供核对。未经验证且不完整的文档响应示例包含根级 id 和 products 数组,数组条目包含 order 与嵌套的 product。示例商品字段包括 id、name、brandName、colour、images、isAvailable、isInStock、productCode、price 和 variants。price 中列出 currency、current、previous、rrp、isMarkedDown 和 isOutletPrice,其中 current 包含 text 和 value;示例规格字段包括 id、brandSize、sizeId、sizeOrder、isAvailable、isInStock 和 isLowInStock。这些字段仅供理解示例,不能视为已验证的当前响应约定,也不表示库存数量或有明确定义的相似度分数。请勿假定此路径仍能返回推荐结果,也不要把其他已列出的接口当作等价替代。若要改为应用自行推荐,可通过当前商品列表获取候选商品,再单独查询详情,并明确说明商品筛选逻辑由应用自行制定。
主动发送测试请求 必填 1 项,可选 1 项
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
商品详情与库存
/api/project/asos/products-v3-detail-deprecated 查询 ASOS v3 商品详情(已弃用)
完整文档 →说明
此商品详情查询接口已弃用,保留文档供现有 v3 客户端维护与迁移规划使用。必填参数 id 为商品列表中取得的数字商品 ID。可选参数 currency、lang、sizeSchema 和 store 应从国家与地区列表中选择,文档示例依次为 USD、en-US、US 和 US。其中 store 使用国家与地区列表中的店铺值,不是商品列表接口使用的站点标识。此已弃用接口没有实测响应可供核对,当前是否可用以及实际响应约定均未验证。不完整的文档示例列出 id、name、productCode、brand、alternateNames、info、media、price、variants 和 isInStock。该未经验证的片段中,alternateNames 包含 locale 和 title,brand 包含 brandId 和 name,info 包含 aboutMe、careInfo 和 sizeAndFit,media 包含 images 和 catwalk 条目,price 包含 currency、current、previous 和 rrp。规格片段列出了 brandSize、isAvailable 和 isLowInStock,但内容并不完整。这些仅见于文档示例的字段只能作为迁移核查线索,不是已确认的当前输出,也不代表准确库存数量。新建商品详情集成时可评估 products-v4-detail,并在切换前对照已保存的响应样本;不要假定两个版本的规格、媒体或价格结构完全一致。
主动发送测试请求 必填 1 项,可选 4 项
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/asos/products-v3-list-similarities-deprecated 查询 ASOS v3 旧版相似商品(已弃用)
完整文档 →说明
此接口用于以已有 ASOS 商品为起点查询相似商品,目前已弃用。必填参数 id 为商品列表返回的数字商品 ID。可选参数 currency、lang、sizeSchema 和 store 用于保留请求的地区设置,文档示例依次为 USD、en-US、US 和 US。货币、尺码体系和店铺值应从国家与地区列表选择,lang 用于指定语言代码。此已弃用路径没有实测响应可供核对,因此当前推荐行为和接口可用性均未验证。不完整的文档示例包含根级 id 和 products 数组,每个可见条目都有 order 和嵌套的 product。该未经验证的片段列出了商品字段 id、name、brandName、colour、images、price、variants、isAvailable 和 isInStock;可见价格字段包括 currency、current、previous 和 rrp,可见规格字段包括 brandSize、sizeId、sizeOrder 和 isLowInStock。这些仅是文档示例中的结构线索,不是已确认的输出、相似度分数、准确库存数量或有保证的排序约定。现有证据没有确认任何未弃用的现行相似商品替代接口。分类商品列表可用于另外设计商品发现流程,但不能将其描述为与此接口推荐结果等价。
主动发送测试请求 必填 1 项,可选 4 项
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/asos/products-v4-detail 查询 ASOS 商品详情、图片与尺码规格
完整文档 →说明
使用商品列表返回的数字商品 id,查询 ASOS 商品详情。id 为必填参数;可选的 currency、lang、sizeSchema 和 store 应使用国家信息查询返回的对应值。store 需要填写店铺市场代码,不要使用商品列表接口中的 site 站点标识。一次成功的 HTTP 200 验证使用了 id=210916181、store=US、currency=USD、lang=en-US 和 sizeSchema=US。 该次响应为对象,包含与请求一致的商品 id,以及 name、description、productCode、gender、brand、productType、info、media、localisedData、尺码相关标记和 variants。示例商品为棕色皮革孟克鞋,brand.id=53、brand.name=ASOS DESIGN、gender=Men、productType.name=Shoes。info 包含 aboutMe、sizeAndFit 和 careInfo。media.images 有四条图片记录,包含 url、type、colourWayId、colour 和 isPrimary;其他媒体集合可能为空。 该商品返回了八个规格,包含 id、sizeId、brandSize、displaySizeText、sizeOrder、sku、isAvailable、colourWayId 和 colour。例如,规格 210916195 的 sizeId 为 388476,displaySizeText 为 US 7;这些标识与商品 id 210916181 不同。localisedData 包含 locale、title 和 pdpUrl 记录。此次响应中的 rating、shippingRestriction 和 fitType 等可选字段为 null,解析时应兼容字段缺失、空值及数组长度变化。 已验证的 v4 详情对象在根层级没有 price 或 isInStock 字段。另一份截断示例中出现过 price、isInStock、alternateNames 和 brand.brandId,但本次 v4 记录未确认这些字段。需要价格或库存状态时,请使用独立的库存与价格查询接口;详情中的规格数据不提供精确库存数量、保证的刷新周期或内置价格历史。
主动发送测试请求 必填 1 项,可选 4 项
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/asos/products-v4-get-stock-price 查询 ASOS 商品库存状态与当前价格
完整文档 →说明
使用必填的数字查询参数 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。补货检查调度、提醒和价格历史存储需由应用自行实现;本查询不会预留库存或创建订单。
主动发送测试请求 必填 1 项,可选 4 项
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
搜索建议
/api/project/asos/v2-auto-complete 获取 ASOS 商品搜索联想词
完整文档 →说明
根据必填查询词 q 获取 ASOS 商品搜索联想建议。可输入商品名称、关键词或品牌短语;文档示例为 bikini top,实测成功的查询词为 nike。可选参数 country、currency、lang、sizeSchema 和 store 的取值来自 countries/list,用于指定目标市场、语言地区及尺码体系,而不是筛选某个具体商品款式或尺码。已验证的组合为 country=US、currency=USD、lang=en-US、sizeSchema=US、store=US。 实测 HTTP 200 响应为对象,顶层 suggestionGroups 数组包含一个分组。该分组的 indexName 为 searchterms,suggestions 数组中有十条建议。每条建议包含 searchTerm(建议搜索词)和 numberOfResults(报告的目录匹配数量)。例如,nike 对应 1770 条,nike women 对应 1530 条,nike shoes 对应 719 条。这些数字仅代表该次请求的目录匹配情况,不是固定总数,也不表示用户搜索量、销量或需求排名。分组数量和每组建议数量均不保证固定。 未经实测验证的响应示例还包含分组级字段 indexTitle,且示例中有八条建议;实测记录未确认 indexTitle,因此它只能作为示意字段,不应视为必定返回。本接口提供的是搜索词建议,不返回商品记录、商品 ID、价格或库存确认。用户选中的 searchTerm 可用于另行提交 products/v2/list 商品搜索,并保留预期的市场与语言地区设置,但出现联想词并不保证后续商品列表非空。获取联想词与提交商品搜索是两个独立的应用操作;页面跳转、打开帮助和复制示例均不应触发这两类请求。
主动发送测试请求 必填 1 项,可选 5 项
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
该端点能提供什么
通过结构化的 ASOS 商品数据,构建选品、商品发现与价格库存监控工具。在选定的国家和店铺中浏览商品目录,查询商品详情与尺码变体,并在一致的地区设置下记录价格和有货状态。
- 先查询国家配置与购物分类,确定要浏览的地区和商品目录
- 按分类分页获取商品,结合排序及尺码、品牌、颜色、价格条件缩小范围
- 使用商品 ID 查询描述、品牌信息、图片和尺码变体
- 查询当前商品价格及商品或变体的有货状态,为库存监控提供观察数据
- 获取关键词自动补全建议及相应的商品匹配数量
- 维护旧集成时,查阅明确标注为已弃用的列表、详情和相似商品端点
请保持国家、店铺、语言、币种和尺码体系一致。商品整体有货,不代表每个尺码都有货。价格历史与补货比较需要自行保存历次查询结果;这些接口用于读取商品目录,不提供订单管理或库存预留,也不保证库存件数或数据即时更新。已弃用端点仅供参考,不代表已验证可作为可用替代方案。