知识库
搜索

插件下载插件更新日志套餐购买常见问题开票须知子账号数据更新

知识库
快速入门
视频课堂
功能手册
运营干货
搜索
本篇目录
功能手册

卖家精灵 MCP 接口说明文档

2026/10/29 阅读数 (1) 评论数 (0)

卖家精灵 MCP 是为 AI 助手设计的亚马逊数据服务。接入后，Claude、ChatGPT/Codex、Cursor 等支持 MCP 的 AI 工具，可以直接调用卖家精灵的数据，回答选品、运营、关键词、广告、评论等问题。
本文档说明接入方式、计费规则、通用约定，以及全部 28 个工具的参数、返回字段和示例。

1. 快速开始

1.1 接入信息

项目
内容
服务地址
https://mcp.sellersprite.com/v2/mcp
传输协议
Streamable HTTP
鉴权方式
请求头 secret-key: <你的密钥>
密钥获取
卖家精灵账号后台

1.2 在常见客户端中配置

Claude Code / Claude Desktop（项目目录下的 .mcp.json）
{ "mcpServers": { "sellersprite": { "type": "http", "url": "https://mcp.sellersprite.com/v2/mcp", "headers": { "secret-key": "<你的密钥>" } } } }
Codex（~/.codex/config.toml）
[mcp_servers.sellersprite] url = "https://mcp.sellersprite.com/v2/mcp" [mcp_servers.sellersprite.http_headers] "secret-key" = "<你的密钥>"
Cursor（~/.cursor/mcp.json）
{ "mcpServers": { "sellersprite": { "url": "https://mcp.sellersprite.com/v2/mcp", "headers": { "secret-key": "<你的密钥>" } } } }
配置完成后重启客户端，在 AI 对话中直接用自然语言提问即可，例如“美国站 B07N7KFHVH 现在多少钱？”。AI 会自动选择合适的工具。

1.3 调用格式

所有工具都通过 MCP 的 tools/call 调用：
{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "asin.detail", "arguments": { "marketplace": "US", "asins": ["B07N7KFHVH"] } } }

2. 计费规则

规则
说明
基本规则
每次成功调用扣 1 次，与一次查询的商品数、关键词数无关（在各工具的上限内）
翻页
每翻一页单独计 1 次
评论
标准版和扩展版评论按返回条数计费：每 20 条扣 1 次，不足 20 条按 20 条算
不扣次的情况
参数错误被拒绝、没有返回任何数据（空结果）
字段裁剪
用 includeFields 只取部分字段，不影响扣次
每次返回都会附带扣次回执，可据此核对：
{ "billing": { "chargedUnits": 1, "remainingUnits": 1497, "requestId": "0cb0cc2c-…" } }
字段
说明
chargedUnits
本次扣除的次数
remainingUnits
扣除后的剩余次数
requestId
请求编号，咨询或排查问题时请提供

3. 通用约定

3.1 站点代码

marketplace 参数支持 19 个站点：
代码
站点
代码
站点
代码
站点
US
美国
UK
英国
DE
德国
FR
法国
IT
意大利
ES
西班牙
NL
荷兰
SE
瑞典
PL
波兰
TR
土耳其
JP
日本
IN
印度
SG
新加坡
AU
澳大利亚
CA
加拿大
MX
墨西哥
BR
巴西
AE
阿联酋
SA
沙特阿拉伯
 
 
 
 

3.2 数据时间口径

  • 近 30 天：以查询日为终点的滚动 30 天，返回中会写明实际的起止日期。
  • 月份：参数用 yyyyMM（如 202609），部分工具用 yyyy-MM，以各工具参数说明为准。不传月份时使用最新可用数据，返回中会写明实际使用的月份。
  • 日期：统一为 yyyy-MM-dd。
  • 估算值：销量、销售额等为卖家精灵根据 BSR 等数据估算，不是亚马逊真实订单数。

3.3 样本口径

类目统计类工具（类目筛选、类目报告、类目分布、头部榜单）基于类目的头部样本商品计算，样本数默认 100，部分工具可选 100–500。亚马逊选品指南针的官方全量数据由“选品指南针报告”category.demand.report 单独提供，两种口径不要混合计算。

3.4 分页

列表类工具统一使用 page 参数：
{ "page": { "cursor": 0, "size": 100 } }
字段
说明
page.cursor
起点偏移量，从 0 开始
page.size
每页条数，各工具上限见参数说明，多数为 100
返回 page.hasMore
是否还有下一页
返回 page.nextCursor
下一页的起点

3.5 区间条件

价格、销量、评分等区间条件统一写成对象，可以只写一端：
{ "price": { "min": 15, "max": 30 }, "sales": { "min": 300 } }
比例类数值统一用小数，如 0.15 表示 15%，0.0059 表示 0.59%。

3.6 字段裁剪

带 includeFields 参数的工具，可以只返回需要的字段，减少 AI 需要阅读的数据量。不传时返回默认字段。字段名必须在该参数的可选值中，否则请求会被拒绝。

3.7 逐条结果状态

批量查询（如一次查多个 ASIN 或关键词）时，每一条结果都带 resultStatus：
值
含义
success
查到并返回数据
PARTIAL
只有部分指标有数据
no_data
没有查到，这一行仅作占位
某一条没有数据，不影响同一请求中的其他条。

3.8 错误返回

参数不符合要求时，请求会被拒绝并说明原因和正确写法，不扣次：
{ "requestId": "00b87636-…", "billing": { "reason": "INVALID_ARGUMENT", "chargedUnits": 0 }, "error": { "code": "INVALID_ARGUMENT", "message": "includeFields 不支持字段: launchDate, 支持字段: asin, title, brand, price, …", "retryable": false } }
错误码
含义
处理方式
INVALID_ARGUMENT
参数不合法：字段名不支持、取值超出范围、格式不对等
按 message 提示修改后重试
CONTROL_PLANE_UNAVAILABLE
服务暂时不可用
retryable 为 true，稍后重试
HTTP 429
请求过于频繁
降低频率，稍后重试

4. 工具目录

共 28 个工具，分 6 个模块。
商品（4 个）
工具
名称
用途
asin.detail
商品详情
按 ASIN 批量查询商品的基础资料，一次最多 20 个。
asin.list
商品列表（按条件找商品）
按关键词、类目、品牌、ASIN 集合等查找商品，并按价格、销量、评分、上架时间、卖家所在地、配送方式等几十种条件筛选。
asin.content.list
商品内容（五点与图片）
查询商品的五点描述原文和商品图片链接。
asin.related.list
关联商品
查询商品在亚马逊站内的关联流量：经常一起购买、看了又看、相似商品对比、关联广告位等。
销量与价格（4 个）
工具
名称
用途
asin.sales.trend
月度销量趋势
查询商品按月的销量、销售额、价格、BSR、评分、评论数走势，同时提供整款（父体）和单个规格（子体）两种销量口径。
asin.prediction.sales
近期逐日销量估算
查询商品最近 N 天（1–65 天）每天的估算销量和 BSR，并给出区间合计和日均。
bsr.prediction.sales
按排名估销量
根据一级类目和大类 BSR 排名，估算这个排名对应的日销量和月销量。
keepa.trend
价格与排名历史
查询商品的逐日历史：价格、促销价、购物车价格与卖家、BSR（大类和小类）、评分、评论数、卖家数、优惠券等 15 项指标。
类目市场（8 个）
工具
名称
用途
category.search
类目搜索
按类目名或产品词查找类目，返回类目的完整节点路径；也可以列出某个类目的子类目。
category.stats.list
类目筛选与对比
按市场规模、价格、竞争、新品、卖家结构等几十项指标批量筛选类目，或者对比多个类目。
category.report.detail
类目报告
查询单个类目的市场报告：规模、价格、评分、品牌和卖家集中度、新品表现、卖家所在地等；可看近 30 天快照，也可看近 24 个月逐月明细。
category.trend
类目分布
查询类目内部的分布结构：行业销量趋势、上架时间分布、评分数和评分值分布、价格带、卖家类型、卖家所在地、A+ 与视频配置。可一次组合多项。
category.top.list
类目头部榜单
查询类目的头部商品、头部品牌或头部卖家排名，以及各自的销量、销售额和份额。
category.demand.trend
类目需求词趋势
查询类目的需求关键词池（最多 2000 个），以及前 10 个关键词近 24 个月的搜索量走势。
category.demand.report
选品指南针报告
查询亚马逊后台选品指南针口径的类目数据：官方商品总数、搜索量和点击趋势、热门关键词、浏览量和销量趋势、退货率和搜索购买比。
category.ai.feature.list
类目 AI 画像
查询卖家精灵对类目商品的 AI 归纳：主要人群、使用场景、产品特点等标签，以及每个标签的商品覆盖率、销量和销量占比。
关键词（9 个）
工具
名称
用途
keyword.batch.info
关键词快照
批量查询关键词当前的搜索量、购买量、购买率、竞争商品数、PPC 竞价等指标，一次最多 20 个词。
keyword.trend
关键词趋势
查询单个关键词按月的搜索量、购买量、购买率，以及同比、环比、近 3 个月增长率。
keyword.related.list
相关词扩展
根据种子词扩展相关关键词，返回每个词的搜索量、购买量、购买率、竞争度、PPC 竞价、相关度等指标，并支持按这些指标筛选和排序。
keyword.asin.list
竞品流量词
根据 1–10 个 ASIN 查询它们获得流量的关键词，返回每个词的搜索量、流量占比、自然和广告排名、流量类型，以及每个词分别命中了哪几个 ASIN。
asin.coreKeyword.trend
核心词趋势
查询商品流量占比最高的几个核心词（默认 5 个，最多 10 个），以及它们每个月的搜索量走势。
keyword.aba.list
ABA 搜索词
查询亚马逊品牌分析（ABA）搜索词数据：按关键词查排名、搜索量、点击和购买份额、点击前三的商品；也可以按 ASIN 反查它出现在哪些 ABA 搜索词里。
keyword.aba.trend
ABA 趋势
查询关键词在 ABA 中的排名、搜索量、点击前三份额、转化前三份额的历史走势，可按周或按月。
keyword.conversion.analysis
广告转化分析
分析关键词的广告指标：点击、转化、购买、点击率、转化率、CPA、ACOS、建议竞价和预算，可按词组或广泛匹配查询相关词。
keyword.google.trend
Google 搜索趋势
查询关键词在 Google 上的搜索热度走势，可选网页搜索（WEB）或购物搜索（SHOPPING）。
评论（2 个）
工具
名称
用途
asin.review.list
商品评论（标准版）
查询商品评论，一次最多 100 条，可按星级、是否带图或视频筛选，并按日期、星级或有用数排序。
asin.review.list.extended
商品评论（扩展版）
查询更多评论，一次最多 500 条；筛选和排序方式与标准版相同。
广告（1 个）
工具
名称
用途
ads.insights.lookup
竞品广告洞察
查询商品的商品推广（SP）广告活动和广告组，以及每个广告组在各周或各月是否出现、热度如何。

5. 工具详情

商品

 

商品详情 asin.detail

用途

按 ASIN 批量查询商品的基础资料，一次最多 20 个。
适合回答：
  • “这款现在多少钱？品牌、卖家是谁？”
  • “这几款竞品的价格、评分放一张表。”
  • “这条链接有哪些规格？父体是哪个？什么时候上架的？”
不适合时改用：
  • 按条件找商品 → asin.list
  • 看销量走势 → asin.sales.trend
  • 看历史价格和优惠券 → keepa.trend

计费

每次调用扣 1 次，与查询的 ASIN 个数无关（1–20 个都是 1 次）。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
asins
string[]
是
待查询的 ASIN 列表，1～20 个；最少 1 项，最多 20 项
marketplace
string
是
站点代码；可选值：DE、AE、IN、JP、IT、MX、FR、ES、SA、BR、SE、AU、SG、UK、PL、US、CA、TR、NL
includeFields
string[]
否
同成本输出字段裁剪；不传或为空时返回默认字段集；可选值：asin、marketplace、title、brand、categoryId、categoryPath、price、currency、rating、reviewCount、totalReview、bsr、seller、fulfillment、parentAsin、dimensions、weight、availableDate、variationList；最多 19 项

返回字段

字段
类型
说明
items
object[]
 
items[].bsr
integer
BSR
items[].seller
object
 
items[].seller.name
string
卖家名称
items[].seller.type
string
卖家类型：AMZ、FBA、FBM、NA；可选值：AMZ、FBA、FBM、NA
items[].parentAsin
string
父 ASIN；无父体或未采集时为 null
items[].marketplace
string
站点
items[].categoryPath
string[]
类目路径
items[].rating
number
评分
items[].weight
string
商品重量原文（数据源采集文本，含单位）；未采集时为 null
items[].availableDate
string
上架日期，格式 yyyy-MM-dd；未采集时为 null
items[].title
string
标题
items[].resultStatus
string
逐条结果状态：success=命中并返回数据；no_data=未命中占位行；可选值：success、no_data
items[].reviewCount
integer
评分人数（ratings，页面 X ratings）；非文字评论数
items[].price
number
当前价格
items[].asin
string
ASIN
items[].currency
string
币种
items[].fulfillment
string
履约方式：FBA 或 FBM；可选值：FBA、FBM
items[].brand
string
品牌
items[].variationList
object[]
子体变体清单（asin + attribute）；非多变体、未采集或子体清单缺失时为 null 或空数组
items[].variationList[].attribute
string
规格，如 Color: Red
items[].variationList[].asin
string
子体 ASIN
items[].categoryId
string
类目节点
items[].totalReview
integer
带文字的评论总数（页面 with reviews）；页面显示 10K+ 时入库为上限 10000，超过 1 万仅表示 >=10000
items[].dimensions
string
商品尺寸原文（数据源采集文本，含单位）；未采集时为 null
字段值缺失时返回 null。

示例

请求
{ "name": "asin.detail", "arguments": { "marketplace": "US", "asins": [ "B07N7KFHVH", "B00HEZ888K", "B098WNQ44M" ], "includeFields": [ "asin", "title", "price", "currency", "parentAsin", "variationList" ] } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "items": [ { "asin": "B07N7KFHVH", "currency": "USD", "parentAsin": "B0GZR4P9N4", "price": 11.99, "resultStatus": "success", "title": "Zulay Kitchen Metal Garlic Press Garlic Mincer Tool Stainless Steel, Silver", "variationList": [ { "asin": "B0CWPT8YGL", "attribute": "Color: Black | Number of Items: 1" }, { "asin": "B0D2JM3NKS", "attribute": "Color: 08 - Copper | Number of Items: 1" } ] }, { "asin": "B00HEZ888K", "currency": "USD", "parentAsin": "B00HEZ888K", "price": 20.0, "resultStatus": "success", "title": "OXO Good Grips Garlic Press, Easy to squeeze & Self Cleaning Tool, Black" } ] }

使用说明

  • 查多个商品时请一次传入，最多 20 个，只扣 1 次。
  • 使用 includeFields 时请包含 asin，否则可能返回 no_data。
  • reviewCount 是评分人数（页面上的 X ratings），totalReview 是带文字的评论数，口径不同。
  • 逐条看 resultStatus：某个 ASIN 没有数据时返回一条 no_data 占位，不影响其他 ASIN。
  • variationList（子体清单）需要在 includeFields 里显式指定。
 

商品列表（按条件找商品） asin.list

用途

按关键词、类目、品牌、ASIN 集合等查找商品，并按价格、销量、评分、上架时间、卖家所在地、配送方式等几十种条件筛选。
适合回答：
  • “美国站 15–30 美元、月销 300 以上、排除 Amazon Basics 的烘焙垫给我 10 款。”
  • “这个类目里中国卖家、FBA 发货的商品有哪些？”
  • “近半年上架、月销过千的新品有哪些？”
不适合时改用：
  • 已知 ASIN、只查资料 → asin.detail
  • 看类目整体规模和结构 → category.report.detail / category.trend

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
keyword
string
否
商品标题关键词
asins
string[]
否
按 ASIN 集合过滤；最多 40 个；最多 40 项
categoryId
string
否
类目节点 ID
categoryIdExact
boolean
否
true 表示只查当前类目；缺省包含子类目
dataMonth
string
否
数据归档月份，格式 yyyyMM。不传时使用近 30 天数据；显式传入时必须是可用历史月份，不可用或晚于最新归档月会直接报错，不会回退近 30 天。响应中的 dataMode / dataMonth 表示实际数据口径；格式 ^\d{6}$
brandInclude
string[]
否
按品牌包含过滤；最多 20 项
brandExclude
string[]
否
按品牌排除过滤；最多 20 项
sellerInclude
string[]
否
按卖家包含过滤；最多 20 项
sellerExclude
string[]
否
按卖家排除过滤；最多 20 项
excludeKeywords
string[]
否
排除标题关键词过滤；最多 20 项
excludeAsins
string[]
否
排除 ASIN 过滤；最多 20 项
searchType
string
否
关键词匹配字段，缺省 TITLE；可选值：ASIN、TITLE、BRAND、SELLER
price
区间
否
价格区间
sales
区间
否
月销量区间（父体/月度表口径，非 Amazon 公布子体销量）
revenue
区间
否
月销售额区间
rating
区间
否
评分区间
reviewCount
区间
否
评论数区间
bsr
区间
否
BSR 排名区间
sellers
区间
否
跟卖卖家数区间
reviewGrowth
区间
否
评论增长量区间
amazonSales
区间
否
Amazon 公布的子体近30天销量区间
ratingShare
区间
否
评分商品占比区间
rankingChange
区间
否
BSR 变动区间
conversionRate
区间
否
转化率区间
crt
区间
否
点击转化率区间
revenueGrowth
区间
否
销售额环比增长区间
salesGrowth
区间
否
销量环比增长区间
salesGrowthYoy
区间
否
销量同比增长区间
salesGrowthYoy3
区间
否
销量同比连续 3 月增长区间
salesGrowthYoy6
区间
否
销量同比连续 6 月增长区间
questions
区间
否
Question 数量区间
weight
区间
否
重量区间
fbaFee
区间
否
FBA 费用区间
variations
区间
否
变体数区间
profit
区间
否
预估利润区间
lqs
区间
否
Listing 质量分区间
deliveryPrice
区间
否
配送费区间
launchDateFrom
string
否
上架开始日期，格式 yyyy-MM-dd
launchDateTo
string
否
上架结束日期，格式 yyyy-MM-dd
firstReviewDateFrom
string
否
首评开始日期，格式 yyyy-MM-dd
firstReviewDateTo
string
否
首评结束日期，格式 yyyy-MM-dd
productTags
string[]
否
商品标签过滤
mainImage
boolean
否
是否有主图视频/主图标记过滤
fulfillment
string[]
否
履约方式过滤；可选值：FBA、FBM
sellerNation
string[]
否
按卖家所属地过滤（国家/地区编码）
sellerType
string[]
否
卖家类型过滤；可选值：AMAZON、THIRD_PARTY
page
object
否
分页窗口
page.cursor
integer
否
offset 起点，默认 0。最大 2000；超过表示结果被截断，不代表名单已经取完；最小 0，最大 2000
page.size
integer
否
每页条数，默认 100；最小 1，最大 100
orderField
string
否
排序字段。支持: total_amount(销售额), total_units(销量), impression(曝光), conversion_rate(转化率)。默认 total_amount 降序；可选值：total_amount、total_units、impression、conversion_rate
desc
boolean
否
是否降序。默认 true
includeFields
string[]
否
同成本输出字段裁剪；不传或为空时返回默认字段集；可选值：asin、title、brand、price、currency、bsr、rating、reviewCount、monthlySales、monthlyRevenue、fulfillment、sellerName、sellerNation、badges、amzUnit、variations、lqs、profit、fba、questions、coupon；最多 21 项

返回字段

字段
类型
说明
dataMode
string
实际数据口径：NEAR_30_DAYS 或 MONTHLY；可选值：NEAR_30_DAYS、MONTHLY
dataMonth
string
实际命中的归档月份，格式 yyyyMM；近 30 天口径时为 null
items
object[]
 
items[].asin
string
ASIN
items[].title
string
标题
items[].brand
string
品牌
items[].price
number
当前价格
items[].currency
string
币种
items[].bsr
integer
BSR
items[].rating
number
评分
items[].reviewCount
integer
评分人数（ratings 口径）；非文字评论数
items[].monthlySales
integer
月销量估算（父体/月度表口径，非 Amazon 公布子体销量）
items[].monthlyRevenue
number
月销售额估算
items[].fulfillment
string
履约方式：FBA 或 FBM；可选值：FBA、FBM
items[].sellerName
string
卖家名称
items[].sellerNation
string
卖家所属地
items[].badges
string[]
标签
items[].amzUnit
integer
Amazon 自营销量（月度表口径）
items[].variations
integer
变体数
items[].lqs
integer
Listing 质量分（LQS）
items[].profit
number
利润估算
items[].fba
number
FBA 费用估算
items[].questions
integer
问答数
items[].coupon
string
优惠券信息（直降/折扣，如 [直降:5]）
page
object
 
page.cursor
integer
当前窗口起点
page.size
integer
当前窗口大小
page.hasMore
boolean
是否还有可以继续请求的下一页。下一页起点超过 maxTotalDepth 时为 false，不要再发请求
page.nextCursor
integer
下一页起点；没有下一页时省略
page.truncated
boolean
为 true 时表示名单因翻页深度上限被截断，不是已经取完。自然结束时省略
字段值缺失时返回 null。

