获取类目月度新秀榜

计费规则
本接口按返回的 ASIN 数量计费，计费方式由 aggregationType 决定。
○ aggregationType=child：每返回 20 个子 ASIN（向上取整）计为 5 Credits 消耗
○ 公式：Credit 消耗 = ⌈返回的子 ASIN 数量 ÷ 20⌉ × 5
○ 示例：返回 50 个子 ASIN，消耗 15 Credits
○ aggregationType=parent：每返回 5 个父 ASIN（向上取整）计为 5 Credits 消耗
○ 公式：Credit 消耗 = ⌈返回的父 ASIN 数量 ÷ 5⌉ × 5
○ 示例：返回 12 个父 ASIN，消耗 15 Credits

用于查询指定类目的月度新秀榜，支持子 ASIN/父体聚合、分页、范围筛选、品牌或 ASIN 搜索及排序。

使用说明：
○ 先调用 /v1/marketInsights/category/resource 生成类目洞察资源，再调用 /v1/marketInsights/category/resource/status，确认资源状态为 success。
○ resourceId、country、categoryId、aggregationType、page、pageSize 为必填字段。
○ 不传 month 或传空字符串时查询最新近 30 天；传入 month 时查询对应自然月，格式必须为 YYYY-MM。
○ aggregationType=child 返回子 ASIN 榜；aggregationType=parent 返回父体聚合榜。
○ query、orders 与 rangeFilters 均为可选；不使用时可省略；orders 最多传入一条排序规则。
○ 新秀榜上架时间范围通过 rangeFilters.streetSince 选择，只支持 within3Months、within6Months、within12Months 三种枚举值。
○ 枚举对应的上架天数分别为：within3Months=0-92 天、within6Months=0-181 天、within12Months=0-365 天；不传时默认 within6Months。
○ rangeFilters 使用按筛选字段命名的对象结构；传入对象时，未使用的数组筛选字段传空数组，streetSince 可省略并使用默认值。
○ 尺寸与重量筛选使用 height、length、width、weight，单位沿用数据源。

可用日期： 调用 GET /v1/foundation/marketInsights/availableDates?country={country}，传入与当前请求相同的国家；从 MarketInsightsAsinInfo 的 monthly 记录获取可查询月份范围。传入 month 查询指定自然月；不传或传空字符串时查询最新近30天。

请求参数

Header 参数

Body 参数application/json必填

示例

{
  "resourceId": "3cdd069d0jj1f754",
  "country": "US",
  "categoryId": "us_202605_87_akde91",
  "aggregationType": "child",
  "page": 1,
  "pageSize": 20,
  "query": "B0XXXXXXXX",
  "orders": [
    {
      "field": "sales",
      "order": "desc"
    }
  ],
  "rangeFilters": {
    "sales": [
      {
        "min": 100,
        "max": 10000
      }
    ],
    "revenue": [],
    "price": [
      {
        "min": "10.00",
        "max": "100.00"
      }
    ],
    "ratings": [],
    "stars": [],
    "salesMom": [],
    "salesYoy": [],
    "trafficScore": [],
    "organicTrafficScoreRatio": [],
    "height": [],
    "length": [],
    "width": [],
    "weight": [],
    "streetSince": "within6Months"
  },
  "month": "2026-06"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功返回类目月度新秀榜。

Bodyapplication/json

示例

{
    "aggregationType": "child",
    "dateRange": {
        "fromDate": "2026-06-01",
        "toDate": "2026-06-30"
    },
    "list": [
        {
            "asinInfo": {
                "asin": "B0XXXXXXXX",
                "brands": [
                    "string"
                ],
                "title": "string",
                "imageUrl": "string",
                "price": {
                    "value": "string",
                    "min": "string",
                    "max": "string"
                },
                "stars": "4.5",
                "ratings": 356,
                "streetDate": "string",
                "streetDays": 420,
                "height": 12,
                "length": 30,
                "width": 20,
                "weight": 850
            },
            "metrics": {
                "sales": {
                    "value": 12800,
                    "mom": {
                        "previous": 0,
                        "amount": 0,
                        "rate": "string"
                    },
                    "yoy": {
                        "previous": 0,
                        "amount": 0,
                        "rate": "string"
                    }
                },
                "salesRevenue": {
                    "value": "string"
                },
                "trafficScore": {
                    "summary": [
                        {
                            "trafficType": "organic",
                            "value": 85,
                            "ratio": "0.7500"
                        }
                    ],
                    "fromDate": "string",
                    "toDate": "string"
                },
                "variation": {
                    "total": 328,
                    "matchedAsins": [
                        {
                            "asin": "string",
                            "sales": 12800,
                            "salesRevenue": "string"
                        }
                    ]
                }
            }
        }
    ],
    "total": 328,
    "page": 1,
    "pageSize": 20,
    "summary": {
        "activeAsinCount": 1250,
        "top10AverageSales": "string",
        "rankedAsinCount": 1250
    }
}