卖家精灵对外 API-选市场

请求网关

对外API的请求网关为：https://api.sellersprite.com/

DEMO地址

对外API的访问DEMO码云地址：https://gitee.com/cdyunya/sellersprite-api-demo

公共头说明

目前卖家精灵对外开放了选产品和查产品等20+接口，访问接口需申请访问秘钥。获取到访问秘钥之后需要将秘钥放入到 header 头中传递到后台，请求接口的参数类型和返回参数类型均为 json。请求头示例：

header 头	参数
secret-key	8957c4cd9rdc4a0eaa3c257e68bu767
Content-Type	application/json;charset=utf-8

访问接口公共返回参数

参数名称	参数类型	参数说明	举例
code	String	返回状态码	见下表
message	String	返回信息	具体的描述信息
data	Object	请求数据

code 码说明

code 值	对应的 message 描述	code 码说明
OK	成功	请求成功，返回数据
ERROR_URL_NOT_FOUND	URL未找到	访问了一个错误的URL
ERROR_SERVER_INTERNAL	服务器内部错误	服务器内部发生错误，不能正确响应
ERROR_PARAM	参数错误	传递的参数有误，具体哪个参数查看 data 内容
ERROR_SECRET_KEY	秘钥错误	传递了一个错误的秘钥
ERROR_SECRET_KEY_OVERDUE	秘钥过期	传递的秘钥已过期
ERROR_VISIT_MAX	接口访问次数已达上限	接口访问已到日访问或月访问限额
ERROR_SECRET_KEY_INVALID	秘钥无效	传递了一个无效的秘钥

选市场列表

1.请求 URL:/v1/market/research，请求方式 POST

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场	见表 1.2	✓
month	String	筛选日期,默认最近30天，最早查询时间为2021年7月份	见表 1.1
topNum	Integer	头部Listing数量	10
newProduct	Integer	新品定义	6
nodeIdPath	String	类目	172282:281407
departmentKeyword	String	类目关键字	Electronics:Accessories & Supplies
minAvgUnits	Integer	最低月均销量	100
maxAvgUnits	Integer	最高均月销量	10000
minAvgRevenue	Float	最低月均销售额	100
maxAvgRevenue	Float	最高月均销售额	900
minAvgRatings	Integer	最低平均评分数	100
maxAvgRatings	Integer	最高平均评分数	500
minAvgRating	Float	最低平均评分值	2.5
maxAvgRating	Float	最高平均评分值	3.0
minAvgBsr	Integer	最低平均BSR排名	50
maxAvgBsr	Integer	最高平均BSR排名	100
minAvgPrice	Float	最低平均价格	30
maxAvgPrice	Float	最高平均价格	50
minWeight	Float	最低重量	30
maxWeight	Float	最高重量	60
minVolume	Float	最低体积	20
maxVolume	Float	最高体积	50
minAvgProfit	Float	最低平均毛利率	20
maxAvgProfit	Float	最高平均毛利率	70
minTopAvgUnits	Integer	最低头部月均销量	200
maxTopAvgUnits	Integer	最高头部均月销量	300
minTopAvgRevenue	Float	最低头部月均销售额	2000
maxTopAvgRevenue	Float	最高头部月均销售额	3000
minTopAvgBsr	Integer	最低头部平均BSR	68
maxTopAvgBsr	Integer	最高头部平均BSR	998
minGoodsCount	Integer	最低商品数量	40
maxGoodsCount	Integer	最高商品数量	90
minBrands	Integer	最小品牌数量	10
maxBrands	Integer	最大品牌数量	20
minSellers	Integer	最小卖家数量	6
maxSellers	Integer	最大卖家数量	10
minAvgSellers	Float	最小平均卖家数量	4.4
maxAvgSellers	Float	最大平均卖家数量	10.4
minGoodsCrn	Float	最小商品集中度	45
maxGoodsCrn	Float	最大商品集中度	55
minBrandCrn	Float	最小品牌集中度	45
maxBrandCrn	Float	最大品牌集中度	55
maxSellerCrn	Float	最小卖家集中度	45
minSellerCrn	Float	最大卖家集中度	55
minEbcProportion	Float	最小A+数量占比	34
maxEbcProportion	Float	最大A+数量占比	54
minFbaProportion	Float	最小FBA占比	34
maxFbaProportion	Float	最大FBA占比	54
minFbmProportion	Float	最小FBM占比	34
maxFbmProportion	Float	最大FBM占比	54
minAmazonSelfProportion	Float	最小Amazon自营占比	34
maxAmazonSelfProportion	Float	最大Amazon自营占比	56
sellerLocation	String	卖家所属地，见表1.3	US,GB
minNewProportion	Float	最小新品数量占比	34
maxNewProportion	Float	最大新品数量占比	56
minNewCount	Integer	最小新品数量	4
maxNewCount	Integer	最大新品数量	20
minNewAvgRatings	Integer	最小新品平均评分数	23
maxNewAvgRatings	Integer	最大新品平均评分数	554
minNewAvgPrice	Float	最小新品平均价格	34
maxNewAvgPrice	Float	最大新品平均价格	45
minNewAvgRating	Float	最小新品平均星级	4.0
maxNewAvgRating	Float	最大新品平均星级	4.5
minNewAvgUnits	Float	最低新品月均销量	400
maxNewAvgUnits	Float	最高新品月均销量	800
minNewAvgRevenue	Float	最低新品月均销售额	900
maxNewAvgRevenue	Float	最高新品月均销售额	2000
page	Integer	页码，从 1 开始	默认：1
size	Integer	每页条数	默认：50，最大：200
order	Object	排序
└field	String	排序字段	见表1.4
└desc	boolean	true为降序 false为升序	默认降序

