1. searchTerms
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
    • 关键词ABA数据趋势（周）
      POST
    • 关键词信息（最近一周）
      POST
    • 关键词分析列表（最近天）
      POST
    • 关键词分析列表（月）
      POST
  • client
    • 获取client Id的余额
      POST
  • 市场洞察
    • 资源生成
      • 生成类目洞察资源
        POST
      • 查询市场资源状态
        POST
    • 市场榜单
      • 获取类目月度销量榜
        POST
      • 获取类目年度销量榜
        POST
      • 获取类目月度新秀榜
        POST
      • 获取类目年度新秀榜
        POST
      • 获取类目月度飙升榜
        POST
      • 获取类目年度飙升榜
        POST
    • 关键词洞察
      • 获取类目关键词分析
        POST
      • 获取类目关键词搜索量趋势
        POST
      • 获取类目关键词列表
        POST
    • 类目销售走势
      • 获取类目市场规模趋势
        POST
      • 获取类目季节性分析
        POST
    • 新品机会分析
      • 类目新老品销量及数量趋势
        POST
    • 价格段机会分析
      • 获取各价格段市场销量趋势
        POST
    • 竞争格局总览
      • 获取价格段 ASIN 列表
        POST
      • 获取类目各品牌市场规模
        POST
      • 批量获取品牌销量趋势
        POST
      • 获取价格段父 ASIN 列表
        POST
    • 评分分析
      • 获取类目评分分布
        POST
      • 获取类目评分数分布
        POST
    • 基于关键词和 ASIN 搜索类目
      POST
  • foundation
    • 获取市场洞察的可用日期
      GET
  1. searchTerms

关键词信息（最近一周）

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

请求参数

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.xydc.com/v1/searchTerms/info' \
--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-07-21 02:00:57
上一页
关键词ABA数据趋势（周）
下一页
关键词分析列表（最近天）
Built with