- 西柚找词OPENAPI接入指引
- asins
- asinSearchTerms
- searchTerms
asin反查关键词列表（最近天）
POST
/v1/asins/research/list/period
1.
○ 公式：Credit 消耗 = ⌈关键词数量 ÷ 100⌉
○ 示例：返回数据包含 250 个关键词，将消耗 3 Credits。
2.
○ 单次请求最多支持 10000 条
请求参数
Header 参数
Body 参数application/json
示例
{
"asin": "B09XS7JWHH",
"country": "US",
"page": 1,
"pageSize": 100,
"period": "last7days",
"sort": {
"field": "advertisingTraffic",
"order": "desc"
}
}请求示例代码
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/asins/research/list/period' \
--header 'X-Client-Id;' \
--header 'X-Timestamp;' \
--header 'X-Sign;' \
--header 'Content-Type: application/json' \
--data-raw '{
"asin": "B09XS7JWHH",
"country": "US",
"page": 1,
"pageSize": 100,
"period": "last7days",
"sort": {
"field": "advertisingTraffic",
"order": "desc"
}
}'返回响应
🟢200成功
application/json
Body
示例
{
"list": [
{
"country": "US",
"searchTerm": "sony headphones",
"ranks": [
{
"position": "sp",
"totalRank": 2,
"page": 1,
"pageRank": 2,
"rankTime": "2025-07-12T08:01:01-07:00"
},
{
"position": "sor",
"page": 3,
"rankTime": "2025-08-07T05:02:52-07:00"
},
{
"position": "or",
"totalRank": 8,
"page": 1,
"pageRank": 8,
"rankTime": "2025-08-09T12:00:43-07:00"
}
],
"trafficSummary": {
"traffic": {
"total": 36523,
"organic": 32448,
"advertising": 4075,
"totalGrowthRate": "-0.042823",
"organicGrowthRate": "-0.148749",
"advertisingGrowthRate": "103.487179"
},
"trafficAcquisitionRate": {
"total": "0.490356",
"organic": "0.436517",
"advertising": "0.053839",
"totalGrowthRate": "-0.103496",
"organicGrowthRate": "-0.201146",
"advertisingGrowthRate": "99.500002"
}
}
},
{
"country": "US",
"searchTerm": "airpods pro 2",
"ranks": [
{
"position": "sor",
"page": 1,
"rankTime": "2025-08-03T11:01:42-07:00"
},
{
"position": "or",
"totalRank": 43,
"page": 3,
"pageRank": 11,
"rankTime": "2025-07-14T05:02:53-07:00"
},
{
"position": "sp",
"totalRank": 5,
"page": 1,
"pageRank": 5,
"rankTime": "2025-07-11T19:00:46-07:00"
}
],
"trafficSummary": {
"traffic": {
"total": 1323,
"organic": 0,
"advertising": 1323,
"totalGrowthRate": "Infinity",
"organicGrowthRate": "0.000000",
"advertisingGrowthRate": "Infinity"
},
"trafficAcquisitionRate": {
"total": "0.005357",
"organic": "0.000000",
"advertising": "0.005357",
"totalGrowthRate": "Infinity",
"organicGrowthRate": "0.000000",
"advertisingGrowthRate": "Infinity"
}
}
},
{
"country": "US",
"searchTerm": "sony wh-1000xm5",
"ranks": [
{
"position": "sp",
"totalRank": 1,
"page": 1,
"pageRank": 1,
"rankTime": "2025-08-03T09:07:51-07:00"
},
{
"position": "sor",
"page": 1,
"rankTime": "2025-08-10T21:08:32-07:00"
}
],
"trafficSummary": {
"traffic": {
"total": 475,
"organic": 0,
"advertising": 475,
"totalGrowthRate": "7.333333",
"organicGrowthRate": "0.000000",
"advertisingGrowthRate": "7.333333"
},
"trafficAcquisitionRate": {
"total": "0.045313",
"organic": "0.000000",
"advertising": "0.045313",
"totalGrowthRate": "7.458333",
"organicGrowthRate": "0.000000",
"advertisingGrowthRate": "7.458333"
}
}
},
{
"country": "US",
"searchTerm": "sony wh-1000xm6",
"ranks": [
{
"position": "sp",
"totalRank": 2,
"page": 1,
"pageRank": 2,
"rankTime": "2025-08-03T09:04:37-07:00"
},
{
"position": "sor",
"page": 1,
"rankTime": "2025-08-03T09:04:37-07:00"
},
{
"position": "or",
"totalRank": 3,
"page": 1,
"pageRank": 3,
"rankTime": "2025-08-10T21:02:30-07:00"
修改于 2025-09-03 03:11:52