返回参数

参数名称	参数类型	参数说明	举例
marketplace	String	市场标志	US
currency	String	该市场的货币类型	USD
nodeId	String	节点ID	3732981
nodeLabelName	String	节点名称	Mattresses
nodeIdPath	String	节点ID路径	1055398:1063306:1063308:3732961:3732981
nodeLabelPath	String	节点名称路径	Home & Kitchen:Furniture:Bedroom Furniture:Mattresses & Box Springs:Mattresses
nodeLabelLocale	String	节点名称翻译	床垫
nodeLabelPathLocale	String	节点名称路径翻译	家居用品厨房:家具:家具卧室:床垫:床垫
totalProducts	Integer	商品总数	1000
ranking	Integer	排名	1
topProducts	Integer	样本数量	100
brands	Integer	品牌数量	34
sellers	Integer	卖家数量	60
totalUnits	Integer	月总销量	539009
totalRevenue	Float	月总销售额	179950610.38
avgUnits	Integer	月均销量	5390
avgRevenue	Float	月均销售额	1799506
avgPrice	Float	平均价格	296.11
avgRatings	Integer	平均评分数	14591
avgRating	Float	平均评分值	4.5
avgBsr	Integer	平均BSR	198077
baseAvgVolume	Float	平均体积(cm³)	529430.46
avgVolume	Float	平均体积(in³)	32307.87
baseAvgWeight	Float	平均重量(g)	35301.19
avgWeight	Float	平均重量(pound)	77.8259
avgProfit	Float	平均利润率	68.76
avgSellers	Float	平均卖家数	3.3
ebcProportion	Float	A+商品占比,百分比	80
amazonSelfProportion	Float	Amazon自营占比,百分比	55
fbaProportion	Float	FBA占比,百分比	22
fbmProportion	Float	FBM占比,百分比	14
sellerNation	String	最多卖家归属地 code，见表1.3	US
sellerNationLabel	String	最多卖家归属地 label	美国
sellerProportion	Float	最多卖家归属地占比	59.3
top10Images	List	前10商品的图片
└asin	String	asin	B01IU6RJYA
└image	String	asin图片链接	https://images-na.ssl-images-amazon.com/images/I/51+5VVLcXSL._AC_US200_.jpg
returnRatio	Float	退货率	3.51
avgReturnRatio	Float	退货率类目平均值	5.54
searchToPurchaseRatio	Float	搜索购买比,千分比	0.94926

