1. asins
xiyou-openapi
  • 西柚洞察OPENAPI-V2接入指引
  • 西柚洞察OPENAPI接入指引（已归档）
  • Release Notes
  • 西柚洞察OPENAPI-V1接入指引（该接入已归档）
  • asins
    • asin流量得分
      POST
    • asin基础信息变动趋势（天）
      POST
    • asin流量得分趋势（天）
      POST
    • asin流量得分趋势（周）
      POST
    • asin流量得分趋势（月）
      POST
    • asin广告信息变动趋势（天）
      POST
    • asin BSR排名趋势（天）
      POST
    • asin订单量趋势（月）
      POST
    • asin商品信息趋势图（天）
      POST
    • asin反查关键词列表（最近天）
      POST
    • asin反查关键词列表（月）
      POST
    • asin商品信息
      POST
    • asin近30天订单量
      POST
    • 获取asin变体接口
      POST
  • asinSearchTerms
    • asin词流量趋势（天）
      POST
    • asin词排名趋势（天）
      POST
    • asin词排名趋势（小时）
      POST
  • searchTerms
    • 关键词分析列表（最近天）
      POST
    • 关键词分析列表（月）
      POST
    • 关键词ABA数据趋势（周）
      POST
    • 关键词信息（最近一周）
      POST
  • client
    • 获取client Id的余额
      POST
  1. asins

asin流量得分趋势（周）

POST
/v1/asins/trafficScore/trend/weekly
计费规则
本接口按“时间范围”计费：每处理 4 周（向上取整）计为 1 Credit 消耗。
○ 公式：Credit 消耗 = ⌈周数 ÷ 4⌉
○ 示例：请求包含 18 周的流量趋势数据，将消耗 ⌈18 ÷ 4⌉ = 5 Credits

请求参数

Body 参数application/json

示例
{
    "asin": "B09XS7JWHH",
    "country": "US",
    "startWeek": {
        "startDate": "2025-05-26",
        "endDate": "2025-06-01"
    },
    "endWeek": {
        "startDate": "2025-06-30",
        "endDate": "2025-07-06"
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://openapi.xydc.com/v1/asins/trafficScore/trend/weekly' \
--header 'Content-Type: application/json' \
--data '{
    "asin": "B09XS7JWHH",
    "country": "US",
    "startWeek": {
        "startDate": "2025-05-26",
        "endDate": "2025-06-01"
    },
    "endWeek": {
        "startDate": "2025-06-30",
        "endDate": "2025-07-06"
    }
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "asin": "B09XS7JWHH",
    "country": "US",
    "trends": [
        {
            "week": {
                "startDate": "2025-05-26",
                "endDate": "2025-06-01"
            },
            "summaryTrafficScore": {
                "organic": 7902,
                "advertising": 3557
            },
            "positionTrafficScore": {
                "or": 7663,
                "sp": 408,
                "ac": 0,
                "er": 0,
                "sb": 2567,
                "sbv": 0,
                "hr": 0,
                "trb": 0,
                "cpf": 0,
                "oor": 234,
                "sor": 578
            }
        },
        {
            "dateRange": {
                "startDate": "2025-06-02",
                "endDate": "2025-06-08"
            },
            "summaryTrafficScore": {
                "organic": 7288,
                "advertising": 2574
            },
            "positionTrafficScore": {
                "or": 7063,
                "sp": 0,
                "ac": 0,
                "er": 0,
                "sb": 2571,
                "sbv": 0,
                "hr": 0,
                "trb": 0,
                "cpf": 0,
                "oor": 219,
                "sor": 0
            }
        },
        {
            "dateRange": {
                "startDate": "2025-06-09",
                "endDate": "2025-06-15"
            },
            "summaryTrafficScore": {
                "organic": 5768,
                "advertising": 2748
            },
            "positionTrafficScore": {
                "or": 5555,
                "sp": 0,
                "ac": 0,
                "er": 0,
                "sb": 2745,
                "sbv": 0,
                "hr": 0,
                "trb": 0,
                "cpf": 0,
                "oor": 207,
                "sor": 0
            }
        },
        {
            "dateRange": {
                "startDate": "2025-06-16",
                "endDate": "2025-06-22"
            },
            "summaryTrafficScore": {
                "organic": 6265,
                "advertising": 1761
            },
            "positionTrafficScore": {
                "or": 6054,
                "sp": 204,
                "ac": 0,
                "er": 0,
                "sb": 1427,
                "sbv": 0,
                "hr": 0,
                "trb": 0,
                "cpf": 0,
                "oor": 203,
                "sor": 127
            }
        },
        {
            "dateRange": {
                "startDate": "2025-06-23",
                "endDate": "2025-06-29"
            },
            "summaryTrafficScore": {
                "organic": 5731,
                "advertising": 1177
            },
            "positionTrafficScore": {
                "or": 5508,
                "sp": 0,
                "ac": 0,
                "er": 0,
                "sb": 1175,
                "sbv": 0,
                "hr": 0,
                "trb": 0,
                "cpf": 0,
                "oor": 216,
                "sor": 0
            }
        },
        {
            "dateRange": {
                "startDate": "2025-06-30",
                "endDate": "2025-07-06"
            },
            "summaryTrafficScore": {
                "organic": 4853,
                "advertising": 5380
            },
            "positionTrafficScore": {
                "or": 4618,
                "sp": 553,
                "ac": 0,
                "er": 0,
                "sb": 4612,
                "sbv": 0,
                "hr": 0,
                "trb": 0,
                "cpf": 0,
                "oor": 229,
                "sor": 210
            }
        }
    ]
}
修改于 2026-07-21 08:45:37
上一页
asin流量得分趋势（天）
下一页
asin流量得分趋势（月）
Built with