搜索类目
提供匹配类目的名称、完整路径、代表 ASIN 数量与可用状态,帮助确定目标市场。
工具
研究类目需求、关键词集中度、商品分布与竞争变化。
搜索类目
搜索亚马逊类目,自动识别关键词或 ASIN,返回完整类目路径、代表 ASIN 数量、可用性及已有翻译。免费。搜索后必须让用户确认目标类目,即使只有一个候选。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
country | string | 是 | 用户明确选择的亚马逊站点,如 US/UK/DE;不能默认站点。 |
query | string | 是 | 关键词或单个 ASIN,服务自动识别。 |
类目路径、代表 ASIN 数量、可用性及已有翻译。
不计费
搜索 1 次类目,消耗 0 Credit
搜索类目
提供匹配类目的名称、完整路径、代表 ASIN 数量与可用状态,帮助确定目标市场。
生成类目洞察资源
为用户已确认的站点和类目生成洞察资源,内部最长等待 5 分钟并自动重建失败资源。每次独立成功调用 500 Credits,命中已有资源也收费。同一任务后续查询应复用 resourceId,避免重复调用生成工具。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
categoryId | string | 是 | 用户已确认的类目 ID。 |
country | string | 是 | 用户明确选择的亚马逊站点,如 US/UK/DE;不能默认站点。 |
可用于后续类目分析的资源 ID;同一任务后续查询复用该资源。
每次独立成功调用消耗 500 Credits,命中已有资源也计费
成功调用 1 次,消耗 500 Credits
生成类目洞察资源
生成选定站点和类目的洞察资源,供商品榜单、关键词、市场趋势与竞争分析使用。
类目销量榜
获取类目销量榜,reportPeriod 必填:YYYY-MM 查询完整自然月,YYYY 查询完整自然年,last30days / last12months 查询滚动周期,支持新版品牌、区间、排序和分页;榜单按 primaryAsin 聚合。每返回 5 个代表 ASIN 收 5 Credits,不足一档向上取整。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
reportPeriod | string | 是 | 必填统计期:YYYY-MM(如 2026-08)表示完整自然月;YYYY(如 2025)表示完整自然年;last30days / last12months 表示近 30 天 / 近 12 个月。按 country 的站点时区展开,不接受日级日期、日期范围或 cycleFilter。自然年固定展开为 1 月 1 日至 12 月 31 日,不自动截断当前年。 |
categoryId | string | 是 | 用户已确认的类目 ID。 |
country | string | 是 | 用户明确选择的亚马逊站点,如 US/UK/DE;不能默认站点。 |
filters | object | 否 | 品牌或相关度筛选。 |
filters.brands | string[] | 否 | 待查询的品牌列表。 |
orders | object[] | 否 | 排序字段及方向。 |
orders[].direction | "asc" | "desc" | 是 | 排序方向:升序或降序。 |
orders[].field | "sales" | "revenue" | "price" | "ratings" | "stars" | "salesMom" | "salesYoy" | "trafficScore" | "organicTrafficScoreRatio" | "height" | "length" | "width" | "weight" | 是 | 排序字段。 |
page | integer | 否 | 页码。 默认值:1。 |
pageSize | integer | 否 | 每页数量。 默认值:20。 |
query | string | 否 | 新版列表搜索词,省略时不筛选。 |
rangeFilters | object | 否 | 同字段多个区间按 OR(并集),不同字段按 AND;每个区间至少一个边界且 min≤max,省略的边界不设限。一个连续区间的上下限应写在同一项,如 [{"min":10,"max":20}];[{"min":10},{"max":20}] 表示两个区间的并集。边界是否包含见各字段说明。上架天数使用 streetDays,无旧 streetSince 默认筛选。 |
rangeFilters.height | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.height[].max | integer | 否 | 区间上限。 |
rangeFilters.height[].min | integer | 否 | 区间下限。 |
rangeFilters.length | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.length[].max | integer | 否 | 区间上限。 |
rangeFilters.length[].min | integer | 否 | 区间下限。 |
rangeFilters.organicTrafficScoreRatio | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.organicTrafficScoreRatio[].max | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.organicTrafficScoreRatio[].min | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.price | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.price[].max | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.price[].min | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.ratings | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.ratings[].max | integer | 否 | 区间上限。 |
rangeFilters.ratings[].min | integer | 否 | 区间下限。 |
rangeFilters.revenue | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.revenue[].max | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.revenue[].min | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.sales | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.sales[].max | integer | 否 | 区间上限。 |
rangeFilters.sales[].min | integer | 否 | 区间下限。 |
rangeFilters.salesMom | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.salesMom[].max | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.salesMom[].min | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.salesYoy | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.salesYoy[].max | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.salesYoy[].min | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.stars | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.stars[].max | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.stars[].min | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.streetDays | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.streetDays[].max | integer | 否 | 区间上限。 |
rangeFilters.streetDays[].min | integer | 否 | 区间下限。 |
rangeFilters.trafficScore | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.trafficScore[].max | integer | 否 | 区间上限。 |
rangeFilters.trafficScore[].min | integer | 否 | 区间下限。 |
rangeFilters.weight | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.weight[].max | integer | 否 | 区间上限。 |
rangeFilters.weight[].min | integer | 否 | 区间下限。 |
rangeFilters.width | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.width[].max | integer | 否 | 区间上限。 |
rangeFilters.width[].min | integer | 否 | 区间下限。 |
resourceId | string | 是 | 生成工具返回的可用资源 ID;同任务复用。 |
按代表 ASIN 聚合的销量榜,支持品牌、区间、排序、搜索和分页。
每返回 5 个代表 ASIN 消耗 5 Credits,不足 5 个向上取整
返回 12 个代表 ASIN,消耗 15 Credits
类目销量榜
提供月度、年度及滚动周期的代表 ASIN 销量榜,结合销量、销售额、价格与评分筛选畅销商品和对标竞品。
类目新品榜
获取类目新品榜,reportPeriod 必填:YYYY-MM 查询完整自然月,YYYY 查询完整自然年,last30days / last12months 查询滚动周期。没有默认上架天数限制;省略 rangeFilters.streetDays 时保留全部活跃候选,不保证都是新品。按用户目标显式设置上架天数区间。每返回 5 个代表 ASIN 收 5 Credits。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
reportPeriod | string | 是 | 必填统计期:YYYY-MM(如 2026-08)表示完整自然月;YYYY(如 2025)表示完整自然年;last30days / last12months 表示近 30 天 / 近 12 个月。按 country 的站点时区展开,不接受日级日期、日期范围或 cycleFilter。自然年固定展开为 1 月 1 日至 12 月 31 日,不自动截断当前年。 |
categoryId | string | 是 | 用户已确认的类目 ID。 |
country | string | 是 | 用户明确选择的亚马逊站点,如 US/UK/DE;不能默认站点。 |
filters | object | 否 | 品牌或相关度筛选。 |
filters.brands | string[] | 否 | 待查询的品牌列表。 |
orders | object[] | 否 | 排序字段及方向。 |
orders[].direction | "asc" | "desc" | 是 | 排序方向:升序或降序。 |
orders[].field | "sales" | "revenue" | "price" | "ratings" | "stars" | "salesMom" | "salesYoy" | "trafficScore" | "organicTrafficScoreRatio" | "height" | "length" | "width" | "weight" | 是 | 排序字段。 |
page | integer | 否 | 页码。 默认值:1。 |
pageSize | integer | 否 | 每页数量。 默认值:20。 |
query | string | 否 | 新版列表搜索词,省略时不筛选。 |
rangeFilters | object | 否 | 同字段多个区间按 OR(并集),不同字段按 AND;每个区间至少一个边界且 min≤max,省略的边界不设限。一个连续区间的上下限应写在同一项,如 [{"min":10,"max":20}];[{"min":10},{"max":20}] 表示两个区间的并集。边界是否包含见各字段说明。上架天数使用 streetDays,无旧 streetSince 默认筛选。 |
rangeFilters.height | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.height[].max | integer | 否 | 区间上限。 |
rangeFilters.height[].min | integer | 否 | 区间下限。 |
rangeFilters.length | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.length[].max | integer | 否 | 区间上限。 |
rangeFilters.length[].min | integer | 否 | 区间下限。 |
rangeFilters.organicTrafficScoreRatio | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.organicTrafficScoreRatio[].max | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.organicTrafficScoreRatio[].min | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.price | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.price[].max | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.price[].min | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.ratings | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.ratings[].max | integer | 否 | 区间上限。 |
rangeFilters.ratings[].min | integer | 否 | 区间下限。 |
rangeFilters.revenue | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.revenue[].max | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.revenue[].min | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.sales | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.sales[].max | integer | 否 | 区间上限。 |
rangeFilters.sales[].min | integer | 否 | 区间下限。 |
rangeFilters.salesMom | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.salesMom[].max | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.salesMom[].min | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.salesYoy | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.salesYoy[].max | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.salesYoy[].min | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.stars | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.stars[].max | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.stars[].min | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.streetDays | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。新品榜没有默认上架天数限制;省略此字段时保留全部活跃候选,不保证为新品。按用户目标显式指定上架天数区间。 |
rangeFilters.streetDays[].max | integer | 否 | 区间上限。 |
rangeFilters.streetDays[].min | integer | 否 | 区间下限。 |
rangeFilters.trafficScore | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.trafficScore[].max | integer | 否 | 区间上限。 |
rangeFilters.trafficScore[].min | integer | 否 | 区间下限。 |
rangeFilters.weight | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.weight[].max | integer | 否 | 区间上限。 |
rangeFilters.weight[].min | integer | 否 | 区间下限。 |
rangeFilters.width | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.width[].max | integer | 否 | 区间上限。 |
rangeFilters.width[].min | integer | 否 | 区间下限。 |
resourceId | string | 是 | 生成工具返回的可用资源 ID;同任务复用。 |
按上架天数筛选的商品榜单;需显式设置上架天数区间,省略时不保证都是新品。
每返回 5 个代表 ASIN 消耗 5 Credits,不足 5 个向上取整
返回 12 个代表 ASIN,消耗 15 Credits
类目新品榜
按上架天数筛选商品,查看其销量、销售额、价格与评分表现,寻找值得关注的新品。
类目飙升榜
获取类目飙升榜,reportPeriod 必填:YYYY-MM 查询完整自然月,YYYY 查询完整自然年,last30days / last12months 查询滚动周期,使用新版增长、筛选和排序规则。每返回 5 个代表 ASIN 收 5 Credits。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
reportPeriod | string | 是 | 必填统计期:YYYY-MM(如 2026-08)表示完整自然月;YYYY(如 2025)表示完整自然年;last30days / last12months 表示近 30 天 / 近 12 个月。按 country 的站点时区展开,不接受日级日期、日期范围或 cycleFilter。自然年固定展开为 1 月 1 日至 12 月 31 日,不自动截断当前年。 |
categoryId | string | 是 | 用户已确认的类目 ID。 |
country | string | 是 | 用户明确选择的亚马逊站点,如 US/UK/DE;不能默认站点。 |
filters | object | 否 | 品牌或相关度筛选。 |
filters.brands | string[] | 否 | 待查询的品牌列表。 |
orders | object[] | 否 | 排序字段及方向。 |
orders[].direction | "asc" | "desc" | 是 | 排序方向:升序或降序。 |
orders[].field | "sales" | "revenue" | "price" | "ratings" | "stars" | "salesMom" | "salesYoy" | "trafficScore" | "organicTrafficScoreRatio" | "height" | "length" | "width" | "weight" | 是 | 排序字段。 |
page | integer | 否 | 页码。 默认值:1。 |
pageSize | integer | 否 | 每页数量。 默认值:20。 |
query | string | 否 | 新版列表搜索词,省略时不筛选。 |
rangeFilters | object | 否 | 同字段多个区间按 OR(并集),不同字段按 AND;每个区间至少一个边界且 min≤max,省略的边界不设限。一个连续区间的上下限应写在同一项,如 [{"min":10,"max":20}];[{"min":10},{"max":20}] 表示两个区间的并集。边界是否包含见各字段说明。上架天数使用 streetDays,无旧 streetSince 默认筛选。 |
rangeFilters.height | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.height[].max | integer | 否 | 区间上限。 |
rangeFilters.height[].min | integer | 否 | 区间下限。 |
rangeFilters.length | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.length[].max | integer | 否 | 区间上限。 |
rangeFilters.length[].min | integer | 否 | 区间下限。 |
rangeFilters.organicTrafficScoreRatio | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.organicTrafficScoreRatio[].max | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.organicTrafficScoreRatio[].min | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.price | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.price[].max | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.price[].min | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.ratings | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.ratings[].max | integer | 否 | 区间上限。 |
rangeFilters.ratings[].min | integer | 否 | 区间下限。 |
rangeFilters.revenue | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.revenue[].max | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.revenue[].min | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.sales | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.sales[].max | integer | 否 | 区间上限。 |
rangeFilters.sales[].min | integer | 否 | 区间下限。 |
rangeFilters.salesMom | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.salesMom[].max | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.salesMom[].min | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.salesYoy | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.salesYoy[].max | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.salesYoy[].min | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.stars | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.stars[].max | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.stars[].min | string | 否 | 有限十进制数值字符串,例如 12.50;可只传 min 或 max。 |
rangeFilters.streetDays | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.streetDays[].max | integer | 否 | 区间上限。 |
rangeFilters.streetDays[].min | integer | 否 | 区间下限。 |
rangeFilters.trafficScore | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.trafficScore[].max | integer | 否 | 区间上限。 |
rangeFilters.trafficScore[].min | integer | 否 | 区间下限。 |
rangeFilters.weight | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.weight[].max | integer | 否 | 区间上限。 |
rangeFilters.weight[].min | integer | 否 | 区间下限。 |
rangeFilters.width | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.width[].max | integer | 否 | 区间上限。 |
rangeFilters.width[].min | integer | 否 | 区间下限。 |
resourceId | string | 是 | 生成工具返回的可用资源 ID;同任务复用。 |
采用新版增长、筛选和排序规则的代表 ASIN 榜单。
每返回 5 个代表 ASIN 消耗 5 Credits,不足 5 个向上取整
返回 12 个代表 ASIN,消耗 15 Credits
类目飙升榜
提供代表 ASIN 飙升榜,结合销量增长、价格与评分表现,发现增长较快的商品和潜力竞品。
类目关键词分析
获取所选自然月、所选相关度的类目关键词分析,完整返回该月 summary、distribution 及全部历史趋势。省略 cycleFilter 或 startDate 时读取站点关键词最新可用月份,显式月份不能晚于该月份;仅支持 monthly,不支持年度、日度或滚动周期。必须指定 correlationType。每次固定 5 Credits,附带趋势不额外收费。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
categoryId | string | 是 | 用户已确认的类目 ID。 |
correlationType | "high" | "medium" | "low" | 是 | 关键词相关度。 |
country | string | 是 | 用户明确选择的亚马逊站点,如 US/UK/DE;不能默认站点。 |
cycleFilter | object | 否 | 仅统计一个自然月。cycleFilter 或 startDate 省略时,读取本站点关键词最新可用月份;显式月份不能晚于该月份。cycle 省略时补为 monthly;endDate 可选,但须显式给出同月 startDate,不按日截取;不支持 period。附带趋势仍返回完整历史。日期为站点当地 YYYY-MM-DD。 |
cycleFilter.cycle | "monthly" | 否 | 统计周期。 |
cycleFilter.endDate | string | 否 | 结束日期 YYYY-MM-DD |
cycleFilter.startDate | string | 否 | 开始日期 YYYY-MM-DD |
resourceId | string | 是 | 生成工具返回的可用资源 ID;同任务复用。 |
所选自然月与相关度的分析汇总、分布及完整历史趋势。
每次调用消耗 5 Credits,附带趋势不额外计费
查询 1 次关键词分析,消耗 5 Credits
类目关键词分析
提供所选月份和相关度的关键词分析汇总、指标分布与历史趋势,评估类目搜索需求和关键词竞争情况。
类目关键词列表
获取所选自然月的类目关键词列表。省略 cycleFilter 或 startDate 时读取站点关键词最新可用月份,显式月份不能晚于该月份;仅支持 monthly,不支持年度、日度或滚动周期。支持新版相关度、品牌、区间、搜索和分页。默认附带完整历史趋势,includeTrend=false 可关闭列表趋势。每返回 20 个关键词收 1 Credit。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
categoryId | string | 是 | 用户已确认的类目 ID。 |
country | string | 是 | 用户明确选择的亚马逊站点,如 US/UK/DE;不能默认站点。 |
cycleFilter | object | 否 | 仅统计一个自然月。cycleFilter 或 startDate 省略时,读取本站点关键词最新可用月份;显式月份不能晚于该月份。cycle 省略时补为 monthly;endDate 可选,但须显式给出同月 startDate,不按日截取;不支持 period。附带趋势仍返回完整历史。日期为站点当地 YYYY-MM-DD。 |
cycleFilter.cycle | "monthly" | 否 | 统计周期。 |
cycleFilter.endDate | string | 否 | 结束日期 YYYY-MM-DD |
cycleFilter.startDate | string | 否 | 开始日期 YYYY-MM-DD |
filters | object | 否 | 品牌或相关度筛选。 |
filters.brands | string[] | 否 | 待查询的品牌列表。 |
filters.correlationTypes | "high" | "medium" | "low"[] | 否 | 关键词相关度筛选。 |
includeTrend | boolean | 否 | 是否附带完整历史趋势。 默认值:True。 |
page | integer | 否 | 页码。 默认值:1。 |
pageSize | integer | 否 | 每页数量。 默认值:20。 |
query | string | 否 | 新版列表搜索词,省略时不筛选。 |
rangeFilters | object | 否 | 同字段多个区间按 OR(并集),不同字段按 AND;每个区间至少一个边界且 min≤max,省略的边界不设限。一个连续区间的上下限应写在同一项,如 [{"min":10,"max":20}];[{"min":10},{"max":20}] 表示两个区间的并集。边界是否包含见各字段说明。所有关键词范围边界均须为非负数(≥0)。 |
rangeFilters.adjustedClickConversionRate | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.adjustedClickConversionRate[].max | string | 否 | 非负的有限十进制数值字符串(≥0),例如 0 或 12.50;可只传 min 或 max。 |
rangeFilters.adjustedClickConversionRate[].min | string | 否 | 非负的有限十进制数值字符串(≥0),例如 0 或 12.50;可只传 min 或 max。 |
rangeFilters.cpc | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.cpc[].max | string | 否 | 非负的有限十进制数值字符串(≥0),例如 0 或 12.50;可只传 min 或 max。 |
rangeFilters.cpc[].min | string | 否 | 非负的有限十进制数值字符串(≥0),例如 0 或 12.50;可只传 min 或 max。 |
rangeFilters.organicRotationRate | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.organicRotationRate[].max | string | 否 | 非负的有限十进制数值字符串(≥0),例如 0 或 12.50;可只传 min 或 max。 |
rangeFilters.organicRotationRate[].min | string | 否 | 非负的有限十进制数值字符串(≥0),例如 0 或 12.50;可只传 min 或 max。 |
rangeFilters.searchFrequencyRank | object[] | 否 | 双闭区间 [min,max],包含 min 和 max。 |
rangeFilters.searchFrequencyRank[].max | integer | 否 | 区间上限。 |
rangeFilters.searchFrequencyRank[].min | integer | 否 | 区间下限。 |
rangeFilters.searchTermCompetitiveDifficulty | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.searchTermCompetitiveDifficulty[].max | integer | 否 | 区间上限。 |
rangeFilters.searchTermCompetitiveDifficulty[].min | integer | 否 | 区间下限。 |
rangeFilters.searchVolume | object[] | 否 | 左闭右开 [min,max),包含 min,不包含 max。 |
rangeFilters.searchVolume[].max | integer | 否 | 区间上限。 |
rangeFilters.searchVolume[].min | integer | 否 | 区间下限。 |
resourceId | string | 是 | 生成工具返回的可用资源 ID;同任务复用。 |
支持相关度、品牌、区间和搜索筛选的关键词列表,默认附带完整历史趋势,可关闭趋势。
每返回 20 个关键词消耗 1 Credit,不足 20 个向上取整
返回 45 个关键词,消耗 3 Credits
类目关键词列表
提供类目关键词及搜索量、ABA 排名、CPC、转化率、竞争难度等指标与历史趋势,为 Listing 布局和广告选词提供依据。
类目市场规模趋势
获取类目全部价格带的完整历史月度销售趋势及已有近 30 天汇总,不接受起止月份筛选。每 6 个月收 5 Credits,近 30 天不额外计费。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
categoryId | string | 是 | 用户已确认的类目 ID。 |
country | string | 是 | 用户明确选择的亚马逊站点,如 US/UK/DE;不能默认站点。 |
resourceId | string | 是 | 生成工具返回的可用资源 ID;同任务复用。 |
全部价格带的完整历史月度销售趋势及已有近 30 天汇总,不接受起止月份筛选。
每 6 个月历史趋势消耗 5 Credits,不足 6 个月向上取整;近 30 天不额外计费
返回 24 个月历史趋势及近 30 天汇总,消耗 20 Credits
类目市场规模趋势
提供类目完整历史月度销售趋势及近 30 天汇总,观察市场规模、需求变化与增长空间。
类目季节性分析
分析类目的季节性需求,结合旺淡季销售对比与预测,为经营节奏提供参考。每次成功调用固定 5 Credits。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
categoryId | string | 是 | 用户已确认的类目 ID。 |
country | string | 是 | 用户明确选择的亚马逊站点,如 US/UK/DE;不能默认站点。 |
resourceId | string | 是 | 生成工具返回的可用资源 ID;同任务复用。 |
类目季节性、旺淡季销售对比及需求预测。
每次成功调用消耗 5 Credits
成功查询 1 次,消耗 5 Credits
类目季节性分析
提供类目旺淡季划分、销售对比与需求预测,为上新、备货和推广节奏提供参考。
类目新品机会分析
获取新版完整新品机会分析,包含 summary、list、完整 trends 和 periods。每 6 个月趋势收 5 Credits,附带列表和周期不另外收费。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
categoryId | string | 是 | 用户已确认的类目 ID。 |
country | string | 是 | 用户明确选择的亚马逊站点,如 US/UK/DE;不能默认站点。 |
cycleFilter | object | 是 | monthly 必须给 startDate,endDate 可省略且如有须在同月;或 period=last30days,cycle 省略或 daily,不带日期。 |
cycleFilter.cycle | "monthly" | "daily" | 否 | 统计周期。 |
cycleFilter.endDate | string | 否 | 结束日期 YYYY-MM-DD |
cycleFilter.period | "last30days" | 否 | 滚动周期。 |
cycleFilter.startDate | string | 否 | 开始日期 YYYY-MM-DD |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | 否 | 全部、低、中、高价格带。 默认值:allPrice。 |
resourceId | string | 是 | 生成工具返回的可用资源 ID;同任务复用。 |
新品机会汇总、列表、完整趋势和周期数据。
每 6 个月趋势消耗 5 Credits,不足 6 个月向上取整;附带列表和周期不额外计费
返回 24 个月趋势,消耗 20 Credits
类目新品机会分析
提供新品机会分析汇总、商品列表与历史趋势,观察新品市场表现,评估进入机会。
类目价格带分析
一次获取低、中、高三个价格带的完整分析及趋势,包括所选周期价格范围、品牌、代表 ASIN、评分及细分价格区间。历史趋势没有逐月价格边界。三个价格带合计每 6 个不同月份收 5 Credits。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
categoryId | string | 是 | 用户已确认的类目 ID。 |
country | string | 是 | 用户明确选择的亚马逊站点,如 US/UK/DE;不能默认站点。 |
cycleFilter | object | 是 | 仅支持同一自然月(cycle=monthly,startDate/endDate 均必填)或 period=last30days 不带日期。 |
cycleFilter.cycle | "monthly" | "daily" | 否 | 统计周期。 |
cycleFilter.endDate | string | 否 | 结束日期 YYYY-MM-DD |
cycleFilter.period | "last30days" | 否 | 滚动周期。 |
cycleFilter.startDate | string | 否 | 开始日期 YYYY-MM-DD |
resourceId | string | 是 | 生成工具返回的可用资源 ID;同任务复用。 |
低、中、高三个价格带的完整分析及趋势,包含所选周期价格范围、品牌、代表 ASIN、评分和细分价格区间。
三个价格带合计每 6 个不同月份消耗 5 Credits,不足 6 个月向上取整
三个价格带覆盖 24 个不同月份,合计消耗 20 Credits
类目价格带分析
提供低、中、高价格带的价格范围、品牌、代表 ASIN、评分与历史趋势,对比各价格带的市场表现和竞争情况。
代表 ASIN 子体列表
查询单个代表 ASIN 下的子 ASIN 列表及完整销售趋势,支持按周期、价格带和分页查看。每返回 20 个子 ASIN 消耗 5 Credits。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
categoryId | string | 是 | 用户已确认的类目 ID。 |
country | string | 是 | 用户明确选择的亚马逊站点,如 US/UK/DE;不能默认站点。 |
cycleFilter | object | 是 | 月/年榜:cycle=monthly/yearly 且 startDate/endDate 在同一自然月/年;或仅 period=last30days/last12months。日期为站点当地 YYYY-MM-DD。 |
cycleFilter.cycle | "monthly" | "yearly" | "daily" | 否 | 统计周期。 |
cycleFilter.endDate | string | 否 | 结束日期 YYYY-MM-DD |
cycleFilter.period | "last30days" | "last12months" | 否 | 滚动周期。 |
cycleFilter.startDate | string | 否 | 开始日期 YYYY-MM-DD |
page | integer | 否 | 页码。 默认值:1。 |
pageSize | integer | 否 | 每页数量。 默认值:20。 |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | 否 | 全部、低、中、高价格带。 默认值:allPrice。 |
primaryAsin | string | 是 | 单个代表 ASIN,不支持数组或一次查询多个主体。 |
resourceId | string | 是 | 生成工具返回的可用资源 ID;同任务复用。 |
单个代表 ASIN 下的子 ASIN 列表及完整销售趋势。
每返回 20 个子 ASIN 消耗 5 Credits,不足 20 个向上取整
返回 45 个子 ASIN,消耗 15 Credits
代表 ASIN 子体列表
提供单个代表 ASIN 下的子 ASIN 列表与完整销售趋势,支持按周期和价格带查看,分析各子体的市场表现。
类目代表 ASIN 列表
获取类目或指定价格带内的代表 ASIN 列表及完整趋势,支持新版榜单类型、排序和分页。近 12 个月(period=last12months)仅支持全部价格带,priceType 必须省略或传 allPrice。每返回 5 个代表 ASIN 收 5 Credits。指定 rankingType 时排序按该榜单规则。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
categoryId | string | 是 | 用户已确认的类目 ID。 |
country | string | 是 | 用户明确选择的亚马逊站点,如 US/UK/DE;不能默认站点。 |
cycleFilter | object | 是 | 月/年榜:cycle=monthly/yearly 且 startDate/endDate 在同一自然月/年;或仅 period=last30days/last12months。日期为站点当地 YYYY-MM-DD。 period=last12months 时仅支持全部价格带:priceType 省略或 allPrice。 查询近 30 天建议仅传 period=last30days,禁止同时传 cycle=yearly。 |
cycleFilter.cycle | "monthly" | "yearly" | "daily" | 否 | 统计周期。 |
cycleFilter.endDate | string | 否 | 结束日期 YYYY-MM-DD |
cycleFilter.period | "last30days" | "last12months" | 否 | 滚动周期。 |
cycleFilter.startDate | string | 否 | 开始日期 YYYY-MM-DD |
orders | object[] | 否 | 排序字段及方向。 |
orders[].direction | "asc" | "desc" | 是 | 排序方向:升序或降序。 |
orders[].field | "sales" | "salesRevenue" | "salesRatio" | "price" | "stars" | "streetDate" | 是 | 排序字段。 |
page | integer | 否 | 页码。 默认值:1。 |
pageSize | integer | 否 | 每页数量。 默认值:20。 |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | 否 | period=last12months 时只能省略或传 allPrice,不支持 lowPrice/midPrice/highPrice。 默认值:allPrice。 |
rankingType | "sales" | "salesRevenue" | "surge" | "newRelease" | 否 | 榜单类型。 |
resourceId | string | 是 | 生成工具返回的可用资源 ID;同任务复用。 |
类目或指定价格带内的代表 ASIN 列表及完整趋势;近 12 个月仅支持全部价格带。
每返回 5 个代表 ASIN 消耗 5 Credits,不足 5 个向上取整
返回 12 个代表 ASIN,消耗 15 Credits
类目代表 ASIN 列表
提供类目或指定价格带的代表 ASIN 列表与完整销售趋势,筛选目标商品并跟踪竞品表现。
类目品牌市场规模
获取类目品牌市场规模列表及完整趋势,支持月度或近 30 天、价格带、榜单类型、排序和分页。只传 startDate 时按月度查询;period=last30days 时 cycle 只能省略或 daily。每返回 5 个品牌收 5 Credits。rankingType=newRelease 在此接口等同于销量降序,不筛选新品品牌。指定 rankingType 时排序按该榜单规则。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
categoryId | string | 是 | 用户已确认的类目 ID。 |
country | string | 是 | 用户明确选择的亚马逊站点,如 US/UK/DE;不能默认站点。 |
cycleFilter | object | 是 | 仅支持月度或近 30 天:startDate 必填,cycle 省略时补为 monthly,endDate 可选且须同月;或 period=last30days 不带日期,此时 cycle 只能省略或 daily,不能混传 monthly。日期为站点当地 YYYY-MM-DD。 |
cycleFilter.cycle | "monthly" | "daily" | 否 | 统计周期。 |
cycleFilter.endDate | string | 否 | 结束日期 YYYY-MM-DD |
cycleFilter.period | "last30days" | 否 | 滚动周期。 |
cycleFilter.startDate | string | 否 | 开始日期 YYYY-MM-DD |
orders | object[] | 否 | 未设置 rankingType 时最多传一个排序;设置 rankingType 时下游忽略 orders。 |
orders[].direction | "asc" | "desc" | 是 | 排序方向:升序或降序。 |
orders[].field | "sales" | "salesRevenue" | "salesRatio" | "price" | "stars" | 是 | 排序字段。 |
page | integer | 否 | 页码。 默认值:1。 |
pageSize | integer | 否 | 每页数量。 默认值:20。 |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | 否 | 全部、低、中、高价格带。 默认值:allPrice。 |
rankingType | "sales" | "salesRevenue" | "surge" | "newRelease" | 否 | newRelease 在此品牌接口中等同于销量降序,不筛选新品品牌;指定 rankingType 时忽略 orders。 |
resourceId | string | 是 | 生成工具返回的可用资源 ID;同任务复用。 |
月度或近 30 天的品牌市场规模列表及完整趋势,支持价格带、榜单类型、排序和分页。
每返回 5 个品牌消耗 5 Credits,不足 5 个向上取整
返回 12 个品牌,消耗 15 Credits
类目品牌市场规模
提供月度或近 30 天的品牌市场规模列表与历史趋势,比较各价格带的品牌表现和竞争格局。
类目品牌销售趋势
获取请求 brands 的完整历史月度销售趋势及已有近 30 天汇总,不接受起止月份筛选。费用为 ceil((最大历史月份数+1)/6) × 请求品牌数 × 2 Credits,近 30 天折算 1 个月。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
brands | string[] | 是 | 待查询的品牌列表。 |
categoryId | string | 是 | 用户已确认的类目 ID。 |
country | string | 是 | 用户明确选择的亚马逊站点,如 US/UK/DE;不能默认站点。 |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | 否 | 全部、低、中、高价格带。 默认值:allPrice。 |
resourceId | string | 是 | 生成工具返回的可用资源 ID;同任务复用。 |
请求品牌的完整历史月度销售趋势及已有近 30 天汇总,不接受起止月份筛选。
(最大历史月份数 + 1)÷ 6 向上取整 × 请求品牌数 × 2 Credits;近 30 天折算 1 个月
最大历史 24 个月,请求 2 个品牌,消耗 20 Credits
类目品牌销售趋势
提供指定品牌的完整历史月度销售趋势及近 30 天汇总,对比品牌增长变化与竞争态势。
类目评分与评价数量分析
获取月度或近 30 天的合并星级和评价数量分析,完整返回 distribution、ratingsTrends 和 starsTrends。每次成功调用总计 5 Credits。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
categoryId | string | 是 | 用户已确认的类目 ID。 |
country | string | 是 | 用户明确选择的亚马逊站点,如 US/UK/DE;不能默认站点。 |
cycleFilter | object | 是 | 仅支持同一自然月(startDate/endDate 均必填,cycle 省略时补为 monthly)或 period=last30days 不带日期;daily 仅用于 last30days。 |
cycleFilter.cycle | "monthly" | "daily" | 否 | 统计周期。 |
cycleFilter.endDate | string | 否 | 结束日期 YYYY-MM-DD |
cycleFilter.period | "last30days" | 否 | 滚动周期。 |
cycleFilter.startDate | string | 否 | 开始日期 YYYY-MM-DD |
priceType | "allPrice" | "lowPrice" | "midPrice" | "highPrice" | 否 | 全部、低、中、高价格带。 默认值:allPrice。 |
resourceId | string | 是 | 生成工具返回的可用资源 ID;同任务复用。 |
月度或近 30 天的星级、评价数量合并分析,包含分布及两类完整趋势。
每次成功调用合计消耗 5 Credits
成功查询 1 次合并分析,消耗 5 Credits
类目评分与评价数量分析
提供星级和评价数量分布及各自的历史趋势,分析类目的口碑结构与评价积累门槛。