请求示例

curl 'https://api.sellersprite.com/v1/market/research' \

-H 'Content-Type: application/json;charset=UTF-8' \

-H 'secret-key: 你的密钥' \

--data-raw $'{\n "marketplace":"US",\n "size":20,\n "page":1\n}' \

--compressed

类目统计

请求 URL:/v1/market/statistics，请求方式 POST

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场 id	见表 1.2	✓
month	String	筛选日期,默认最近30天，最早查询时间为2021年7月份	见表 1.1
topN	Integer	头部Listing数量	10
newProduct	Integer	新品定义	6
nodeIdPath	String	节点 id 路径字符串	1064954:1069242:1069784:1069820:1069838:1069828	✓

返回参数

参数名称	参数类型	参数说明	举例
marketplace	String	市场标志	US
currency	String	该市场的货币类型	USD
nodeIdPath	String	节点ID路径	1064954:1069242:1069784:1069820:1069838:1069828
nodeLabelPath	String	节点名称路径	Office Products:Office & School Supplies:Writing & Correction Supplies:Pens & Refills:Rollerball Pens:Gel Ink Rollerball Pens
nodeLabelLocale	String	节点名称翻译	办公产品:办公室:写作:钢笔:滚珠笔:中性笔
countryCode	String	国家二简码	US
totalProducts	Integer	商品总数	5127
products	Integer	样品商品数	100
brands	Integer	品牌数	4
sellers	Integer	卖家数	58
avgBsr	Integer	平均BSR	41970
baseAvgVolume	Float	平均体积(cm³)	819942.68
avgVolume	Float	平均体积(in³)	50035.97
baseAvgWeight	Float	平均重量(g)	2460.95
avgWeight	Float	平均重量(pound)	5.4255
avgProfit	Float	平均利润率	66.03
avgUnits	Integer	月均销量	26255
avgRevenue	Float	月均销售额	344369
avgPrice	Float	平均价格	13.91
avgRatingsCv	Integer	月评论平均增长数	0
avgRatings	Integer	平均评分数	19071
avgRating	Float	平均星级	4.7
avgSellers	Float	平均卖家数	5.2
hlProducts	Integer	头部Listing前N名商品样本数	5
hlAvgBsr	Integer	头部Listing前N名商品平均BSR	13126
hlAvgUnits	Integer	头部Listing前N名商品月均销量	1123
hlAvgRevenue	Float	头部Listing前N名商品月均销售额	12342.85
hlAvgPrice	Float	头部Listing前N名商品平均价格	11.77
hlAvgRatingsCv	Integer	头部Listing前N名商品月评论平均增长数	0
hlAvgRatings	Integer	头部Listing前N名商品平均评论数	2794
hlAvgRating	Float	头部Listing前N名商品平均星级	4.7
newProducts	Integer	新品数量	67
newProductProportion	Float	新品数量占比	67
newAvgPrice	Float	新品平均价格	14.14
newAvgRatings	Integer	新品平均评分数	24295
minNewRatings	Integer	最低新品评分数	24
maxNewRatings	Integer	最高新品评分数	6432
newAvgRating	Float	新品平均星级	4.7
newAvgUnits	Integer	新品月均销量	26425
newAvgRevenue	Float	新品月均销售额	350209.91
firstShelfDate	String	商品首次上架日期	2014-10-30
lastShelfDate	String	商品最新上架日期	2021-04-28

请求示例

curl 'https://api.sellersprite.com/v1/market/statistics' \

-H 'Content-Type: application/json;charset=UTF-8' \

-H 'secret-key: 你的密钥' \

--data-raw $'{\n "marketplace":"US",\n "nodeIdPath":"1064954:1069242:1069784:1069820:1069838:1069828"\n}' \

--compressed

商品集中度

请求 URL:/v1/market/goods，请求方式 POST

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场 id	见表 1.2	✓
month	String	筛选日期,默认最近30天，最早查询时间为2021年7月份	见表 1.1
asins	List	过滤asin	["B00P19MFYE"]
topN	Integer	头部Listing数量	10
newProduct	Integer	新品定义	6
nodeIdPath	String	节点 id 路径字符串	1064954:1069242:1069784:1069820:1069838:1069828	✓

