获取 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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>'
查询结果
使用场景
- 为 ASOS 搜索框构建输入联想功能,直接展示 searchterms 分组返回的 searchTerm,而不是从商品标题中自行拼接补全词。
- 帮助目录分析人员将宽泛的品牌查询细化为 nike women 或 nike shoes 等短语,以 numberOfResults 了解目录匹配情况,不将其解读为消费需求指标。
- 在商品列表为空时提供替代查询词,保留市场与语言地区参数,并等待用户明确提交后再发起下一次商品列表请求。
- 保存联想词快照,用于内部商品运营的搜索用语研究,同时记录查询词与语言地区,并将建议数量标注为目录观测值,而非趋势排名或关键词搜索量。
常见问题
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 视为未经验证的示意字段,展示已验证的建议文本和匹配数量时,不要依赖它一定存在。