获取类目评分分布

POST

/v1/marketInsights/category/stars/distribution

计费规则
本接口按次数计费。每处理 1 个类目计为 5 Credits 消耗。
○ 公式：Credit 消耗 = 5
○ 示例：请求获取 1 个类目的评分分布，将消耗 5 Credits。

用于查询指定类目在给定月份的商品评分分布，返回各评分区间的 ASIN 数量、销量及其占比。

使用说明：
○ resourceId、country、categoryId 为必填参数。
○ month 为可选参数，使用 YYYY-MM 格式；未传或为空时，默认返回近 30 天数据。

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

请求参数

Header 参数

Body 参数application/json必填

示例

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "country": "US",
    "categoryId": "us_202605_87_akde91",
    "categoryName": {
        "original": "Political leanings/adult products",
        "translated": "政治倾向/成人用品"
    },
    "distribution": [
        {
            "stars": "4.5",
            "asinCount": {
                "value": 1250,
                "ratio": "0.4517"
            },
            "sales": {
                "value": 12800,
                "ratio": "0.4517"
            }
        }
    ]
}

修改于 2026-07-28 09:29:13

评分分析

获取类目评分数分布