获取类目市场规模趋势

POST

/v1/marketInsights/sales/trends/category

计费规则
本接口按查询时间范围计费。每处理 6 个月（向上取整）计为 5 Credits 消耗
○ 公式：Credit 消耗 = ⌈月数 ÷ 6⌉ × 5
○ 示例：请求包含 1 个类目，查询 24 个月的数据，将消耗 ⌈24 ÷ 6⌉ × 5 = 20 Credits

用于查询指定类目的月度市场规模趋势，包括销量与销售额。

使用说明：
○ resourceId、country、categoryId 与 startMonth 为必填参数；endMonth 为可选参数。
○ startMonth、endMonth 使用 YYYY-MM 格式；endMonth 不传或为空时默认查询至最新可用月份的数据。
○ 本接口仅提供月度趋势数据，不支持也不返回近 30 天数据。

可用日期： 调用 GET /v1/foundation/marketInsights/availableDates?country={country}，传入与当前请求相同的国家；从 MarketInsightsAsinInfo 的 monthly 记录获取可查询月份范围，endMonth 为空时查询至最新可用月份。

请求参数

Header 参数

Body 参数application/json必填

示例

{
  "resourceId": "3cdd069d0jj1f754",
  "country": "US",
  "categoryId": "us_202605_87_akde91",
  "startMonth": "2025-07",
  "endMonth": "2025-07"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://openapi.xydc.com/v1/marketInsights/sales/trends/category' \
--header 'X-Auth-Version: 2.0' \
--header 'X-Api-Key: your_api_key' \
--header 'Content-Type: application/json' \
--data '{
  "resourceId": "3cdd069d0jj1f754",
  "country": "US",
  "categoryId": "us_202605_87_akde91",
  "startMonth": "2025-07",
  "endMonth": "2025-07"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "trends": [
        {
            "date": "2025-06",
            "sales": {
                "value": 12800,
                "mom": {
                    "previous": 0,
                    "amount": 0,
                    "rate": "string"
                },
                "yoy": {
                    "previous": 0,
                    "amount": 0,
                    "rate": "string"
                }
            },
            "salesRevenue": {
                "value": "string",
                "mom": {
                    "previous": "string",
                    "amount": "string",
                    "rate": "string"
                },
                "yoy": {
                    "previous": "string",
                    "amount": "string",
                    "rate": "string"
                }
            }
        }
    ]
}

修改于 2026-07-28 09:28:58

类目销售走势

获取类目季节性分析