- 西柚找词OPENAPI接入指引
- asins
- asinSearchTerms
- searchTerms
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