asin反查关键词列表（月）
POST
/v1/asins/research/list/monthly
1.
○ 公式：Credit 消耗 = ⌈关键词数量 ÷ 100⌉
○ 示例：返回数据包含 250 个关键词，将消耗 3 Credits。
2.
○ 单次请求最多支持 10000 条
○ 查询周期最长为 一年
请求参数
Header 参数
Body 参数application/json
示例
{
"asin": "B0DR3BRJZL",
"country": "US",
"page": 1,
"pageSize": 10,
"startMonth": "2025-06",
"endMonth": "2025-06",
"sort": {
"field": "traffic",
"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/monthly' \
--header 'X-Client-Id;' \
--header 'X-Timestamp;' \
--header 'X-Sign;' \
--header 'Content-Type: application/json' \
--data-raw '{
"asin": "B0DR3BRJZL",
"country": "US",
"page": 1,
"pageSize": 10,
"startMonth": "2025-06",
"endMonth": "2025-06",
"sort": {
"field": "traffic",
"order": "desc"
}
}'返回响应
🟢200成功
application/json
Body
示例
{
"list": [
{
"country": "US",
"searchTerm": "personal fan",
"ranks": [
{
"position": "or",
"totalRank": 75,
"page": 2,
"pageRank": 27,
"rankTime": "2025-06-30T23:02:13-07:00"
},
{
"position": "sp",
"totalRank": 5,
"page": 1,
"pageRank": 5,
"rankTime": "2025-06-20T11:01:11-07:00"
},
{
"position": "sor",
"page": 1,
"rankTime": "2025-06-20T11:01:11-07:00"
}
],
"trafficSummary": {
"traffic": {
"total": 86251,
"organic": 83510,
"advertising": 2741
},
"trafficAcquisitionRate": {
"total": "0.407961",
"organic": "0.392899",
"advertising": "0.015062"
}
}
},
{
"country": "US",
"searchTerm": "portable fan",
"ranks": [
{
"position": "or",
"totalRank": 133,
"page": 3,
"pageRank": 41,
"rankTime": "2025-06-30T21:02:17-07:00"
},
{
"position": "sp",
"totalRank": 22,
"page": 3,
"pageRank": 1,
"rankTime": "2025-06-25T09:00:27-07:00"
},
{
"position": "sor",
"page": 2,
"rankTime": "2025-06-20T11:05:33-07:00"
},
{
"position": "sbv",
"page": 1,
"rankTime": "2025-06-27T19:03:14-07:00"
}
],
"trafficSummary": {
"traffic": {
"total": 58164,
"organic": 53189,
"advertising": 4975
},
"trafficAcquisitionRate": {
"total": "0.061961",
"organic": "0.057086",
"advertising": "0.004874"
}
}
},
{
"country": "US",
"searchTerm": "waist fan",
"ranks": [
{
"position": "or",
"totalRank": 25,
"page": 1,
"pageRank": 25,
"rankTime": "2025-06-30T23:03:56-07:00"
},
{
"position": "sp",
"totalRank": 15,
"page": 3,
"pageRank": 3,
"rankTime": "2025-06-28T06:02:00-07:00"
},
{
"position": "sor",
"page": 1,
"rankTime": "2025-06-20T01:02:06-07:00"
}
],
"trafficSummary": {
"traffic": {
"total": 47792,
"organic": 46028,
"advertising": 1764
},
"trafficAcquisitionRate": {
"total": "0.600718",
"organic": "0.571345",
"advertising": "0.029373"
}
}
},
{
"country": "US",
"searchTerm": "belt fan",
"ranks": [
{
"position": "or",
"totalRank": 21,
"page": 1,
"pageRank": 21,
"rankTime": "2025-06-30T23:03:40-07:00"
},
{
"position": "sp",
"totalRank": 6,
"page": 1,
"pageRank": 6,
"rankTime": "2025-06-20T10:04:46-07:00"
},
{
"position": "ac",
"page": 1,
"rankTime": "2025-06-03T00:12:06-07:00"
},
{
"position": "sor",
"page": 1,
"rankTime": "2025-06-20T10:04:46-07:00"
}
],
"trafficSummary": {
"traffic": {
"total": 27541,
"organic": 26112,
"advertising": 1429
},
"trafficAcquisitionRate": {
"total": "0.685832",
"organic": "0.640315",
"advertising": "0.045517"
}
}
},
{
"country": "US",
"searchTerm": "portable waist fan",
"ranks": [
{
"position": "or",
"totalRank": 31,
"page": 1,
"pageRank": 31,
"rankTime": "2025-06-30T23:07:16-07:00"
},
{
"position": "sp",
"totalRank": 13,
"page": 3,
"pageRank": 1,
"rankTime": "2025-06-28T06:03:56-07:00"
},
{
"position": "sor",
"page": 1,
"rankTime": "2025-06-28T04:03:48-07:00"
}
],
"trafficSummary": {
"traffic": {
"total": 24331,
"organic": 21475,
"advertising": 2856
},
"trafficAcquisitionRate": {
"total": "0.498641",
"organic": "0.434521",
"advertising": "0.064120"
}
}
},
{
"country": "US",
"searchTerm": "shirt fan",
"ranks": [
{
"position": "sp",
"totalRank": 14,
"page": 2,
"pageRank": 2,
"rankTime": "2025-06-08T18:22:49-07:00"
},
{
"position": "or",
"totalRank": 35,
"page": 1,
"pageRank": 35,
"rankTime": "2025-06-30T23:08:05-07:00"
}
],
"trafficSummary": {
"traffic": {
"total": 21248,
"organic": 21241,
"advertising": 7
},
"trafficAcquisitionRate": {
"total": "0.481326",
"organic": "0.481103",
"advertising": "0.000223"
}
}
},
{
"country": "US",
"searchTerm": "personal fans portable rechargeable",
"ranks": [
{
"position": "sp",
"totalRank": 5,
"page": 1,
"pageRank": 5,
"rankTime": "2025-06-20T11:05:12-07:00"
},
{
"position": "sor",
"page": 1,
"rankTime": "2025-06-29T00:03:22-07:00"
},
{
"position": "sbv",
"page": 2,
"rankTime": "2025-06-24T19:05:13-07:00"
},
{
"position": "or",
"totalRank": 56,
"page": 2,
"pageRank": 7,
"rankTime": "2025-06-30T23:03:01-07:00"
}
],
"trafficSummary": {
"traffic": {
"total": 20427,
"organic": 18335,
"advertising": 2092
},
"trafficAcquisitionRate": {
"total": "0.476101",
"organic": "0.416352",
"advertising": "0.059749"
}
}
},
{
"country": "US",
"searchTerm": "body fan",
"ranks": [
{
"position": "or",
"totalRank": 10,
"page": 1,
"pageRank": 10,
"rankTime": "2025-06-30T23:15:31-07:00"
},
{
"position": "sp",
"totalRank": 13,
"page": 2,
"pageRank": 1,
"rankTime": "2025-06-29T01:04:29-07:00"
},
{
"position": "sbv",
"page": 2,
"rankTime": "2025-06-27T19:08:33-07:00"
},
{
"position": "sor",
"page": 3,
"rankTime": "2025-06-11T05:30:09-07:00"
}
],
"trafficSummary": {
"traffic": {
"total": 16861,
"organic": 15922,
"advertising": 939
},
"trafficAcquisitionRate": {
"total": "0.716579",
"organic": "0.664482",
"advertising": "0.052097"
}
}
},
{
"country": "US",
"searchTerm": "clip on fan for shirt",
"ranks": [
{
"position": "or",
"totalRank": 51,
"page": 2,
"pageRank": 3,
"rankTime": "2025-06-30T23:10:40-07:00"
},
{
"position": "sp",
"totalRank": 8,
"page": 1,
"pageRank": 8,
"rankTime": "2025-06-25T09:05:24-07:00"
},
{
"position": "sor",
"page": 1,
"rankTime": "2025-06-21T00:23:29-07:00"
}
],
"trafficSummary": {
"traffic": {
"total": 16690,
"organic": 13863,
"advertising": 2827
},
"trafficAcquisitionRate": {
"total": "0.459691",
"organic": "0.374953",
"advertising": "0.084738"
}
}
},
{
"country": "US",
"searchTerm": "belt fan clip on waist portable cooling fan",
"ranks": [
{
"position": "sor",
"page": 3,
"rankTime": "2025-06-16T02:13:27-07:00"
},
{
"position": "or",
"totalRank": 29,
"page": 1,
"pageRank": 29,
"rankTime": "2025-06-30T23:07:34-07:00"
},
{
"position": "sp",
"totalRank": 17,
"page": 2,
"pageRank": 5,
"rankTime": "2025-06-28T02:07:18-07:00"
}
],
"trafficSummary": {
"traffic": {
"total": 15862,
"organic": 14525,
"advertising": 1337
},
"trafficAcquisitionRate": {
"total": "0.595443",
"organic": "0.535214",
"advertising": "0.060229"
}
}
}
],
"total": 1807
}修改于 2025-09-03 03:12:02