示例

请求
{ "name": "asin.list", "arguments": { "marketplace": "US", "keyword": "slow feeder dog bowl non spill weighted", "searchType": "TITLE", "includeFields": [ "asin", "title", "brand", "price", "currency", "rating", "reviewCount", "monthlySales", "monthlyRevenue", "fulfillment", "variations" ], "page": { "cursor": 0, "size": 50 } } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "dataMode": "NEAR_30_DAYS", "dataMonth": null, "items": [ { "asin": "B0DZ7MLZ9P", "brand": "Yomp", "currency": "USD", "fulfillment": "FBA", "monthlyRevenue": 649.74, "monthlySales": 26, "price": 24.99, "rating": 4.3, "reviewCount": 15, "title": "Yomp BetterFeeder Puzzle Slow Feeder Dog Bowl – Interactive, Weighted Silicone Dog Bowl, BPA &amp; Phthalate Free, Spill-Proof, Non-Slip, Pet-Safe, Non-Toxic, Textured, Dishwasher Safe", "variations": 1 } ], "page": { "cursor": 0, "hasMore": false, "size": 50 } }

使用说明

  • keyword、asins、categoryId、brandInclude 至少提供一个，作为查询的起点。
  • 结果按规格（子体）逐行返回；monthlySales 等销量字段是整款（父体）口径，同一款的不同规格会显示相同的销量，请勿相加。
  • 需要按销量排行时传 orderField（如 total_units）和 desc；默认按销售额降序。
  • 区间类条件统一写成 {"min": …, "max": …}，可以只写一端。
  • 不传 dataMonth 时使用近 30 天数据；传入历史月份（yyyyMM）时使用该月归档数据。
  • 分页起点 cursor 最大 2000；返回里 hasMore 为 true 表示还有下一页。
 

商品内容（五点与图片） asin.content.list

用途

查询商品的五点描述原文和商品图片链接。
适合回答：
  • “这款的五点原文和主图给我。”
  • “参考竞品的五点，帮我改写我的五点。”
不适合时改用：
  • 查价格、评分等基础资料 → asin.detail

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
asin
string
是
ASIN；格式 ^B[0-9A-Z]{9}$

返回字段

字段
类型
说明
bullets
string[]
五点描述，原样返回站点语言，可为空数组
asin
string
ASIN
images
object[]
商品图片集，可为空数组；source=keepa 时为整套图集（首张为主图），source=asin_profile 时仅档案单主图。不做下载与转存
images[].source
string
图片来源：keepa=整套图集（Keepa imagesCSV 口径，非详情页实时顺序，不含 A+ 模块图）；asin_profile=档案单主图（仅首图）；可选值：keepa、asin_profile
images[].url
string
图片 URL
images[].capturedTime
string
Keepa 采集时间（ISO-8601 UTC）；asin_profile 来源为 null
images[].zoomUrl
string
放大图 URL
字段值缺失时返回 null。

示例

请求
{ "name": "asin.content.list", "arguments": { "marketplace": "US", "asin": "B0DP1D9BNW" } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "asin": "B0DP1D9BNW", "bullets": [ "Medium slow feeder dog bowl – helps slow down eating up to 10X; this SLOW level feeder is designed for small to medium dog breeds who need to slow their pace a little", "Holds 2 cups of dry or wet dog food – this shallow bowl has a simple puzzle feeder maze design and can fit a full meal for medium sized dogs", "Mindful mealtime – encourages slower eating and longer engagement, helping pups enjoy every bite while making mealtime more fun and interactive", "Multiple sizes, maze patterns, and 3 SLOW levels to choose from – Slow, Slower, or Slowest – to slow your dog down as much as needed; pick the perfect size and design for your unique pet", "Non-slip, food-safe, and easy to clean – our puzzle feeders are top-rack dishwasher-safe and made without BPAs, PVCs, lead, or phthalates" ], "images": [ { "capturedTime": "2026-10-25T01:47:58Z", "source": "keepa", "url": "https://images-na.ssl-images-amazon.com/images/I/81xPXugJDgL._AC_US200_.jpg", "zoomUrl": "https://images-na.ssl-images-amazon.com/images/I/81xPXugJDgL._AC_US600_.jpg" }, { "capturedTime": "2026-10-25T01:47:58Z", "source": "keepa", "url": "https://images-na.ssl-images-amazon.com/images/I/71yNv-i-6uL._AC_US200_.jpg", "zoomUrl": "https://images-na.ssl-images-amazon.com/images/I/71yNv-i-6uL._AC_US600_.jpg" } ] }

使用说明

  • 五点按原文返回，不做翻译或改写。
 

关联商品 asin.related.list

用途

查询商品在亚马逊站内的关联流量：经常一起购买、看了又看、相似商品对比、关联广告位等。
适合回答：
  • “这款经常和什么一起买？”
  • “买家看这款时还会看哪些竞品？”
不适合时改用：
  • 找直接竞品 → asin.list（按关键词或类目）

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
asin
string
是
目标 ASIN，v1 仅单个；格式 ^B[0-9A-Z]{9}$
relations
string[]
否
关联类型白名单；不传或为空时查全部支持的关联类型。FBT 表示 Frequently Bought Together（组合购买），基于共同购买行为，经常包含跨类目、与目标商品看似无关的商品（配件、赠品、场景性搭配等），这是该数据类型的正常特征，不代表数据质量问题，也不代表语义相似；可选值：MIB、FBT、CSI、COB、MIE、BAB、VAV、AVP、BAV、ASF、CPF、BCA、FSA、SP；最多 14 项
dataMonth
string
否
数据归档月份，格式 yyyyMM。仅当用户明确要求指定历史月份时才传；不要根据当前日期主动推断。不传时使用当前关联数据。仅支持已归档历史月份；传入不存在或未归档月份时，服务端回退当前关联数据。响应中的 dataMode / dataMonth 表示实际数据口径；格式 ^\d{6}$
page
object
否
分页窗口
page.cursor
integer
否
offset 起点，默认 0；最小 0，最大 3000
page.size
integer
否
每页条数，默认 100；累计翻页深度（cursor+size）上限 3000；最小 1，最大 100
orderField
string
否
排序字段：createdTime=引流时间（默认），relationCount=关联 ASIN 数；可选值：createdTime、relationCount
desc
boolean
否
是否降序，默认 true
includeFields
string[]
否
同成本输出字段裁剪；不传或为空时返回默认字段集；可选值：asin、title、brand、price、currency、rating、reviewCount、monthlySales、relations；最多 9 项

返回字段

字段
类型
说明
dataMode
string
实际数据口径：NEAR 表示当前关联数据，MONTHLY 表示指定归档月；可选值：NEAR、MONTHLY
dataMonth
string
实际命中的归档月份，格式 yyyyMM；当前关联数据口径为 null
items
object[]
 
items[].asin
string
ASIN
items[].title
string
标题
items[].brand
string
品牌
items[].price
number
当前价格
items[].currency
string
币种
items[].rating
number
评分
items[].reviewCount
integer
评分人数（ratings 口径）；非文字评论数
items[].monthlySales
integer
月销量估算（父体/月度表口径，非 Amazon 公布子体销量）
items[].relations
string[]
命中的关联类型；FBT=组合购买，基于共同购买行为，经常包含跨类目、与目标商品看似无关的商品（配件、赠品、场景性搭配等），这是该数据类型的正常特征，不代表数据质量问题，也不代表语义相似
page
object
 
page.cursor
integer
当前窗口起点
page.size
integer
当前窗口大小
page.truncated
boolean
为 true 时表示名单因翻页深度上限被截断，不是已经取完
page.hasMore
boolean
是否还有下一页
page.nextCursor
integer
下一页起点；没有下一页时省略
字段值缺失时返回 null。

示例

请求
{ "name": "asin.related.list", "arguments": { "asin": "B0725GYNG6", "marketplace": "US", "relations": [ "FBT" ], "orderField": "relationCount", "desc": true, "page": { "cursor": 0, "size": 10 }, "includeFields": [ "asin", "title", "brand", "price", "currency", "rating", "reviewCount", "monthlySales", "relations" ] } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "dataMode": "NEAR", "dataMonth": null, "items": [ { "asin": "B00004OCKR", "brand": "OXO", "currency": "USD", "monthlySales": 24532, "price": 32.92, "rating": 4.7, "relations": [ "FBT" ], "reviewCount": 55652, "title": "OXO Good Grips 6.22 Qt Salad Spinner, Vegetable Washer with Bowl &amp; Strainer" }, { "asin": "B07H7TW2Y6", "brand": "Ziruma", "currency": "USD", "monthlySales": 2105, "price": 39.95, "rating": 4.4, "relations": [ "FBT" ], "reviewCount": 1404, "title": "Non-Toxic Acacia Wood Cutting Board, Mineral Oil &amp; Plastic Free, 16x11 in" } ], "page": { "cursor": 0, "hasMore": true, "nextCursor": 10, "size": 10 } }

使用说明

  • 结果来自亚马逊的购买和浏览行为，不代表商品相似。“经常一起购买”（FBT）里出现跨类目的配件、搭配商品属于正常情况。
  • relations 不传时返回全部关联类型；可传入一个或多个类型只看指定关联。

销量与价格

 

月度销量趋势 asin.sales.trend

用途

查询商品按月的销量、销售额、价格、BSR、评分、评论数走势，同时提供整款（父体）和单个规格（子体）两种销量口径。
适合回答：
  • “这款 2026 年 3–8 月每个月卖了多少？”
  • “这个规格和整条链接 8 月分别卖了多少？”
  • “销量哪个月变化最大？”
不适合时改用：
  • 最近 30 天逐日销量 → asin.prediction.sales
  • 逐日价格、优惠券 → keepa.trend

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
asin
string
是
ASIN 或父体 ASIN；传入什么就查什么，服务端不做子/父转换；格式 ^B[0-9A-Z]{9}$
metrics
string[]
是
月度趋势指标，至少一个，不允许重复。口径：parentSales=父体月销量（该父体下所有跟卖销量之和）；childSales=子体月销量（亚马逊搜索页 'X+ bought in past month' 月度快照，搜索页显示 '-' 即无该数据）；parentSalesAmount/childSalesAmount 为对应月销售额；price/bsr/rating/reviews 为该月最后一个有效日数据点的快照值（期末值，非月均/非月合计）；月均价请用 keepa.trend metrics=[price] 取整月日数据等权平均，并注明覆盖天数；可选值：parentSales、childSales、parentSalesAmount、childSalesAmount、price、bsr、rating、reviews；最少 1 项，最多 8 项
monthRange
object
否
月度窗口；月份落在 [startDate, endDate] 闭区间内才返回
monthRange.endDate
string
否
结束月，格式 yyyy-MM。晚于最新可用月份时截断到最新可用月份。窗口上限 60 个月
monthRange.startDate
string
否
起始月，格式 yyyy-MM。与 endDate 同时缺省时为最新可用月份往前 12 个自然月

返回字段

字段
类型
说明
asin
string
ASIN（与请求一致，未做父子转换）
metrics
string[]
本次返回的指标
series
object
按指标键组织的月度序列；只包含本次选择的指标。parentSales=父体月销量（所有跟卖之和）；childSales=子体月销量（亚马逊搜索页 'X+ bought in past month' 月度快照）；price/bsr/rating/reviews 为该月最后一个有效日数据点的快照值（期末值，非月均价）
series.parentSales
object[]
 
series.parentSales[].value
number
趋势点数值
series.parentSales[].date
string
月份，格式 yyyy-MM（月表/搜索页快照键原样，不转每月 1 日）
series.childSales
object[]
 
series.childSales[].value
number
趋势点数值
series.childSales[].date
string
月份，格式 yyyy-MM（月表/搜索页快照键原样，不转每月 1 日）
series.parentSalesAmount
object[]
 
series.parentSalesAmount[].value
number
趋势点数值
series.parentSalesAmount[].date
string
月份，格式 yyyy-MM（月表/搜索页快照键原样，不转每月 1 日）
series.childSalesAmount
object[]
 
series.childSalesAmount[].value
number
趋势点数值
series.childSalesAmount[].date
string
月份，格式 yyyy-MM（月表/搜索页快照键原样，不转每月 1 日）
series.price
object[]
 
series.price[].value
number
趋势点数值
series.price[].date
string
月份，格式 yyyy-MM（月表/搜索页快照键原样，不转每月 1 日）
series.bsr
object[]
 
series.bsr[].value
number
趋势点数值
series.bsr[].date
string
月份，格式 yyyy-MM（月表/搜索页快照键原样，不转每月 1 日）
series.rating
object[]
 
series.rating[].value
number
趋势点数值
series.rating[].date
string
月份，格式 yyyy-MM（月表/搜索页快照键原样，不转每月 1 日）
series.reviews
object[]
 
series.reviews[].value
number
趋势点数值
series.reviews[].date
string
月份，格式 yyyy-MM（月表/搜索页快照键原样，不转每月 1 日）
recentDailySales
object[]
近 30 天逐日估算销量（以查询日为终点的滚动 30 天窗口，预测口径，含 5 日均线，日期跨自然月，勿当自然月合计使用）；仅部分 ASIN 有，无时为 null
recentDailySales[].date
string
日期，格式 yyyy-MM-dd
recentDailySales[].dailySales
number
当日销量估算
recentDailySales[].dailySales5MA
number
当日销量 5 日移动平均
recentDailySales[].bsr
integer
当日 BSR
recentDailySales[].price
number
UTC 每日末点价格
recentDailySales[].rating
number
当日评分
recentDailySales[].reviews
integer
当日评论数
parentChangeHis
object[]
父体构成变化历史（变更日期 + 变更后的父体 ASIN）；无变化或无数据时为 null 或空数组。用于解读 parentSales 断崖式变化是否由父体构成变化导致
parentChangeHis[].parentAsin
string
变更后的父体 ASIN
parentChangeHis[].date
string
父体变更日期，格式 yyyy-MM-dd
字段值缺失时返回 null。

示例

请求
{ "name": "asin.sales.trend", "arguments": { "asin": "B07N7KFHVH", "marketplace": "US", "metrics": [ "parentSales", "childSales", "parentSalesAmount", "childSalesAmount", "price" ], "monthRange": { "startDate": "2026-03", "endDate": "2026-08" } } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "asin": "B07N7KFHVH", "metrics": [ "parentSales", "childSales", "parentSalesAmount", "childSalesAmount", "price" ], "parentChangeHis": [ { "date": "2024-10-16", "parentAsin": "B0D58N8WRB" }, { "date": "2024-10-16", "parentAsin": "B0DK3RTNRK" } ], "recentDailySales": [ { "bsr": 569, "dailySales": 293.0, "dailySales5MA": 293.0, "date": "2026-09-27" }, { "bsr": 528, "dailySales": 317.0, "dailySales5MA": 305.0, "date": "2026-09-28" } ], "series": { "parentSales": [ { "date": "2026-03", "value": 14797 }, { "date": "2026-04", "value": 14342 } ], "childSales": [ { "date": "2026-03", "value": 7000 }, { "date": "2026-04", "value": 7000 } ], "parentSalesAmount": [ { "date": "2026-03", "value": 186886.11 }, { "date": "2026-04", "value": 165936.94 } ], "childSalesAmount": [ { "date": "2026-03", "value": 88410.0 }, { "date": "2026-04", "value": 80990.0 } ], "price": [ { "date": "2026-03", "value": 8.49 }, { "date": "2026-04", "value": 8.49 } ] } }

使用说明

  • parentSales 为整款月销量；childSales 为该规格的月销量，来自亚马逊搜索页“X+ bought in past month”的月度快照，页面没有显示时为空。
  • price、bsr、rating、reviews 为该月最后一个有效日的数值（期末值），不是月平均。月均价请用 keepa.trend 的逐日价格计算。
  • 传入什么 ASIN 就查什么，服务端不做父子体转换。查整款销量建议直接传父体 ASIN（可用 asin.detail 的 parentAsin 获得）。
  • 返回中的 parentChangeHis 记录了这个商品所属父体的变更历史，变更前后的整款销量可能属于不同的父体。
  • recentDailySales 是以查询日为终点的近 30 天逐日估算，跨自然月，不能当作某个自然月的合计。
  • monthRange 不传时，默认返回最新可用月份往前 12 个月，最长 60 个月。
 

近期逐日销量估算 asin.prediction.sales

用途

查询商品最近 N 天（1–65 天）每天的估算销量和 BSR，并给出区间合计和日均。
适合回答：
  • “这款最近 30 天每天大概卖多少？”
  • “最近两周销量是在涨还是在跌？”
不适合时改用：
  • 按月看销量 → asin.sales.trend
  • 只知道排名、想估销量 → bsr.prediction.sales

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
asin
string
是
ASIN；格式 ^B[0-9A-Z]{9}$
days
integer
否
最近估算天数，缺省 27；1 到 65。截止最近一个已有估算日，不是今天之后的未来天数；最小 1，最大 65

返回字段

字段
类型
说明
asin
string
ASIN
days
integer
实际返回的估算天数
dateRange
object
实际返回的估算日期窗口；无估算点时为 null
dateRange.endDate
string
返回窗口结束日期，格式 yyyy-MM-dd
dateRange.startDate
string
返回窗口开始日期，格式 yyyy-MM-dd
daily
object[]
 
daily[].date
string
估算日期，格式 yyyy-MM-dd。截止最近一个已有估算日
daily[].predictedSales
number
该日历史估算销量（截至查询日，非未来预测；按请求 ASIN 口径，不自动聚合父体全部变体）
daily[].bsr
integer
该日历史估算 BSR（截至查询日）
summary
object
 
summary.avgDailySales
number
日均历史销量估算（截至查询日，非未来预测；按请求 ASIN 口径）
summary.totalPredictedSales
number
本次返回窗口内逐日估算销量求和（截至查询日的历史窗口，非未来预测；按请求 ASIN 口径）
字段值缺失时返回 null。

示例

请求
{ "name": "asin.prediction.sales", "arguments": { "asin": "B0725GYNG6", "marketplace": "US", "days": 2 } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "asin": "B0725GYNG6", "daily": [ { "bsr": 377, "date": "2026-10-25", "predictedSales": 382.0 }, { "bsr": 318, "date": "2026-10-26", "predictedSales": 425.0 } ], "dateRange": { "startDate": "2026-10-25", "endDate": "2026-10-26" }, "days": 2, "summary": { "avgDailySales": 403.5, "totalPredictedSales": 807.0 } }

使用说明

  • 返回的是过去到最近一个有估算数据的日期为止的估算值，不是对未来的预测；字段名中的 predicted 指“估算”。
  • 估算值根据 BSR 推算，不是真实订单数。
 

按排名估销量 bsr.prediction.sales

用途

根据一级类目和大类 BSR 排名，估算这个排名对应的日销量和月销量。
适合回答：
  • “Home & Kitchen 大类第 1000 名，一天、一个月大概能卖多少？”
不适合时改用：
  • 已有具体商品 → asin.prediction.sales 或 asin.sales.trend

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
categoryId
string
是
一级类目节点 id，查产品类目返回
bsr
integer
是
大类 BSR 排名，1 到 10000000；最小 1，最大 10000000
includeFields
string[]
否
同成本输出字段裁剪；不传或为空时返回默认字段集（marketplace、categoryId、bsr、estDailySales、estMonSales）；rankSales、curveSales、linerParams 为 BSR 区间明细，需显式选择；可选值：marketplace、categoryId、bsr、estDailySales、estMonSales、rankSales、curveSales、linerParams；最多 8 项

返回字段

字段
类型
说明
marketplace
string
站点代码
categoryId
string
一级类目节点 id
bsr
integer
查询的大类 BSR 排名
estDailySales
number
预测日销量（估算口径）
estMonSales
number
预测近 30 天销量
rankSales
object
xgboost 排序销量曲线；BSR 范围 [bsr-1000, bsr+1000]，最小 1。 key 为 BSR（字符串），value 为该 BSR 的预测日销量；未选择该字段或无数据时为 null
curveSales
object
curve 排序销量曲线；范围同 rankSales。 key 为 BSR（字符串），value 为该 BSR 的预测日销量；未选择该字段或无数据时为 null
linerParams
number[]
一次函数参考线参数 [w, b]，daily_sales = w * daily_bsr + b
字段值缺失时返回 null。

示例

请求
{ "name": "bsr.prediction.sales", "arguments": { "marketplace": "US", "categoryId": "1055398", "bsr": 1000, "includeFields": [ "marketplace", "categoryId", "bsr", "estDailySales", "estMonSales" ] } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "bsr": 1000, "categoryId": "1055398", "curveSales": null, "estDailySales": 469.16, "estMonSales": 14074.8, "linerParams": null, "marketplace": "US", "rankSales": null }

使用说明

  • categoryId 需为一级类目节点。
  • estMonSales 为日销量 × 30 的估算，不是逐日累加。
  • 排名区间明细（rankSales、curveSales、linerParams）需要在 includeFields 中显式指定。
 

价格与排名历史 keepa.trend

用途

查询商品的逐日历史：价格、促销价、购物车价格与卖家、BSR（大类和小类）、评分、评论数、卖家数、优惠券等 15 项指标。
适合回答：
  • “这款 8 月有没有降价或发优惠券？”
  • “购物车价格和卖家有没有变化？”
  • “8 月每天的价格和 BSR 给我。”
