类目洞察
了解类目需求、关键词集中度、商品分布与竞争变化。
get_category_sales_ranking
类目销量榜
工具描述
获取类目销量榜,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
get_category_market_size_trends
类目市场规模趋势
工具描述
获取类目全部价格带的完整历史月度销售趋势及已有近 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
get_category_new_release_opportunity_trends
类目新品机会分析
工具描述
获取新版完整新品机会分析,包含 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
get_category_price_segment_trends
类目价格带分析
工具描述
一次获取低、中、高三个价格带的完整分析及趋势,包括所选周期价格范围、品牌、代表 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