返回参数

参数名称	参数类型	参数说明	举例
title	String	标题	Pilot G2, Dr. Grip Gel/Ltd, ExecuGel G6, Q7 Rollerball Gel Ink Pen Refills, 0.7mm, Fine Point, Black Ink, 3 Packs of 2
asin	String	asin	B00P19MFYE
asinUrl	String	asin链接	https://www.amazon.com/dp/B00P19MFYE
imageUrl	String	图片链接	https://images-na.ssl-images-amazon.com/images/I/51hxvoxGnjL._AC_US200_.jpg
ranking	Integer	排名	1
brand	String	品牌	PILOT
sellerName	String	卖家名称	JA Wholesale LLC
sellerType	String	卖家类型	FBA
price	Float	价格	6.19
shelfDate	String	上架时间	2014-10-30
ratings	Integer	评分数	5695
reviews	Integer	评论数	133
rating	Float	评论值	4.8
newFlag	Integer	是否新品 1新品，0非新品	0
totalUnits	Integer	总销量	2515
totalRevenue	Float	总销额	18837.35
totalUnitsRatio	Float	总销量占比	0.4478
totalRevenueRatio	Float	总销额占比	0.3052

请求示例

curl 'https://api.sellersprite.com/v1/market/goods' \

-H 'Content-Type: application/json;charset=UTF-8' \

-H 'secret-key: 你的密钥' \

--data-raw $'{\n "marketplace":"US",\n "nodeIdPath":"1064954:1069242:1069784:1069820:1069838:1069828"\n}' \

--compressed

品牌集中度

请求 URL:/v1/market/brand，请求方式 POST

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场 id	见表 1.2	✓
month	String	筛选日期,默认最近30天，最早查询时间为2021年7月份	见表 1.1
topN	Integer	头部Listing数量	10
newProduct	Integer	新品定义	6
nodeIdPath	String	节点 id 路径字符串	1064954:1069242:1069784:1069820:1069838:1069828	✓

响应参数

参数名称	参数类型	参数说明	举例
brand	String	品牌名称	PILOT
ranking	Integer	排名	1
asins	List	包含的商品ASIN集合	["B00P19MFYE"]
products	Integer	商品数量，包含新品	4
newProducts	Integer	新品数量	1
newUnits	Integer	新品销量	45
newRevenue	Float	新品销售额	2342
newUnitsRatio	Float	新品销量占比	4.3
newRevenueRatio	Float	新品销售额占比	4
avgPrice	Float	平均价格	6.19
ratings	Integer	评分数	5695
rating	Float	评分值	4.8
reviews	Integer	评论数	234
totalUnits	Integer	总销量	32342
totalRevenue	Float	总销额	18837.35
totalUnitsRatio	Float	总销量占比	0.4478
totalRevenueRatio	Float	总销额占比	0.3052

请求示例

curl 'https://api.sellersprite.com/v1/market/brand' \

-H 'Content-Type: application/json;charset=UTF-8' \

-H 'secret-key: 你的密钥' \

--data-raw $'{\n "marketplace":"US",\n "nodeIdPath":"1064954:1069242:1069784:1069820:1069838:1069828"\n}' \

--compressed

卖家集中度

请求 URL:/v1/market/seller，请求方式 POST

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场 id	见表 1.2	✓
month	String	筛选日期,默认最近30天，最早查询时间为2021年7月份	见表 1.1
topN	Integer	头部Listing数量	10
newProduct	Integer	新品定义	6
nodeIdPath	String	节点 id 路径字符串	1064954:1069242:1069784:1069820:1069838:1069828	✓

返回参数