不适合时改用：
  • 按月看销量 → asin.sales.trend

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
asin
string
是
ASIN 或父体 ASIN；格式 ^B[0-9A-Z]{9}$
metrics
string[]
否
时序指标，可选。缺省返回常用 5 个：price/bsr/rating/reviews/sellers；需要其他指标（dealPrice/buybox/priceList/priceFBA/priceFBM/pricePrime/buyBoxSellerIdHistory/subSalesRank/monthlySoldHistory/couponHistory）时显式传入，可一次传全部 15 个。monthlySoldHistory 是 Keepa 子体销量快照，不是父体自然月销量，不能替代 asin.sales.trend 的 parentSales。price 为 UTC 每日最后一个数据点价格，可作为月均价计算源（整月等权平均）；可选值：price、dealPrice、buybox、priceList、priceFBA、priceFBM、pricePrime、buyBoxSellerIdHistory、bsr、subSalesRank、reviews、rating、sellers、monthlySoldHistory、couponHistory；最多 15 项
dateRange
object
否
查询日期窗口；缺省近 3 个月，上限 12 个月
dateRange.endDate
string
否
结束日期，格式 yyyy-MM-dd。缺省为当前日期。窗口上限 12 个月，超限报错
dateRange.startDate
string
否
开始日期，格式 yyyy-MM-dd。缺省为当前日期往前 3 个月

返回字段

字段
类型
说明
asin
string
实际返回数据的 ASIN（关联命中时可能与请求不同）
dataAsin
string
Keepa 数据实际归属的 ASIN
parentAsin
string
父体 ASIN；无父体时为 null
title
string
商品标题
brand
string
品牌
rootCategory
string
根类目 id
rootCategoryLabel
string
根类目名称
nodeIdPath
string
类目节点路径 id
nodeLabelPath
string
类目节点路径名称
metrics
string[]
本次返回的指标
ts
integer[]
共享时间轴（秒级时间戳，升序，按 UTC 自然日去重，每日保留当日最后一个数据点）
series
object
按指标名组织的值数组；与顶层 ts 共享时间轴（UTC 自然日粒度，每日保留当日最后一个数据点），数组长度与 ts 等长
series.price
number[]
与 ts 等长的值数组；null 表示该指标在该日期无数据；浮点保留 2 位小数
series.dealPrice
number[]
与 ts 等长的值数组；null 表示该指标在该日期无数据；浮点保留 2 位小数
series.buybox
number[]
与 ts 等长的值数组；null 表示该指标在该日期无数据；浮点保留 2 位小数
series.priceList
number[]
与 ts 等长的值数组；null 表示该指标在该日期无数据；浮点保留 2 位小数
series.priceFBA
number[]
与 ts 等长的值数组；null 表示该指标在该日期无数据；浮点保留 2 位小数
series.priceFBM
number[]
与 ts 等长的值数组；null 表示该指标在该日期无数据；浮点保留 2 位小数
series.pricePrime
number[]
与 ts 等长的值数组；null 表示该指标在该日期无数据；浮点保留 2 位小数
series.buyBoxSellerIdHistory
number[]
与 ts 等长的值数组；null 表示该指标在该日期无数据；浮点保留 2 位小数
series.bsr
number[]
与 ts 等长的值数组；null 表示该指标在该日期无数据；浮点保留 2 位小数
series.subSalesRank
number[]
与 ts 等长的值数组；null 表示该指标在该日期无数据；浮点保留 2 位小数
series.reviews
number[]
与 ts 等长的值数组；null 表示该指标在该日期无数据；浮点保留 2 位小数
series.rating
number[]
与 ts 等长的值数组；null 表示该指标在该日期无数据；浮点保留 2 位小数
series.sellers
number[]
与 ts 等长的值数组；null 表示该指标在该日期无数据；浮点保留 2 位小数
series.monthlySoldHistory
number[]
与 ts 等长的值数组；null 表示该指标在该日期无数据；浮点保留 2 位小数
series.couponHistory
number[]
与 ts 等长的值数组；null 表示该指标在该日期无数据；浮点保留 2 位小数
字段值缺失时返回 null。

示例

请求
{ "name": "keepa.trend", "arguments": { "asin": "B0725GYNG6", "marketplace": "US", "dateRange": { "startDate": "2026-08-01", "endDate": "2026-08-31" }, "metrics": [ "price", "bsr" ] } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "asin": "B0725GYNG6", "brand": "Amazon Basics", "dataAsin": "B0725GYNG6", "metrics": [ "price", "bsr" ], "nodeIdPath": "1055398:284507:289668:289719:3736921", "nodeLabelPath": "Home & Kitchen:Kitchen & Dining:Bakeware:Baking Tools & Accessories:Baking Mats", "parentAsin": "B0HLL4Y52C", "rootCategory": "1055398", "rootCategoryLabel": "Home & Kitchen", "series": { "price": [ 13.59, 13.59, 13.59, 13.59, 13.59, 13.59 ], "dealPrice": [ null, null, null, null, null, null ], "buybox": [ null, null, null, null, null, null ], "priceList": [ null, null, null, null, null, null ], "priceFBA": [ null, null, null, null, null, null ], "priceFBM": [ null, null, null, null, null, null ], "pricePrime": [ null, null, null, null, null, null ], "bsr": [ 568.0, 558.0, 528.0, 515.0, 521.0, 485.0 ], "reviews": [ null, null, null, null, null, null ], "rating": [ null, null, null, null, null, null ], "sellers": [ null, null, null, null, null, null ], "monthlySoldHistory": [ null, null, null, null, null, null ], "buyBoxSellerIdHistory": [ null, null, null, null, null, null ], "couponHistory": [ null, null, null, null, null, null ] }, "title": "Amazon Basics Silicone Rectangular Baking Mat, Non-Stick, Reusable, Dishwasher Safe, Food Safe, Heat Resistant, 16.5\" x 11.6\", Beige/Gray, 2-Pack", "ts": [ 1785618480, 1785711000, 1785797040, 1785881160, 1785963540, 1786055400 ] }

使用说明

  • 所有指标共用一条时间轴：ts 为按 UTC 自然日去重后的时间点（秒级时间戳、升序，每天保留当天最后一个数据点）；series 中每个指标的数组与 ts 等长，null 表示该指标当天无数据。
  • metrics 不传时默认返回 price、bsr、rating、reviews、sellers 5 项；其余指标需显式传入，一次最多 15 项。
  • 日期窗口默认近 3 个月，最长 12 个月。
  • monthlySoldHistory 是单个规格的“近一个月购买人数”快照，不是整款月销量；整款月销量请用 asin.sales.trend 的 parentSales。

类目市场

 

类目搜索 category.search

用途

按类目名或产品词查找类目，返回类目的完整节点路径；也可以列出某个类目的子类目。
适合回答：
  • “美国站 Kitchen & Dining 的类目编号是什么？”
  • “压蒜器属于哪个类目？”
  • “这个类目下面有哪些子类目？”
不适合时改用：
  • 按条件筛选多个类目 → category.stats.list

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
keyword
string
否
类目名或产品词，缺省不做关键词过滤。按类目名检索是获取完整节点路径的推荐方式（返回的 categoryId 即完整路径）
categoryId
string
否
类目节点 ID 完整路径，传入时返回其子类目。深层节点的短节点 ID 无法解析；其他类目工具传短节点 ID 会查不到数据
includeSubcategories
boolean
否
是否包含子类目；缺省包含子类目
page
object
否
分页窗口
page.size
integer
否
每页条数，默认 100；最小 1，最大 100
page.cursor
integer
否
offset 起点，默认 0；最小 0，最大 3000

返回字段

字段
类型
说明
items
object[]
 
items[].categoryId
string
类目节点 ID 完整路径（可直接用作其他类目工具的 categoryId）
items[].name
string
类目名称
items[].nodePath
string[]
类目路径
items[].productCount
integer
类目搜索节点的商品数量（来自 bsr_sales_nearly 表，反映近30天快照的在售商品数，与类目报告/需求报告的商品数口径不同）
page
object
 
page.cursor
integer
 
page.size
integer
 
page.truncated
boolean
为 true 时表示名单因翻页深度上限被截断，不是已经取完
page.hasMore
boolean
 
page.nextCursor
integer
下一页起点；没有下一页时省略
字段值缺失时返回 null。

示例

请求
{ "name": "category.search", "arguments": { "marketplace": "US", "keyword": "Scrubbers", "includeSubcategories": true, "page": { "cursor": 0, "size": 100 } } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "items": [ { "categoryId": "16310091:317971011:3310260011:3310269011", "name": "Industrial & Scientific:Janitorial & Sanitation Supplies:Cleaning Tools:Scouring Pads & Scrubbers", "nodePath": [ "Industrial & Scientific:Janitorial & Sanitation Supplies:Cleaning Tools:Scouring Pads & Scrubbers" ], "productCount": 268 } ], "page": { "cursor": 0, "hasMore": false, "size": 100 } }

使用说明

  • 其他类目工具的 categoryId 都需要完整节点路径（如 1055398:284507:289668:289719:3736921），请先用本工具获取。
  • 按类目名匹配。非英语站点请使用当地语言的类目名（如德国站用 Näpfe）；搜不到时可先搜上一级类目，再逐级查看子类目。
 

类目筛选与对比 category.stats.list

用途

按市场规模、价格、竞争、新品、卖家结构等几十项指标批量筛选类目，或者对比多个类目。
适合回答：
  • “厨房用品里，平均售价 20–40 美元、平均评价数不超过 500 的细分类目有哪些？”
  • “哪些细分类目新品销量占比高？”
不适合时改用：
  • 已确定一个类目、看它的详细报告 → category.report.detail
  • 看类目内部的价格带、评分等分布 → category.trend

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
categoryId
string
是
类目节点 ID 完整路径（冒号分隔，如 1055398:284507:289668:289719:3736921）；深层节点的短节点 ID 会查不到数据，请先用 category.search(keyword=类目名) 获取完整路径
dataRange
string
否
查询数据范围：LAST_30_DAYS=近30天（默认）；LAST_24_MONTHS=近24个月；可选值：LAST_30_DAYS、LAST_24_MONTHS
departmentKeyword
string
否
类目名关键词
language
string
否
类目名称语言。EN=英文原始名称，CN=中文翻译（默认）；可选值：EN、CN
sampleCount
integer
否
统计样本档位 100/200/300/400/500，默认 100；该档位决定各月 TopN 样本切分与汇总去重范围。LAST_30_DAYS 与 LAST_24_MONTHS 均支持；最小 100，最大 500
sellerNation
string
否
卖家所属地过滤
orderField
string
否
排序字段，缺省 total_sales。LAST_30_DAYS 支持 total_products/brands/sellers/total_sales/total_revenue/avg_sales/avg_revenue/avg_price/avg_reviews/avg_rating/avg_bsr/avg_volume/avg_weight/avg_profit/yoy_growth_rate/ranking/top_products/top3_avg_/top5_avg_/top10_avg_*/l1|l3|l6|l12_new_avg_rating；LAST_24_MONTHS 支持 total_products/brands/sellers/total_sales/total_revenue/avg_sales/annual_growth_rate/yoy_growth_rate/avg_revenue/avg_price/weighted_avg_price/avg_bsr/avg_ratings/avg_rating/avg_volume/avg_weight/avg_profit/avg_sellers/ebc_ratio/amz_ratio/fba_ratio/fbm_ratio；可选值：total_products、brands、sellers、total_sales、total_revenue、avg_sales、avg_revenue、avg_price、avg_reviews、avg_rating、avg_bsr、avg_volume、avg_weight、avg_profit、yoy_growth_rate、ranking、top_products、top3_avg_bsr、top3_avg_sales、top3_avg_revenue、top5_avg_bsr、top5_avg_sales、top5_avg_revenue、top10_avg_bsr、top10_avg_sales、top10_avg_revenue、l1_new_avg_rating、l3_new_avg_rating、l6_new_avg_rating、l12_new_avg_rating、annual_growth_rate、weighted_avg_price、avg_ratings、avg_sellers、ebc_ratio、amz_ratio、fba_ratio、fbm_ratio
desc
boolean
否
是否降序，默认 true
page
object
否
分页窗口
page.cursor
integer
否
offset 起点，默认 0；最小 0，最大 3000
page.size
integer
否
每页条数，默认 100；最小 1，最大 100
totalProducts
区间
否
商品总数区间过滤。两种口径均支持
avgSales
区间
否
平均销量区间过滤。仅 LAST_30_DAYS 支持
avgRevenue
区间
否
平均销售额区间过滤。仅 LAST_30_DAYS 支持
avgPrice
区间
否
平均价格区间过滤。两种口径均支持
avgRating
区间
否
平均星级区间过滤。仅 LAST_30_DAYS 支持
avgBsr
区间
否
平均 BSR 区间过滤。仅 LAST_30_DAYS 支持
avgWeight
区间
否
平均重量区间过滤。两种口径均支持
avgProfit
区间
否
平均利润区间过滤。仅 LAST_30_DAYS 支持
brands
区间
否
品牌数区间过滤。两种口径均支持
sellers
区间
否
卖家数区间过滤。两种口径均支持
avgSellers
区间
否
平均卖家数区间过滤。两种口径均支持
sellerRatio
区间
否
国别卖家占比区间过滤（sellerNation 对应国家的卖家占比）。两种口径均支持
amzRatio
区间
否
自营占比区间过滤。两种口径均支持
ebcRatio
区间
否
A+ 页面占比区间过滤。两种口径均支持
fbaProportion
区间
否
FBA 占比区间过滤。两种口径均支持
fbmRatio
区间
否
FBM 占比区间过滤。两种口径均支持
newProportion
区间
否
新品占比区间过滤。两种口径均支持
brandConcentration
区间
否
头部品牌集中度区间过滤（头部 3 品牌销量份额；部分归档表为 top5 口径）。两种口径均支持
productConcentration
区间
否
头部商品集中度区间过滤（头部 3 商品口径；部分归档表为 top5）。两种口径均支持
sellerConcentration
区间
否
头部卖家集中度区间过滤（头部 3 卖家口径；部分归档表为 top5）。两种口径均支持
headListingAvgSales
区间
否
头部商品平均销量区间过滤。两种口径均支持
headListingAvgRevenue
区间
否
头部商品平均销售额区间过滤。两种口径均支持
headListingAvgBsr
区间
否
头部商品平均 BSR 区间过滤。仅 LAST_30_DAYS 支持
newAvgSales
区间
否
新品销量区间过滤。LAST_30_DAYS 为新品平均销量；LAST_24_MONTHS 实际过滤新品总销量，注意口径差异
newAvgRevenue
区间
否
新品销售额区间过滤。LAST_30_DAYS 为新品平均销售额；LAST_24_MONTHS 实际过滤新品总销售额，注意口径差异
newAvgPrice
区间
否
新品价格区间过滤。LAST_30_DAYS 为新品平均价；LAST_24_MONTHS 为新品加权均价
newAvgRating
区间
否
新品平均星级区间过滤。两种口径均支持
newAvgReviews
区间
否
新品平均评论数区间过滤。仅 LAST_30_DAYS 支持
newSalesRatio
区间
否
新品销量占比区间过滤。两种口径均支持
returnRatio
区间
否
退货率区间过滤。仅 LAST_24_MONTHS 支持
totalSales
区间
否
类目总销量区间过滤。两种口径均支持
totalRevenue
区间
否
类目总销售额区间过滤。两种口径均支持
yoyGrowthRate
区间
否
同比增长率区间过滤（小数，0.15 表示 15%）。两种口径均支持
annualGrowthRate
区间
否
年增长率区间过滤。仅 LAST_24_MONTHS 支持
avgVolume
区间
否
平均体积区间过滤。两种口径均支持
avgReviews
区间
否
全商品平均评论数区间过滤。仅 LAST_30_DAYS 支持
newCount
区间
否
新品数量区间过滤。仅 LAST_30_DAYS 支持
sellerNations
string[]
否
卖家归属地多值过滤，如 ["CN","US"]
tags
string[]
否
类目标签过滤。仅 LAST_24_MONTHS 支持

返回字段

字段
类型
说明
dataRange
string
数据范围：LAST_30_DAYS / LAST_24_MONTHS
items
object[]
类目统计行；字段为两种口径的并集，未命中口径的字段为 null
items[].marketId
integer
站点市场 ID
items[].currency
string
货币代码
items[].nodeIdPath
string
类目节点 ID 路径
items[].nodeLabelPathLocale
string
类目名称路径（本地化）
items[].ranking
integer
排名
items[].currentMonth
integer
统计月份 yyyyMM。近 30 天口径为 null，210001 不是月份
items[].sampleCount
integer
各月 Top{档位} 样本按 ASIN 去重后的商品总数（跨月汇总值，非档位值、非单月样本数；单月样本数见 monthlyList[].products，仅 category.report.detail 提供）
items[].totalProducts
integer
商品总数
items[].brands
integer
品牌数
items[].sellers
integer
卖家数
items[].totalSales
integer
月总销量（类目聚合口径，不区分单个父体/子体）
items[].totalRevenue
number
月总销售额
items[].avgSales
integer
月均销量（类目聚合口径，不区分单个父体/子体）
items[].avgRevenue
number
月均销售额
items[].avgPrice
number
平均价格
items[].weightedAvgPrice
number
加权平均价格（仅近24个月口径）
items[].avgBsr
integer
平均 BSR
items[].avgRatings
integer
平均评分数（仅近24个月口径）
items[].avgRating
number
平均星级
items[].avgProfit
number
平均利润率
items[].avgSellers
number
平均卖家数（仅近24个月口径）
items[].ebcRatio
number
A+ 商品占比（仅近24个月口径）
items[].amzRatio
number
Amazon 自营占比（仅近24个月口径）
items[].fbaRatio
number
FBA 占比（仅近24个月口径）
items[].fbmRatio
number
FBM 占比（仅近24个月口径）
items[].sellerNation
string
头部样本卖家归属地 code（仅近24个月口径）
items[].sellerNationLabel
string
头部样本卖家归属地（仅近24个月口径）
items[].sellerRatio
number
头部样本卖家归属地占比（仅近24个月口径）
items[].returnRatio
number
退货率（仅近24个月口径）
items[].avgReturnRatio
number
同类目平均退货率（仅近24个月口径）
items[].searchToPurchaseRatio
number
搜索购买比（仅近24个月口径）
items[].avgSearchToPurchaseRatio
number
同类目搜索购买比（仅近24个月口径）
items[].glanceViews
integer
浏览量（仅近24个月口径）
items[].avgReviews
integer
全商品平均评论数。仅近30天口径
items[].yoyGrowthRate
number
同比增长率（小数）。两种口径
items[].annualGrowthRate
number
年增长率（小数）。仅近24个月口径
items[].avgVolume
number
平均体积。两种口径
items[].avgWeight
number
平均重量。两种口径
items[].topProducts
integer
TopN 样本商品数。仅近30天口径
items[].collectFlag
integer
采集标记。仅近30天口径
items[].top3AvgBsr
integer
头部 3 口径指标。两种口径
items[].top3AvgSales
integer
头部 3 口径指标。两种口径
items[].top3AvgRevenue
number
头部 3 口径指标。两种口径
items[].top5AvgBsr
integer
头部 5 口径指标。两种口径
items[].top5AvgSales
integer
头部 5 口径指标。两种口径
items[].top5AvgRevenue
number
头部 5 口径指标。两种口径
items[].top10AvgBsr
integer
头部 10 口径指标。两种口径
items[].top10AvgSales
integer
头部 10 口径指标。两种口径
items[].top10AvgRevenue
number
头部 10 口径指标。两种口径
items[].top20AvgBsr
integer
头部 20 口径指标。两种口径
items[].top20AvgSales
integer
头部 20 口径指标。两种口径
items[].top20AvgRevenue
number
头部 20 口径指标。两种口径
items[].top3ProductSales
integer
头部 3 口径指标。两种口径
items[].top3BrandSales
integer
头部 3 口径指标。两种口径
items[].top3SellerSales
integer
头部 3 口径指标。两种口径
items[].top3ProductRevenue
number
头部 3 口径指标。两种口径
items[].top3BrandRevenue
number
头部 3 口径指标。两种口径
items[].top3SellerRevenue
number
头部 3 口径指标。两种口径
items[].top3ProductCrn
number
头部 3 口径指标。两种口径
items[].top3BrandCrn
number
头部 3 口径指标。两种口径
items[].top3SellerCrn
number
头部 3 口径指标。两种口径
items[].top5ProductSales
integer
头部 5 口径指标。两种口径
items[].top5BrandSales
integer
头部 5 口径指标。两种口径
items[].top5SellerSales
integer
头部 5 口径指标。两种口径
items[].top5ProductRevenue
number
头部 5 口径指标。两种口径
items[].top5BrandRevenue
number
头部 5 口径指标。两种口径
items[].top5SellerRevenue
number
头部 5 口径指标。两种口径
items[].top5ProductCrn
number
头部 5 口径指标。两种口径
items[].top5BrandCrn
number
头部 5 口径指标。两种口径
items[].top5SellerCrn
number
头部 5 口径指标。两种口径
items[].top10ProductSales
integer
头部 10 口径指标。两种口径
items[].top10BrandSales
integer
头部 10 口径指标。两种口径
items[].top10SellerSales
integer
头部 10 口径指标。两种口径
items[].top10ProductRevenue
number
头部 10 口径指标。两种口径
items[].top10BrandRevenue
number
头部 10 口径指标。两种口径
items[].top10SellerRevenue
number
头部 10 口径指标。两种口径
items[].top10ProductCrn
number
头部 10 口径指标。两种口径
items[].top10BrandCrn
number
头部 10 口径指标。两种口径
items[].top10SellerCrn
number
头部 10 口径指标。两种口径
items[].top20ProductSales
integer
头部 20 口径指标。两种口径
items[].top20BrandSales
integer
头部 20 口径指标。两种口径
items[].top20SellerSales
integer
头部 20 口径指标。两种口径
items[].top20ProductRevenue
number
头部 20 口径指标。两种口径
items[].top20BrandRevenue
number
头部 20 口径指标。两种口径
items[].top20SellerRevenue
number
头部 20 口径指标。两种口径
items[].top20ProductCrn
number
头部 20 口径指标。两种口径
items[].top20BrandCrn
number
头部 20 口径指标。两种口径
items[].top20SellerCrn
number
头部 20 口径指标。两种口径
items[].newCount
integer
新品数量（近 3 个月口径）
items[].newRatio
number
新品占比（新品数 / 样本数，0-1 小数）
items[].newAvgSales
integer
新品平均销量
items[].newSalesRatio
number
新品销量占比（新品总销量 / 类目总销量，0-1 小数）
page
object
 
