关键词ABA数据趋势（周）

POST

/v1/searchTerms/abaReport/trends/weekly

计费规则
本接口按关键词数量 × 周数计费。每处理 20 个关键词 × 1 周（向上取整）计为 1 Credit 消耗
○ 公式：Credit 消耗 = ⌈(关键词数量 ÷ 20) × 周数⌉
○ 示例：请求包含 250 个关键词，查询 4 周数据，将消耗 [(250 ÷ 20) × 4] = 50 Credits

请求限制
○ 单次请求最多支持 100 个关键词
○ 查询周期最长为 52 周

返回字段说明
○ searchTermCompetitiveDifficulty：关键词竞争难度；数值越大表示竞争越激烈，无数据时返回 null
○ organicRotationRate：自然轮动率，小数形式；无数据时返回 null
○ adjustedClickConversionRate：调整后点击转化率，小数形式保留 4 位；无数据时返回 null
○ cpc：CPC（每次点击成本），包含 value、min、max；无数据时对应字段返回 null

请求参数

Header 参数

Body 参数application/json

示例

{
    "country": "US",
    "searchTerms": [
        "sony"
    ],
    "startWeek": {
        "startDate": "2025-07-06",
        "endDate": "2025-07-12"
    },
    "endWeek": {
        "startDate": "2025-07-13",
        "endDate": "2025-07-19"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://openapi.xydc.com/v1/searchTerms/abaReport/trends/weekly' \
--header 'X-Auth-Version: 2.0' \
--header 'X-Api-Key: your_api_key' \
--header 'Content-Type: application/json' \
--data '{
    "country": "US",
    "searchTerms": [
        "sony"
    ],
    "startWeek": {
        "startDate": "2025-07-06",
        "endDate": "2025-07-12"
    },
    "endWeek": {
        "startDate": "2025-07-13",
        "endDate": "2025-07-19"
    }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

修改于 2026-07-28 09:25:31

asin词排名趋势（小时）

关键词信息（最近一周）