获取价格段 ASIN 列表

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

用于获取指定类目在某个价格段内的 ASIN 分页列表，同时返回销量、销售额、类目占比、价格段占比及商品基础信息。

使用说明：
○ 先调用 /v1/marketInsights/category/resource 生成类目洞察资源，再调用 /v1/marketInsights/category/resource/status，确认资源状态为 success。
○ resourceId、categoryId、country、page、pageSize、priceType、orders 为必填字段；month 为可选字段。
○ 不传 month 时，返回最新近 30 天的数据。
○ 传入 month 时，返回指定自然月的数据，格式为 YYYY-MM，例如 2026-06。
○ 不指定排序时 orders 传空数组。仅支持按销量（sales）、销售额（salesRevenue）、销量占比（salesRatio）和上架时间（streetDate）排序。
○ priceType 支持 highPrice、midPrice、lowPrice，价格段边界由类目价格分布分析结果确定。

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

请求参数

Header 参数

Body 参数application/json必填

示例

{
  "resourceId": "3cdd069d0jj1f754",
  "categoryId": "us_202605_87_akde91",
  "country": "US",
  "month": "2026-06",
  "page": 1,
  "pageSize": 20,
  "priceType": "midPrice",
  "orders": [
    {
      "field": "sales",
      "order": "desc"
    }
  ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功返回价格段 ASIN 分页列表。

Bodyapplication/json

示例

{
    "list": [
        {
            "sales": {
                "value": 12800,
                "mom": {
                    "previous": 11950,
                    "amount": 850,
                    "rate": "string"
                },
                "ratio": "0.0123",
                "priceTypeRatio": "0.0456"
            },
            "salesRevenue": {
                "value": "12345.67",
                "mom": {
                    "previous": "86079.95",
                    "amount": "15027.37",
                    "rate": "string"
                },
                "ratio": "0.0123",
                "priceTypeRatio": "0.0456"
            },
            "asin": "B0XXXXXXXX",
            "price": "29.99",
            "imageUrl": "string",
            "streetDate": "string",
            "stars": "4.5",
            "brand": "string",
            "ratings": 356,
            "title": "string"
        }
    ],
    "total": 328,
    "page": 1,
    "pageSize": 20,
    "priceRange": {
        "min": "30.00",
        "max": "80.00"
    }
}