page.cursor
integer
当前 offset
page.size
integer
每页条数
page.hasMore
boolean
是否还有下一页
page.nextCursor
integer
下一页 offset；没有下一页时为 null
periodStart
string
数据实际覆盖的日期区间起点，格式 yyyy-MM-dd
periodEnd
string
数据实际覆盖的日期区间终点，格式 yyyy-MM-dd
sampleCount
integer
本次请求的样本档位（如 100/200/300/400/500）
字段值缺失时返回 null。

示例

请求
{ "name": "category.stats.list", "arguments": { "categoryId": "2619533011", "marketplace": "US", "dataRange": "LAST_30_DAYS", "sampleCount": 100, "avgPrice": { "min": 18, "max": 45 }, "avgReviews": { "max": 800 }, "productConcentration": { "max": 0.35 }, "brandConcentration": { "max": 0.35 }, "orderField": "avg_sales", "desc": true, "page": { "cursor": 0, "size": 20 }, "language": "CN" } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "dataRange": "LAST_30_DAYS", "items": [ { "avgBsr": 47011, "avgPrice": 19.32, "avgProfit": 59.8, "avgRating": 4.6, "avgRevenue": 3395.0, "avgReviews": 340, "avgSales": 199, "avgVolume": 157.62, "avgWeight": 0.6712, "brands": 91, "collectFlag": 0, "currency": "USD", "marketId": 1, "newAvgSales": 177, "newCount": 5, "newRatio": 0.05, "newSalesRatio": 0.0446, "nodeIdPath": "2619533011:2975241011:2975302011", "nodeLabelPathLocale": "宠物用品:猫:纪念物", "ranking": 1, "sellers": 93, "top10AvgBsr": 15634, "top10AvgRevenue": 8482.8, "top10AvgSales": 612, "top10BrandCrn": 0.3447, "top10BrandRevenue": 100037.92, "top10BrandSales": 6877, "top10ProductCrn": 0.3072, "top10ProductRevenue": 84828.01, "top10ProductSales": 6128, "top10SellerCrn": 0.3398, "top10SellerRevenue": 98589.1, "top10SellerSales": 6779, "top20AvgBsr": 19379, "top20AvgRevenue": 6594.31, "top20AvgSales": 463, "top20BrandCrn": 0.5139, "top20BrandRevenue": 152762.97, "top20BrandSales": 10253, "top20ProductCrn": 0.4645, "top20ProductRevenue": 131886.24, "top20ProductSales": 9267, "top20SellerCrn": 0.5051, "top20SellerRevenue": 149932.74, "top20SellerSales": 10076, "top3AvgBsr": 10998, "top3AvgRevenue": 10012.36, "top3AvgSales": 897, "top3BrandCrn": 0.157, "top3BrandRevenue": 39158.28, "top3BrandSales": 3132, "top3ProductCrn": 0.1349, "top3ProductRevenue": 30037.08, "top3ProductSales": 2692, "top3SellerCrn": 0.157, "top3SellerRevenue": 39158.28, "top3SellerSales": 3132, "top5AvgBsr": 13172, "top5AvgRevenue": 9229.96, "top5AvgSales": 771, "top5BrandCrn": 0.219, "top5BrandRevenue": 63134.31, "top5BrandSales": 4369, "top5ProductCrn": 0.1934, "top5ProductRevenue": 46149.81, "top5ProductSales": 3859, "top5SellerCrn": 0.219, "top5SellerRevenue": 63134.31, "top5SellerSales": 4369, "topProducts": 100, "totalProducts": 1347, "totalRevenue": 339455.71, "totalSales": 19950 } ], "page": { "cursor": 0, "size": 20, "hasMore": false }, "periodEnd": "2026-10-26", "periodStart": "2026-09-27", "sampleCount": 100 }

使用说明

  • dataRange 可选 LAST_30_DAYS（默认）或 LAST_24_MONTHS；部分筛选条件只支持其中一种，说明见参数表。
  • 统计基于类目头部样本（sampleCount 默认 100，可选 100–500），与亚马逊选品指南针的全量数据口径不同。
  • 比例类条件用小数表示，如 0.15 表示 15%。
 

类目报告 category.report.detail

用途

查询单个类目的市场报告：规模、价格、评分、品牌和卖家集中度、新品表现、卖家所在地等；可看近 30 天快照，也可看近 24 个月逐月明细。
适合回答：
  • “Baking Mats 最近 30 天卖了多少件、平均价格多少？”
  • “这个类目近两年每个月的销量和销售额？”
  • “这个类目被头部品牌垄断了吗？新品卖得怎么样？”
不适合时改用：
  • 筛选多个类目 → category.stats.list
  • 价格带、评分等分桶分布 → category.trend
  • 头部商品 / 品牌 / 卖家名单 → category.top.list

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
categoryId
string
是
类目节点 ID 完整路径（冒号分隔，如 1055398:284507:289668:289719:3736921）；深层节点的短节点 ID 会查不到数据，请先用 category.search(keyword=类目名) 获取完整路径
dataRange
string
否
查询数据范围：LAST_30_DAYS=近30天（默认）；LAST_24_MONTHS=近24个月完整报告；可选值：LAST_30_DAYS、LAST_24_MONTHS
sampleCount
integer
否
统计样本档位 100/200/300/400/500，默认 100；该档位决定各月 TopN 样本切分与汇总去重范围；最小 100，最大 500
topN
integer
否
头部 TopN 档位：3/5/10/20，默认 10；决定 competition / brandConcentration / sellerConcentration 等头部口径。仅 LAST_30_DAYS 支持；可选值：3、5、10、20
newReleaseNum
integer
否
新品定义月数，默认 3。仅 LAST_30_DAYS 支持；最小 1，最大 12
currentMonth
integer
否
数据归档月份 yyyyMM。只有用户明确要求指定历史月份时才传；不要根据当前日期主动推断。不传时使用近 30 天默认口径；仅 LAST_30_DAYS 支持
asins
string[]
否
可选 ASIN 集合，聚合该组 ASIN 的报告；仅 LAST_30_DAYS 支持；最多 100 项
language
string
否
类目名称语言。EN=英文原始名称，CN=中文翻译（默认）；可选值：EN、CN
familyMerge
boolean
否
变体合并口径；仅 LAST_30_DAYS 支持
includeFields
string[]
否
仅用于 LAST_30_DAYS 口径的基础盘字段裁剪；不传或为空时返回默认核心字段（productCount/marketSize/competition/newProductFeasibility/avgPrice/avgRating/name/nodePath/categoryId），扩展字段需显式传入。LAST_24_MONTHS 口径不支持该参数；可选值：categoryId、name、nodePath、productCount、marketSize、competition、newProductFeasibility、avgPrice、avgRating、currency、sampleProducts、brands、sellers、avgBsr、avgSales、avgProfit、avgSellers、avgVolume、avgWeight、avgReviews、avgReviewsIncr、sellerNationRatios、shelfDateProducts、firstShelfDate、lastShelfDate、headProducts、headAvgBsr、headAvgSales、headAvgRevenue、headAvgPrice、headAvgReviews、headAvgReviewsIncr、headAvgRating、brandConcentration、sellerConcentration、peerAvgProductConcentration、peerAvgBrandConcentration、peerAvgSellerConcentration、peerMarkets、newCount、newAvgPrice、newAvgReviews、minNewReviews、maxNewReviews、newAvgRating、newAvgSales、newAvgBsr、newAvgRevenue、newSalesRatio、totalSales、availableMonths、latestMonth、collectFlag；最多 53 项

返回字段

字段
类型
说明
periodStart
string
数据实际覆盖的日期区间起点，格式 yyyy-MM-dd
periodEnd
string
数据实际覆盖的日期区间终点，格式 yyyy-MM-dd
dataMonth
string
实际使用的归档月份，格式 yyyyMM；近 30 天默认口径为 null，近 24 个月口径用 startMonth/endMonth 表示
dataRange
string
数据范围：LAST_30_DAYS / LAST_24_MONTHS
categoryId
string
类目节点 ID 路径
name
string
类目名称（末级节点）
nodePath
string[]
类目名称路径列表
productCount
integer
商品总数；来自 MarketStatsMonthly 归档表，反映指定样本量下的去重 ASIN 数，与类目搜索/需求报告口径不同。近30天口径返回
marketSize
number
市场规模（avgRevenue 口径）；近30天口径返回
competition
number
竞争度（头部商品集中度，口径随 topN 档位，默认 Top10）；仅 LAST_30_DAYS 口径按 includeFields 返回
newProductFeasibility
number
新品可行性（新品占比）；近30天口径返回
avgPrice
number
平均价格；近30天口径返回
avgRating
number
平均星级；近30天口径返回
currency
string
币种；仅 LAST_30_DAYS 口径按 includeFields 返回
sampleProducts
integer
样本商品数；仅 LAST_30_DAYS 口径按 includeFields 返回
brands
integer
品牌数；仅 LAST_30_DAYS 口径按 includeFields 返回
sellers
integer
卖家数；仅 LAST_30_DAYS 口径按 includeFields 返回
avgBsr
integer
平均 BSR；仅 LAST_30_DAYS 口径按 includeFields 返回
avgSales
integer
月均销量；仅 LAST_30_DAYS 口径按 includeFields 返回
avgProfit
number
平均利润率；仅 LAST_30_DAYS 口径按 includeFields 返回
avgSellers
number
平均卖家数；仅 LAST_30_DAYS 口径按 includeFields 返回
avgVolume
number
平均体积；仅 LAST_30_DAYS 口径按 includeFields 返回
avgWeight
number
平均重量；仅 LAST_30_DAYS 口径按 includeFields 返回
avgReviews
integer
平均评论数；仅 LAST_30_DAYS 口径按 includeFields 返回
avgReviewsIncr
integer
月评论平均增长数；仅 LAST_30_DAYS 口径按 includeFields 返回
sellerNationRatios
object[]
卖家归属地占比列表；仅 LAST_30_DAYS 口径按 includeFields 返回
sellerNationRatios[].ratio
number
占比
sellerNationRatios[].nation
string
国家名称
sellerNationRatios[].code
string
国家代码
shelfDateProducts
integer
上架时间趋势中的商品数；仅 LAST_30_DAYS 口径按 includeFields 返回
firstShelfDate
string
商品首次上架日期；仅 LAST_30_DAYS 口径按 includeFields 返回
lastShelfDate
string
商品最新上架日期；仅 LAST_30_DAYS 口径按 includeFields 返回
headProducts
integer
头部 Listing 前 N 名商品样本数（N 由 topN 决定）；仅 LAST_30_DAYS 口径按 includeFields 返回
headAvgBsr
integer
头部 Listing 前 N 名平均 BSR；仅 LAST_30_DAYS 口径按 includeFields 返回
headAvgSales
integer
头部 Listing 前 N 名月均销量；仅 LAST_30_DAYS 口径按 includeFields 返回
headAvgRevenue
number
头部 Listing 前 N 名月均销售额；仅 LAST_30_DAYS 口径按 includeFields 返回
headAvgPrice
number
头部 Listing 前 N 名平均价格；仅 LAST_30_DAYS 口径按 includeFields 返回
headAvgReviews
integer
头部 Listing 前 N 名平均评论数；仅 LAST_30_DAYS 口径按 includeFields 返回
headAvgReviewsIncr
integer
头部 Listing 前 N 名月评论平均增长数；仅 LAST_30_DAYS 口径按 includeFields 返回
headAvgRating
number
头部 Listing 前 N 名平均星级；仅 LAST_30_DAYS 口径按 includeFields 返回
brandConcentration
number
头部品牌集中度（口径随 topN 档位，默认 Top10 品牌销量占比）；仅 LAST_30_DAYS 口径按 includeFields 返回
sellerConcentration
number
头部卖家集中度（口径随 topN 档位）；仅 LAST_30_DAYS 口径按 includeFields 返回
peerAvgProductConcentration
number
同级类目平均头部商品集中度（对比基准）；仅 LAST_30_DAYS 口径按 includeFields 返回
peerAvgBrandConcentration
number
同级类目平均头部品牌集中度（对比基准）；仅 LAST_30_DAYS 口径按 includeFields 返回
peerAvgSellerConcentration
number
同级类目平均头部卖家集中度（对比基准）；仅 LAST_30_DAYS 口径按 includeFields 返回
peerMarkets
integer
同级细分市场数量（peerAvg* 基准的样本范围）；仅 LAST_30_DAYS 口径按 includeFields 返回
newCount
integer
新品数量（newReleaseNum 定义）；仅 LAST_30_DAYS 口径按 includeFields 返回
newAvgPrice
number
新品平均价格；仅 LAST_30_DAYS 口径按 includeFields 返回
newAvgReviews
integer
新品平均评论数；仅 LAST_30_DAYS 口径按 includeFields 返回
minNewReviews
integer
最低新品评论数；仅 LAST_30_DAYS 口径按 includeFields 返回
maxNewReviews
integer
最高新品评论数；仅 LAST_30_DAYS 口径按 includeFields 返回
newAvgRating
number
新品平均星级；仅 LAST_30_DAYS 口径按 includeFields 返回
newAvgSales
integer
新品月均销量；仅 LAST_30_DAYS 口径按 includeFields 返回
newAvgBsr
integer
新品平均 BSR；仅 LAST_30_DAYS 口径按 includeFields 返回
newAvgRevenue
number
新品月均销售额；仅 LAST_30_DAYS 口径按 includeFields 返回
newSalesRatio
number
新品销量占比（新品总销量 / 类目总销量，0-1 小数）；仅 LAST_30_DAYS 口径按 includeFields 返回
totalSales
integer
类目总销量；仅 LAST_30_DAYS 口径按 includeFields 返回
availableMonths
integer[]
可用的归档月份列表（yyyyMM）；仅 LAST_30_DAYS 口径按 includeFields 返回
latestMonth
integer
最新归档月份 yyyyMM；仅 LAST_30_DAYS 口径按 includeFields 返回
collectFlag
integer
采集状态标记；仅 LAST_30_DAYS 口径按 includeFields 返回
startMonth
integer
统计起始月份 yyyyMM；近24个月口径返回
endMonth
integer
统计截至月份 yyyyMM；近24个月口径返回
period
integer
统计月份数；近24个月口径返回
summary
object
 
