xiyou-openapi
  1. asinSearchTerms
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
    • 获取asin变体接口
      POST
  • asinSearchTerms
    • asin词流量趋势(天)
      POST
    • asin词排名趋势(天)
      POST
    • asin词排名趋势(小时)
      POST
  • searchTerms
    • 关键词ABA数据趋势(周)
      POST
    • 关键词信息(最近一周)
      POST
  1. asinSearchTerms

asin词排名趋势(小时)

POST
/v1/asinSearchTerms/rank/trends/hourly
计费规则
本接口按“天”计费:每请求 1 天(24 小时) 的数据计为 1 Credit 消耗。
○ 公式:Credit 消耗 = 1(固定值)
○ 示例:请求 1 天(24 小时)的排名数据,将消耗 1 Credit
请求限制
○ 本接口单次请求仅支持 1 天 数据,如需多日数据请分多次请求。

请求参数

Body 参数application/json

示例
{
    "asin": "B06XZTZ7GB",
    "country": "US",
    "searchTerm": "usb c cable",
    "date": "2025-06-06"
}

请求示例代码

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/asinSearchTerms/rank/trends/hourly' \
--header 'Content-Type: application/json' \
--data-raw '{
    "asin": "B06XZTZ7GB",
    "country": "US",
    "searchTerm": "usb c cable",
    "date": "2025-06-06"
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "asin": "B0DR3BRJZL",
    "country": "US",
    "searchTerm": "belt fan",
    "trends": [
        {
            "date": "2025-07-10T00:00:00.000-07:00",
            "displayPositions": [
                {
                    "displayPosition": "or",
                    "page": 1,
                    "pageRank": 14,
                    "totalRank": 14
                },
                {
                    "displayPosition": "sp",
                    "page": 1,
                    "pageRank": 14,
                    "totalRank": 14
                },
                {
                    "displayPosition": "sb",
                    "page": 10
                },
                {
                    "displayPosition": "sbv",
                    "page": 10
                },
                {
                    "displayPosition": "oor",
                    "page": 10
                },
                {
                    "displayPosition": "sor",
                    "page": 10
                }
            ]
        },
        {
            "date": "2025-07-10T01:00:00.000-07:00",
            "displayPositions": [
                {
                    "displayPosition": "or",
                    "page": 1,
                    "pageRank": 13,
                    "totalRank": 13
                },
                {
                    "displayPosition": "sp",
                    "page": 1,
                    "pageRank": 12,
                    "totalRank": 12
                },
                {
                    "displayPosition": "sb",
                    "page": 10
                },
                {
                    "displayPosition": "sbv",
                    "page": 10
                },
                {
                    "displayPosition": "oor",
                    "page": 10
                },
                {
                    "displayPosition": "sor",
                    "page": 10
                }
            ]
        },
        {
            "date": "2025-07-10T02:00:00.000-07:00",
            "displayPositions": [
                {
                    "displayPosition": "or",
                    "page": 1,
                    "pageRank": 15,
                    "totalRank": 15
                },
                {
                    "displayPosition": "sp",
                    "page": 1,
                    "pageRank": 15,
                    "totalRank": 15
                },
                {
                    "displayPosition": "sb",
                    "page": 10
                },
                {
                    "displayPosition": "sbv",
                    "page": 10
                },
                {
                    "displayPosition": "oor",
                    "page": 10
                },
                {
                    "displayPosition": "sor",
                    "page": 10
                }
            ]
        },
        {
            "date": "2025-07-10T03:00:00.000-07:00",
            "displayPositions": [
                {
                    "displayPosition": "or",
                    "page": 1,
                    "pageRank": 14,
                    "totalRank": 14
                },
                {
                    "displayPosition": "sp",
                    "page": 1,
                    "pageRank": 13,
                    "totalRank": 13
                },
                {
                    "displayPosition": "sb",
                    "page": 10
                },
                {
                    "displayPosition": "sbv",
                    "page": 10
                },
                {
                    "displayPosition": "oor",
                    "page": 10
                },
                {
                    "displayPosition": "sor",
                    "page": 10
                }
            ]
        }
    ]
}
修改于 2026-01-20 09:00:57
上一页
asin词排名趋势(天)
下一页
关键词ABA数据趋势(周)
Built with