参数名称	参数类型	参数说明	举例
name	String	卖家名称	JA Wholesale LLC
ranking	Integer	排名	1
asinSet	List	包含的商品ASIN集合	["B00P19MFYE"]
products	Integer	商品数量，包含新品	4
newProducts	Integer	新品数量	1
newUnits	Integer	新品销量	45
newRevenue	Float	新品销售额	2342
newUnitsRatio	Float	新品销量占比	4.3
newRevenueRatio	Float	新品销售额占比	4
avgPrice	Float	平均价格	6.19
ratings	Integer	评分数	5695
rating	Float	评分值	4.8
reviews	Integer	评论数	234
totalUnits	Integer	总销量	32342
totalRevenue	Float	总销额	18837.35
totalUnitsRatio	Float	总销量占比	0.4478
totalRevenueRatio	Float	总销额占比	0.3052

请求示例

curl 'https://api.sellersprite.com/v1/market/seller' \

-H 'Content-Type: application/json;charset=UTF-8' \

-H 'secret-key: 你的密钥' \

--data-raw $'{\n "marketplace":"US",\n "nodeIdPath":"1064954:1069242:1069784:1069820:1069838:1069828"\n}' \

--compressed

卖家类型分布

请求 URL:/v1/market/seller/type，请求方式 POST

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场 id	见表 1.2	✓
month	String	筛选日期,默认最近30天，最早查询时间为2021年7月份	见表 1.1
topN	Integer	头部Listing数量	10
newProduct	Integer	新品定义	6
nodeIdPath	String	节点 id 路径字符串	1064954:1069242:1069784:1069820:1069838:1069828	✓

响应参数

参数名称	参数类型	参数说明	举例
label	String	类型说明	Amazon自营
asinNum	Integer	ASIN数量	4
asinRatio	Float	ASIN数量占比	0.03
units	Integer	月销量	79875
unitsRatio	Float	月销量占比	0.0345
ratings	Integer	评分数	6607
rating	Float	评分值	4.7
productNum	Integer	商品总数	3

请求示例

curl 'https://api.sellersprite.com/v1/market/seller/type' \

-H 'Content-Type: application/json;charset=UTF-8' \

-H 'secret-key: 你的密钥' \

--data-raw $'{\n "marketplace":"US",\n "nodeIdPath":"1064954:1069242:1069784:1069820:1069838:1069828"\n}' \

--compressed

卖家所属地分布

请求 URL:/v1/market/seller/location，请求方式 POST

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场 id	见表 1.2	✓
month	String	筛选日期,默认最近30天，最早查询时间为2021年7月份	见表 1.1
topN	Integer	头部Listing数量	10
newProduct	Integer	新品定义	6
nodeIdPath	String	节点 id 路径字符串	1064954:1069242:1069784:1069820:1069838:1069828	✓

响应参数

参数名称	参数类型	参数说明	举例
label	String	类型说明	美国
country	String	国家	美国
asins	List	包含的asin列表	["B00P19MFYE"]
products	Integer	产品数	3
revenue	Float	销售额	47492.83
units	Integer	销量	4107
unitsRatio	Float	销量占比	0.7313

请求示例

curl 'https://api.sellersprite.com/v1/market/seller/location' \

-H 'Content-Type: application/json;charset=UTF-8' \

-H 'secret-key: 你的密钥' \

--data-raw $'{\n "marketplace":"US",\n "nodeIdPath":"1064954:1069242:1069784:1069820:1069838:1069828"\n}' \

--compressed

商品需求趋势

请求 URL:/v1/market/performance，请求方式 POST

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场 id	见表 1.2	✓
month	String	筛选日期,默认最近30天，最早查询时间为2021年7月份	见表 1.1
topN	Integer	头部Listing数量	10
newProduct	Integer	新品定义	6
nodeIdPath	String	节点 id 路径字符串	1064954:1069242:1069784:1069820:1069838:1069828	✓

返回参数

参数名称	参数类型	参数说明	举例
asinCount	String	asin数量	22187
returnRatio	String	退货率，百分比	1.38
searchToPurchaseRatio	List	搜索购买比，千分比	3.17875
avgReturnRatio	Integer	类目平均退货率，百分比	2.72
avgSearchToPurchaseRatio	Float	类目平均搜索购买比，千分比	2.6
items	List	月浏览趋势
└date	String	时间，yyyy-MM-dd格式	2022-09-10
└glanceViews	Integer	浏览量	2