summary.marketId
integer
站点市场 ID
summary.currency
string
货币代码
summary.nodeIdPath
string
类目节点 ID 路径
summary.nodeLabelPathLocale
string
类目名称路径（本地化）
summary.ranking
integer
排名
summary.currentMonth
integer
统计月份 yyyyMM。近 30 天口径为 null，210001 不是月份
summary.sampleCount
integer
各月 Top{档位} 样本按 ASIN 去重后的商品总数（跨月汇总值，非档位值、非单月样本数；单月样本数见 monthlyList[].products，仅 category.report.detail 提供）
summary.totalProducts
integer
商品总数
summary.brands
integer
品牌数
summary.sellers
integer
卖家数
summary.totalSales
integer
月总销量（类目聚合口径，不区分单个父体/子体）
summary.totalRevenue
number
月总销售额
summary.avgSales
integer
月均销量（类目聚合口径，不区分单个父体/子体）
summary.avgRevenue
number
月均销售额
summary.avgPrice
number
平均价格
summary.weightedAvgPrice
number
加权平均价格（仅近24个月口径）
summary.avgBsr
integer
平均 BSR
summary.avgRatings
integer
平均评分数（仅近24个月口径）
summary.avgRating
number
平均星级
summary.avgProfit
number
平均利润率
summary.avgSellers
number
平均卖家数（仅近24个月口径）
summary.ebcRatio
number
A+ 商品占比（仅近24个月口径）
summary.amzRatio
number
Amazon 自营占比（仅近24个月口径）
summary.fbaRatio
number
FBA 占比（仅近24个月口径）
summary.fbmRatio
number
FBM 占比（仅近24个月口径）
summary.sellerNation
string
头部样本卖家归属地 code（仅近24个月口径）
summary.sellerNationLabel
string
头部样本卖家归属地（仅近24个月口径）
summary.sellerRatio
number
头部样本卖家归属地占比（仅近24个月口径）
summary.returnRatio
number
退货率（仅近24个月口径）
summary.avgReturnRatio
number
同类目平均退货率（仅近24个月口径）
summary.searchToPurchaseRatio
number
搜索购买比（仅近24个月口径）
summary.avgSearchToPurchaseRatio
number
同类目搜索购买比（仅近24个月口径）
summary.glanceViews
integer
浏览量（仅近24个月口径）
summary.avgReviews
integer
全商品平均评论数。仅近30天口径
summary.yoyGrowthRate
number
同比增长率（小数）。两种口径
summary.annualGrowthRate
number
年增长率（小数）。仅近24个月口径
summary.avgVolume
number
平均体积。两种口径
summary.avgWeight
number
平均重量。两种口径
summary.topProducts
integer
TopN 样本商品数。仅近30天口径
summary.collectFlag
integer
采集标记。仅近30天口径
summary.top3AvgBsr
integer
头部 3 口径指标。两种口径
summary.top3AvgSales
integer
头部 3 口径指标。两种口径
summary.top3AvgRevenue
number
头部 3 口径指标。两种口径
summary.top5AvgBsr
integer
头部 5 口径指标。两种口径
summary.top5AvgSales
integer
头部 5 口径指标。两种口径
summary.top5AvgRevenue
number
头部 5 口径指标。两种口径
summary.top10AvgBsr
integer
头部 10 口径指标。两种口径
summary.top10AvgSales
integer
头部 10 口径指标。两种口径
summary.top10AvgRevenue
number
头部 10 口径指标。两种口径
summary.top20AvgBsr
integer
头部 20 口径指标。两种口径
summary.top20AvgSales
integer
头部 20 口径指标。两种口径
summary.top20AvgRevenue
number
头部 20 口径指标。两种口径
summary.top3ProductSales
integer
头部 3 口径指标。两种口径
summary.top3BrandSales
integer
头部 3 口径指标。两种口径
summary.top3SellerSales
integer
头部 3 口径指标。两种口径
summary.top3ProductRevenue
number
头部 3 口径指标。两种口径
summary.top3BrandRevenue
number
头部 3 口径指标。两种口径
summary.top3SellerRevenue
number
头部 3 口径指标。两种口径
summary.top3ProductCrn
number
头部 3 口径指标。两种口径
summary.top3BrandCrn
number
头部 3 口径指标。两种口径
summary.top3SellerCrn
number
头部 3 口径指标。两种口径
summary.top5ProductSales
integer
头部 5 口径指标。两种口径
summary.top5BrandSales
integer
头部 5 口径指标。两种口径
summary.top5SellerSales
integer
头部 5 口径指标。两种口径
summary.top5ProductRevenue
number
头部 5 口径指标。两种口径
summary.top5BrandRevenue
number
头部 5 口径指标。两种口径
summary.top5SellerRevenue
number
头部 5 口径指标。两种口径
summary.top5ProductCrn
number
头部 5 口径指标。两种口径
summary.top5BrandCrn
number
头部 5 口径指标。两种口径
summary.top5SellerCrn
number
头部 5 口径指标。两种口径
summary.top10ProductSales
integer
头部 10 口径指标。两种口径
summary.top10BrandSales
integer
头部 10 口径指标。两种口径
summary.top10SellerSales
integer
头部 10 口径指标。两种口径
summary.top10ProductRevenue
number
头部 10 口径指标。两种口径
summary.top10BrandRevenue
number
头部 10 口径指标。两种口径
summary.top10SellerRevenue
number
头部 10 口径指标。两种口径
summary.top10ProductCrn
number
头部 10 口径指标。两种口径
summary.top10BrandCrn
number
头部 10 口径指标。两种口径
summary.top10SellerCrn
number
头部 10 口径指标。两种口径
summary.top20ProductSales
integer
头部 20 口径指标。两种口径
summary.top20BrandSales
integer
头部 20 口径指标。两种口径
summary.top20SellerSales
integer
头部 20 口径指标。两种口径
summary.top20ProductRevenue
number
头部 20 口径指标。两种口径
summary.top20BrandRevenue
number
头部 20 口径指标。两种口径
summary.top20SellerRevenue
number
头部 20 口径指标。两种口径
summary.top20ProductCrn
number
头部 20 口径指标。两种口径
summary.top20BrandCrn
number
头部 20 口径指标。两种口径
summary.top20SellerCrn
number
头部 20 口径指标。两种口径
summary.newCount
integer
新品数量（近 3 个月口径）
summary.newRatio
number
新品占比（新品数 / 样本数，0-1 小数）
summary.newAvgSales
integer
新品平均销量
summary.newSalesRatio
number
新品销量占比（新品总销量 / 类目总销量，0-1 小数）
monthlyList
object[]
逐月明细（近24个月口径返回）
monthlyList[].statMonth
integer
统计月份 yyyyMM
monthlyList[].hasDetail
boolean
当月是否存在明细数据
monthlyList[].totalSales
integer
月总销量（类目聚合口径，不区分单个父体/子体）
monthlyList[].totalRevenue
number
月总销售额
monthlyList[].avgPrice
number
平均价格
monthlyList[].weightedAvgPrice
number
加权平均价格
monthlyList[].avgBsr
integer
平均 BSR
monthlyList[].products
integer
该月样本商品数（= 所选样本档位 TopN）
monthlyList[].brands
integer
品牌数
monthlyList[].sellers
integer
卖家数
monthlyList[].avgRatings
integer
平均评分数
monthlyList[].highRatingRatio
number
高评分产品占比
monthlyList[].top3ProductCrn
number
TOP3 商品集中度
monthlyList[].top10ProductCrn
number
TOP10 商品集中度
monthlyList[].top20ProductCrn
number
TOP20 商品集中度
monthlyList[].top3BrandCrn
number
TOP3 品牌集中度
monthlyList[].top10BrandCrn
number
TOP10 品牌集中度
monthlyList[].top20BrandCrn
number
TOP20 品牌集中度
monthlyList[].top3SellerCrn
number
TOP3 卖家集中度
monthlyList[].top10SellerCrn
number
TOP10 卖家集中度
monthlyList[].top20SellerCrn
number
TOP20 卖家集中度
monthlyList[].sellerTypeTrends
object[]
卖家类型趋势（FBA/FBM/AMZ）
monthlyList[].sellerTypeTrends[].dimension
string
维度标识
monthlyList[].sellerTypeTrends[].asins
integer
ASIN 数量
monthlyList[].sellerTypeTrends[].sales
integer
月销量（类目聚合维度口径，不区分单个父体/子体）
monthlyList[].sellerTypeTrends[].asinRatio
number
ASIN 数量占比
monthlyList[].sellerTypeTrends[].coverageRate
number
覆盖率
monthlyList[].sellerTypeTrends[].salesRatio
number
销量占比（类目聚合维度口径）
monthlyList[].sellerTypeTrends[].efficiencyDiff
number
效率差（销量占比-覆盖率）
monthlyList[].sellerTypeTrends[].avgRatings
integer
平均评分数
monthlyList[].sellerTypeTrends[].avgRating
number
平均星级
monthlyList[].ebcVideoTrends
object[]
A+ 视频趋势
monthlyList[].ebcVideoTrends[].dimension
string
维度标识
monthlyList[].ebcVideoTrends[].asins
integer
ASIN 数量
monthlyList[].ebcVideoTrends[].sales
integer
月销量（类目聚合维度口径，不区分单个父体/子体）
monthlyList[].ebcVideoTrends[].asinRatio
number
ASIN 数量占比
monthlyList[].ebcVideoTrends[].coverageRate
number
覆盖率
monthlyList[].ebcVideoTrends[].salesRatio
number
销量占比（类目聚合维度口径）
monthlyList[].ebcVideoTrends[].efficiencyDiff
number
效率差（销量占比-覆盖率）
monthlyList[].ebcVideoTrends[].avgRatings
integer
平均评分数
monthlyList[].ebcVideoTrends[].avgRating
number
平均星级
monthlyList[].sellerNationTrends
object[]
卖家归属地趋势
monthlyList[].sellerNationTrends[].dimension
string
维度标识
monthlyList[].sellerNationTrends[].asins
integer
ASIN 数量
monthlyList[].sellerNationTrends[].sales
integer
月销量（类目聚合维度口径，不区分单个父体/子体）
monthlyList[].sellerNationTrends[].asinRatio
number
ASIN 数量占比
monthlyList[].sellerNationTrends[].coverageRate
number
覆盖率
monthlyList[].sellerNationTrends[].salesRatio
number
销量占比（类目聚合维度口径）
monthlyList[].sellerNationTrends[].efficiencyDiff
number
效率差（销量占比-覆盖率）
monthlyList[].sellerNationTrends[].avgRatings
integer
平均评分数
monthlyList[].sellerNationTrends[].avgRating
number
平均星级
monthlyList[].publishDateTrends
object[]
上架时长趋势
monthlyList[].publishDateTrends[].dimension
string
维度标识
monthlyList[].publishDateTrends[].asins
integer
ASIN 数量
monthlyList[].publishDateTrends[].sales
integer
月销量（类目聚合维度口径，不区分单个父体/子体）
monthlyList[].publishDateTrends[].asinRatio
number
ASIN 数量占比
monthlyList[].publishDateTrends[].coverageRate
number
覆盖率
monthlyList[].publishDateTrends[].salesRatio
number
销量占比（类目聚合维度口径）
monthlyList[].publishDateTrends[].efficiencyDiff
number
效率差（销量占比-覆盖率）
monthlyList[].publishDateTrends[].avgRatings
integer
平均评分数
monthlyList[].publishDateTrends[].avgRating
number
平均星级
monthlyList[].ratingTrends
object[]
评分值分布趋势
monthlyList[].ratingTrends[].dimension
string
维度标识
monthlyList[].ratingTrends[].asins
integer
ASIN 数量
monthlyList[].ratingTrends[].sales
integer
月销量（类目聚合维度口径，不区分单个父体/子体）
monthlyList[].ratingTrends[].asinRatio
number
ASIN 数量占比
monthlyList[].ratingTrends[].coverageRate
number
覆盖率
monthlyList[].ratingTrends[].salesRatio
number
销量占比（类目聚合维度口径）
monthlyList[].ratingTrends[].efficiencyDiff
number
效率差（销量占比-覆盖率）
monthlyList[].ratingTrends[].avgRatings
integer
平均评分数
monthlyList[].ratingTrends[].avgRating
number
平均星级
字段值缺失时返回 null。

示例

请求
{ "name": "category.report.detail", "arguments": { "marketplace": "US", "categoryId": "1055398:284507:289668:289719:3736921", "dataRange": "LAST_30_DAYS", "includeFields": [ "name", "productCount", "marketSize", "totalSales", "avgPrice", "currency" ] } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "avgPrice": 12.89, "currency": "USD", "dataMonth": null, "dataRange": "LAST_30_DAYS", "marketSize": 20059.0, "name": "烘焙垫", "periodEnd": "2026-10-26", "periodStart": "2026-09-27", "productCount": 1580, "totalSales": 162405 }

使用说明

  • dataRange 为 LAST_30_DAYS（默认）时返回近 30 天快照，返回中带实际起止日期；为 LAST_24_MONTHS 时返回汇总和 24 个月逐月明细（monthlyList）。
  • marketSize 为样本商品的平均月销售额，不是类目总销售额；totalSales 为样本商品的销量合计。
  • 统计基于类目头部样本（sampleCount 默认 100），topN 决定集中度按头部几名计算（3/5/10/20）。
  • includeFields 只用于近 30 天口径，可选值见参数表；不在可选值中的字段名会被拒绝并列出允许值。
  • 查询指定历史月份请传 currentMonth（yyyyMM）。
 

类目分布 category.trend

用途

查询类目内部的分布结构：行业销量趋势、上架时间分布、评分数和评分值分布、价格带、卖家类型、卖家所在地、A+ 与视频配置。可一次组合多项。
适合回答：
  • “Baking Mats 不同价格段的商品数和销量占比？”
  • “这个类目亚马逊自营、FBA、FBM 各占多少？中国卖家占多少？”
  • “卖得好的商品是不是大多有 A+ 和视频？”
不适合时改用：
  • 类目规模和集中度 → category.report.detail

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
categoryId
string
是
类目节点 ID 完整路径（nodeIdPath，冒号分隔，如 1055398:284507:289668:289719:3736921）；一级部门节点为单段。深层节点的短节点 ID 会查不到数据，请先用 category.search(keyword=类目名) 获取完整路径
metrics
string[]
是
分布 / 分桶趋势指标，至少一个，不允许重复；只能使用 items.enum 中的值。评分相关请用 ratingsCount（评分数分布）或 ratingValue（评分值分布），不支持 rating；可选值：industrySales、shelfTime、shelfTrend、ratingsCount、ratingValue、price、sellerType、sellerNation、apVideo；最少 1 项，最多 9 项
dataMonth
string
否
数据归档月份，格式 yyyyMM。只有用户明确要求指定历史月份时才传；不要根据当前日期主动推断。不传时使用最新可用月份；显式传入必须是可用历史月份，晚于最新或未归档会直接报错。响应中的 dataMonth 是实际使用的月份。注意：industrySales（行业销量/销售额）仅覆盖数据源最新可用窗口，不支持按 dataMonth 回溯历史；历史月份的类目销量/销售额请改用 category.report.detail（monthlyList 覆盖近 24 个月）；格式 ^\d{6}$
topN
integer
否
分桶统计的样本头部数量，缺省 100；最小 1
months
integer
否
行业销售趋势回溯月数，缺省 5；最小 1

返回字段

字段
类型
说明
dataMonth
string
实际使用的归档月份，格式 yyyyMM
metrics
object[]
按请求指标顺序返回
metrics[].metric
string
指标名
metrics[].buckets
object[]
分桶列表
metrics[].buckets[].key
string
分桶键
metrics[].buckets[].label
string
分桶标签
metrics[].buckets[].products
integer
商品数
metrics[].buckets[].sales
integer
分桶销量（类目聚合口径，不区分单个父体/子体）
metrics[].buckets[].revenue
number
销售额
metrics[].buckets[].productShare
number
商品数占该指标分桶样本总数的比例
metrics[].buckets[].rating
number
评分
metrics[].buckets[].asinShare
number
ASIN 占比
metrics[].buckets[].salesShare
number
分桶销量占该指标样本总销量的比例（类目聚合口径，不区分单个父体/子体）
metrics[].buckets[].revenueShare
number
销售额占该指标分桶样本总销售额的比例
metrics[].months
string[]
行业销售趋势时间轴；仅该指标返回
字段值缺失时返回 null。

示例

请求
{ "name": "category.trend", "arguments": { "marketplace": "US", "categoryId": "1055398:284507:289668:289719:3736921", "metrics": [ "price" ], "topN": 100 } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "dataMonth": "202609", "metrics": [ { "buckets": [ { "key": "0-5", "label": "0-5", "productShare": 0.03, "products": 3, "revenue": 9387.91, "revenueShare": 0.0063, "sales": 1925, "salesShare": 0.0155 }, { "key": "5-10", "label": "5-10", "productShare": 0.48, "products": 48, "revenue": 671918.15, "revenueShare": 0.448, "sales": 74390, "salesShare": 0.5987 } ], "metric": "price" } ] }

使用说明

  • metrics 至少传一项，可多选：industrySales、shelfTime、shelfTrend、ratingsCount、ratingValue、price、sellerType、sellerNation、apVideo。
  • 统计基于类目头部样本（topN 默认 100），不代表类目全量。
  • industrySales 只返回最新可用窗口（默认最近 12 个月），不能按 dataMonth 回溯；历史月份的类目销量请用 category.report.detail。
  • 返回中的 dataMonth 为实际使用的数据月份。
 

类目头部榜单 category.top.list

用途

查询类目的头部商品、头部品牌或头部卖家排名，以及各自的销量、销售额和份额。
适合回答：
  • “Baking Mats 销量最高的 5 个品牌是谁？”
  • “对应的前 5 个卖家呢？”
  • “头部 10 个商品是哪些？”
不适合时改用：
  • 集中度汇总指标 → category.report.detail

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
categoryId
string
是
类目节点 ID 完整路径（冒号分隔，如 1055398:284507:289668:289719:3736921）；一级部门节点为单段。深层节点的短节点 ID 会查不到数据，请先用 category.search(keyword=类目名) 获取完整路径
dimension
string
是
排名维度；可选值：product、brand、seller
dataMonth
string
否
数据归档月份，格式 yyyyMM。只有用户明确要求指定历史月份时才传；不要根据当前日期主动推断。不传或传入未归档月份时，服务端返回最新可用数据。响应中的 dataMonth 是实际使用的月份；格式 ^\d{6}$
topN
integer
否
TopN 数量，缺省 10；最小 1，最大 100
newProductMonths
integer
否
新品判定阈值（月）；不传不区分新品

返回字段

字段
类型
说明
dataMonth
string
实际使用的归档月份，格式 yyyyMM
dimension
string
排名维度
items
object[]
TopN 排名列表
items[].name
string
品牌 / 卖家名
items[].asin
string
ASIN，仅商品维度
items[].title
string
标题，仅商品维度
items[].imageUrl
string
主图链接，仅商品维度
items[].ranking
integer
排名
items[].products
integer
商品数
items[].newProducts
integer
新品数
items[].newSales
integer
周期内新品销量（类目聚合口径）
items[].newSalesRatio
number
周期内新品销量占比（类目聚合口径）
items[].avgPrice
number
均价
items[].rating
number
评分
items[].reviews
integer
评分人数（ratings 口径）；多源回退（详情采集值优先，其次月度统计列），null 表示两源均无数据，0 表示两源确认无评论；非文字评论数（with reviews 另见 totalReview 能力规划）
items[].sales
integer
月销量；商品维度为父体/Listing 口径，品牌/卖家维度为聚合口径
items[].revenue
number
月销售额；商品维度为父体/Listing 口径，品牌/卖家维度为聚合口径
items[].salesShare
number
销量占比（父体/Listing 或品牌/卖家聚合口径，视 dimension 而定）
items[].revenueShare
number
销售额占比
字段值缺失时返回 null。

示例

请求
{ "name": "category.top.list", "arguments": { "marketplace": "US", "categoryId": "1055398:284507:289668:289719:3736921", "dimension": "brand", "topN": 5 } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "dataMonth": "202609", "dimension": "brand", "items": [ { "avgPrice": 10.32, "name": "Folksy Super Kitchen,Hight Quality life", "newProducts": 0, "newSales": 0, "newSalesRatio": 0.0, "products": 3, "ranking": 1, "rating": 4.7, "revenue": 178460.23, "revenueShare": 0.119, "reviews": 2215, "sales": 17755, "salesShare": 0.1429 }, { "avgPrice": 9.25, "name": "Koolstuffs,Koolstuffs Store", "newProducts": 0, "newSales": 0, "newSalesRatio": 0.0, "products": 5, "ranking": 2, "rating": 4.7, "revenue": 132592.74, "revenueShare": 0.0884, "reviews": 0, "sales": 12604, "salesShare": 0.1014 } ] }

使用说明

  • dimension 选择榜单维度：product（商品）、brand（品牌）、seller（卖家）。
  • topN 默认 10，最多 100。
  • 份额为占类目样本销量的比例。
 

类目需求词趋势 category.demand.trend

用途

查询类目的需求关键词池（最多 2000 个），以及前 10 个关键词近 24 个月的搜索量走势。
适合回答：
  • “Baking Mats 买家主要搜哪些需求？”
  • “近两年哪些需求词在涨、哪些只在旺季有人搜？”
不适合时改用：
  • 单个关键词的走势 → keyword.trend

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
categoryId
string
是
类目节点 ID 完整路径（冒号分隔，如 1055398:284507:289668:289719:3736921）；深层节点的短节点 ID 会查不到数据，请先用 category.search(keyword=类目名) 获取完整路径
sampleCount
integer
否
样本档位 100/200/300/400/500，默认 100；最小 100，最大 500
page
integer
否
关键词列表页码，默认 1；page>1 时返回纯关键词列表（trendList 为空数组）。 page*size <= 3000；最小 1，最大 3000
size
integer
否
每页条数，默认 100；最小 1，最大 100
marketPeriod
string
否
市场周期编码：N/I/D/S1..S12，可选，用于筛选关键词
includeKeywords
string
否
包含关键词，多个用英文逗号分隔，按 OR 模糊匹配，可选

返回字段

字段
类型
说明
keywordPage
object
左侧关键词分页（默认第一页）
keywordPage.page
integer
当前页码
keywordPage.size
integer
每页条数
keywordPage.total
integer
关键词总数（最多 2000）
keywordPage.hasNextPage
boolean
是否还有下一页
keywordPage.items
object[]
关键词列表
keywordPage.items[].keyword
string
关键词
keywordPage.items[].keywordCn
string
关键词中文
keywordPage.items[].keywordJp
string
关键词日文
keywordPage.items[].searches
integer
最近30天月搜索量，用于默认排序
keywordPage.items[].marketPeriod
string
市场周期编码：N/I/D/S1..S12
keywordPage.items[].trendList
object[]
近24个月历史搜索量趋势；仅第 1 页（或缺省 page）返回，page>1 的翻页页为空数组
keywordPage.items[].trendList[].month
integer
月份 yyyyMM
keywordPage.items[].trendList[].searches
integer
搜索量
trendList
object[]
右侧默认展示的 Top10 关键词及近24个月历史搜索量趋势
trendList[].keyword
string
关键词
trendList[].keywordCn
string
关键词中文
trendList[].keywordJp
string
关键词日文
trendList[].searches
integer
最近30天月搜索量，用于默认排序
trendList[].marketPeriod
string
市场周期编码：N/I/D/S1..S12
trendList[].trendList
object[]
近24个月历史搜索量趋势；仅第 1 页（或缺省 page）返回，page>1 的翻页页为空数组
trendList[].trendList[].month
integer
月份 yyyyMM
trendList[].trendList[].searches
integer
搜索量
字段值缺失时返回 null。

示例

请求
{ "name": "category.demand.trend", "arguments": { "marketplace": "UK", "categoryId": "11052681:3313444031", "sampleCount": 100, "page": 1, "size": 30 } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "keywordPage": { "hasNextPage": true, "items": [ { "keyword": "shelves", "keywordCn": "货架", "keywordJp": "棚", "marketPeriod": "N", "searches": 63746, "trendList": [] }, { "keyword": "book shelf", "keywordCn": "书架", "keywordJp": "ブックシェルフ", "marketPeriod": "N", "searches": 48377, "trendList": [] } ], "page": 1, "size": 30, "total": 805 }, "trendList": [ { "keyword": "shelves", "keywordCn": "货架", "keywordJp": "棚", "marketPeriod": "N", "searches": 63746, "trendList": [ { "month": 201712, "searches": 53000 }, { "month": 201801, "searches": 181583 } ] }, { "keyword": "book shelf", "keywordCn": "书架", "keywordJp": "ブックシェルフ", "marketPeriod": "N", "searches": 48377, "trendList": [ { "month": 201712, "searches": 22651 }, { "month": 201801, "searches": 63042 } ] } ] }

使用说明

  • 关键词池来自类目头部商品的流量词扩展，可能包含跨类目或品牌词，使用时请按相关性过滤。
  • 24 个月走势（trendList）只在第 1 页返回；翻页时只返回关键词列表。
 

选品指南针报告 category.demand.report

用途

查询亚马逊后台选品指南针口径的类目数据：官方商品总数、搜索量和点击趋势、热门关键词、浏览量和销量趋势、退货率和搜索购买比。
适合回答：
  • “Baking Mats 最近 90 天在选品指南针里的需求和退货情况怎么样？”
不适合时改用：
  • 卖家精灵样本口径的类目报告 → category.report.detail

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
categoryId
string
是
类目节点 ID 完整路径（冒号分隔，如 1055398:284507:289668:289719:3736921）；深层节点的短节点 ID 会查不到数据，请先用 category.search(keyword=类目名) 获取完整路径
days
integer
否
统计维度：7/30/90/365，默认 365；可选值：7、30、90、365

返回字段

