获取 ASOS 商品搜索联想词

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

根据必填查询词 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 商品搜索,并保留预期的市场与语言地区设置,但出现联想词并不保证后续商品列表非空。获取联想词与提交商品搜索是两个独立的应用操作;页面跳转、打开帮助和复制示例均不应触发这两类请求。

API 功能

按搜索词分组呈现补全建议 读取 suggestionGroups 及各组的 indexName,再展示对应的 suggestions。实测 searchterms 分组包含十条建议,但这一数量只是单次观测结果,不是固定的响应条数。
为联想词标注目录匹配数量 在每个 searchTerm 旁展示 numberOfResults,说明报告的目录匹配情况。实测 nike shoes 对应 719 条;该数字不能用来估算关键词搜索量或商品销量。
为联想查询指定市场与语言地区 将 countries/list 提供的 country、currency、lang、sizeSchema 和 store 代码与 q 一同提交。实测取值依次为 US、USD、en-US、US 和 US;调整搜索词时应保持预期的查询环境。
将选中的建议词交给独立商品搜索 把返回的 searchTerm 作为单独提交的 products/v2/list 请求的查询词。联想响应本身不含商品记录,也不保证后续搜索能返回商品。

在线 API 演示

GET /api/project/asos/v2-auto-complete

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

q 参数应该填写什么?

填写商品名称、关键词或品牌短语。文档中的占位示例是 bikini top,实测成功的查询词是 nike。q 为必填参数;现有验证信息没有确定最短输入长度,也不保证每个输入都能获得建议。

如何读取搜索联想响应?

先读取顶层 suggestionGroups 数组。实测响应中有一个 indexName 为 searchterms 的分组,包含十条建议,每条建议均包含 searchTerm 和 numberOfResults。应遍历实际返回的数组,不要假定始终只有一个分组或十条建议。

numberOfResults 表示什么?

它表示某个建议搜索词 searchTerm 对应的目录匹配数量,不是关键词搜索量、销量或消费需求。实测 nike 为 1770 条,nike women 为 1530 条,nike shoes 为 719 条。这些数字只描述一次请求的结果,不是固定总数,也不保证与后续商品列表的数量一致。

应该如何设置市场和语言参数?

使用 countries/list 提供的 country、currency、lang、sizeSchema 和 store 取值,这五个参数均为可选。已验证的组合为 country=US、currency=USD、lang=en-US、sizeSchema=US、store=US。将选中的建议词提交到商品搜索时,应保持预期的市场与语言地区设置,不要假定文档未说明的默认值。

联想建议是否包含匹配商品、价格或库存?

不包含。实测结果提供建议搜索词和目录匹配数量,不含商品记录、商品 ID、价格或库存确认。用户提交后,可将选中的 searchTerm 用于单独的 products/v2/list 请求;存在联想词并不保证后续响应中一定有商品。

indexTitle 是已验证的响应字段吗?

响应示例包含分组级字段 indexTitle,但实测记录确认的是 indexName、suggestions、searchTerm 和 numberOfResults,并未确认 indexTitle。应将 indexTitle 视为未经验证的示意字段,展示已验证的建议文本和匹配数量时,不要依赖它一定存在。

相关接口

相关指南

查看订阅方案 →