请求示例

curl 'https://api.sellersprite.com/v1/market/performance' \

-H 'Content-Type: application/json;charset=UTF-8' \

-H 'secret-key: 你的密钥' \

--data-raw $'{\n "marketplace":"US",\n "nodeIdPath":"1064954:1069242:1069784:1069820:1069838:1069828"\n}' \

--compressed

上架时间分布

请求 URL:/v1/market/shelf/time，请求方式 POST

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场 id	见表 1.2	✓
month	String	筛选日期,默认最近30天，最早查询时间为2021年7月份	见表 1.1
topN	Integer	头部Listing数量	10
newProduct	Integer	新品定义	6
nodeIdPath	String	节点 id 路径字符串	1064954:1069242:1069784:1069820:1069838:1069828	✓

返回参数

参数名称	参数类型	参数说明	举例
label	String	类型说明	3年以上
shelfTime	String	上架时间	3年以上
asins	List	包含的asin列表	["B00P19MFYE"]
products	Integer	产品数	B07Z82895W
revenue	Float	销售额	40846.76
units	Integer	销量	4684
unitsRatio	Float	销量占比	0.834

请求示例

curl 'https://api.sellersprite.com/v1/market/shelf/time' \

-H 'Content-Type: application/json;charset=UTF-8' \

-H 'secret-key: 你的密钥' \

--data-raw $'{\n "marketplace":"US",\n "nodeIdPath":"1064954:1069242:1069784:1069820:1069838:1069828"\n}' \

--compressed

上架趋势分布

请求 URL:/v1/market/shelf/trend，请求方式 POST

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场 id	见表 1.2	✓
month	String	筛选日期,默认最近30天，最早查询时间为2021年7月份	见表 1.1
topN	Integer	头部Listing数量	10
newProduct	Integer	新品定义	6
nodeIdPath	String	节点 id 路径字符串	1064954:1069242:1069784:1069820:1069838:1069828	✓

返回参数

参数名称	参数类型	参数说明	举例
label	String	类型说明	2014
year	String	年份，yyyy格式	2014
asins	List	包含的asin列表	["B00P19MFYE"]
products	Integer	产品数	1
revenue	Float	销售额	2515
units	Integer	销量	18837.35
unitsRatio	Float	销量占比	0.4478

请求示例

curl 'https://api.sellersprite.com/v1/market/shelf/trend' \

-H 'Content-Type: application/json;charset=UTF-8' \

-H 'secret-key: 你的密钥' \

--data-raw $'{\n "marketplace":"US",\n "nodeIdPath":"1064954:1069242:1069784:1069820:1069838:1069828"\n}' \

--compressed

评分数分布

请求 URL:/v1/market/ratings，请求方式 POST

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场 id	见表 1.2	✓
month	String	筛选日期,默认最近30天，最早查询时间为2021年7月份	见表 1.1
topN	Integer	头部Listing数量	10
newProduct	Integer	新品定义	6
nodeIdPath	String	节点 id 路径字符串	1064954:1069242:1069784:1069820:1069838:1069828	✓

返回参数

参数名称	参数类型	参数说明	举例
label	String	类型说明	500以上
asins	List	包含的asin列表	5
products	Integer	产品数	["B00P19MFYE"]
revenue	Float	销售额	61714.24
units	Integer	销量	5616
unitsRatio	Float	销量占比	0.9743

请求示例

curl 'https://api.sellersprite.com/v1/market/ratings' \

-H 'Content-Type: application/json;charset=UTF-8' \

-H 'secret-key: 你的密钥' \

--data-raw $'{\n "marketplace":"US",\n "nodeIdPath":"1064954:1069242:1069784:1069820:1069838:1069828"\n}' \

--compressed

评分值分布

请求 URL:/v1/market/rating，请求方式 POST

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场 id	见表 1.2	✓
month	String	筛选日期,默认最近30天，最早查询时间为2021年7月份	见表 1.1
topN	Integer	头部Listing数量	10
newProduct	Integer	新品定义	6
nodeIdPath	String	节点 id 路径字符串	1064954:1069242:1069784:1069820:1069838:1069828	✓