字段
类型
说明
label
string
类目名称
market
string
站点市场
nodePath
string
类目名称路径
days
integer
统计维度天数
asinCount
integer
该细分类目的 ASIN 总数（来自 Amazon 官方选品指南针数据源，含全部在售/下架 ASIN，与类目搜索/类目报告的商品数口径不同）。没有数据时为 null
lastUpdatedTime
string
数据更新时间；没有数据时为 null
searchPerformanceItems
object[]
搜索绩效：搜索量与客户点击次数变化趋势
searchPerformanceItems[].date
string
日期
searchPerformanceItems[].searchVolume
integer
搜索量。某一天没有数据时为 null，不补 0
searchPerformanceItems[].clickCount
integer
客户点击次数。某一天没有数据时为 null，不补 0
popularKeywordItems
object[]
最热门的关键词及搜索量
popularKeywordItems[].keyword
string
关键词
popularKeywordItems[].searchVolume
integer
搜索量。没有数据时为 null，不补 0
goodsTrendItems
object[]
浏览量与卖出件数趋势
goodsTrendItems[].date
string
日期
goodsTrendItems[].glanceViews
integer
浏览量。某一天没有数据时为 null，不补 0
goodsTrendItems[].unitSold
integer
卖出件数（类目聚合口径，不区分单个父体/子体）。某一天没有数据时为 null，不补 0
ratioComparison
object
退货率 / 搜索购买比及同类目均值
ratioComparison.returnRatio
number
退货率。没有数据时为 null，不补 0
ratioComparison.avgReturnRatio
number
同类目平均退货率。没有数据时为 null，不补 0
ratioComparison.searchToPurchaseRatio
number
搜索购买比。没有数据时为 null，不补 0
ratioComparison.avgSearchToPurchaseRatio
number
同类目搜索购买比。没有数据时为 null，不补 0
glanceViewMaxLabel
integer
浏览量趋势图纵轴最大刻度标签（前端绘图用）。没有数据时为 null
glanceViewMinLabel
integer
浏览量趋势图纵轴最小刻度标签（前端绘图用）。没有数据时为 null
字段值缺失时返回 null。

示例

请求
{ "name": "category.demand.report", "arguments": { "marketplace": "US", "categoryId": "1055398:284507:289668:289719:3736921", "days": 90 } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "asinCount": 65383, "days": 90, "glanceViewMaxLabel": 407969, "glanceViewMinLabel": 173002, "goodsTrendItems": [ { "date": "2026-06-22", "glanceViews": 193057, "unitSold": 31010 }, { "date": "2026-06-29", "glanceViews": 332069, "unitSold": 45786 } ], "label": "Baking Mats", "lastUpdatedTime": "2026-09-18T16:00:00Z", "market": "US", "nodePath": "Kitchen:BAKING_MAT:3736921", "popularKeywordItems": [ { "keyword": "silicone baking mat", "searchVolume": 789131 }, { "keyword": "oven liners for bottom of oven", "searchVolume": 286189 } ], "ratioComparison": { "avgReturnRatio": 3.44, "avgSearchToPurchaseRatio": 15.23, "returnRatio": 3.44, "searchToPurchaseRatio": 15.23 }, "searchPerformanceItems": [ { "clickCount": 26776, "date": "2026-06-22", "searchVolume": 217965 }, { "clickCount": 44326, "date": "2026-06-29", "searchVolume": 317097 } ] }

使用说明

  • 数据来自亚马逊官方选品指南针，商品总数为全类目口径，与卖家精灵样本统计的数值不同，请勿混合计算。
  • days 可选 7 / 30 / 90 / 365，默认 365。
  • 官方数据更新可能有延迟，返回中的 lastUpdatedTime 为数据更新时间。
  • 请使用细分类目；部分一级大类暂无该口径数据。
 

类目 AI 画像 category.ai.feature.list

用途

查询卖家精灵对类目商品的 AI 归纳：主要人群、使用场景、产品特点等标签，以及每个标签的商品覆盖率、销量和销量占比。
适合回答：
  • “慢食狗碗这个类目的主要人群、使用场景和产品特点有哪些？”
  • “哪类人群的商品销量占比高？”
不适合时改用：
  • 用评论验证需求 → asin.review.list

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
categoryId
string
是
类目节点路径 nodeIdPath，格式如 123:456:789

返回字段

字段
类型
说明
sampleCount
integer
实际命中的样本档位
dataMonth
string
统计月份；当前固定为 210001（表示近 30 天）
categoryId
string
类目节点路径
aiTagStatus
string
AI 属性挖掘任务状态
marketplace
string
站点
features
object[]
AI 属性分组列表
features[].items
object[]
属性项列表
features[].items[].dimension
string
维度标识
features[].items[].salesRatio
number
月销量占比（类目聚合口径，不区分单个父体/子体）
features[].items[].asins
integer
ASIN 数量
features[].items[].asinRatio
number
ASIN 数量占比
features[].items[].sales
integer
月销量（类目聚合口径，不区分单个父体/子体）
features[].items[].avgRating
number
平均评分值
features[].items[].avgRatings
integer
平均评分数
features[].items[].efficiencyDiff
number
效率差：销量占比 - 覆盖率
features[].items[].coverageRate
number
覆盖率
features[].name
string
属性分组名：audience / scenario / custom
字段值缺失时返回 null。

示例

请求
{ "name": "category.ai.feature.list", "arguments": { "marketplace": "US", "categoryId": "1055398:284507:510136:8841480011:12900081" } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "aiTagStatus": "SUCCESS", "categoryId": "1055398:284507:510136:8841480011:12900081", "dataMonth": "210001", "features": [ { "items": [ { "asins": 314, "coverageRate": 0.628, "dimension": "旅行者", "efficiencyDiff": 0.0173, "sales": 204572, "salesRatio": 0.6453 }, { "asins": 266, "coverageRate": 0.532, "dimension": "上班族", "efficiencyDiff": 0.0358, "sales": 179995, "salesRatio": 0.5678 } ], "name": "audience" }, { "items": [ { "asins": 359, "coverageRate": 0.718, "dimension": "旅行", "efficiencyDiff": 0.0444, "sales": 241694, "salesRatio": 0.7624 }, { "asins": 247, "coverageRate": 0.494, "dimension": "日常通勤", "efficiencyDiff": 0.1273, "sales": 196955, "salesRatio": 0.6213 } ], "name": "scenario" } ], "marketplace": "US", "sampleCount": 500 }

使用说明

  • 标签由商品信息归纳得出，反映的是类目商品的定位，不是消费者调研。
  • 固定使用近 30 天数据。

关键词

 

关键词快照 keyword.batch.info

用途

批量查询关键词当前的搜索量、购买量、购买率、竞争商品数、PPC 竞价等指标，一次最多 20 个词。
适合回答：
  • “silicone baking mat 现在月搜索量多少？”
  • “这 3 个词的搜索量和购买率对比一下。”
不适合时改用：
  • 看历史走势 → keyword.trend
  • 扩展相关词 → keyword.related.list

计费

每次调用扣 1 次，与查询的关键词个数无关（1–20 个都是 1 次）。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
keywords
string[]
是
关键词列表，1 到 20 个；最少 1 项，最多 20 项
month
string
否
数据归档月份，格式 yyyyMM。仅当用户明确要求指定历史月份时才传；不要根据当前日期主动推断。不传时使用服务端默认当前链路。传入未归档月份时，服务端会归一化到最新可用历史月份，响应中的 month 是实际使用的月份；格式 ^\d{6}$
orderField
string
否
排序字段，缺省 searches；可选值：searches、purchases、purchase_rate、products、supply_demand_ratio、latest1daysAds、bid、titleDensityExact、cprExact、avg_price、monopoly_click_rate、avg_rating、avg_reviews、relevancy、adProducts7、rank、clicks、impressions、goods_value、cvsShareRate、searches_growth、yearly_growth_rate
desc
boolean
否
是否降序，默认 true

返回字段

字段
类型
说明
month
string
实际使用的关键词归档月份，格式 yyyyMM；未传 month 时为 null，表示服务端默认当前链路
items
object[]
 
items[].keyword
string
关键词
items[].resultStatus
string
逐条结果状态：success=命中并返回数据；no_data=未命中占位行；可选值：success、no_data
items[].searchVolume
integer
搜索量
items[].purchaseVolume
integer
购买量
items[].purchaseRate
number
购买率（小数，0.0059 表示 0.59%）
items[].weeklySearchRank
integer
周搜索排名
items[].products
integer
商品数
items[].supplyDemandRatio
number
供需比
items[].bid
number
PPC 竞价（自然口径当前值）
items[].monopolyClickRate
number
点击集中度
items[].clicks
integer
点击量
items[].impressions
integer
曝光量
items[].avgPrice
number
平均价格
items[].avgReviews
integer
平均评论数
items[].avgRating
number
平均星级
items[].wordCount
integer
词单词数
items[].cvsShareRate
number
转化份额
items[].bidMin
number
PPC 竞价下限
items[].bidMax
number
PPC 竞价上限
items[].phrasePpc
number
词组匹配 PPC 当前值
items[].minPhrasePpc
number
词组匹配 PPC 下限
items[].maxPhrasePpc
number
词组匹配 PPC 上限
items[].broadPpc
number
广泛匹配 PPC 当前值
items[].minBroadPpc
number
广泛匹配 PPC 下限
items[].maxBroadPpc
number
广泛匹配 PPC 上限
items[].exactPpc
number
精准匹配 PPC 当前值
items[].minExactPpc
number
精准匹配 PPC 下限
items[].maxExactPpc
number
精准匹配 PPC 上限
字段值缺失时返回 null。

示例

请求
{ "name": "keyword.batch.info", "arguments": { "keywords": [ "silicone baking mat" ], "marketplace": "US" } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "items": [ { "avgPrice": 8.9, "avgRating": 4.5, "avgReviews": 123765, "bid": 0.81, "bidMax": 1.0, "bidMin": 0.64, "broadPpc": 0.81, "clicks": 30217, "cvsShareRate": 0.2217, "exactPpc": 0.77, "impressions": 2186024, "keyword": "silicone baking mat", "maxBroadPpc": 1.0, "maxExactPpc": 0.88, "maxPhrasePpc": 1.0, "minBroadPpc": 0.64, "minExactPpc": 0.54, "minPhrasePpc": 0.64, "monopolyClickRate": 0.293, "phrasePpc": 0.81, "products": 5259, "purchaseRate": 0.0595, "purchaseVolume": 4638, "resultStatus": "success", "searchVolume": 77947, "supplyDemandRatio": 14.82, "weeklySearchRank": 14469, "wordCount": 3 } ], "month": "202609" }

使用说明

  • 未收录的词返回 resultStatus=no_data 占位行，只有部分指标的返回 PARTIAL。
  • purchaseRate 为小数，0.0059 表示 0.59%。
  • 返回中的 month 为实际数据月份。
 

关键词趋势 keyword.trend

用途

查询单个关键词按月的搜索量、购买量、购买率，以及同比、环比、近 3 个月增长率。
适合回答：
  • “silicone baking mat 2025 年 9 月到 2026 年 8 月每月搜索量？有没有旺淡季？”
不适合时改用：
  • 当月快照 → keyword.batch.info
  • ABA 排名走势 → keyword.aba.trend

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
keyword
string
是
关键词
metrics
string[]
是
趋势指标，至少一个，不允许重复。searchVolume 序列开头到首个非 0 值之前的月份值为 null，中段 0 为真实值；词库未收录的词直接报错，不返回全 0 序列；可选值：searchVolume、purchaseVolume、purchaseRate、yearlyGrowth、chainGrowth、threeMonthGrowth；最少 1 项，最多 6 项
dateRange
object
否
查询日期窗口；月度粒度按自然月取整。两者同时缺省时基于数据源最新可用月份返回最近 36 个自然月；响应中的 dateRange 是实际使用的窗口
dateRange.endDate
string
否
结束日期，格式 yyyy-MM-dd。只有用户明确要求指定历史窗口时才传；不要根据当前日期主动推断；不传或晚于数据源最新可用月份时截断到最新可用月份
dateRange.startDate
string
否
开始日期，格式 yyyy-MM-dd。只有用户明确要求指定历史窗口时才传；不要根据当前日期主动推断；不传时为数据源最新可用月份往前 36 个自然月
granularity
string
否
粒度，缺省 MONTH；可选值：MONTH

返回字段

字段
类型
说明
series
object
按指标键组织的趋势序列；只包含本次选择的指标
series.searchVolume
object[]
 
series.searchVolume[].value
number
趋势点数值
series.searchVolume[].date
string
月份，格式 yyyy-MM
series.purchaseVolume
object[]
 
series.purchaseVolume[].value
number
趋势点数值
series.purchaseVolume[].date
string
月份，格式 yyyy-MM
series.purchaseRate
object[]
 
series.purchaseRate[].value
number
趋势点数值
series.purchaseRate[].date
string
月份，格式 yyyy-MM
series.yearlyGrowth
object[]
 
series.yearlyGrowth[].value
number
趋势点数值
series.yearlyGrowth[].date
string
月份，格式 yyyy-MM
series.chainGrowth
object[]
 
series.chainGrowth[].value
number
趋势点数值
series.chainGrowth[].date
string
月份，格式 yyyy-MM
series.threeMonthGrowth
object[]
 
series.threeMonthGrowth[].value
number
趋势点数值
series.threeMonthGrowth[].date
string
月份，格式 yyyy-MM
dateRange
object
实际使用的月度窗口；传入未来/未归档日期时会截断到数据源最新可用数据点
dateRange.endDate
string
实际使用的结束月份，格式 yyyy-MM
dateRange.startDate
string
实际使用的开始月份，格式 yyyy-MM
granularity
string
粒度；可选值：MONTH
keyword
string
关键词
metrics
string[]
本次返回的指标
marketplace
string
站点
字段值缺失时返回 null。

示例

请求
{ "name": "keyword.trend", "arguments": { "keyword": "lunch bag", "marketplace": "US", "dateRange": { "startDate": "2026-03-01", "endDate": "2026-08-31" }, "granularity": "MONTH", "metrics": [ "searchVolume" ] } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "dateRange": { "startDate": "2026-03", "endDate": "2026-08" }, "granularity": "MONTH", "keyword": "lunch bag", "marketplace": "US", "metrics": [ "searchVolume" ], "series": { "searchVolume": [ { "date": "2026-03", "value": 307257 }, { "date": "2026-04", "value": 299387 } ] } }

使用说明

  • 默认返回最新可用月份往前 36 个月。
  • 关键词被收录之前的月份值为 null；中间出现的 0 为真实值。
  • 词库未收录的关键词会直接返回错误提示。
  • purchaseRate 为小数，0.0059 表示 0.59%。
 

相关词扩展 keyword.related.list

用途

根据种子词扩展相关关键词，返回每个词的搜索量、购买量、购买率、竞争度、PPC 竞价、相关度等指标，并支持按这些指标筛选和排序。
适合回答：
  • “帮我找 20 个 pot lid holder 相关的长尾词，至少三个单词。”
  • “竞价低于 1 美元、购买率高的相关词有哪些？”
不适合时改用：
  • 只查种子词本身 → keyword.batch.info
  • 竞品带来流量的词 → keyword.asin.list

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
seedKeyword
string
是
种子词
searchVolume
区间
否
搜索量区间
purchaseVolume
区间
否
购买量区间
purchaseRate
区间
否
购买率区间
wordCount
区间
否
词长区间（单词个数）
competition
区间
否
竞争度区间（商品数口径）
ppcBid
区间
否
PPC 竞价区间
relevancy
区间
否
相关度区间
spr
区间
否
SPR 区间
titleDensity
区间
否
标题密度区间
supplyDemandRatio
区间
否
供需比区间
adProducts
区间
否
广告商品数区间
searchRank
区间
否
搜索排名区间
avgPrice
区间
否
命中商品均价区间
avgRating
区间
否
命中商品平均评分区间
avgReviewCount
区间
否
命中商品平均评论数区间
clicks
区间
否
点击量区间
impressions
区间
否
曝光量区间
monopolyClickRate
区间
否
点击集中度区间
searchesGrowth
区间
否
搜索量增长率区间
yearlyGrowthRate
区间
否
年度增长率区间
includeKeywords
string[]
否
包含关键词过滤；最多 20 项
excludeKeywords
string[]
否
排除关键词过滤；最多 20 项
keywordBidMatchType
string
否
竞价匹配类型过滤
departments
string[]
否
类目节点路径过滤；最多 20 项
amazonChoice
boolean
否
是否 Amazon's Choice 过滤
extensiveMatch
boolean
否
是否广泛匹配
page
object
否
分页窗口
page.cursor
integer
否
offset 起点，默认 0；最小 0，最大 3000
page.size
integer
否
每页条数，默认 100；最小 1，最大 100
orderField
string
否
排序字段，缺省 searches；可选值：searches、purchases、purchase_rate、products、supply_demand_ratio、latest1daysAds、bid、titleDensityExact、cprExact、avg_price、monopoly_click_rate、avg_rating、avg_reviews、relevancy、adProducts7、rank、clicks、impressions、goods_value、cvsShareRate、searches_growth、yearly_growth_rate
desc
boolean
否
是否降序，默认 true
includeFields
string[]
否
同成本输出字段裁剪；不传或为空时返回默认字段集；可选值：keyword、searchVolume、purchaseVolume、purchaseRate、competition、ppcBid、wordCount、spr、relevancy；最多 9 项

返回字段

字段
类型
说明
items
object[]
 
items[].keyword
string
关键词
items[].resultStatus
string
逐条结果状态：success=命中；PARTIAL=命中但缺关键指标（如搜索量和购买率均为空）
items[].searchVolume
integer
搜索量
items[].purchaseVolume
integer
购买量
items[].purchaseRate
number
购买率（小数，0.0059 表示 0.59%）
items[].competition
integer
竞争度（商品数口径）
items[].ppcBid
number
PPC 竞价
items[].wordCount
integer
词长
items[].spr
integer
SPR
items[].relevancy
number
相关度评分；分值含义以数据源口径为准，缺失时为 null
page
object
 
page.cursor
integer
当前窗口起点
page.size
integer
当前窗口大小
page.truncated
boolean
为 true 时表示名单因翻页深度上限被截断，不是已经取完
page.hasMore
boolean
是否还有下一页
page.nextCursor
integer
下一页起点；没有下一页时省略
total
integer
扩词结果总条数
dataMonth
string
数据统计月份 yyyyMM
字段值缺失时返回 null。

示例

请求
{ "name": "keyword.related.list", "arguments": { "marketplace": "US", "seedKeyword": "renter friendly storage", "includeFields": [ "keyword", "searchVolume", "purchaseVolume", "purchaseRate", "competition", "ppcBid", "wordCount", "spr", "relevancy" ], "orderField": "relevancy", "desc": true, "page": { "cursor": 0, "size": 100 } } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "dataMonth": "202609", "items": [ { "competition": 71, "keyword": "renter friendly - 360 degree rotating shoe storage rack", "resultStatus": "PARTIAL", "spr": 1, "wordCount": 9 }, { "keyword": "shower storage renter friendly", "ppcBid": 0.98, "resultStatus": "PARTIAL", "spr": 1, "wordCount": 4 } ], "page": { "cursor": 0, "hasMore": false, "size": 100 }, "total": 2 }

使用说明

  • 默认按搜索量降序；想优先看和种子词最相关的词，请传 orderField=relevancy。
  • includeKeywords 可限定结果必须包含某个词，适合找精准长尾词。
  • 返回中的 total 为符合条件的总数，dataMonth 为数据月份。
 

竞品流量词 keyword.asin.list

用途

根据 1–10 个 ASIN 查询它们获得流量的关键词，返回每个词的搜索量、流量占比、自然和广告排名、流量类型，以及每个词分别命中了哪几个 ASIN。
适合回答：
  • “这款主要靠哪些词带流量？先给我前 10 个。”
  • “这两款竞品的流量词有哪些是共同的？”
不适合时改用：
  • 核心词的月度搜索量走势 → asin.coreKeyword.trend
  • ABA 反查 → keyword.aba.list

计费

每次调用扣 1 次，与查询的 ASIN 个数无关（1–10 个都是 1 次）；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
asins
string[]
是
ASIN 集合，1～10 个；服务端去重；最少 1 项，最多 10 项
month
string
否
数据归档月份，格式 yyyyMM。只有用户明确要求指定历史月份时才传；不传或传入未归档月份时由数据源返回最新归档月份。不要根据当前日期主动推断 month；格式 ^\d{6}$
trafficWordType
string[]
否
流量词类型过滤，OR 语义；不传表示不过滤。只影响 items，不影响 summary.typeStats；可选值：ORGANIC、ADS、AMAZON_CHOICE、EDITORIAL_RECOMMENDATION、FOUR_STAR、HIGHLY_RATED、SPONSOR_BRAND、SPONSOR_VIDEO、PRIMARY、PRECISE、PRECISE_LONG_TAIL、EFFECTIVE、CONVERSION_EXCELLENT、CONVERSION_STABLE、CONVERSION_LOST、INVALID；最少 1 项，最多 16 项
page
object
否
分页窗口
page.cursor
integer
否
offset 起点，默认 0；最小 0，最大 3000
page.size
integer
否
每页条数，默认 100；最小 1，最大 100
includeFields
string[]
否
同成本输出字段裁剪；不传或为空时返回默认字段集。只影响 items；可选值：keyword、searchVolume、searchesRank、trafficShare、trafficWordTypes、purchases、purchaseRate、clicks、impressions、products、supplyDemandRatio、bid、ppc、avgPrice、avgRating、avgReviews、titleDensity、spr、monopolyClickRate、adProducts、updatedTime、bestRank、bestAdRank、matchedAsins、clickShareRate、conversionShareRate；最少 1 项，最多 26 项

返回字段

字段
类型
说明
items
object[]
关键词具体数据列表
items[].keyword
string
关键词
items[].searchVolume
integer
搜索量
items[].searchesRank
integer
关键词搜索排名
items[].trafficShare
number
该关键词在整组 ASIN 流量中的占比
items[].trafficWordTypes
string[]
命中的 16 类流量词类型
items[].purchases
integer
购买量
items[].purchaseRate
number
购买率
items[].clicks
integer
点击量
items[].impressions
integer
曝光量
items[].products
integer
商品 / 竞品数
items[].supplyDemandRatio
number
供需比
items[].bid
object
 
