| Http Method | POST |
|---|---|
| Http Request URL | https://api.sellersprite.com/v1/keyword-research |
| # | 参数 | 参数类型 | 是否必填 | 参数名称 | 参数描述 |
| 1 | marketplace | String | ✓ | 市场 | 见表 1.2 |
| 2 | month | String | 筛选日期,yyyyMM格式,支持近24个月的 | 202203 | |
| 3 | departments | List | 查询类目,见关键词选品类目接口,传递code | ["automotive","baby-products"] | |
| 4 | keywords | String | 关键词 | N95 | |
| 5 | excludeKeywords | String | 排除的关键字 | portable | |
| 6 | minSearches | Integer | 最小月搜索量 | 100 | |
| 7 | maxSearches | Integer | 最大月搜索量 | 300 | |
| 8 | minSearchesCr | Float | 最小月搜索量增长率 | 10 | |
| 9 | maxSearchesCr | Float | 最大月搜索量增长率 | 50.8 | |
| 10 | minProducts | Integer | 最小商品数 | 10 | |
| 11 | maxProducts | Integer | 最大商品数 | 90 | |
| 12 | minPurchases | Integer | 最小购买量 | 100 | |
| 13 | maxPurchases | Integer | 最大购买量 | 500 | |
| 14 | minPurchaseRate | Float | 最小购买率 | 3.2 | |
| 15 | maxPurchaseRate | Float | 最大购买率 | 10.5 | |
| 16 | withYearlyGrowth | Boolean | 新细分市场 | false | |
| 17 | minSearchMonthCv | Integer | 最小月搜索量同比增长值 | 1000 | |
| 18 | maxSearchMonthCv | Integer | 最大月搜索量同比增长值 | 3000 | |
| 19 | minSearchMonthCr | Float | 最小月搜索量同比增长率 | 5.3 | |
| 20 | maxSearchMonthCr | Float | 最大月搜索量同比增长率 | 30.1 | |
| 21 | minSearchNearlyCv | Integer | 最小月搜索量近3个月增长值 | 6000 | |
| 22 | maxSearchNearlyCv | Integer | 最大月搜索量近3个月增长值 | 20000 | |
| 23 | minSearchNearlyCr | Float | 最小月搜索量近3个月增长率 | 10.3 | |
| 24 | maxSearchNearlyCr | Float | 最大月搜索量近3个月增长率 | 20.4 | |
| 25 | marketPeriod | String | 市场周期 | 见表1.7 | |
| 26 | minAvgPrice | Float | 最小均价 | 20 | |
| 27 | maxAvgPrice | Float | 最大均价 | 30.3 | |
| 28 | minRatings | Integer | 最小评分数 | 2000 | |
| 29 | maxRatings | Integer | 最大评分数 | 3000 | |
| 30 | minRating | Float | 最小评分值 | 3.2 | |
| 31 | maxRating | Float | 最大评分值 | 4.1 | |
| 32 | minBid | Float | 最小PPC竞价 | 6.2 | |
| 33 | maxBid | Float | 最大PPC竞价 | 10.6 | |
| 34 | minAraClickRate | Float | 最小点击集中度 | 20.1 | |
| 35 | maxAraClickRate | Float | 最大点击集中度 | 56.4 | |
| 36 | minGoodsValue | Float | 最小货流值 | 10.1 | |
| 37 | maxGoodsValue | Float | 最大货流值 | 41.1 | |
| 38 | minSupplyDemandRatio | Float | 最小供需比 | 5.6 | |
| 39 | maxSupplyDemandRatio | Float | 最大供需比 | 10.4 | |
| 40 | minWordCount | Integer | 最小单词个数 | 1 | |
| 41 | maxWordCount | Integer | 最大单词个数 | 3 | |
| 42 | page | Integer | 页码,从 1 开始 | 默认:1 | |
| 43 | size | Integer | 每页条数,默认15 | 最大:15 | |
| 44 | order | Object | 排序 | ||
| 45 | └field | String | 排序字段 | 见表1.8 | |
| 46 | └desc | boolean | true为降序 false为升序 | 默认降序 |
| # | 参数 | 参数类型 | 参数名称 | 参数描述 |
| 1 | 参数名称 | 参数类型 | 参数说明 | 举例 |
| 2 | marketplace | String | 市场 | US |
| 3 | keywords | String | 关键词 | polaroid cameras |
| 4 | searches | Integer | 搜索量 | 141356 |
| 5 | purchases | Integer | 月购买量 | 4029 |
| 6 | growth | Float | 增长率 | -25.482092 |
| 7 | purchaseRate | Float | 月购买率 | 0.0285 |
| 8 | products | Integer | 产品数 | 173 |
| 9 | supplyDemandRatio | Float | 供需比 | 817.09 |
| 10 | searchDepartments | List | 类目 | |
| 11 | └code | String | 类目代码 | electronics |
| 12 | └label | String | 类目名称 | Electronics |
| 13 | └total | Integer | 类目总计 | 141356 |
| 14 | └ratio | Float | 类目占比 | 1 |
| 15 | month | String | 查询月份 | 2022.01 |
| 16 | supplement | String | 是否属于补充关键词 | N |
| 17 | searchMonthlyCv | Integer | 关键词同比增长 | 139749 |
| 18 | searchMonthlyCr | Float | 关键词同比增长率 | 8696.27 |
| 19 | searchNearlyCv | Integer | 关键词近3个月增长值 | -48338 |
| 20 | searchNearlyCr | Float | 关键词近3个月增长率 | -25.48 |
| 21 | currency | String | 货币 | $ |
| 22 | avgPrice | Float | 平均价格 | 116.24 |
| 23 | avgRatings | Integer | 平均评分数 | 2584 |
| 24 | avgRating | Float | 平均评论数 | 4.5 |
| 25 | relationAsinList | List | 关键词关联asin | 4.8 |
| 26 | └asin | String | asin | B06WW64YM6 |
| 27 | └imageUrl | String | 图片地址 | https://m.media-amazon.com/images/I/817aVWYpblL._AC_UY218_.jpg |
| 28 | └price | Float | 价格 | 59.95 |
| 29 | └ratings | Integer | 评分数 | 20115 |
| 30 | └rating | Float | 评分 | 4.7 |
| 31 | bidMin | Float | bid最小价格 | 0.987 |
| 32 | bidMax | Float | bid最大价格 | 2.54 |
| 33 | bid | Float | bid价格 | 1.26 |
| 34 | araClickRate | Float | 点击垄断率 | 0.2633 |
| 35 | araShareRate | Float | 共享转化率 | 0.2633 |
| 36 | araAsinList | List | 点击前三ASIN | |
| 37 | └asin | String | asin | B099VDRGG1 |
| 38 | └title | String | title | Fujifilm Instax Mini 9 |
| 39 | └imageUrl | String | 图片 | [{cellPosition=null, link=https://m.media-amazon.com/images/I/51aZiZaicYL._AC_US200_.jpg, text=https://m.media-amazon.com/images/I/51aZiZaicYL._AC_US200_.jpg, type=url}] |
| 40 | └clickRate | Double | 点击率 | 0.116 |
| 41 | └conversionShareRate | Double | 转化率 | 0.1217 |
| 42 | goodsValue | Float | 货流值 | 0.0108 |
| 43 | brands | List | TOP3 品牌 | ["LEGO","Jorumo","Nifeliz"] |
| 44 | categories | List | TOP3 类目 | ["Toys","Home","Mobile_Apps"] |
| 45 | titleDensityExact | String | 标题密度首页商品包含该关键词的数量(不含广告位) | 21 |
| 46 | marketPeriod | String | 市场周期 | S11,S12 |
| 47 | brand | String | 品牌 | Fujifilm |
| 48 | hasBrandWord | Boolean | 是否存在品牌词 | false |
| 49 | keywordCn | String | 中文翻译 | 宝丽来相机 |
curl --location --request POST 'https://api.sellersprite.com/v1/keyword-research' \
--header 'secret-key: Your Secret' \
--header 'Content-Type: application/json' \
--data-raw '{
"marketplace": "US",
"month":"202507",
"keywords":"child",
"page":1,
"size":1
}'
{
"code": "OK",
"message": "成功",
"data": {
"guestId": null,
"pages": 1239,
"page": 1,
"size": 1,
"total": 1239,
"took": 15,
"url": null,
"order": {
"field": "",
"desc": true
},
"items": [
{
"marketplace": "US",
"keywords": "child",
"searches": 17702,
"purchases": 2436,
"growth": -19.83153,
"purchaseRate": 0.1376,
"products": 364623,
"supplyDemandRatio": 0.05,
"searchDepartments": [
{
"code": "hpc",
"label": "Health, Household & Baby Care",
"total": 2725,
"ratio": 0.15393741
},
{
"code": "grocery",
"label": "Grocery & Gourmet Food",
"total": 1361,
"ratio": 0.07688397
}
],
"month": "2025.07",
"supplement": "N",
"searchMonthlyCv": -12649,
"searchMonthlyCr": -41.68,
"searchNearlyCv": -4379,
"searchNearlyCr": -19.83,
"currency": "$",
"avgPrice": 17.97,
"avgRatings": 25985,
"avgRating": 4.8,
"relationAsinList": [
{
"asin": "B06XSCPJZK",
"imageUrl": "https://m.media-amazon.com/images/I/41dfAc5LCkL._AC_US200_.jpg",
"price": 26.59,
"ratings": 6816,
"rating": 4.4
},
{
"asin": "B08N7XY3YX",
"imageUrl": "https://m.media-amazon.com/images/I/51I4il4gDiL._SX200_SY200_CR,0,0,200,200_.jpg",
"price": 3.88,
"ratings": 1891,
"rating": 4.3
},
{
"asin": "B0DBK72RNM",
"imageUrl": null,
"price": null,
"ratings": null,
"rating": null
},
{
"asin": "031075013X",
"imageUrl": "https://m.media-amazon.com/images/I/51W5p0Xa+bL._SX200_SY200_CR,0,0,200,200_.jpg",
"price": 0.0,
"ratings": 26942,
"rating": 4.9
},
{
"asin": "1589255518",
"imageUrl": "https://m.media-amazon.com/images/I/51X8S5lCw0L._SX200_SY200_CR,0,0,200,200_.jpg",
"price": 799.0,
"ratings": 78366,
"rating": 4.9
},
{
"asin": "1558585362",
"imageUrl": "https://m.media-amazon.com/images/I/61PSea9xxtL._SX200_SY200_CR,0,0,200,200_.jpg",
"price": 5.16,
"ratings": 7356,
"rating": 4.8
},
{
"asin": "B0D47TX6KL",
"imageUrl": null,
"price": null,
"ratings": null,
"rating": null
},
{
"asin": "0060245867",
"imageUrl": "https://m.media-amazon.com/images/I/51TyTVf8ALL._SX200_SY200_CR,0,0,200,200_.jpg",
"price": 0.0,
"ratings": 14669,
"rating": 4.8
},
{
"asin": "0399226907",
"imageUrl": "https://m.media-amazon.com/images/I/41oCAss2B8L._SX200_SY200_CR,0,0,200,200_.jpg",
"price": 599.0,
"ratings": 77242,
"rating": 4.9
},
{
"asin": "B000I9VO6C",
"imageUrl": null,
"price": null,
"ratings": null,
"rating": null
}
],
"bidMin": 0.91,
"bidMax": 1.4,
"bid": 1.26,
"araAsinList": [
{
"asin": "B07HQ2JS3L",
"title": null,
"imageUrl": null,
"clickRate": 0.28,
"conversionShareRate": 0.0
},
{
"asin": "B00CR9RR12",
"title": null,
"imageUrl": null,
"clickRate": 0.1878,
"conversionShareRate": 0.0
},
{
"asin": "B00D5DO41K",
"title": null,
"imageUrl": null,
"clickRate": 0.1527,
"conversionShareRate": 0.0
}
],
"araClickRate": 0.6205,
"araShareRate": 0.0,
"goodsValue": 0.0701,
"marketPeriod": "S9,S10",
"brand": null,
"hasBrandWord": false,
"keywordCn": "孩子",
"brands": [
"Majosta",
"Delacorte Press"
],
"categories": [
"Digital_Video_Download",
"Books",
"Digital_Ebook_Purchase"
],
"titleDensityExact": 3
}
],
"terminal": null,
"hasNextPage": null,
"guestVisited": false
}
}