xiyou-openapi
  1. searchTerms
xiyou-openapi
  • 西柚找词OPENAPI接入指引
  • asins
    • asin流量得分
      POST
    • asin基础信息变动趋势(天)
      POST
    • asin流量得分趋势(天)
      POST
    • asin广告信息变动趋势(天)
      POST
    • asin BSR排名趋势(天)
      POST
    • asin订单量趋势(月)
      POST
    • asin商品信息趋势图(天)
      POST
    • asin反查关键词列表(最近天)
      POST
    • asin反查关键词列表(月)
      POST
    • asin商品信息
      POST
  • asinSearchTerms
    • asin词流量趋势(天)
      POST
    • asin词排名趋势(天)
      POST
  • searchTerms
    • 关键词ABA数据趋势(周)
      POST
    • 关键词信息(最近一周)
      POST
  1. searchTerms

关键词ABA数据趋势(周)

测试中
POST
/v1/searchTerms/abaReport/trends/weekly
计费规则
本接口按 关键词数量 × 周数 计费。每处理 100 个关键词 × 1 周(向上取整)计为 1 Credit 消耗
○ 公式:Credit 消耗 = ⌈(关键词数量 ÷ 100) × 周数⌉
○ 示例:请求包含 250 个关键词,查询 4 周数据,将消耗 [(250 ÷ 100) × 4] = 10 Credits
请求限制
○ 单次请求最多支持 100 个关键词
○ 查询周期最长为 52 周

请求参数

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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://openapi.xiyouzhaoci.com/v1/searchTerms/abaReport/trends/weekly' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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
Body

示例
{
    "entities": [
        {
            "country": "US",
            "searchTerm": "sony",
            "trends": [
                {
                    "reportFromDate": "2025-07-06",
                    "reportToDate": "2025-07-12",
                    "searchFrequencyRank": 6743,
                    "weeklySearchVolume": 20187,
                    "topAsins": [
                        {
                            "asin": "B0863TXGM3",
                            "clickShare": "0.1763",
                            "conversionShare": "0.1135"
                        },
                        {
                            "asin": "B09XS7JWHH",
                            "clickShare": "0.0811",
                            "conversionShare": "0.058"
                        },
                        {
                            "asin": "B0BS1QCFHX",
                            "clickShare": "0.0771",
                            "conversionShare": "0.1135"
                        }
                    ]
                },
                {
                    "reportFromDate": "2025-07-13",
                    "reportToDate": "2025-07-19",
                    "searchFrequencyRank": 20798,
                    "weeklySearchVolume": 8598,
                    "topAsins": [
                        {
                            "asin": "B0863TXGM3",
                            "clickShare": "0.136",
                            "conversionShare": "0.119"
                        },
                        {
                            "asin": "B0BS1QCFHX",
                            "clickShare": "0.0825",
                            "conversionShare": "0.0952"
                        },
                        {
                            "asin": "B0BS1PRC4L",
                            "clickShare": "0.0633",
                            "conversionShare": "0.0714"
                        }
                    ]
                }
            ]
        }
    ]
}
修改于 2025-08-20 10:30:42
上一页
asin词排名趋势(天)
下一页
关键词信息(最近一周)
Built with