items[].bid.value
number
建议竞价
items[].bid.min
number
最低竞价
items[].bid.max
number
最高竞价
items[].ppc
object
 
items[].ppc.phrase
object
 
items[].ppc.phrase.max
number
PPC 上限
items[].ppc.phrase.value
number
PPC 值
items[].ppc.phrase.min
number
PPC 下限
items[].ppc.exact
object
 
items[].ppc.exact.max
number
PPC 上限
items[].ppc.exact.value
number
PPC 值
items[].ppc.exact.min
number
PPC 下限
items[].ppc.broad
object
 
items[].ppc.broad.max
number
PPC 上限
items[].ppc.broad.value
number
PPC 值
items[].ppc.broad.min
number
PPC 下限
items[].avgPrice
number
平均商品价
items[].avgRating
number
平均评分
items[].avgReviews
integer
平均评分数
items[].titleDensity
number
标题密度
items[].spr
integer
SPR
items[].monopolyClickRate
number
点击垄断度
items[].adProducts
object
 
items[].adProducts.last1d
integer
近 1 天广告竞品数
items[].adProducts.last7d
integer
近 7 天广告竞品数
items[].adProducts.last30d
integer
近 30 天广告竞品数
items[].updatedTime
string
数据更新时间
items[].bestRank
integer
多 ASIN 下最优自然排名
items[].bestAdRank
integer
多 ASIN 下最优广告排名；无广告排名时不输出
items[].clickShareRate
number
点击份额（小数）
items[].conversionShareRate
number
转化份额（小数）
items[].matchedAsins
object[]
该关键词命中的输入 ASIN 明细
items[].matchedAsins[].asin
string
命中的输入 ASIN
items[].matchedAsins[].rank
integer
该 ASIN 在该 keyword 下的自然排名
items[].matchedAsins[].adRank
integer
该 ASIN 在该 keyword 下的广告排名；无广告排名时为 null
items[].matchedAsins[].adRankTime
string
广告排名更新时间
items[].matchedAsins[].trafficShare
number
该 ASIN 在该 keyword 下的流量占比
items[].matchedAsins[].searchVolume
integer
keyword 级搜索量
items[].matchedAsins[].clicks
integer
该 ASIN 的点击量
items[].matchedAsins[].impressions
integer
该 ASIN 的曝光量
items[].matchedAsins[].purchases
integer
该 ASIN 的购买量
items[].matchedAsins[].purchaseRate
number
该 ASIN 的购买率
items[].matchedAsins[].top3ClickingRate
number
该 ASIN 的 Top3 点击率
items[].matchedAsins[].top3ConversionRate
number
该 ASIN 的 Top3 转化率
items[].matchedAsins[].naturalRatio
number
该 ASIN 在该 keyword 下的自然流量占比（0-1 小数；按该词在该 ASIN 下的流量分布计算，缺失时为 null）
items[].matchedAsins[].adRatio
number
该 ASIN 在该 keyword 下的广告流量占比（0-1 小数；按该词在该 ASIN 下的流量分布计算，缺失时为 null）
page
object
 
page.cursor
integer
当前 offset 起点
page.size
integer
每页条数
page.truncated
boolean
为 true 时表示名单因翻页深度上限被截断，不是已经取完
page.hasMore
boolean
是否还有下一页
page.nextCursor
integer
下一页起点；无下一页时不返回
summary
object
 
summary.asins
object[]
每个输入 ASIN 的分析状态
summary.asins[].analyzed
boolean
当前月份是否已有可用分析快照
summary.asins[].asin
string
输入 ASIN
summary.allAnalyzed
boolean
是否全部 ASIN 已分析
summary.analyzedAsinCount
integer
已分析 ASIN 数量
summary.keywordCount
integer
已分析 ASIN 集合命中的 distinct keyword 数量
summary.typeStats
object
 
summary.typeStats.month
string
统计月份 yyyyMM
summary.typeStats.natural
integer
自然搜索词数量
summary.typeStats.ac
integer
Amazon Choice 词数量
summary.typeStats.er
integer
Editorial Recommendation 词数量
summary.typeStats.fourStar
integer
Four Star 词数量
summary.typeStats.hr
integer
Highly Rated 词数量
summary.typeStats.sponsorBrand
integer
Sponsor Brand 词数量
summary.typeStats.sponsorVideo
integer
Sponsor Video 词数量
summary.typeStats.sp
integer
SP 广告词数量
summary.typeStats.primary
integer
主要流量词数量
summary.typeStats.precise
integer
精准流量词数量
summary.typeStats.preciseLongTail
integer
精准长尾词数量
summary.typeStats.effectiveConversion
integer
有效转化词数量
summary.typeStats.conversionGood
integer
转化优质词数量
summary.typeStats.conversionStable
integer
转化平稳词数量
summary.typeStats.conversionLost
integer
转化流失词数量
summary.typeStats.invalid
integer
无效曝光词数量
summary.organicShare
number
自然词占比
summary.adShare
number
广告词占比
字段值缺失时返回 null。

示例

请求
{ "name": "keyword.asin.list", "arguments": { "asins": [ "B0725GYNG6" ], "marketplace": "US", "includeFields": [ "keyword", "searchVolume", "trafficShare" ], "page": { "cursor": 0, "size": 20 } } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "items": [ { "keyword": "baking sheet", "searchVolume": 138070, "trafficShare": 0.1088 }, { "keyword": "cookie sheets", "searchVolume": 119960, "trafficShare": 0.0802 } ], "page": { "cursor": 0, "hasMore": true, "nextCursor": 20, "size": 20 }, "summary": { "adShare": 0.0345, "allAnalyzed": true, "analyzedAsinCount": 1, "asins": [ { "analyzed": true, "asin": "B0725GYNG6" } ], "keywordCount": 261, "organicShare": 0.9387, "typeStats": { "ac": 29, "conversionGood": 2, "conversionLost": 2, "conversionStable": 4, "effectiveConversion": 6, "er": 0, "fourStar": 0, "hr": 0, "invalid": 0, "month": "202609", "natural": 245, "precise": 5, "preciseLongTail": 11, "primary": 2, "sp": 9, "sponsorBrand": 0, "sponsorVideo": 0 } } }

使用说明

  • 结果默认按流量占比从高到低排列。
  • matchedAsins 列出每个词命中的 ASIN 及该 ASIN 在这个词下的排名和流量占比；多个 ASIN 合查时，同一关键词只出现一行。
  • summary 中有整组 ASIN 的分析状态和各类流量词数量统计。
  • trafficWordType 可只看某类流量词，如自然词 ORGANIC、广告词 ADS。
  • month 一次查一个月份，不传时为最新月份。
 

核心词趋势 asin.coreKeyword.trend

用途

查询商品流量占比最高的几个核心词（默认 5 个，最多 10 个），以及它们每个月的搜索量走势。
适合回答：
  • “这款最主要的 5 个流量词，3 月到 8 月搜的人是多了还是少了？”
不适合时改用：
  • 完整流量词列表 → keyword.asin.list

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
asin
string
是
ASIN；格式 ^B[0-9A-Z]{9}$
topN
integer
否
核心词数量，缺省 5；1 到 10；最小 1，最大 10
dateRange
object
否
查询日期窗口。只有用户明确要求指定历史窗口时才传；不传时使用默认窗口
dateRange.endDate
string
否
结束日期，格式 yyyy-MM-dd。只有用户明确要求指定历史窗口时才传；不要根据当前日期主动推断，也不要传未来日期
dateRange.startDate
string
否
开始日期，格式 yyyy-MM-dd。只有用户明确要求指定历史窗口时才传；不要根据当前日期主动推断；最长 5 年且不早于 2022-01

返回字段

字段
类型
说明
keywords
object[]
 
keywords[].keyword
string
关键词
keywords[].trafficPercentage
number
流量占比
keywords[].trend
object[]
月度搜索量序列，只含 searchVolume 口径
keywords[].trend[].month
string
月份，格式 yyyy-MM
keywords[].trend[].searchVolume
integer
月搜索量（估算口径）
字段值缺失时返回 null。

示例

请求
{ "name": "asin.coreKeyword.trend", "arguments": { "asin": "B0DJV9G6FG", "marketplace": "US", "topN": 5 } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "keywords": [ { "keyword": "silicone baking mat", "trafficPercentage": 0.1332, "trend": [ { "month": "2025-10", "searchVolume": 112926 }, { "month": "2025-11", "searchVolume": 145227 } ] }, { "keyword": "baking", "trafficPercentage": 0.1279, "trend": [ { "month": "2025-10", "searchVolume": 95153 }, { "month": "2025-11", "searchVolume": 128669 } ] } ] }

使用说明

  • 词库未收录的商品返回空结果，不代表商品没有流量。
 

ABA 搜索词 keyword.aba.list

用途

查询亚马逊品牌分析（ABA）搜索词数据：按关键词查排名、搜索量、点击和购买份额、点击前三的商品；也可以按 ASIN 反查它出现在哪些 ABA 搜索词里。
适合回答：
  • “silicone baking mat 在 2026 年 8 月的 ABA 点击前三商品是谁，各占多少点击和购买份额？”
  • “这两款竞品在 ABA 里有哪些共同的搜索词？”
  • “baking mat 相关的增长词有哪些？”
不适合时改用：
  • 普通的商品流量词 → keyword.asin.list
  • ABA 排名走势 → keyword.aba.trend

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
否
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
keyword
string
否
正向锚点：关键词筛选
asins
string[]
否
反向锚点：批量 ASIN 反查，最多 10 个；最多 10 项
searchModel
integer
否
可选的榜单过滤：1 热门 / 2 异动 / 3 持续增长 / 4 快速飙升 / 5 潜力 / 6 长尾；不传则不过滤，返回全部匹配关键词（按搜索频率排名升序稳定分页）；可选值：1、2、3、4、5、6
departments
string[]
否
正向类目过滤
dateType
string
否
周期类型：WEEK / MONTH；缺省 MONTH。MONTH 支持自定义 yyyyMM 历史月份；可选值：WEEK、MONTH
date
string
否
dateType=WEEK 时为当周周六 yyyyMMdd；dateType=MONTH 时为 yyyyMM。不传时使用最新可用周期；不要根据当前日期主动推断未来周期。MONTH 显式传入尚未归档的月份时，服务端回退默认月表查询，结果可能为空；格式 ^(\d{6}|\d{8})$
searches
区间
否
搜索量区间
searchRank
区间
否
搜索排名区间
rankGrowthRate
区间
否
排名增长率区间
monopolyClickRate
区间
否
点击集中度区间
clicks
区间
否
点击量区间
impressions
区间
否
曝光量区间
conversionRate
区间
否
转化率区间
wordCount
区间
否
词长区间（单词个数）
spr
区间
否
SPR 区间
titleDensity
区间
否
标题密度区间
excludeKeywords
string[]
否
排除关键词过滤；最多 20 项
keywordBidMatchType
string
否
竞价匹配类型过滤
exactFlag
boolean
否
是否精确匹配
movementMarket
boolean
否
是否异动市场
includeKeywords
string[]
否
正向锚点或包含关键词过滤；多值 OR，命中任一；非空时覆盖 keyword；不能与 asins 同时使用；最多 20 项；最少 1 项，最多 20 项
rankGrowthValue
integer
否
搜索增长量过滤
page
object
否
分页窗口
page.cursor
integer
否
offset 起点，默认 0；最小 0，最大 3000
page.size
integer
否
每页条数，默认 100；最小 1，最大 100

返回字段

字段
类型
说明
dateType
string
实际命中的周期类型；可选值：WEEK、MONTH
date
string
实际命中的周期；WEEK 为 yyyyMMdd，MONTH 为 yyyyMM
items
object[]
 
items[].keyword
string
关键词
items[].searches
integer
搜索量
items[].purchases
integer
购买量
items[].purchaseRate
number
购买率
items[].searchRank
integer
搜索排名
items[].clicks
integer
点击量
items[].impressions
integer
展示量
items[].monopolyClickRate
number
点击集中度
items[].top3Asins
object[]
ABA 点击前三 ASIN 明细（周/月表 n1-n3 口径）：各 ASIN 的点击份额与转化份额，逐个相加应与 top3 聚合值/点击集中度对齐；不足三个时为实际条数
items[].top3Asins[].asin
string
ABA 点击前三 ASIN
items[].top3Asins[].title
string
商品标题；部分历史月份可能为 null
items[].top3Asins[].imageUrl
string
商品图片；部分历史月份可能为 null
items[].top3Asins[].clickShare
number
该 ASIN 的 ABA 点击份额
items[].top3Asins[].conversionShare
number
该 ASIN 的 ABA 转化份额
items[].clickShareRate
number
点击分享率；仅 ASIN 反查锚点返回
items[].conversionShareRate
number
转化分享率；仅 ASIN 反查锚点返回
items[].conversionType
string
反查结果上的转化类型标签，不是查询条件。数据源分页后才计算，不能用来保证本页已按类型滤全
page
object
 
page.cursor
integer
当前窗口起点
page.size
integer
当前窗口大小
page.truncated
boolean
为 true 时表示名单因翻页深度上限被截断，不是已经取完
page.hasMore
boolean
是否还有下一页
page.nextCursor
integer
下一页起点；没有下一页时省略
字段值缺失时返回 null。

示例

请求
{ "name": "keyword.aba.list", "arguments": { "keyword": "silicone baking mat", "marketplace": "US", "dateType": "MONTH", "date": "202608", "page": { "cursor": 0, "size": 100 } } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "date": "202608", "dateType": "MONTH", "items": [ { "clicks": 30128, "impressions": 2131225, "keyword": "silicone baking mat", "monopolyClickRate": 0.276, "purchaseRate": 0.0592, "purchases": 4238, "searchRank": 16584, "searches": 71603, "top3Asins": [ { "asin": "B0725GYNG6", "clickShare": 0.1009, "conversionShare": 0.0714, "imageUrl": "https://m.media-amazon.com/images/I/51imXcMRg0L._AC_US200_.jpg", "title": "Amazon Basics Silicone Rectangular Baking Mat, Non-Stick, Reusable, Dishwasher Safe, Food Safe, Heat Resistant, 16.5\" x 11.6\", Beige/Gray, 2-Pack" }, { "asin": "B0CFTP6JR4", "clickShare": 0.0989, "conversionShare": 0.1077, "imageUrl": "https://m.media-amazon.com/images/I/41evrh-aFvL._AC_US200_.jpg", "title": "Koolstuffs Silicone Baking Mat, Nonstick and Reusable, 3 Pack" } ] }, { "clicks": 4459, "impressions": 261207, "keyword": "silicone mats for baking", "monopolyClickRate": 0.2414, "purchaseRate": 0.0549, "purchases": 522, "searchRank": 169493, "searches": 9501, "top3Asins": [ { "asin": "B077XR38W3", "clickShare": 0.084, "conversionShare": 0.0612, "imageUrl": "https://m.media-amazon.com/images/I/51WmrQ2L8IL._AC_US200_.jpg", "title": "Amazon Basics Silicone Baking Mat for Macarons, Non-Stick, Food Safe, Reusable, Oven-Safe, 16.5\" x 11.6\", Beige/Gray, 2-Pack" }, { "asin": "B0725GYNG6", "clickShare": 0.0799, "conversionShare": 0.0816, "imageUrl": "https://m.media-amazon.com/images/I/51imXcMRg0L._AC_US200_.jpg", "title": "Amazon Basics Silicone Rectangular Baking Mat, Non-Stick, Reusable, Dishwasher Safe, Food Safe, Heat Resistant, 16.5\" x 11.6\", Beige/Gray, 2-Pack" } ] } ], "page": { "cursor": 0, "hasMore": false, "size": 100 } }

使用说明

  • 正向查询用 keyword 或 includeKeywords（多个词为“或”关系）；反向查询用 asins（最多 10 个）。两者不能同时使用。
  • dateType 为 MONTH（默认，date 填 yyyyMM）或 WEEK（date 填当周周六 yyyyMMdd）。
  • searchModel 可按榜单筛选：1 热门、2 异动、3 持续增长、4 快速飙升、5 潜力、6 长尾。
 

ABA 趋势 keyword.aba.trend

用途

查询关键词在 ABA 中的排名、搜索量、点击前三份额、转化前三份额的历史走势，可按周或按月。
适合回答：
  • “silicone baking mat 今年 7–9 月 ABA 排名和头部点击占比怎么变？”
  • “按周看是一直在变，还是某几周突然变化？”
不适合时改用：
  • 平台搜索量走势 → keyword.trend

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
keyword
string
是
关键词
metrics
string[]
否
指标白名单；缺省全量返回；可选值：abaRank、abaSearchVolume、top3ClickShare、top3ConversionShare
granularity
string
否
粒度：WEEK / MONTH；缺省 MONTH。WEEK 趋势点为 yyyy-MM-dd，MONTH 趋势点为当月 1 日 yyyy-MM-dd；可选值：WEEK、MONTH
dateRange
object
否
日期窗口。只有用户明确要求指定历史窗口时才传；不传时基于数据源最新可用数据点返回最近 1 年；响应中的 dateRange 是实际使用的窗口
dateRange.startDate
string
否
开始日期，格式 yyyy-MM-dd。只有用户明确要求指定历史窗口时才传；不要根据当前日期主动推断；不传时为数据源最新可用数据点往前 1 年
dateRange.endDate
string
否
结束日期，格式 yyyy-MM-dd。只有用户明确要求指定历史窗口时才传；不要根据当前日期主动推断；不传或晚于数据源最新可用数据点时截断到最新可用数据点

返回字段

字段
类型
说明
keyword
string
关键词
marketplace
string
站点
granularity
string
粒度；WEEK 趋势点为 yyyy-MM-dd，MONTH 趋势点为当月 1 日 yyyy-MM-dd；可选值：WEEK、MONTH
dateRange
object
实际使用的日期窗口；传入未来/未归档日期时会截断到数据源最新可用数据点
dateRange.endDate
string
实际使用的结束日期，格式 yyyy-MM-dd
dateRange.startDate
string
实际使用的开始日期，格式 yyyy-MM-dd
metrics
string[]
本次返回的指标
series
object
按指标键组织的 ABA 趋势序列；只包含本次选择的指标
series.abaRank
object[]
 
series.abaRank[].value
number
趋势点数值；缺失点为 null
series.abaRank[].date
string
日期，格式 yyyy-MM-dd
series.abaSearchVolume
object[]
 
series.abaSearchVolume[].value
number
趋势点数值；缺失点为 null
series.abaSearchVolume[].date
string
日期，格式 yyyy-MM-dd
series.top3ClickShare
object[]
 
series.top3ClickShare[].value
number
趋势点数值；缺失点为 null
series.top3ClickShare[].date
string
日期，格式 yyyy-MM-dd
series.top3ConversionShare
object[]
 
series.top3ConversionShare[].value
number
趋势点数值；缺失点为 null
series.top3ConversionShare[].date
string
日期，格式 yyyy-MM-dd
字段值缺失时返回 null。

示例

请求
{ "name": "keyword.aba.trend", "arguments": { "keyword": "baking mat", "marketplace": "US", "granularity": "WEEK", "dateRange": { "startDate": "2026-08-01", "endDate": "2026-10-17" }, "metrics": [ "abaRank" ] } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "dateRange": { "startDate": "2026-08-01", "endDate": "2026-10-17" }, "granularity": "WEEK", "keyword": "baking mat", "marketplace": "US", "metrics": [ "abaRank" ], "series": { "abaRank": [ { "date": "2026-08-01", "value": 54134 }, { "date": "2026-08-08", "value": 53513 } ] } }

使用说明

  • 默认返回最近 1 年。
  • 历史数据主要覆盖头部排名的词，长尾词可能没有历史。
  • 按月时，每个点的日期为当月 1 日。
 

广告转化分析 keyword.conversion.analysis

用途

分析关键词的广告指标：点击、转化、购买、点击率、转化率、CPA、ACOS、建议竞价和预算，可按词组或广泛匹配查询相关词。
适合回答：
  • “售价 29.99 美元，这 3 个词先试哪些、出价怎么起步？”
  • “哪些词点击转化率高、竞价还不贵？”
不适合时改用：
  • 关键词基础指标 → keyword.batch.info

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
keyword
string
是
关键词
timeType
string
是
分析周期口径；可选值：WEEK、90D
matchType
string
否
关键词匹配方式，缺省 PHRASE；可选值：PHRASE、BROAD
bidMatchType
string
否
竞价匹配类型过滤
customAvgProductPrice
number
否
自定义商品均价
nicheMarkets
string[]
否
细分市场过滤；最多 20 项
includeKeywords
string[]
否
包含词过滤；最多 20 项
excludeKeywords
string[]
否
排除词过滤；最多 20 项
searches
区间
否
搜索量区间
clicks
区间
否
点击量区间
purchases
区间
否
购买量区间
searchConvRate
区间
否
搜索转化率区间
clickConvRate
区间
否
点击转化率区间
ppc
区间
否
PPC 竞价区间
cpa
区间
否
CPA 区间
productPrice
区间
否
商品价格区间
acos
区间
否
ACOS 区间
clickingRate
区间
否
点击率区间
conversionRate
区间
否
转化率区间
phraseCount
区间
否
词组数区间
budget
区间
否
建议预算区间
orderField
string
否
排序字段：searches/clicks/purchases/searchConvRate/clickConvRate/clickingRate/avgProductPrice；ppc/cpa/acos/budget 需同时指定 bidMatchType，否则数据源回退 searches；可选值：searches、clicks、purchases、searchConvRate、clickConvRate、clickingRate、avgProductPrice、ppc、cpa、acos、budget
desc
boolean
否
是否降序，默认 true
page
object
否
分页窗口
page.cursor
integer
否
offset 起点，默认 0；最小 0，最大 3000
page.size
integer
否
每页条数，默认 100；最小 1，最大 100

