获取价格段父 ASIN 列表

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

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

使用说明：
○ 先调用 /v1/marketInsights/category/resource 生成类目洞察资源，再调用资源状态接口确认状态为 success。
○ resourceId、categoryId、country、page、pageSize、priceType、orders 为必填字段；month 为可选字段。
○ 不传 month 时，返回最新近 30 天的数据；传入时返回指定自然月的数据。
○ priceType 支持 highPrice、midPrice、lowPrice。
○ 不指定排序时 orders 传空数组。

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

请求参数

Header 参数

Body 参数application/json必填

示例

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

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

Bodyapplication/json

示例

{
  "list": [
    {
      "asin": "B07QK9C9KT",
      "title": "Hand Warmers, 10 Pair",
      "brands": [
        {
          "value": "HotHands",
          "childCount": 6
        }
      ],
      "imageUrl": "https://m.media-amazon.com/images/I/71example.jpg",
      "price": "29.99",
      "streetDate": "2024-03-15",
      "stars": "4.5",
      "ratings": 356,
      "sales": {
        "value": 12800,
        "mom": {
          "previous": 11950,
          "amount": 850,
          "rate": "0.0711"
        },
        "ratio": "0.0123",
        "priceTypeRatio": "0.0456"
      },
      "salesRevenue": {
        "value": "383872.00",
        "mom": {
          "previous": "358380.50",
          "amount": "25491.50",
          "rate": "0.0711"
        },
        "ratio": "0.0123",
        "priceTypeRatio": "0.0456"
      },
      "childCount": 12
    }
  ],
  "total": 328,
  "page": 1,
  "pageSize": 20,
  "priceRange": {
    "min": "30.00",
    "max": "80.00"
  }
}