返回参数

参数名称	参数类型	参数说明	举例
label	String	类型说明	4.5以上
asins	List	包含的asin列表	["B00P19MFYE"]
products	Integer	产品数	5
revenue	Float	销售额	59934.22
units	Integer	销量	5418
unitsRatio	Float	销量占比	0.9647

请求示例

curl 'https://api.sellersprite.com/v1/market/rating' \

-H 'Content-Type: application/json;charset=UTF-8' \

-H 'secret-key: 你的密钥' \

--data-raw $'{\n "marketplace":"US",\n "nodeIdPath":"1064954:1069242:1069784:1069820:1069838:1069828"\n}' \

--compressed

价格分布

请求 URL:/v1/market/price，请求方式 POST

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场 id	见表 1.2	✓
month	String	筛选日期,默认最近30天，最早查询时间为2021年7月份	见表 1.1
topN	Integer	头部Listing数量	10
newProduct	Integer	新品定义	6
nodeIdPath	String	节点 id 路径字符串	1064954:1069242:1069784:1069820:1069838:1069828	✓

返回参数

参数名称	参数类型	参数说明	举例
label	String	类型说明	5-10
asins	List	包含的asin列表	["B00P19MFYE"]
products	Integer	产品数	3
revenue	Float	销售额	33058.76
units	Integer	销量	4024
unitsRatio	Float	销量占比	0.7165

请求示例

curl 'https://api.sellersprite.com/v1/market/price' \

-H 'Content-Type: application/json;charset=UTF-8' \

-H 'secret-key: 你的密钥' \

--data-raw $'{\n "marketplace":"US",\n "nodeIdPath":"1064954:1069242:1069784:1069820:1069838:1069828"\n}' \

--compressed

A+视频分布

请求 URL:/v1/market/ebc，请求方式 POST

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场 id	见表 1.2	✓
month	String	筛选日期,默认最近30天，最早查询时间为2021年7月份	见表 1.1
topN	Integer	头部Listing数量	10
newProduct	Integer	新品定义	6
nodeIdPath	String	节点 id 路径字符串	1064954:1069242:1069784:1069820:1069838:1069828	✓

返回参数

参数名称	参数类型	参数说明	举例
label	String	类型说明	有A+有视频
products	Integer	产品数	1
productsRatio	Float	类目名称产品占比	20
units	Integer	销量	1311
unitsRatio	Float	销量占比	23.34

请求示例

curl 'https://api.sellersprite.com/v1/market/ebc' \

-H 'Content-Type: application/json;charset=UTF-8' \

-H 'secret-key: 你的密钥' \

--data-raw $'{\n "marketplace":"US",\n "nodeIdPath":"1064954:1069242:1069784:1069820:1069838:1069828"\n}' \

--compressed

附录

表 1.1 查询日期

参数值	说明
nearly	最近 30 天
格式为 yyyyMM	具体某一月，代表某一个月的日期

表 1.2 市场

参数值	说明
US	美国站
UK	英国站
DE	德国站
FR	法国站
JP	日本站
CA	加拿大站
IT	意大利
ES	西班牙

参数值	说明
EN	信封装
ST	标准
OS	大件
O	其他尺寸

表 1.3 卖家所属地

参数值	说明
CN	中国
HK	中国香港特区
US	美国
JP	日本
DE	德国
FR	法国

其他国家二字码见链接： http://www.mamicode.com/info-detail-1583748.html

表 1.4 选产品和查竞品排序字段

参数值	说明
total_units	月销量
total_amount	月销售额
bsr_rank	bsr排名
price	价格
rating	评分
reviews	评分数
profit	毛利率
reviews_rate	留评率
available_date	上架时间
questions	Q & A
total_units_growth	月销量增长率
total_amount_growth	月销售额增长率
reviews_increasement	月新增评分数
bsr_rank_cv	近7天BSR增长数
bsr_rank_cr	近7天BSR增长率