返回字段

字段
类型
说明
items
object[]
关键词转化分析行
items[].keyword
string
关键词
items[].searches
integer
搜索量
items[].clicks
integer
点击量
items[].purchases
integer
购买量
items[].searchConvRate
number
搜索转化率
items[].clickConvRate
number
点击转化率
items[].clickingRate
number
点击率
items[].conversionRate
number
转化率
items[].phrasePpc
number
词组匹配 PPC
items[].exactPpc
number
精准匹配 PPC
items[].broadPpc
number
广泛匹配 PPC
items[].phraseCpa
number
词组匹配 CPA
items[].exactCpa
number
精准匹配 CPA
items[].broadCpa
number
广泛匹配 CPA
items[].phraseAcos
number
词组匹配 ACOS
items[].exactAcos
number
精准匹配 ACOS
items[].broadAcos
number
广泛匹配 ACOS
items[].avgProductPrice
number
商品均价
items[].phraseBudget
number
词组匹配建议预算
items[].exactBudget
number
精准匹配建议预算
items[].broadBudget
number
广泛匹配建议预算
items[].phraseCount
integer
词组数量
items[].dateCycle
string
数据周期
page
object
 
page.cursor
integer
当前 offset 起点
page.size
integer
每页条数
page.truncated
boolean
为 true 时表示名单因翻页深度上限被截断，不是已经取完
page.hasMore
boolean
是否还有下一页
page.nextCursor
integer
下一页起点；无下一页时不返回
resultStatus
string
整体查询状态：success=有数据；no_data=无匹配结果；可选值：success、no_data、None
message
string
无数据时的说明
字段值缺失时返回 null。

示例

请求
{ "name": "keyword.conversion.analysis", "arguments": { "marketplace": "US", "keyword": "pot lid organizer", "matchType": "PHRASE", "timeType": "90D", "orderField": "searches", "desc": true, "page": { "cursor": 0, "size": 20 } } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "items": [ { "avgProductPrice": 16.99, "broadAcos": 0.5006, "broadBudget": 13.32, "broadCpa": 8.51, "broadPpc": 1.11, "clickConvRate": 0.1305, "clickingRate": 0.2713, "clicks": 36520, "conversionRate": 0.18, "exactAcos": 0.5548, "exactBudget": 14.76, "exactCpa": 9.43, "exactPpc": 1.23, "keyword": "pot lid organizer", "phraseAcos": 0.4194, "phraseBudget": 11.16, "phraseCount": 0, "phraseCpa": 7.13, "phrasePpc": 0.93, "purchases": 4767, "searchConvRate": 0.055, "searches": 86658 }, { "avgProductPrice": 18.99, "clickConvRate": 0.0758, "clickingRate": 0.3534, "clicks": 12118, "conversionRate": 0.0822, "keyword": "stainless steel utensil holder & pot lid organizer", "phraseCount": 8, "purchases": 919, "searchConvRate": 0.0274, "searches": 33581 } ], "message": null, "page": { "cursor": 0, "hasMore": false, "size": 20 }, "resultStatus": "success" }

使用说明

  • timeType 为 WEEK（近一周）或 90D（近 90 天）。
  • searches 为所选时间窗的估算值，与 keyword.trend 的月度搜索量口径不同；本工具更适合看转化率、CPA、竞价类指标。
  • customAvgProductPrice 可传入你的售价，用于计算 ACOS 等指标。
  • 按 ppc、cpa、acos、budget 排序时需同时指定 bidMatchType。
 

Google 搜索趋势 keyword.google.trend

用途

查询关键词在 Google 上的搜索热度走势，可选网页搜索（WEB）或购物搜索（SHOPPING）。
适合回答：
  • “camping lantern 过去一年在 Google 上的搜索热度有什么季节变化？”
  • “购物搜索的走势也一样吗？”
不适合时改用：
  • 亚马逊站内搜索量 → keyword.trend

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
keyword
string
是
关键词
gprop
string
否
Google 搜索来源，缺省 WEB；可选值：WEB、SHOPPING
dateRange
object
否
查询日期窗口；跨度最长 5 年
dateRange.endDate
string
否
结束日期，格式 yyyy-MM-dd；缺省为当前日期
dateRange.startDate
string
否
开始日期，格式 yyyy-MM-dd；缺省为当前日期 - 5 年

返回字段

字段
类型
说明
marketplace
string
站点
gprop
string
搜索来源
keyword
string
关键词
series
object
 
series.interest
object[]
Google Trends 热度序列
series.interest[].value
integer
热度指数；数据缺失时为 null
series.interest[].date
string
日期，格式 yyyy-MM-dd
字段值缺失时返回 null。

示例

请求
{ "name": "keyword.google.trend", "arguments": { "keyword": "camping lantern", "marketplace": "US", "gprop": "WEB" } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "gprop": "WEB", "keyword": "camping lantern", "marketplace": "US", "series": { "interest": [ { "date": "2021-10-31", "value": 21 }, { "date": "2021-11-07", "value": 16 } ] } }

使用说明

  • 热度为 Google 归一化指数（0–100），不是搜索次数，不能和亚马逊搜索量直接比较，WEB 和 SHOPPING 两个指数也不能相加。
  • 搜索量较低的词，Google 可能不提供数据，对应的点为 null。
  • 日期窗口默认近 5 年。

评论

 

商品评论（标准版） asin.review.list

用途

查询商品评论，一次最多 100 条，可按星级、是否带图或视频筛选，并按日期、星级或有用数排序。
适合回答：
  • “这款最新 20 条评论给我，带日期、星级和原文。”
  • “这款买家最不满意什么？”
  • “只看 1–3 星、带图或视频的评论。”
不适合时改用：
  • 需要更多评论（最多 500 条）→ asin.review.list.extended

计费

按返回条数计费：每 20 条扣 1 次，不足 20 条按 20 条算（例如返回 100 条扣 5 次，返回 13 条扣 1 次）。没有返回评论时不扣次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
asin
string
是
父体或子体 ASIN；服务端归一到父体
star
integer[]
否
精确星级过滤，可多选；不传不过滤；可选值：1、2、3、4、5；最少 1 项，最多 5 项
hasMedia
boolean
否
true=有图片或视频；false=无图片且无视频；不传不过滤
sort
string
否
排序方式，默认 DATE_DESC；可选值：DATE_DESC、DATE_ASC、STAR_DESC、STAR_ASC、HELPFUL_DESC、HELPFUL_ASC
limit
integer
否
返回条数，默认 100，最大 100；常用于批量获取 TopN 评论；最小 1，最大 100

返回字段

字段
类型
说明
coverageStartDate
string
本次返回评论中最早的评论日期
returnedReviewCount
integer
本次实际返回评论数
asin
string
输入 ASIN
collectionStatus
string
父体评论采集状态。NOT_COLLECTED=未采集；PARTIAL=部分采集；COMPLETE=采集完成；FETCHING=采集中；STALE=采集完成但覆盖日期落后超过30天；NO_REVIEWS=已采集但无评论；可选值：NOT_COLLECTED、PARTIAL、COMPLETE、FETCHING、STALE、NO_REVIEWS
reviews
object[]
评论列表，最多 100 条；最多 100 项
reviews[].reviewId
string
评论唯一 ID；主题分类、引用和去重都必须保留该 ID
reviews[].date
string
评论日期，格式 yyyy-MM-dd
reviews[].star
integer
星级，1～5；解析失败或缺失时为 null
reviews[].title
string
评论标题
reviews[].content
string
评论内容
reviews[].author
string
评论人
reviews[].purchased
boolean
是否已购买
reviews[].vine
boolean
是否 Vine 评论
reviews[].helpful
integer
helpful 数
reviews[].images
string[]
评论图片链接列表；无图片评论时为 null
reviews[].videos
string[]
评论视频链接列表；无视频评论时为 null
reviews[].skus
string[]
购买规格，如 Size: 8 Rolls；无规格时为 null
collectedAt
string
最近一次成功采集评论的时间；从未采集时为 null
retrievedAt
string
本次 MCP 检索时间；不是抓取完成时间
marketplace
string
站点
coverageEndDate
string
本次返回评论中最晚的评论日期
totalStoredReviewCount
integer
库中当前已存的父体评论总数
字段值缺失时返回 null。

示例

请求
{ "name": "asin.review.list", "arguments": { "marketplace": "US", "asin": "B0G3PP6SML", "star": [ 1, 2 ], "sort": "HELPFUL_DESC", "limit": 100 } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "asin": "B0G3PP6SML", "collectedAt": "2026-10-22 16:09:12", "collectionStatus": "COMPLETE", "coverageEndDate": "2026-10-13", "coverageStartDate": "2026-01-18", "marketplace": "US", "retrievedAt": "2026-10-26 21:23:47", "returnedReviewCount": 9, "reviews": [ { "author": "Kelli VB", "content": "Broken top after two uses", "date": "2026-05-05", "purchased": true, "reviewId": "USR1O6V8DNH4SLGP", "skus": [ "Color: Dark Knight & Cotton Candy", "Size: 18 oz (Pack of 2)" ], "star": 1, "title": "Poor quality", "vine": false }, { "author": "Frances T Daly", "content": "At first these water bottles kept water cold but for some unknown reason they fail to keep water cold for even 2 hours. I put water with ice before physical therapy and within 2 hours ice is melted a…", "date": "2026-07-25", "purchased": true, "reviewId": "USR2AMQHVC49AIF3", "skus": [ "Color: Dark Knight & Cotton Candy", "Size: 18 oz (Pack of 2)" ], "star": 1, "title": "Does not keep water cold.", "vine": false } ], "totalStoredReviewCount": 43 }

使用说明

  • 按父体返回评论：传入任意一个规格（子体）的 ASIN，返回的都是这款商品所有规格的评论。每条评论的 skus 字段标明它属于哪个规格；只分析某个规格时，请按 skus 筛选。
  • 评论内容取自亚马逊前台商品页。返回中会标明采集时间（collectedAt）、本次结果的日期范围（coverageStartDate～coverageEndDate）、库中已存评论总数（totalStoredReviewCount）和采集状态（collectionStatus）。
  • 采集状态 collectionStatus 的各个取值含义见返回字段表。
  • star 可多选，如 [1, 2, 3]；hasMedia 为 true 只看带图或视频的评论。
 

商品评论（扩展版） asin.review.list.extended

用途

查询更多评论，一次最多 500 条；筛选和排序方式与标准版相同。
适合回答：
  • “这款的评论我想看得完整些，最多看 500 条，帮我整理主要问题。”
不适合时改用：
  • 日常查询 100 条以内 → asin.review.list

计费

按返回条数计费：每 20 条扣 1 次，不足 20 条按 20 条算（例如返回 452 条扣 23 次）。没有返回评论时不扣次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
asin
string
是
父体或子体 ASIN；服务端归一到父体
star
integer[]
否
精确星级过滤，可多选；不传不过滤；可选值：1、2、3、4、5；最少 1 项，最多 5 项
hasMedia
boolean
否
true=有图片或视频；false=无图片且无视频；不传不过滤
sort
string
否
排序方式，默认 DATE_DESC；可选值：DATE_DESC、DATE_ASC、STAR_DESC、STAR_ASC、HELPFUL_DESC、HELPFUL_ASC
limit
integer
否
返回条数，默认 500，最大 500；常用于批量获取 TopN 评论；最小 1，最大 500

返回字段

字段
类型
说明
coverageStartDate
string
本次返回评论中最早的评论日期
returnedReviewCount
integer
本次实际返回评论数
asin
string
输入 ASIN
collectionStatus
string
父体评论采集状态。NOT_COLLECTED=未采集；PARTIAL=部分采集；COMPLETE=采集完成；FETCHING=采集中；STALE=采集完成但覆盖日期落后超过30天；NO_REVIEWS=已采集但无评论；可选值：NOT_COLLECTED、PARTIAL、COMPLETE、FETCHING、STALE、NO_REVIEWS
reviews
object[]
评论列表，最多 500 条；最多 500 项
reviews[].reviewId
string
评论唯一 ID；主题分类、引用和去重都必须保留该 ID
reviews[].date
string
评论日期，格式 yyyy-MM-dd
reviews[].star
integer
星级，1～5；解析失败或缺失时为 null
reviews[].title
string
评论标题
reviews[].content
string
评论内容
reviews[].author
string
评论人
reviews[].purchased
boolean
是否已购买
reviews[].vine
boolean
是否 Vine 评论
reviews[].helpful
integer
helpful 数
reviews[].images
string[]
评论图片链接列表；无图片评论时为 null
reviews[].videos
string[]
评论视频链接列表；无视频评论时为 null
reviews[].skus
string[]
购买规格，如 Size: 8 Rolls；无规格时为 null
collectedAt
string
最近一次成功采集评论的时间；从未采集时为 null
retrievedAt
string
本次 MCP 检索时间；不是抓取完成时间
marketplace
string
站点
coverageEndDate
string
本次返回评论中最晚的评论日期
totalStoredReviewCount
integer
库中当前已存的父体评论总数
字段值缺失时返回 null。

示例

请求
{ "name": "asin.review.list.extended", "arguments": { "asin": "B07N7KFHVH", "marketplace": "US", "limit": 500, "sort": "DATE_DESC", "star": [ 4 ] } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "asin": "B07N7KFHVH", "collectedAt": "2026-09-22 17:22:00", "collectionStatus": "STALE", "coverageEndDate": "2026-07-26", "coverageStartDate": "2020-12-24", "marketplace": "US", "retrievedAt": "2026-10-26 21:05:26", "returnedReviewCount": 62, "reviews": [ { "author": "Ligia Roman", "content": "Es practico y bueno. Si cuesta un poco o debes hacer mucha fuerza para partir el ajo, pero cumple su funcion", "date": "2026-07-26", "purchased": true, "reviewId": "USRLDGYC6S97IBG", "skus": [ "Color: Black" ], "star": 4, "title": "Bueno", "vine": false }, { "author": "Barbara Bates", "content": "The garlic peeler works great. It’s so easy, just insert garlic into tube, press lightly and roll. The dried skins come right off. The garlic press is a bit disappointing to me, as it smashes the ga…", "date": "2026-07-21", "helpful": 1, "purchased": true, "reviewId": "USR3F98V3Q2KMZSX", "skus": [ "Color: Black" ], "star": 4, "title": "Makes cooking with fresh garlic much easier.", "vine": false } ], "totalStoredReviewCount": 452 }

使用说明

  • 按父体返回评论，说明同标准版：传入任意规格 ASIN，返回这款商品所有规格的评论，用 skus 区分规格。
  • 单次可能需要约 2 分钟。
  • 返回字段与标准版相同。

广告

 

竞品广告洞察 ads.insights.lookup

用途

查询商品的商品推广（SP）广告活动和广告组，以及每个广告组在各周或各月是否出现、热度如何。
适合回答：
  • “这款竞品的商品推广广告是怎么分组的？”
  • “哪些广告组一直在投，哪些是最近新出现的？”
不适合时改用：
  • 竞品出现在哪些广告关键词上 → keyword.asin.list（trafficWordType=ADS）

计费

每次调用扣 1 次；翻页时每页单独计 1 次。 参数错误被拒绝时不扣次。

请求参数

参数
类型
必填
说明
marketplace
string
是
站点代码；可选值：AE、AU、BR、CA、DE、ES、FR、IN、IT、JP、MX、NL、PL、SA、SE、SG、TR、UK、US
asin
string
是
单个 ASIN；可传父体或任一子体，服务端会展开变体
interval
string
否
统计粒度，缺省 MONTH；数据源当前暂不支持 DAY；可选值：WEEK、MONTH
months
integer
否
回溯月数，缺省 3；仅在未传 startDate/endDate 时生效；最小 1，最大 12
campaignId
string
否
广告活动过滤
adId
string
否
广告组过滤
type
string
否
广告类型过滤
variation
string
否
变体过滤
startDate
string
否
自定义日期窗口起点（yyyy-MM-dd）；与 endDate 同时传入时日期优先生效，months 被忽略，实际窗口在响应无法回显时以本参数为准
endDate
string
否
自定义日期窗口终点（yyyy-MM-dd）
combination
boolean
否
是否合并展示同一广告活动（按 campaignId 聚合），默认 false
desc
boolean
否
广告组排序开关，缺省 false
page
object
否
广告组分页窗口
page.cursor
integer
否
offset 起点，默认 0；最小 0，最大 3000
page.size
integer
否
每页条数，默认 100；最小 1，最大 100

返回字段

字段
类型
说明
asin
string
输入的单个 ASIN
summary
object
 
summary.adCount
integer
广告组总数
summary.campaignCount
integer
广告活动总数
campaigns
object[]
广告活动列表
campaigns[].campaignId
string
广告活动 ID
campaigns[].type
string
广告类型
page
object
 
page.cursor
integer
当前 offset 起点
page.size
integer
每页条数
page.truncated
boolean
为 true 时表示名单因翻页深度上限被截断，不是已经取完
page.hasMore
boolean
是否还有下一页
page.nextCursor
integer
下一页起点；无下一页时不返回
marketplace
string
站点
groups
object[]
当前页广告组列表
groups[].adId
string
广告组 ID
groups[].campaignId
string
广告活动 ID
groups[].asin
string
关联 ASIN
groups[].asinImage
string
ASIN 主图
groups[].type
string
广告类型
groups[].totalCount
integer
累计关键词数量
groups[].startDate
string
最早抓取日期
groups[].lastEffectiveDate
string
最近有效日期
groups[].firstEffectiveDate
string
最早有效日期
groups[].history
object[]
历史周期数据
groups[].history[].endDate
string
周期结束日期
groups[].history[].beginDate
string
周期开始日期
groups[].history[].dateLabel
string
数据源日期标签
groups[].history[].keywordsCount
integer
投放关键词数量
interval
string
统计粒度
字段值缺失时返回 null。

示例

请求
{ "name": "ads.insights.lookup", "arguments": { "marketplace": "US", "asin": "B00HEZ888K", "interval": "MONTH", "months": 3, "combination": true, "desc": true, "page": { "cursor": 0, "size": 50 } } }
返回（2026-10-26 实测结果；数组只展示前几项，长文本已截断）
{ "asin": "B00HEZ888K", "campaigns": [ { "campaignId": "A047467130MBOQT6VPORI", "type": "SP" }, { "campaignId": "A017693533LCZWY47B7ER", "type": "SP" } ], "groups": [ { "adId": "A07039481TBP9TULOB35L", "asin": "B00HEZ888K", "asinImage": "https://m.media-amazon.com/images/I/21y6NxlnayL._AC_US200_.jpg", "campaignId": "A04847913PO3DDUAQY2UM", "firstEffectiveDate": "2025-12-31", "history": [ { "beginDate": "2025-10-31", "endDate": "2025-11-30", "keywordsCount": 0 }, { "beginDate": "2025-11-30", "endDate": "2025-12-31", "keywordsCount": 16 } ], "lastEffectiveDate": "2026-02-28", "startDate": "2025-12-31", "totalCount": 21, "type": "SP" }, { "adId": "A0828394HMW4W4MG9XEE", "asin": "B00HEZ888K", "asinImage": "https://m.media-amazon.com/images/I/21y6NxlnayL._AC_US200_.jpg", "campaignId": "A089066434RDPH5WS5EDG", "firstEffectiveDate": "2025-12-31", "history": [ { "beginDate": "2025-10-31", "endDate": "2025-11-30", "keywordsCount": 0 }, { "beginDate": "2025-11-30", "endDate": "2025-12-31", "keywordsCount": 4 } ], "lastEffectiveDate": "2026-02-28", "startDate": "2025-12-31", "totalCount": 5, "type": "SP" } ], "interval": "MONTH", "marketplace": "US", "page": { "cursor": 0, "hasMore": false, "size": 50 }, "summary": { "adCount": 9, "campaignCount": 9 } }

使用说明

  • 传入父体或任一子体 ASIN，服务端会展开整款所有变体的广告；可用 variation 只看某个变体。
  • 时间窗口：传 months（1–12，默认 3）表示从当前往前回溯的月数；interval 可选 MONTH（默认）或 WEEK。
  • 返回的是可观测到的广告活动和广告组，不包含竞品的真实花费和后台完整结构。
  • 广告组较多时请翻页（每页最多 100 条），summary 中有广告组和广告活动总数。
中文第二个广告
真诚点赞，手留余香

上一篇

15 找出自家差评最该先改的问题

下一篇

如何使用卖家精灵【Listing生成器】功能？新手入门教程

网友评论
全部评论 (0) / 我的评论 (0)
最新 (0) / 最热 (0)

暂无评论