| Http Method | POST |
|---|---|
| Http Request URL | https://api.sellersprite.com/v1/keyword/miner |
| # | 参数 | 参数类型 | 是否必填 | 参数名称 | 参数描述 |
| 1 | marketplace | String | ✓ | 市场 | 见表 1.2 |
| 2 | historyDate | String | 历史日期,yyyyMM格式,最近30天不传或传空字符串 | 202201 | |
| 3 | keyword | String | ✓ | 关键词 | |
| 4 | keywordList | List | 批量查询关键词 | ["phone stand"] | |
| 5 | minSearch | Integer | 最小搜索量 | 543 | |
| 6 | maxSearch | Integer | 最大搜索量 | 23453 | |
| 7 | minPurchases | Integer | 最小购买量 | 6 | |
| 8 | maxPurchases | Integer | 最大购买量 | 34 | |
| 9 | minPurchasesRate | Float | 最小购买率 | 3 | |
| 10 | maxPurchasesRate | Float | 最大购买率 | 43 | |
| 11 | minSPR | Integer | 最小SPR | 2 | |
| 12 | maxSPR | Integer | 最大SPR | 16 | |
| 13 | minTitleDensity | Integer | 最小标题密度 | 2 | |
| 14 | maxTitleDensity | Integer | 最大标题密度 | 23 | |
| 15 | minRelevancy | Float | 最小相关度 | 23,最小0 | |
| 16 | maxRelevancy | Float | 最大相关度 | 90,最大100 | |
| 17 | minSearchRank | Integer | 最小搜索排名 | 33 | |
| 18 | maxSearchRank | Integer | 最大搜索排名 | 3223 | |
| 19 | minProducts | Integer | 最小商品数 | 54 | |
| 20 | maxProducts | Integer | 最大商品数 | 324 | |
| 21 | minSupplyDemandRatio | Float | 最小供需比 | 11.2 | |
| 22 | maxSupplyDemandRatio | Float | 最大供需比 | 45.2 | |
| 23 | minAdProducts | Integer | 最小广告竞品数 | 123 | |
| 24 | maxAdProducts | Integer | 最大广告竞品数 | 345 | |
| 25 | minWordCount | Integer | 最小单词个数 | 2 | |
| 26 | maxWordCount | Integer | 最大单词个数 | 4 | |
| 27 | minMonopolyClickRate | Float | 最小点击集中度 | 23.4 | |
| 28 | maxMonopolyClickRate | Float | 最大点击集中度 | 53.1 | |
| 29 | minBid | Float | 最小ppc竞价 | 10.2 | |
| 30 | maxBid | Float | 最大ppc竞价 | 23.1 | |
| 31 | minPrice | Float | 最小均价 | 43.3 | |
| 32 | maxPrice | Float | 最大均价 | 234.2 | |
| 33 | minRatings | Integer | 最小评分数 | 100 | |
| 34 | maxRatings | Integer | 最大评分数 | 399 | |
| 35 | minRating | Float | 最小评分值 | 3 | |
| 36 | maxRating | Float | 最大评分值 | 4.9 | |
| 37 | amazonChoice | Boolean | 亚马逊推荐词 | true | |
| 38 | filterRootWord | Integer | 过滤词根 0包含所有 1只包含词根 | 0 | |
| 39 | includeKeywords | List | 包含的词 | ["phone stand"] | |
| 40 | excludeKeywords | List | 排除的词 | ["phone stand"] | |
| 41 | page | Integer | 页码,从 1 开始 | 默认:1 | |
| 42 | size | Integer | 每页条数 | 默认:50,最大:100 | |
| 43 | order | Object | 排序 | ||
| 44 | └field | String | 排序字段,加入筛序条件之后,不能以相关度排序 | 见表2.4 | |
| 45 | └desc | boolean | true为降序 false为升序 | 默认降序 |
| # | 参数 | 参数类型 | 参数名称 | 参数描述 |
| 1 | marketplace | String | 市场,见表 1.2 | US |
| 2 | keyword | String | 关键词 | phone stand for recording |
| 3 | keywordCn | String | 关键词中文翻译 | 用于录音的电话支架 |
| 4 | keywordJp | String | 关键词英文翻译 | 録音用電話スタンド |
| 5 | departments | List | 类目 | |
| 6 | └code | String | 类目代码 | electronics |
| 7 | └label | String | 类目名称 | Electronics |
| 8 | month | String | 搜索月份 | 2022.01 |
| 9 | supplement | String | 是否属于补充关键词(无当前月搜索量) | N |
| 10 | searches | Integer | 搜索量 | 21582 |
| 11 | purchases | Integer | 月购买量 | 1996 |
| 12 | purchaseRate | Float | 月购买率 | 0.0925 |
| 13 | monopolyClickRate | Float | 点击垄断率 | 0.3 |
| 14 | products | Integer | 商品数 | 1645 |
| 15 | adProducts | Integer | 广告竞品数 | 34 |
| 16 | supplyDemandRatio | Float | 供需比 | 13.12 |
| 17 | avgPrice | Float | 平均价格 | 36.14 |
| 18 | avgRatings | Integer | 平均评分数 | 12223 |
| 19 | avgRating | Float | 平均评分值 | 4.5 |
| 20 | bidMin | Float | 最小PPC价格 | 1.34 |
| 21 | bidMax | Float | 最大PPC价格 | 3.21 |
| 22 | bid | Float | PPC价格 | 1.6 |
| 23 | cvsShareRate | Float | 转化共享率 | 0.3084 |
| 24 | wordCount | Integer | 单词个数 | 4 |
| 25 | titleDensity | Integer | 标题密度 | 42.9 |
| 26 | spr | Integer | SPR | 6 |
| 27 | relevancy | Double | 相关度 | 28.6 |
| 28 | amazonChoice | Boolean | 亚马逊推荐词 true是的 false不是 | false |
| 29 | searchRank | Integer | 搜索排名 | 17910 |
| 30 | └code | String | 类目代码 | electronics |
| 31 | └label | String | 类目名称 | Electronics |
curl --location --request POST 'https://api.sellersprite.com/v1/keyword/miner' \
--header 'secret-key: Your Secret' \
--header 'Content-Type: application/json' \
--data-raw '{
"marketplace": "US",
"historyDate":"202507",
"keyword":"child",
"page":1,
"size":1
}'
{
"code": "OK",
"message": "成功",
"data": {
"guestId": null,
"pages": 3070,
"page": 1,
"size": 1,
"total": 3070,
"took": 0,
"url": null,
"order": {
"field": "",
"desc": true
},
"items": [
{
"marketplace": "US",
"keyword": "child",
"keywordCn": "孩子",
"keywordJp": "子供",
"departments": [
{
"code": "hpc",
"label": "Health, Household & Baby Care"
},
{
"code": "grocery",
"label": "Grocery & Gourmet Food"
}
],
"month": "2025.07",
"supplement": "N",
"searches": 17702,
"purchases": 2436,
"purchaseRate": 0.1376,
"monopolyClickRate": 0.6205,
"products": 364623,
"adProducts": 36,
"supplyDemandRatio": 0.05,
"avgPrice": 17.97,
"avgRatings": null,
"avgRating": 4.8,
"bidMin": 0.91,
"bidMax": 1.4,
"bid": 1.26,
"cvsShareRate": 0.0,
"wordCount": 1,
"titleDensity": 3,
"spr": 56,
"relevancy": 100.0,
"amazonChoice": false,
"searchRank": 94289,
"trends": null
}
],
"terminal": null,
"hasNextPage": null,
"guestVisited": false
}
}