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/analysis/list/monthly
计费规则
1.
本接口按返回的asin数量计费。每处理 50 个asin(向上取整)计为 1 Credit 消耗。
○ 公式:Credit 消耗 = ⌈asin ÷ 50⌉
○ 示例:返回数据包含 250 个asin,将消耗 5 Credits。
2.
针对关键词分析等可能返回大量asin(最高可达数万条)的场景,您可在请求参数中设置 pageSize 限制和设置排序,仅返回有限条数的asin,以减少处理量并节省 Credit 消耗。
请求限制
○ 单次请求最多支持 10000 条

请求参数

Header 参数

Body 参数application/json必填

请求示例代码

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/analysis/list/monthly' \
--header 'X-Client-Id: your16charclientid' \
--header 'X-Timestamp: 1754886692' \
--header 'X-Sign: da79eb2a1d2a5597c7dcc1a0f607c8a2d2f7167be65b01b0e341d8e497a3be49' \
--header 'Content-Type: application/json' \
--data '{
    "searchTerm": "usb c cable",
    "country": "US",
    "page": 0,
    "pageSize": 0,
    "startMonth": "2025-06",
    "endMonth": "2025-06",
    "sort": {
        "field": "traffic",
        "order": "asc"
    }
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "list": [
        {
            "country": "US",
            "asin": "B06XZTZ7GB",
            "ranks": [
                {
                    "position": "or",
                    "totalRank": 0,
                    "page": 0,
                    "pageRank": 0,
                    "rankTime": "string"
                }
            ],
            "trafficSummary": {
                "traffic": {
                    "total": 0,
                    "organic": 0,
                    "advertising": 0,
                    "totalGrowthRate": "string",
                    "organicGrowthRate": "string",
                    "advertisingGrowthRate": "string"
                },
                "trafficRatio": {
                    "total": "string",
                    "organic": "string",
                    "advertising": "string"
                },
                "trafficAcquisitionRate": {
                    "total": "string",
                    "organic": "string",
                    "advertising": "string",
                    "totalGrowthRate": "string",
                    "organicGrowthRate": "string",
                    "advertisingGrowthRate": "string"
                }
            },
            "asinInfo": {
                "country": "string",
                "asin": "string",
                "amazonUrl": "string",
                "picUrl": "string",
                "currency": "string",
                "price": 0,
                "ratings": 0,
                "stars": 0,
                "title": "string"
            }
        }
    ],
    "total": 0
}
修改于 2026-05-08 06:44:28
上一页
关键词分析列表(最近天)
下一页
关键词ABA数据趋势(周)
Built with