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

关键词信息(最近一周)

POST
/v1/searchTerms/info
计费规则
本接口按 关键词数量 计费。每处理 50 个关键词(向上取整)计为 1 Credit 消耗。
○ 公式:Credit 消耗 = (关键词数量 ÷ 50)
○ 示例:请求包含 250 个关键词,将消耗 (250 ÷ 50) = 5 Credits。
请求限制
○ 单次请求最多支持 100 个关键词

请求参数

Header 参数

Body 参数application/json

示例
{
    "country": "US",
    "searchTerms": [
        "usb c cable",
        "usb"
    ],
    "sort": {
        "field": "weeklySearchVolume",
        "order": "desc"
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://openapi.xiyouzhaoci.com/v1/searchTerms/info' \
--header 'X-Client-Id: your16charclientid' \
--header 'X-Timestamp: 1754886692' \
--header 'X-Sign: da79eb2a1d2a5597c7dcc1a0f607c8a2d2f7167be65b01b0e341d8e497a3be49' \
--header 'Content-Type: application/json' \
--data '{
    "country": "US",
    "searchTerms": [
        "usb c cable",
        "usb"
    ],
    "sort": {
        "field": "weeklySearchVolume",
        "order": "desc"
    }
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "list": [
        {
            "searchTerm": "usb c cable",
            "clickConversionRate": "0.494941",
            "competitiveDifficulty": 76,
            "organicRotation": "2.200000",
            "abaReport": {
                "reportFromDate": "2026-05-10",
                "reportToDate": "2026-05-16",
                "searchFrequencyRank": 655,
                "weeklySearchVolume": 125591,
                "topAsins": [
                    {
                        "asin": "B088NMR44C",
                        "clickShare": "0.120",
                        "conversionShare": "0.074"
                    },
                    {
                        "asin": "B0CG1LGWR6",
                        "clickShare": "0.102",
                        "conversionShare": "0.074"
                    },
                    {
                        "asin": "B0CFQ5T5F6",
                        "clickShare": "0.057",
                        "conversionShare": "0.041"
                    }
                ]
            },
            "costPerClick": {
                "value": "1.97",
                "minSuggestedBid": "1.51",
                "maxSuggestedBid": "2.43"
            }
        },
        {
            "searchTerm": "usb",
            "clickConversionRate": "0.361822",
            "competitiveDifficulty": 89,
            "organicRotation": "2.200000",
            "abaReport": {
                "reportFromDate": "2026-05-10",
                "reportToDate": "2026-05-16",
                "searchFrequencyRank": 12249,
                "weeklySearchVolume": 12594,
                "topAsins": [
                    {
                        "asin": "B07GN6CGDF",
                        "clickShare": "0.152",
                        "conversionShare": "0.167"
                    },
                    {
                        "asin": "B015CH1PJU",
                        "clickShare": "0.135",
                        "conversionShare": "0.118"
                    },
                    {
                        "asin": "B0B6148YKN",
                        "clickShare": "0.102",
                        "conversionShare": "0.062"
                    }
                ]
            },
            "costPerClick": {
                "value": "5.23",
                "minSuggestedBid": "3.81",
                "maxSuggestedBid": "6.42"
            }
        }
    ],
    "total": 2
}
修改于 2026-05-25 10:40:35
上一页
关键词ABA数据趋势(周)
Built with