批量获取品牌销量趋势

计费规则
本接口按品牌数量和计费月数计费。每个品牌每处理 6 个计费月（向上取整）计为 2 Credits 消耗；请求的 last30days 按额外 1 个计费月计算。
○ 计费月数 = startMonth 至 endMonth 的自然月数 + periods 中的周期数（当前 last30days 计 1 个月）
○ 公式：Credit 消耗 = 品牌数量 × ⌈计费月数 ÷ 6⌉ × 2
○ 示例：请求包含 5 个品牌，查询 12 个自然月并请求 last30days，计费月数为 13，将消耗 5 × ⌈13 ÷ 6⌉ × 2 = 30 Credits。

用于批量查询指定类目下多个品牌的月度销量与销售额趋势。

使用说明：
○ resourceId、country、categoryId、brands、startMonth 与 periods 为必填参数。
○ startMonth、endMonth 使用 YYYY-MM 格式，并复用 MonthDate 数据模型。
○ endMonth 为可选参数；不传或为空时默认查询至最新可用月份的数据。
○ periods 字段必传，但允许传空数组；元素使用 TrendPeriod 枚举，当前仅支持 last30days（近30天）。传 [] 时不返回周期数据且不增加周期计费；传 ["last30days"] 时返回近30天数据并按额外 1 个计费月计算。

可用日期： 调用 GET /v1/foundation/marketInsights/availableDates?country={country}，传入与当前请求相同的国家；从 MarketInsightsAsinInfo 的 monthly 记录获取可查询月份范围。需要近30天数据时传入 periods: ["last30days"]，不需要时传入 periods: []。

{ "resourceId": "3cdd069d0jj1f754", "country": "US", "categoryId": "us_202605_87_akde91", "brands": [ "Acme" ], "startMonth": "2025-01", "endMonth": "2025-06", "periods": [ "last30days" ] }

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "entities": [
        {
            "brand": "string",
            "trends": [
                {
                    "date": "2025-06",
                    "sales": {
                        "value": 12800,
                        "mom": {
                            "previous": 11950,
                            "amount": 850,
                            "rate": "string"
                        },
                        "yoy": {
                            "previous": 11950,
                            "amount": 850,
                            "rate": "string"
                        }
                    },
                    "salesRevenue": {
                        "value": "string",
                        "mom": {
                            "previous": "string",
                            "amount": "string",
                            "rate": "string"
                        },
                        "yoy": {
                            "previous": "string",
                            "amount": "string",
                            "rate": "string"
                        }
                    }
                }
            ],
            "periods": [
                {
                    "period": "last24hours",
                    "sales": {
                        "value": 12800,
                        "mom": {
                            "previous": 11950,
                            "amount": 850,
                            "rate": "string"
                        },
                        "yoy": {
                            "previous": 11950,
                            "amount": 850,
                            "rate": "string"
                        }
                    },
                    "salesRevenue": {
                        "value": "string",
                        "mom": {
                            "previous": "string",
                            "amount": "string",
                            "rate": "string"
                        },
                        "yoy": {
                            "previous": "string",
                            "amount": "string",
                            "rate": "string"
                        }
                    }
                }
            ]
        }
    ]
}

批量获取品牌销量趋势

请求参数

请求示例代码

返回响应