卖家精灵对外 API

请求网关

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

DEMO地址

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

注意事项

1、同一查询条件，只支持获取TOP2K的数据，这是底层服务的限制，与WEB端限制一致，

拉取数据时可以考虑按照排名、BSR、搜索量、销量等进行分段获取，来规避这个问题

公共头说明

目前卖家精灵对外开放了选产品和查产品等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	秘钥无效	传递了一个无效的秘钥

可用次数查询

获取到的是当前月份的可用次数，已使用次数=套餐总次数-可用次数

并发每分钟40次，请勿频繁调用(注意：查询前每个模块需先请求1次进行初始化)

curl -XGET 'https://api.sellersprite.com/v1/visits'

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

-H 'content-type: application/json;charset=UTF-8'

选产品

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

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场	见表 1.2	✓
month	String	筛选日期,默认最近30天，最早查询时间当前月份往前推24个月	见表 1.1
keyword	String	关键字	N95
matchType	Integer	匹配方式，1词组匹配 2模糊匹配 3精准匹配；默认2	2
excludeKeywords	String	排除的关键字	portable
minPrice	Float	最低价格	10
maxPrice	Float	最高价格	30
minRating	Float	最低评分值	1.0
maxRating	Float	最高评分值	5.0
minRatings	Integer	最低评分数	1
maxRatings	Integer	最高评分数	90
minRatingsCv	Integer	最低月新增评分数	1
maxRatingsCv	Integer	最高月新增评分数	5
minSellers	Integer	最小卖家数量	3
maxSellers	Integer	最大卖家数量	10
minBsr	Integer	大类 BSR 最高排名	1
maxBsr	Integer	大类 BSR 最低排名	100
minBsrCv	Integer	BSR 最低增长数	3
maxBsrCv	Integer	BSR 最高增长数	5
minBsrCr	Float	BSR 最低增长率	30
maxBsrCr	Float	BSR 最高增长率	60
minUnits	Integer	最低月销量	20
maxUnits	Integer	最高月销量	50
minRevenue	Float	最低月销售额	60
maxRevenue	Float	最高月销售额	200
minRevenueCr	Float	月销售额最低增长率	20
maxRevenueCr	Float	月销售额最高增长率	30
minUnitsCr	Float	月销量最低增长率	20
maxUnitsCr	Float	月销量最高增长率	30
minWeights	Float	最小重量	20
maxWeights	Float	最大重量	30
minVariations	Integer	最低变体数	1
maxVariations	Integer	最高变体数	3
nodeIdPath	String	类目节点字符串	见查产品类目接口
nodeIdPaths	List	类目节点字符串列表	见查产品类目接口
nodeIdPathEqual	boolean	true为类目精确查询 false为查询当前及子类目	默认false
availableMonth	Integer	上架月份	见表 1.3，默认不限制
dimensionType	String	尺寸类型集合,逗号分隔，默认不限制	见表 1.4
minFba	Float	FBA 最低运费	10
maxFba	Float	FBA 最高运费	20
minLqs	Float	最低 Listing 页面质量分	0
maxLqs	Float	最高 Listing 页面质量分	10
sellerNation	String	卖家所属地，默认不限制，多条件查询用逗号隔开	见表 1.5
badgeBS	String	是否有热销标识 Best Seller	Y:是
badgeAC	String	是否有热销标识 Amazon's Choice	Y:是
fulfillment	String	配送方式，多条件查询用逗号隔开	AMZ or FBA or FBM
variation	String	是否查询变体 asin	Y:否 N:是，默认N
page	Integer	页码，从 1 开始	默认：1，总条数限制2000条，可以细分条件拉取整个类目数据
size	Integer	每页条数	默认：50，最大：200
order	Object	排序
└field	String	排序字段	见表1.6
└desc	boolean	true为降序 false为升序	默认降序

返回参数

参数名称	参数类型	参数说明	举例
asin	String	asin	B078J8VPVW
brand	String	品牌	Pampers
brandUrl	String	品牌 URL	https://www.amazon.com/s?k=HP
imageUrl	String	图片 URL	https://images-na.ssl-images-amazon.com/images/I/51axlzme6aL .AC_US200.jpg
title	String	商品标题	Diapers Size 2, 186 Count - Pampers Swaddlers Disposable Baby Diapers, ONE MONTH SUPPLY
parent	String	父体	B081RGNL17
nodeId	Long	节点 id	3741281
nodeIdPath	String	节点 id 路径字符串	2619525011:3741271:3741281
nodeLabelPath	String	类目	Baby Products:Diapering:Disposable Diapers
bsrId	String	BSRid	office-products
bsr	Integer	BSR 排名	1
bsrCr	Float	BSR 增长率	926.67
bsrCv	Integer	BSR 增长数	10
units	Integer	月销量	26289
unitsGr	Float	月销量增长率	-46.3
amzUnit	Integer	子体近30日销量 (仅近30日查询支持)	4000
amzUnitDate	Date	子体销量更新日期	1702476590000
revenue	Float	月销售额	1693537.4
price	Float	价格	64.42
primePrice	Float	prime价格，-1表示没有	56.6
profit	Float	利润率	63.92
fba	Float	fba 运费	13.58
ratings	Integer	评分数	32004
ratingsRate	Float	留评率	40.57
rating	Float	评分	4.8
ratingsCv	Integer	月度增长数	10666
ratingDelta	Integer	留评数：近 30 天新增评论数	0
lqs	Float	listing质量得分
availableDate	Long	上架时间，时间戳格式	1454083200000
fulfillment	String	配送方式	AMZ or FBA or FBM
variations	Integer	变体数	7
sellers	Integer	卖家数	7
sellerId	String	BuyBox 卖家 id	A1Y8BVAASXO4R7
sellerName	String	BuyBox 卖家	Amazon
sellerNation	String	BuyBox 卖家国籍	见表 1.5
badge	Badge	标识	包括了下面 5 个标识
└bestSeller	String	Best Seller 标识	Y 或者 N
└amazonChoice	String	amazon choice 标识	Y 或者 N
└newRelease	String	release 标识	Y 或者 N
└ebc	String	A+页面	Y 或者 N
└video	String	视频介绍	Y 或者 N
weight	String	重量	8.88 pounds
dimension	String	尺寸	13.3 x 15.8 x 10.6 inches
dimensionsType	String	尺寸类型	ST,0V
pkgDimensions	String	包装尺寸	14.3 x 16.8 x 12.6 inches
pkgDimensionType	String	包装尺寸类型
pkgWeight	String	包装重量	18.88 pounds
subcategories	List	子类目
└code	String	类目code	1063242
└rank	Integer	排名	1
└label	String	名称	Bath Rugs
sku	String	sku	["Color: Beige","Size: 47 inches"]
deliveryPrice	Float	卖家运费,-1表示没有	4
primePrice	Float	prime价格，-1表示没有	42

请求示例

curl -XPOST 'https://api.sellersprite.com/v1/product/research' \

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

-H 'content-type: application/json;charset=UTF-8' \

-d '{"marketplace": "US","excludeKeywords":"HP","maxPrice":432}'

查竞品

请求 URL:/v1/product/competitor-lookup，请求方式 POST

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场 id	见表 1.2	✓
month	String	筛选日期,默认最近30天，最早查询时间为当前月份往前推24个月	见表 1.1
brand	String	品牌	WWDOLL
sellerName	String	卖家	Chengde Technology Co.
asins	List	asin 的 list 字符串，最大40	B08MT3JR3F
nodeIdPath	String	类目节点字符串	见查产品类目
nodeIdPathEqual	boolean	true为类目精确查询 false为查询当前及子类目	默认false
keyword	String	关键字	N95
matchType	Integer	匹配方式，1词组匹配 2模糊匹配 3精准匹配；默认2	2
keywordEqual	boolean	关键字模式，true=精确查找，false=模糊查找，默认为true，最多支持200个字符（不建议使用，后续将废弃）	phone stand for desk
variation	String	是否查询变体 asin	Y:否 N:是，默认 N
page	Integer	页码，从 1 开始	默认：1，总条数限制2000条，可以细分条件拉取整个类目数据
size	Integer	每页条数	默认：50，最大: 200
order	Object	排序
└field	String	排序字段	见表1.6
└desc	boolean	true为降序 false为升序	默认降序

返回参数

参数名称	参数类型	参数说明	举例
asin	String	asin	B078J8VPVW
brand	String	品牌	Pampers
brandUrl	String	品牌 URL	https://www.amazon.com/s?k=HP
imageUrl	String	图片 URL	https://images-na.ssl-images-amazon.com/images/I/51axlzme6aL .AC_US200.jpg
title	String	商品标题	Diapers Size 2, 186 Count - Pampers Swaddlers Disposable Baby Diapers, ONE MONTH SUPPLY
parent	String	父体	B081RGNL17
nodeId	Long	节点 id	3741281
nodeIdPath	String	节点 id 路径字符串	2619525011:3741271:3741281
nodeLabelPath	String	类目	Baby Products:Diapering:Disposable Diapers
bsrId	String	BSRid	office-products
bsr	Integer	BSR 排名	1
bsrCr	Float	BSR 增长率	926.67
bsrCv	Integer	BSR 增长数	10
units	Integer	月销量	26289
unitsGr	Float	月销量增长率	-46.3
amzUnit	Integer	子体近30日销量 (仅近30日查询支持)	4000
amzSales	Float	销售额	235000
amzUnitDate	Date	子体销量更新日期	1702476590000
revenue	Float	月销售额	1693537.4
price	Float	价格	64.42
primePrice	Float	prime价格，-1表示没有	56.6
profit	Float	利润率	63.92
fba	Float	fba 运费	13.58
ratings	Integer	评分数	32004
ratingsRate	Float	留评率	40.57
rating	Float	评分	4.8
ratingsCv	Integer	月度增长数	10666
ratingDelta	Integer	留评数：近 30 天新增评论数	0
lqs	Float	listing质量得分
availableDate	Long	上架时间，时间戳格式	1454083200000
fulfillment	String	配送方式	AMZ or FBA or FBM
variations	Integer	变体数	7
sellers	Integer	卖家数	7
sellerId	String	BuyBox 卖家 id	A1Y8BVAASXO4R7
sellerName	String	BuyBox 卖家	Amazon
sellerNation	String	BuyBox 卖家国籍	见表 1.5
badge	Badge	标识	包括了下面 5 个标识
└bestSeller	String	Best Seller 标识	Y 或者 N
└amazonChoice	String	amazon choice 标识	Y 或者 N
└newRelease	String	release 标识	Y 或者 N
└ebc	String	A+页面	Y 或者 N
└video	String	视频介绍	Y 或者 N
weight	String	重量	8.88 pounds
dimension	String	尺寸	13.3 x 15.8 x 10.6 inches
dimensionsType	String	尺寸类型	ST,0V
pkgDimensions	String	包装尺寸	14.3 x 16.8 x 12.6 inches
pkgDimensionType	String	包装尺寸类型
pkgWeight	String	包装重量	18.88 pounds
sku	String	sku	["Color: Beige","Size: 47 inches"]
subcategories	List	子类目
└code	String	类目code	1063242
└rank	Integer	排名	1
└label	String	名称	Bath Rugs
deliveryPrice	Float	卖家运费,-1表示没有	4
primePrice	Float	prime价格，-1表示没有	42

请求示例

curl -XPOST 'https://api.sellersprite.com/v1/product/competitor-lookup' \

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

-H 'content-type: application/json;charset=UTF-8' \

-d '{"marketplace": "US","brand":"Gorilla Grip"}'

查产品类目

请求 URL:/v1/product/node，请求方式 GET

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场	见表 1.2	✓
nodeIdPath	String	类目节点 id 字符串	2619525011:3741271:3741281
keyword	String	搜索关键字，nodeId或类目名称	Books 或者 4053
month	String	查询历史月份类目，格式yyyyMM	202502

返回参数

参数名称	参数类型	参数说明	举例
nodeIdPath	String	类目 id 字符串，即 nodeIdPath	2619525011:3741271
nodeLabelPath	String	类目名称	Appliances:Dishwashers
products	Integer	类目下产品数	42
nodeLabelLocale	String	类目节点名称中文	洗碗机
nodeLabelPathLocale	String	类目所属所有节点名称中文	大家电:洗碗机

请求示例

curl 'https://api.sellersprite.com/v1/product/node?marketplace=US&nodeIdPath=2619525011' \

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

-H 'content-type: application/json;charset=utf-8' \

--compressed

类目大数据统计(废弃)

使用场景

包含整个市场视角下月度及年度的根类目及末级类目的销售额、销量、评分、卖家数量、客单价等，以及同比和环比情况；包含商品数、品牌数、浏览量、退货率、搜索购买比、最早/最晚上架时间，top10/top100/top500的新品及商品信息。

1、选市场，市场容量、竞争、趋势分析

2、类目（品类）的数据中台构建

3、各类类目大盘的分析报表、报告

注意：价格及销售额的货币单位为站点对应的的货币，各站点货币单位见表 1.2 市场

接口地址:/v1/node/page

请求方式：POST

请求参数

参数名称	参数类型	参数说明	举例	是否必须
marketplace	String	市场	见表 1.2	✓
date	String	历史日期	202201 月度 2022 年度	✓
nodeIdPath	String	类目节点 id 字符串(仅首级和末级类目)	2619525011:3741271	✓
page	Integer	页码，从 1 开始	默认：1
size	Integer	每页条数	默认：50

响应参数

参数名称	参数类型	参数说明	举例
date	String	日期	202201
marketplace	String	市场,见表 1.2	US
nodeId	String	类目id	3741281
nodeLabel	String	类目标签	Built-In Dishwashers
nodeIdPath	String	类目id路径	2619525011:3741271:3741281
nodeIdPathLabel	String	类目标签路径	Appliances:Dishwashers:Built-In Dishwashers
nodeLabelCn	String	类目标签翻译	家电
nodePathLabelCn	String	类目标签路径翻译	家电:洗碗机:嵌入式洗碗机
rootNodeId	String	根类目id	2619525011
rootNodeLabel	String	根类目标签	Appliances
totalAmount	Float	总销售额	199633
totalUnits	Integer	总销量	545
totalRatings	Float	总评分数	234562
sellerCount	Integer	卖家数量	34
avgPrice	Float	客单价	323.12
amountRate	Float	销售额占比（占上一级类目）	36.14
unitsRate	Float	销量占比（占上一级类目）	43.65
amountQoq	Float	销售额环比	4.5
amountYoy	Float	销售额同比	1.34
unitQoq	Float	销量环比	3.21
unitYoy	Float	销量同比	1.6
priceQoq	Float	客单价环比	1.32
priceYoy	Float	客单价同比	4.4
goodsCountQoq	Float	商品数量环比	2.7
goodsCountYoy	Float	商品数量同比	3.8
goodsCount	Float	商品数量	4345
brandCount	Integer	品牌数量	342
glanceView	Long	类目浏览量	17910
returnRate	Float	类目退货率	3.4
avgReturnRate	Float	退货率同类目均值	2.6
searchToPurchaseRate	Float	搜索购买比	1.2
avgSearchToPurchaseRate	Float	搜索购买比类目均值	1.1
firstAvailableDate	Date	最早上架时间	2012-11-1
lastAvailableDate	Date	最晚上架时间	2022-09-1
goodsTypeTop100	GoodsType	top100商品分类信息	字段信息见下表
goodsTypeTop500	GoodsType	top500商品分类信息	字段信息见下表
sellerLocals	List<SellerLocal>	卖家地域统计(取top500的)	字段信息见下表
newProductTop10	NewProduct	top10新品信息	字段信息见下表
newProductTop100	NewProduct	top100新品信息	字段信息见下表
newProductTop500	NewProduct	top500新品信息	字段信息见下表
top10	TopProduct	top10商品信息	字段信息见下表
top100	TopProduct	top100商品信息	字段信息见下表
top500	TopProduct	top500商品信息	字段信息见下表

GoodsType结构：

参数名称	参数类型	参数说明	举例
goodsFocusRate	Float	商品集中度	95
sellerFocusRate	Float	卖家集中度	94
brandFocusRate	Float	品牌集中度	92
amzSellerRate	Float	卖家AMZ占比	73
fbaSellerRate	Float	卖家FBA占比	42
fbmSellerRate	Float	卖家FBM占比	71
ebcRate	Float	A+占比	42.1
videoRate	Float	视频占比	34
fbaGoodsCount	Integer	FBA商品数	455
fbmGoodsCount	Integer	FBM商品数	421
amzGoodsCount	Integer	AMZ自营商品数	453
ebcGoodsCount	Integer	A+商品数	23
videoGoodsCount	Integer	视频商品数量	54
fbaUnits	Integer	FBA销量	23
fbmUnits	Integer	FBM销量	53223
amzUnits	Integer	AMZ销量	34512
ebcUnits	Integer	A+销量	23451
videoUnits	Integer	视频销量	2344
fbaAmount	Float	FBA销售额	456342
amzAmount	Float	AMZ销售额	23423
fbmAmount	Float	FBM销售额	23423
ebcAmount	Float	A+销售额	234
videoAmount	Float	视频销售	345
ebcVideo	Integer	有视频有A+商品数量	23
ebcNotVideo	Integer	无视频有A+商品数量	54
notEbcVideo	Integer	有视频无A+商品数量	42
notEbcNotVideo	Integer	无视频无A+商品数量	21

SellerLocal结构：

参数名称	参数类型	参数说明	举例
nation	String	所属国家	CN
totalAmount	Float	总销售额	43534
totalUnits	Integer	总销量	4243
unitRate	Float	销量占比	65
amountRate	Float	总销售额	2345
goodsCount	Integer	商品数量	454

NewProduct结构：

参数名称	参数类型	参数说明	举例
newProductRate	Float	新品占率	0.14
TopProduct	TopProduct	余下字段同TopProduct一致

TopProduct结构：

参数名称	参数类型	参数说明	举例
asinCount	Integer	包含的asin数量	123
maxBsr	Integer	最大BSR	234534
minBsr	Integer	最小BSR	32
avgBsr	String	平均BSR	3564
maxVariations	Integer	最大变体数	34
minVariations	Integer	最小变体数	4
avgVariations	Float	平均变体数	11.2
sumVariations	Integer	总的变体数	567
maxFba	Float	最大FBA	5676
minFba	Float	最小FBA	456
avgFba	Float	平均FBA	2345
sumFba	Float	总的FBA	67784
maxSellers	Integer	最大卖家数	22
minSellers	Integer	最小卖家数	4
avgSellers	Float	平均卖家数	9.8
sumSellers	Integer	总的卖家数	674
maxUnits	Integer	最大销量	5674
minUnits	Integer	最小销量	76
avgUnits	Float	平均销量	545
sumUnits	Integer	总的销量	67845
maxAmount	Float	最大销售额	678678
minAmount	Float	最小销售额	678
avgAmount	Float	平均销售额	7653
sumAmount	Float	总的销售额	787908
maxPrice	Float	最高价格	456
minPrice	Float	最低价格	356
avgPrice	Float	平均价格	402.1
sumPrice	Float	总的价格	67867
maxLqs	Float	最大质量得分	9.5
minLqs	Float	最小质量得分	6.2
avgLqs	Float	平均质量得分	7.9
maxRating	Float	最大评分值	4.8
minRating	Float	最小评分值	3.2
avgRating	Float	平均评分值	4.2
maxRatings	Integer	最大评分数	2344
minRatings	Integer	最小评分数	52
avgRatings	Float	平均评分数	442
sumRatings	Integer	总的评分数	7654
maxQuestion	Integer	最大QA	45
minQuestion	Integer	最小QA	8
avgQuestion	Float	平均QA	12.3
sumQuestion	Integer	总的QA	657
maxAvailableDate	Date	最早上架时间	2008-09-06
minAvailableDate	FloatDate	最晚上架时间	2018-06-09
maxAvailableDays	Integer	最大上架时间	1254
minAvailableDays	Integer	最小上架时间	434
avgAvailableDays	Float	平均上架时间	654
maxWeight	Float	最大重量	1243
minWeight	Float	最小重量	125
avgWeight	Float	平均重量	234
maxDimensions	Float	最大体积	4321
maxDimensionsStr	String	最大体积字符串	22.4 x 17.6 x 32.5 inches
minDimensions	Float	最小体积	1234
minDimensionsStr	String	最小体积字符串	12.4 x 17.6 x 22.5 inches
avgDimensions	Float	平均体积	4342
maxProfitRate	Float	最大利润率	67
minProfitRate	Float	最小利润率	45
avgProfitRate	Float	平均利润率	56

请求示例

curl 'https://api.sellersprite.com/v1/node/page' \

-H 'Content-Type: application/json' \

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

-d '{"date": '202301',"marketplace": "US","nodeIdPath":"165793011:166333011"}'

最佳实践

1、配合查产品类目(免费)获取到感兴趣的类目节点的id(nodeIdPath)

2、如果想获取某一类目下的所有末级类目，则使用如下方式查询(例如:Toys & Games)

接口地址：/v1/node/final/query

请求方式：POST

请求参数

参数名称	参数类型	参数说明	举例	是否必须
market	String	市场	见表 1.2	✓
nodeId	String	需查询的父类目ID	165793011	与nodeLabel 不能同时为空
nodeLabel	String	需查询的父类目	Toys & Games	与nodeId 不能同时为

响应参数

参数名称

参数类型

参数说明

举例

market

String

市场,见表 1.2

nodes

Array<FinalNode>

关键词挖掘

接口地址:/v1/keyword/miner

请求方式：POST

请求参数

参数名称	参数类型	参数说明	举例	是否必须
marketplace	String	市场	见表 1.2	✓
historyDate	String	历史日期，yyyyMM格式，最近30天不传或传空字符串	202201
keyword	String	关键词		✓
keywordList	List	批量查询关键词	["phone stand"]
minSearch	Integer	最小搜索量	543
maxSearch	Integer	最大搜索量	23453
minPurchases	Integer	最小购买量	6
maxPurchases	Integer	最大购买量	34
minPurchasesRate	Float	最小购买率	3
maxPurchasesRate	Float	最大购买率	43
minSPR	Integer	最小SPR	2
maxSPR	Integer	最大SPR	16
minTitleDensity	Integer	最小标题密度	2
maxTitleDensity	Integer	最大标题密度	23
minRelevancy	Float	最小相关度	23，最小0
maxRelevancy	Float	最大相关度	90，最大100
minSearchRank	Integer	最小搜索排名	33
maxSearchRank	Integer	最大搜索排名	3223
minProducts	Integer	最小商品数	54
maxProducts	Integer	最大商品数	324
minSupplyDemandRatio	Float	最小供需比	11.2
maxSupplyDemandRatio	Float	最大供需比	45.2
minAdProducts	Integer	最小广告竞品数	123
maxAdProducts	Integer	最大广告竞品数	345
minWordCount	Integer	最小单词个数	2
maxWordCount	Integer	最大单词个数	4
minMonopolyClickRate	Float	最小点击集中度	23.4
maxMonopolyClickRate	Float	最大点击集中度	53.1
minBid	Float	最小ppc竞价	10.2
maxBid	Float	最大ppc竞价	23.1
minPrice	Float	最小均价	43.3
maxPrice	Float	最大均价	234.2
minRatings	Integer	最小评分数	100
maxRatings	Integer	最大评分数	399
minRating	Float	最小评分值	3.0
maxRating	Float	最大评分值	4.9
amazonChoice	Boolean	亚马逊推荐词	true
filterRootWord	Integer	过滤词根 0包含所有 1只包含词根	0
includeKeywords	List	包含的词	["phone stand"]
excludeKeywords	List	排除的词	["phone stand"]
page	Integer	页码，从 1 开始	默认：1
size	Integer	每页条数	默认：50
order	Object	排序
└field	String	排序字段，加入筛序条件之后，不能以相关度排序	见表2.4
└desc	boolean	true为降序 false为升序	默认降序

响应参数

参数名称	参数类型	参数说明	举例
marketplace	String	市场，见表 1.2	US
keyword	String	关键词	phone stand for recording
keywordCn	String	关键词中文翻译	用于录音的电话支架
keywordJp	String	关键词英文翻译	録音用電話スタンド
departments	List	类目
└code	String	类目代码	electronics
└label	String	类目名称	Electronics
month	String	搜索月份	2022.01
supplement	String	是否属于补充关键词（无当前月搜索量）	N
searches	Integer	搜索量	21582
purchases	Integer	月购买量	1996
purchaseRate	Float	月购买率	0.0925
monopolyClickRate	Float	点击垄断率	0.3
products	Integer	商品数	1645
adProducts	Integer	广告竞品数	34
supplyDemandRatio	Float	供需比	13.12
avgPrice	Float	平均价格	36.14
avgRatings	Integer	平均评分数	12223
avgRating	Float	平均评分值	4.5
bidMin	Float	最小PPC价格	1.34
bidMax	Float	最大PPC价格	3.21
bid	Float	PPC价格	1.6
cvsShareRate	Float	转化共享率	0.3084
wordCount	Integer	单词个数	4
titleDensity	Integer	标题密度	42.9
spr	Integer	SPR	6
relevancy	Double	相关度	28.6
amazonChoice	Boolean	亚马逊推荐词 true是的 false不是	false
searchRank	Integer	搜索排名	17910

请求示例

curl 'https://api.sellersprite.com/v1/keyword/miner' \

-H 'Content-Type: application/json' \

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

--data-raw '{"desc": true,"keyword":"phone stand","marketplace": "US","amazonChoice":false,"page": 1,"size":100,"order":{"field":"searches","desc":false}}'

--compressed

关键词反查(流量词列表)

1.请求 URL：/v1/traffic/keyword，请求方式 POST

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场,见表1.2	US	✓
asin	String	asin	B07Z82895W	✓
keyword	String	关键词	phone stand
month	String	历史月份，不传默认最近30天	202308
badges	List	流量词类型	见表1.10
trafficKeywordTypes	List	流量占比类型	见表2.0
conversionKeywordTypes	List	流量转化类型	见表2.1
page	Integer	当前页	默认1	否
size	Integer	每页显示多少条	默认200，最大200，最多查询2000条数据	否
order	Object	排序
└field	String	排序字段	见表2.3
└desc	Boolean	是否倒序	false

返回参数

参数名称	参数类型	参数说明	举例
marketplace	String	市场	US
asin	String	asin	B07Z82895W
total	Integer	总条数	2685
items	List	词条	1848
└keywords	String	关键词	phone stand
└keywordCn	String	关键词中文翻译	手机支架
└searches	Integer	搜索量	10
└products	Integer	商品数	10
└purchases	Integer	购买量	10000
└purchaseRate	Float	购买率	0.5
└bid	Float	PPC竞价	2.9
└bidMax	Float	PPC竞价范围
└bidMin	Float	PPC竞价范围
└badges	List	曝光位置	见表1.9
└rankPosition	RankPosition	自然排名
└└page	Integer	第几页	3
└└pageSize	Integer	每页多少条数据	60
└└index	Integer	当前页排第几	10
└└position	Integer	总结果中排第几	106
└└updatedTime	long	排名时间
└adPosition	AdPosition	广告排名
└└page	Integer	第几页	2
└└pageSize	Integer	每页多少条数据	63
└└index	Integer	当前页排第几	37
└└position	Integer	总结果中排第几	85
└└updatedTime	long	排名时间
└searchesRank	Integer	周搜索量排名	25
└searchesRankTimeFrom	Long	周搜索量排名时间范围
└searchesRankTimeTo	Long
└latest1daysAds	Integer	最近1天广告竞品数	70
└latest7daysAds	Integer	最近7天广告竞品数	100
└latest30daysAds	Integer	最近30天广告竞品数	280
└supplyDemandRatio	Float	供需比	3.8
└trafficPercentage	Float	流量占比	0.015
└trafficKeywordType	String	流量占比类型	见表2.0
└conversionKeywordType	String	转换效果类型	见表2.1
└calculatedWeeklySearches	Float	预估周搜索量	40
└updatedTime	Long	更新时间
clicks	Integer	点击量	7032
impressions	Long	展示量	356751
stats	List	高频词
└keywords	String	词	phone
└total	Integer	总条数	90

请求示例

curl 'https://api.sellersprite.com/v1/traffic/keyword' \

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

-H 'content-type: application/json;charset=UTF-8' \

--data-raw $'{"marketplace":"US","asin":"B07Z82895W"}' \

--compressed

出单词反查

接口地址:/v1/keyword-order

请求方式：POST

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场,见表1.2	US	✓
asins	List	asin列表，最大20	B07Z82895W	✓
reverseType	String	反查模式 W-周 M-月	W	✓
date	String	查询日期，按周查，格式为yyyMMdd该周最后一天，按月查询yyyyMM	周：20241109 月：202411
conversionType	List	转化类型：E：转化优质词，S：转化平稳词，L：转化流失词，I：无效曝光词	E
variation	List	是否查询变体asin：Y:否 N:是	Y
page	Integer	当前页	默认1
size	Integer	每页显示多少条	固定50
order	Object	排序
└field	String	排序字段	见表2.6
└desc	Boolean	是否倒序	false

响应参数

参数名称	参数类型	参数说明	举例
marketplace	String	市场，见表 1.2	US
keyword	String	关键词	phone stand for recording
keywordCn	String	关键词中文翻译	用于录音的电话支架
keywordJp	String	关键词英文翻译	録音用電話スタンド
asin	String	所属asin	B0D1FZW65X
searches	Integer	搜索量	21582
monopolyClickRate	Float	点击垄断率	0.3
cvsShareRate	Float	转化共享率	0.3084
searchRank	Integer	搜索排名	17910
searchRankGv	Integer	月变化量	5343
searchRankGr	Double	月变化率	0.3
top3ClickingRate	Float	前三点击	0.0813
top3ConversionRate	Float	前三转化	0.2011
conversionType	String	转化类型：E：转化优质词，S：转化平稳词，L：转化流失词，I：无效曝光词	E

请求示例

curl 'https://api.sellersprite.com/v1/keyword-order' \

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

-H 'content-type: application/json;charset=UTF-8' \

--data-raw $'{"marketplace":"US","asins":["B07Z82895W"],"date": "20241228","reverseType": "W"}' \

--compressed

商品趋势详情(keepa)

使用场景

主要用于获取商品的近实时信息，包含上架时间开始到当前的所有历史趋势等，可用于分析ASIN的经营历史。

包含的商品信息如下：

asin、父体 asin、变体 asin列表、大类目ID、大类目、大类排名ID、上架类目全路径ID、

上架类目全路径、商品状态、亚马逊跟卖状态、标题、品牌、asin 链接、品牌链接、销售排名链接、缩放图片链接(缩略图)、商品图片列表(原图)、尺寸、重量、打包体积、打包重量、FBA费用、FBA费用项明细、商品所在页数、商品所在页数排名

包含的趋势信息如下：

排名大类变动历史、新品价格趋势、成交价趋势、购物车趋势、黄金购物车卖家ID变动趋势、

大类BSR趋势、小类排名趋势、评分数趋势、评分趋势、卖家数趋势

注意：返回值为-1时，表示为没有该值，可自行根据业务需求进行删除、填充为空值(null)、填充为上一时间节点值等操作。

接口地址:/v1/keepa/{marketplace}/{asin}

请求方式：GET

请求参数

参数名称	参数类型	参数说明	举例	是否必须
marketplace	String	市场	见表 1.2	✓
asin	String	asin	B08GHW4TBS	✓

响应参数

参数名称	参数类型	参数说明	举例
marketplace	String	市场	见表 1.2
asin	String	asin	B07V34QQ3C
dataAsin	String	实际返回Keepa数据的ASIN	B07V34QQ3C
parentAsin	String	父体ASIN	B0CWW9N7QW
variationAsins	List<String>	变体ASIN列表	["B0CN2PBVNS","B0BT4PMNY4","B0C6FYKC3D","B0CSLMG2TF","B0CGGPC6G3","B0BXG8L46Y","B0CRSZGN9L","B07V34QQ3C"]
rootCategory	String	BSR大类节点ID	172282
rootCategoryLabel	String	跟类目	Electronics
salesRankReference	String	排名节点ID	541966
salesRankReferenceHistory	List<PairStrDto>	排名节点变动历史	PairStrDto 趋势字符串数据结构
nodeIdPath	String	上架类目全路径	172282:541966:13896617011:565098:13896597011
nodeLabelPath	String	上架类目名称全路径	Electronics:Computers & Accessories:Computers & Tablets:Desktops:Towers
productStatus	String	商品状态	STANDARD:everything accessible DOWNLOADABLE:no marketplace/3rd party price data EBOOK:no price data and sales rank accessible INACCESSIBLE:no data accessible INVALID:invalid or deprecated asin VARIATION_PARENT:product is a parent ASIN UNKNOWN:null of status
availabilityAmazon	String	亚马逊跟卖转态	-1
title	String	标题	iBUYPOWER Gaming PC Computer Desktop Element 9260 (Intel Core i7-9700F 3.0Ghz, NVIDIA GeForce GTX 1660 Ti 6GB, 16GB DDR4, 240GB SSD, 1TB HDD, Wi-Fi & Windows 10 Home) Black
brand	String	品牌	iBUYPOWER
asinUrl	String	ASIN链接	https://www.amazon.com/dp/B07V34QQ3C
brandUrl	String	品牌链接	https://www.amazon.com/s?k=iBUYPOWER
salesRankUrl	String	销售排名链接	https://www.amazon.com/b/?node=541966
imageUrl	String	商品缩略图200*200	https://images-na.ssl-images-amazon.com/images/I/711nEj5l5SL._AC_US200_.jpg
zoomImageUrl	String	商品大图 600*600	https://images-na.ssl-images-amazon.com/images/I/711nEj5l5SL._AC_US600_.jpg
imageUrls	List<String>	商品图片列表	[ "https://images-na.ssl-images-amazon.com/images/I/711nEj5l5SL._AC_US200_.jpg", "https://images-na.ssl-images-amazon.com/images/I/61bpfnvHjqL._AC_US200_.jpg", ...... ]
dimensions	String	净尺寸	97
weight	String	净重量	1063280
weightGram	Integer	净重数值单位统一为：克(g)	1055398:1063252:1063280
pkgDimensions	String	打包尺寸	22 x 19.9 x 12.4 inches
pkgDimensionsSize	List<Integer>	打包尺寸长/宽/高单位统一为：厘米(cm)	[558,506,316]
pkgWeight	String	打包重量	0.11 pounds
pkgWeightGram	Integer	打包重量数值单位统一为：克(g)	13660
fbaFees	Float	FBA总费用	26.11
fbaItems	String	FBA费用项明细JSON串，包含：仓储费，仓储费税，运送打包费，运送打包费税	"{\"pickAndPackFeeTax\":0,\"storageFee\":0,\"storageFeeTax\":0,\"pickAndPackFee\":26.11}"
numberOfPages	Integer	在第几页	-1
numberOfItems	Integer	在第几个	1
price	List<PairNumberDto>	价格趋势	见 PairNumberDto 趋势数字数据结构
dealPrice	List<PairNumberDto>	成交价趋势	见 PairNumberDto 趋势数字数据结构
buyBox	List<PairNumberDto>	黄金购物车价格趋势	见 PairNumberDto 趋势数字数据结构
buyBoxSellerIdHistory	List<PairStrDto>	黄金购物车卖家Id历史趋势	PairStrDto 趋势字符串数据结构
bsr	List<PairNumberDto>	大类BSR排名历史趋势	见 PairNumberDto 趋势数字数据结构
subSalesRank	List<SubRankTrendDto>	小类排名趋势数据	见 SubRankTrendDto 小类排名趋势
reviews	List<PairNumberDto>	评分数趋势数据	见 PairNumberDto 趋势数字数据结构


rating	List<PairNumberDto>	评分值趋势数据	见 PairNumberDto 趋势数字数据结构
sellers	List<PairNumberDto>	卖家数趋势数据	见 PairNumberDto 趋势数字数据结构

PairNumberDto 趋势数字数据结构

参数名称

参数类型

参数说明

举例

timePoint

Long

时间戳

1585476240000

value

Number

数值类型，根据值场景转化为整形和浮点型

172282

-1

1398.99

PairStrDto 趋势字符串数据结构

参数名称

参数类型

参数说明

举例

timePoint

Long

时间戳

1585476240000

value

String

卖家ID、排名等

ATVPDKIKX0DER

-1

172282

SubRankTrendDto 小类排名趋势

参数名称	参数类型	参数说明	举例
nodeId	String	小类ID	13896597011
node	String	小类	Towers
ranks	List<PairNumberDto>	小类排名趋势	见 PairNumberDto 趋势数字数据结构

请求示例

curl 'https://api.sellersprite.com/v1/keepa/US/B07V34QQ3C' \

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

-H 'content-type: application/json;charset=utf-8' \

--compressed

查询 asin 详情

接口地址:/v1/asin/{marketplace}/{asin}

请求方式：GET

请求参数

参数名称	参数类型	参数说明	举例	是否必须
marketplace	String	市场	见表 1.2	✓
asin	String	asin	B08GHW4TBS	✓

响应参数

参数名称	参数类型	参数说明	举例
asin	String	asin	B08GHW4TBS
asinUrl	String	asin url	https://www.amazon.com/dp/B08GHW4TBS
availableDate	Long	上架日期	1609059137000
badge	Badge	标识	包括了下面 5 个标识
└bestSeller	String	Best Seller 标识	Y 或者 N
└amazonChoice	String	amazon choice 标识	Y 或者 N
└newRelease	String	release 标识	Y 或者 N
└ebc	String	A+页面	Y 或者 N
└video	String	视频介绍	Y 或者 N
brand	String	品牌	mermaker
brandUrl	String	品牌 URL	/stores/Mermaker/page/984A6448-1C68-4CCA-AD5A-D574EA2D65D5?ref_=ast_bln
bsrId	String	bsr id	home-garden
bsrLabel	String	bsr 标签	Home & Kitchen
bsrRank	Integer	bsr 排名	1006
createdTime	Long	创建时间	1606467137000
dimensions	String	尺寸	7 x 6 x 0.6 inches
firstRatingDate	Long	第一次评论时间	1609059137000
imageUrl	String	图片链接	https://images-na.ssl-images-amazon.com/images/I/412616zl5YL .AC_US200.jpg
lqs	Integer	Listing 页面质量得分	97
nodeId	String	节点 id	1063280
nodeIdPath	String	节点 id 串	1055398:1063252:1063280
nodeLabelPath	String	类目名称串	Home & Kitchen:Bedding:Blankets & Throws
nodeLabelPathLocale	String	类目名称串中文	家居厨房用品:床上用品:毯子、盖毯
parent	String	父 asin	B07V5GB9B5
price	Float	价格	21.99
questions	Integer	问题数量	5
rating	Float	评分	4.8
ratings	Integer	评分数	29229
reviews	Integer	评论数	9229
variantRatings	Integer	子体评分数	12454
variantReviews	Integer	子体评论数	3211
sellerId	String	卖家 id	A13AJ1GXFINAZ
sellerName	String	卖家名称	Mermaker
fulfillment	String	配送方式	FBA
sellers	Integer	卖家数	1
skuList	List	sku	["Color: Beige","Size: 47 inches"]
marketplace	String	String	见表 1.2
title	String	标题	mermaker Burritos Tortilla Blanket 2.0 Double Sided 47 inches for Adult and Kids,Giant Funny Realistic Food Throw Blanket,285 GSM Novelty Soft Flannel Taco Blanket (Yellow Blanket-Double Sided)


features	List	五点描述
overviews	String	详情，json格式字符串
updatedTime	Long	更新时间	1609059137000
variationList	List	变体	[{"asin":"B07V5GB9B5","attribute":"Beige"},{"asin":"B08H86SSSF","attribute":"Cookie"}]
variations	Integer	变体数量	14
weight	String	重量	15.2 ounces
zoomImageUrl	String	大图 URL	https://images-na.ssl-images-amazon.com/images/I/412616zl5YL .AC_US600.jpg
subcategories	Object	子类目信息
└rank	Integer	子类目排名	1
└code	String	子类目code	17874234011
└label	String	子类目标签	Kids' Throw Blankets
deliveryPrice	Float	卖家运费,-1表示没有	4
primePrice	Float	prime价格，-1表示没有	42
coupon	String	优惠卷	[save $20]

请求示例

curl 'https://api.sellersprite.com/v1/asin/US/B07V34QQ3C' \

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

-H 'content-type: application/json;charset=utf-8' \

--compressed

谷歌趋势

接口地址:/v1/google/trends

请求方式：GET

请求参数

参数名称	参数类型	参数说明	举例	是否必须
marketplace	String	市场	见表 1.2	✓
keyword	String	关键字	iphone stand	✓
googleProp	String	类别	web:google网页搜索 shoppingCart:google购物搜索
monthly	boolean	按照月份	false（默认值）

响应参数

参数名称	参数类型	参数说明	举例
marketplace	String	市场，见表 1.2	US
keyword	String	关键字	phone stand
link	String	google trend链接
items	List	明细
└time	Long	时间戳	1555804800000
└value	Integer	值	2

请求示例

curl 'https://api.sellersprite.com/v1/google/trends?googleProp=web&keyword=iphone%20stand&marketplace=US&monthly=true' \

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

-H 'content-type: application/json;charset=utf-8' \

--compressed

关键词选品

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

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场	见表 1.2	✓
month	String	筛选日期,yyyyMM格式，支持近24个月的	202203
departments	List	查询类目，见关键词选品类目接口，传递code	["automotive","baby-products"]
keywords	String	关键词	N95
excludeKeywords	String	排除的关键字	portable
minSearches	Integer	最小月搜索量	100
maxSearches	Integer	最大月搜索量	300
minSearchesCr	Float	最小月搜索量增长率	10.0
maxSearchesCr	Float	最大月搜索量增长率	50.8
minProducts	Integer	最小商品数	10
maxProducts	Integer	最大商品数	90
minPurchases	Integer	最小购买量	100
maxPurchases	Integer	最大购买量	500
minPurchaseRate	Float	最小购买率	3.2
maxPurchaseRate	Float	最大购买率	10.5
withYearlyGrowth	Boolean	新细分市场	false
minSearchMonthCv	Integer	最小月搜索量同比增长值	1000
maxSearchMonthCv	Integer	最大月搜索量同比增长值	3000
minSearchMonthCr	Float	最小月搜索量同比增长率	5.3
maxSearchMonthCr	Float	最大月搜索量同比增长率	30.1
minSearchNearlyCv	Integer	最小月搜索量近3个月增长值	6000
maxSearchNearlyCv	Integer	最大月搜索量近3个月增长值	20000
minSearchNearlyCr	Float	最小月搜索量近3个月增长率	10.3
maxSearchNearlyCr	Float	最大月搜索量近3个月增长率	20.4
marketPeriod	String	市场周期	见表1.7
minAvgPrice	Float	最小均价	20.0
maxAvgPrice	Float	最大均价	30.3
minRatings	Integer	最小评分数	2000
maxRatings	Integer	最大评分数	3000
minRating	Float	最小评分值	3.2
maxRating	Float	最大评分值	4.1
minBid	Float	最小PPC竞价	6.2
maxBid	Float	最大PPC竞价	10.6
minAraClickRate	Float	最小点击集中度	20.1
maxAraClickRate	Float	最大点击集中度	56.4
minGoodsValue	Float	最小货流值	10.1
maxGoodsValue	Float	最大货流值	41.1
minSupplyDemandRatio	Float	最小供需比	5.6
maxSupplyDemandRatio	Float	最大供需比	10.4
minWordCount	Integer	最小单词个数	1
maxWordCount	Integer	最大单词个数	3
page	Integer	页码，从 1 开始	默认：1
size	Integer	每页条数，默认15	最大：15
order	Object	排序
└field	String	排序字段	见表1.8
└desc	boolean	true为降序 false为升序	默认降序

返回参数

参数名称	参数类型	参数说明	举例
marketplace	String	市场	US
keywords	String	关键词	polaroid cameras
searches	Integer	搜索量	141356
purchases	Integer	月购买量	4029
growth	Float	增长率	-25.482092
purchaseRate	Float	月购买率	0.0285
products	Integer	产品数	173
supplyDemandRatio	Float	供需比	817.09
searchDepartments	List	类目
└code	String	类目代码	electronics
└label	String	类目名称	Electronics
└total	Integer	类目总计	141356
└ratio	Float	类目占比	1.0
month	String	查询月份	2022.01
supplement	String	是否属于补充关键词	N
searchMonthlyCv	Integer	关键词同比增长	139749
searchMonthlyCr	Float	关键词同比增长率	8696.27
searchNearlyCv	Integer	关键词近3个月增长值	-48338
searchNearlyCr	Float	关键词近3个月增长率	-25.48
currency	String	货币	$
avgPrice	Float	平均价格	116.24
avgRatings	Integer	平均评分数	2584
avgRating	Float	平均评论数	4.5
relationAsinList	List	关键词关联asin	4.8
└asin	String	asin	B06WW64YM6
└imageUrl	String	图片地址	https://m.media-amazon.com/images/I/817aVWYpblL._AC_UY218_.jpg
└price	Float	价格	59.95
└ratings	Integer	评分数	20115
└rating	Float	评分	4.7
bidMin	Float	bid最小价格	0.987
bidMax	Float	bid最大价格	2.54
bid	Float	bid价格	1.26
araClickRate	Float	点击垄断率	0.2633
araShareRate	Float	共享转化率	0.2633
araAsinList	List	点击前三ASIN
└asin	String	asin	B099VDRGG1
└title	String	title	Fujifilm Instax Mini 9
└imageUrl	String	图片	https://m.media-amazon.com/images/I/51aZiZaicYL._AC_US200_.jpg
└clickRate	Double	点击率	0.116
└conversionShareRate	Double	转化率	0.1217
goodsValue	Float	货流值	0.0108
brands	List	TOP3 品牌	["LEGO","Jorumo","Nifeliz"]
categories	List	TOP3 类目	["Toys","Home","Mobile_Apps"]
titleDensityExact	String	标题密度首页商品包含该关键词的数量（不含广告位）	21
marketPeriod	String	市场周期	S11,S12
brand	String	品牌	Fujifilm
hasBrandWord	Boolean	是否存在品牌词	false
keywordCn	String	中文翻译	宝丽来相机

请求示例

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

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

-H 'content-type: application/json;charset=UTF-8' \

--data-raw $'{"marketplace":"US","month":"202203"}' \

--compressed

关键词选品类目

1.请求 URL:/v1/keyword-research/department，请求方式 GET

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场	见表 1.2	✓

返回参数

参数名称	参数类型	参数说明	举例
code	String	类目代码	automotive
label	String	类目名称	Automotive Parts & Accessories

请求示例

curl 'https://api.sellersprite.com/v1/keyword-research/department?marketplace=US' \

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

-H 'content-type: application/json;charset=UTF-8' \

--compressed

关联流量统计

1.请求 URL：/v1/traffic/listing/stat，请求方式 GET

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场,见表1.2	US	✓
asinList	List	asin列表	["B07Z82895W"]	✓

返回参数

参数名称	参数类型	参数说明	举例
marketplace	String	市场	US
asin	String	asin	B07Z82895W
relations	Integer	全部流量	1848
freeRelations	Integer	免费流量	1414
paidRelations	Integer	付费流量	286
calcTime	Long	最近计算时间
items	List	统计概要
└relation	String	关联类型，见表2.2,忽略大小写	vav
└count	Integer	数量	3

请求示例

curl 'https://api.sellersprite.com/v1/traffic/listing/stat/US/B07Z82895W' \

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

-H 'content-type: application/json;charset=UTF-8' \

--compressed

关联流量列表

1.请求 URL：/v1/traffic/listing/page，请求方式 POST

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场,见表1.2	US	✓
asinList	List	asin列表	["B07Z82895W"]	✓
relations	List	关联类型，见表2.2	["vav"]	✓
variations	Boolean	是否查询变体	false
page	Integer	页码，从 1 开始	默认：1
size	Integer	每页条数	默认：50
order	Object	排序
└field	String	排序字段	见表2.2
└desc	boolean	true为降序 false为升序	默认降序

返回参数

参数名称	参数类型	参数说明	举例
asin	String	asin	B078J8VPVW
brand	String	品牌	Pampers
brandUrl	String	品牌 URL	https://www.amazon.com/s?k=HP
imageUrl	String	图片 URL	https://images-na.ssl-images-amazon.com/images/I/51axlzme6aL .AC_US200.jpg
title	String	商品标题	Diapers Size 2, 186 Count - Pampers Swaddlers Disposable Baby Diapers, ONE MONTH SUPPLY
parent	String	父体	B081RGNL17
nodeId	Long	节点 id	3741281
nodeIdPath	String	节点 id 路径字符串	2619525011:3741271:3741281
nodeLabelPath	String	类目	Baby Products:Diapering:Disposable Diapers
bsrId	String	BSRid	office-products
bsr	Integer	BSR 排名	1
units	Integer	月销量	26289
unitsCr	Float	月销量增长率	-46.3
revenue	Float	月销售额	1693537.4
price	Float	价格	64.42
profit	Float	利润率	63.92
fba	Float	fba 运费	13.58
ratings	Integer	评分数	32004
ratingsRate	Float	留评率	40.57
rating	Float	评分	4.8
ratingsCv	Integer	月度增长数	10666
ratingDelta	Integer	留评数：近 30 天新增评论数	0
availableDate	Long	上架时间，时间戳格式	1454083200000
fulfillment	String	配送方式	AMZ or FBA or FBM
variations	Integer	变体数	7
sellers	Integer	卖家数	7
sellerId	String	BuyBox 卖家 id	A1Y8BVAASXO4R7
sellerName	String	BuyBox 卖家	Amazon
sellerNation	String	BuyBox 卖家国籍	见表 1.5
badge	Badge	标识	包括了下面 5 个标识
└bestSeller	String	Best Seller 标识	Y 或者 N
└amazonChoice	String	amazon choice 标识	Y 或者 N
└newRelease	String	release 标识	Y 或者 N
└ebc	String	A+页面	Y 或者 N
└video	String	视频介绍	Y 或者 N
weight	String	重量	8.88 pounds
dimension	String	尺寸	13.3 x 15.8 x 10.6 inches
dimensionType	String	尺寸类型	ST,0V
sku	String	sku	["Color: Beige","Size: 47 inches"]

请求示例

curl 'https://api.sellersprite.com/v1/traffic/listing/page' \

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

-H 'content-type: application/json;charset=UTF-8' \

-d'{"marketplace":"US","asinList":["B07Z82895W"],"relations":["vav"]}'

流量词统计

1.请求 URL：/v1/traffic/keyword/stat/{marketplace}/{asin}，请求方式 GET

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场,见表1.2	US	✓
asin	String	asin	B07Z82895W	✓

返回参数

参数名称	参数类型	参数说明	举例
marketplace	String	市场	US
asin	String	asin	B07Z82895W
keywords	Integer	全部流量词条数	2685
ranks	Integer	自然流量词条数	1848
ads	Integer	广告流量词条数	1414
calcTime	Long	最近计算时间
badgeCount	Object	流量词类型统计
└ns	Integer	自然搜索词数量	1070
└ac	Integer	AC推荐词数量	0
└er	Integer	ER推荐词数量	42
└fs	Integer	4星推荐词数量	0
└hr	Integer	HR广告词数量	117
└sb	Integer	品牌广告词数量	334
└sv	Integer	视频广告词数量	208
└ad	Integer	SP广告词数量	764

请求示例

curl 'https://api.sellersprite.com/v1/traffic/keyword/stat/US/B07Z82895W' \

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

-H 'content-type: application/json;charset=UTF-8'

查流量来源(关键词流向)

1.请求 URL：/v1/traffic/source,请求方式 POST

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场,见表1.2	US	✓
q	String	asin 或者关键词	B07Z82895W	✓
month	String	筛选日期,yyyyMM格式	202203	✓
page	Integer	页码，从 1 开始	默认：1
size	Integer	每页条数	默认：50
order	Object	排序
└field	String	排序字段	见表2.4
└desc	boolean	true为降序 false为升序	默认降序

返回参数

参数名称	参数类型	参数说明	举例
keywords	Integer	全部流量词	1
searchKeywords	Integer	自然搜索词	12
acKeywords	String	AC推荐词	13
editorialKeywords	Integer	ER推荐词	13
fourStarsKeywords	Integer	4星推荐词	14
hrKeywords	Integer	HR推荐词	1
adKeywords	Integer	SP广告词	3
videoKeywords	Integer	视频广告词	4
brandKeywords	Integer	品牌广告词	5
badgeLabels	List	流量来源概览	[“SEARCH”, “OFFICIAL”, “AD”]
badgeDetails	Map	流量来源明细	{“SEARCH”: [“NATURAL_SEARCHING”],”OFFICIAL”: [“AMAZON_CHOICE”],”AD”: [“SPONSOR_BRAND”,”SPONSOR_VIDEO”,”HIGHLY_RATED”,”ADS”]}
asinInfo	Object	Asin相关信息
└asin	String	asin	B078J8VPVW
└asinUrl	String	该asin对应亚马逊地址	https://www.amazon.com/dp/B08GHW4TBS
└currency	String	货币code	$
└price	Float	价格	23
└rating	Float	评分	234
└reviews	Integer	评分数	23
└title	String	标题	Diapers Size 2, 186 Count - Pampers Swaddlers Disposable Baby Diapers, ONE MONTH SUPPLY
└sku	String	sku	["Color: Beige","Size: 47 inches"]
└variations	Integer	变体数	2
└nodeId	Long	类目ID	12097479011
└nodeIdPath	String	类目ID路径	172282:24046923011:172541:12097479011
└nodeLabelPath	String	类目路径	Electronics:Headphones, Earbuds & Accessories:Headphones & Earbuds:Over-Ear Headphones
└bsrRank	Long	大类排名(BSR)	175204

请求示例

curl 'https://api.sellersprite.com/v1/traffic/source' \

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

-H 'content-type: application/json;charset=UTF-8' \

-d'{"marketplace":"US","q":"B07Z82895W","month":"202210"}'

拓展流量词

1.请求 URL：/v1/traffic/extend,请求方式 POST

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场,见表1.2	US	✓
historyDate	String	历史日期，yyyyMM格式，最近30天不传或传空字符串	202201
asinList	List	asin列表(最多20)	["B07Z82895W"]	✓
queryType	Integer	查询方式 0 所有变体 1畅销变体 2当前变体，默认2	2
minSearches	Integer	最小月搜索量	100
maxSearches	Integer	最大月搜索量	300
minSearchRank	Integer	最小搜索排名	33
maxSearchRank	Integer	最大搜索排名	3223
minPurchases	Integer	最小购买量	6
maxPurchases	Integer	最大购买量	34
minPurchasesRate	Float	最小购买率	3
maxPurchasesRate	Float	最大购买率	43
minProducts	Integer	最小商品数	10
maxProducts	Integer	最大商品数	90
minSupplyDemandRatio	Float	最小供需比	11.2
maxSupplyDemandRatio	Float	最大供需比	45.2
minBid	Float	最小ppc竞价	10.2
maxBid	Float	最大ppc竞价	23.1
minAdProducts	Integer	最小广告竞品数	123
maxAdProducts	Integer	最大广告竞品数	345
minAvgPrice	Float	最小均价	20.0
maxAvgPrice	Float	最大均价	30.3
minWordCount	Integer	最小单词个数	2
maxWordCount	Integer	最大单词个数	4
includeKeywords	List	包含的词	["phone stand"]
excludeKeywords	List	排除的词	["phone stand"]
minSPR	Integer	最小SPR	2
maxSPR	Integer	最大SPR	16
minTitleDensity	Integer	最小标题密度	2
maxTitleDensity	Integer	最大标题密度	23
minMonopolyClickRate	Float	最小点击集中度	23.4
maxMonopolyClickRate	Float	最大点击集中度	53.1
minTrafficPercentage	Float	最小流量占比	45
maxTrafficPercentage	Float	最大流量占比	23
minConversionRate	Float	最小转化率	0.23
maxConversionRate	Float	最大转化率	1.4
minCompetitors	Integer	最小asin数	4
maxCompetitors	Integer	最大asin数	23
amazonChoice	Boolean	亚马逊推荐词	true
page	Integer	页码，从 1 开始	默认：1
size	Integer	每页条数，最大50	默认：50
order	Object	排序
└field	String	排序字段	见表2.5
└desc	boolean	true为降序 false为升序	默认降序

返回参数

参数名称	参数类型	参数说明	举例
keyword	String	关键字	N95
keywordCn	String	关键词中文翻译	用于录音的电话支架
searches	Integer	搜索量	21582
purchases	Integer	月购买量	1996
purchaseRate	Float	月购买率	0.0925
products	Integer	商品数	1645
bidMin	Float	最小PPC价格	1.34
bidMax	Float	最大PPC价格	3.21
bid	Float	PPC价格	1.6
badges	List	流量词类型	见表1.10
updatedTime	long	更新时间
searchesRank	Integer	周搜索量排名	25
searchesRankTimeFrom	Long	周搜索量排名时间范围
searchesRankTimeTo	Long
latest1daysAds	Integer	最近1天广告竞品数	70
latest7daysAds	Integer	最近7天广告竞品数	100
latest30daysAds	Integer	最近30天广告竞品数	280
supplyDemandRatio	Float	供需比	3.8
trafficPercentage	Float	流量占比	0.015
calculatedWeeklySearches	Float	预估周搜索量	40
avgPrice	Float	平均价格	36.14
avgRatings	Integer	平均评分数	12223
avgRating	Float	平均评分值	4.5
titleDensity	Integer	标题密度	42.9
spr	Integer	SPR	6
monopolyClickRate	Float	点击垄断率	0.3
top3ClickingRate	Float	前三点击	0.0813
top3ConversionRate	Float	前三转化	0.2011
relationVariationsItems	List	来自于哪些变体
└marketplace	String	站点	3
└asin	String		B08P6SC34B
└imageUrl	String	图片链接	10
└trafficPercentage	Float	流量占比	54.6
└title	String	标题
└price	Float	价格	60
└reviews	Float	评论数	10
└rating	Float	评分	4.5

请求示例

curl 'https://api.sellersprite.com/v1/traffic/extend' \

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

-H 'content-type: application/json;charset=UTF-8' \

-d'{"marketplace": "US","asinList":["B07Z82895W"] }'

BSR销量预测

1.请求 URL：/v1/sales/prediction/bsr，请求方式 GET

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场,见表1.2	US	✓
bsr	Integer	大类排名	1024	✓
categoryId	String	一级类目节点，查产品类目返回	11260432011	✓

返回参数

参数名称	参数类型	参数说明	举例
marketplace	String	市场	US
bsr	Integer	1	B07Z82895W
categoryLabel	String	类目名称	2685
estDailySales	Integer	预测日销量	99
estMonthSales	Integer	预测30天销量	2965
itemList	List	明细
└bsr	Integer	bsr	1
└estDailySales	Integer	预测日销量	99
└estMonthSales	Integer	预测30天销量	2965

请求示例

curl 'https://api.sellersprite.com/v1/sales/prediction/bsr?

bsr=2&categoryId=11260432011&marketplace=US' \

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

-H 'content-type: application/json;charset=UTF-8' \

--compressed

ASIN销量预测

1.请求 URL：/v1/sales/prediction/asin，请求方式 GET

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场,见表1.2	US	✓
asin	String	asin	B07Z82895W	✓

返回参数

参数名称	参数类型	参数说明	举例
asinDetail	Object	asin明细
└asin	String	asin	B00CFM8DI2
└title	String	标题	Boot Bananas Original Shoe Deodorizer \| Long-Lasting, Reusable Sports Shoe Deodorizer Odor Neutralizer & Air Purifier \| Eco-Conscious \| Lasts 6 to 12 Months \| 1 Pair
└brand	String	平台	Boot Bananas
└availableDate	Long	上架时间	1397001600000
└category	String	类目名称	Clothing, Shoes & Jewelry
└categoryId	String	类目id	7141123011
└imageUrl	String	图片URL	https://images-na.ssl-images-amazon.com/images/I/41AGxmiW-vL._AC_US600_.jpg
└ratings	Integer	评分数	32004
└rating	Float	评分值	4.6
dailyItemList	List	日销量预测明细
└date	String	日期	2023-04-19
└bsr	Integer	bsr	48614
└sales	Integer	销量	14
└amount	Float	销售额	200
└price	Float	单价	20
monthItemList	List	月销量预测明细
└date	String	日期	2023-04
└sales	Integer	销量	14
└amount	Float	销售额	200
└price	Float	单价	20

请求示例

curl 'https://api.sellersprite.com/v1/sales/prediction/asin?

asin=B08C7HDF1F&marketplace=US' \

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

-H 'content-type: application/json;charset=UTF-8' \

--compressed

ASIN销量预测-按天

1.请求 URL：/v1/sales/prediction/asin/daily，请求方式 GET

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场,见表1.2	US	✓
asin	String	asin	B07Z82895W	✓
date	String	预测日期，为空默认当前时间前一天，格式yyyy-MM-dd，最大历史为当前时间往前推390天	2025-03-02

返回参数

参数名称	参数类型	参数说明	举例
asin	String	asin	B00CFM8DI2
title	String	标题	Boot Bananas Original Shoe Deodorizer \| Long-Lasting, Reusable Sports Shoe Deodorizer Odor Neutralizer & Air Purifier \| Eco-Conscious \| Lasts 6 to 12 Months \| 1 Pair
brand	String	平台	Boot Bananas
availableDate	Long	上架时间	1397001600000
category	String	类目名称	Clothing, Shoes & Jewelry
categoryId	String	类目id	7141123011
imageUrl	String	图片URL	https://images-na.ssl-images-amazon.com/images/I/41AGxmiW-vL._AC_US600_.jpg
ratings	Integer	评分数	32004
rating	Float	评分值	4.6
date	String	日期	2023-04-19
bsr	Integer	bsr	48614
sales	Integer	销量	14
amount	Float	销售额	200
price	Float	单价	20

请求示例

curl 'https://api.sellersprite.com/v1/sales/prediction/asin/daily?

asin=B08C7HDF1F&marketplace=US&date=2025-02-03' \

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

-H 'content-type: application/json;charset=UTF-8' \

--compressed

ABA数据选品(废弃)

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

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场	见表 1.2	✓
reverseType	String	查询类型 W:按周 M:按月默认查周，即W
date	String	和reverseType配合使用 reverseType=W或空时，查最新周 reverseType=M时，查最近30天目前支持到2023年1月	202306(reverseType=M时),20230610(reverseType=W时，且限定为周六的日期）
departments	List	类目列表	["automotive","baby-products"]
keyword	List	关键词	phone
excludeKeywords	String	排除关键词	portable
includeKeywords	String	包含关键词
minRankGrowthRate	Double	最小排名增长率
maxRankGrowthRate	Double	最大排名增长率
minSearchRank	Integer	最小排名
maxSearchRank	Integer	最大排名
minSearches	Integer	最小搜索量
maxSearches	Integer	最大搜索量
minMonopolyClickRate	Double	最小点击集中度
maxMonopolyClickRate	Double	最大点击集中度
minConversionRate	Double	最小转化占比
maxConversionRate	Double	最大转化占比
minWordCount	Integer	最小单词数
maxWordCount	Integer	最大单词数
minSPR	Integer	最小SPR
maxSPR	Integer	最大SPR
minTitleDensity	Integer	最小标题密度
maxTitleDensity	Integer	最大标题密度
minClicks	Integer	最小点击量	1
maxClicks	Integer	最大点击量	10000
minImpressions	Integer	最小展示量	10000
maxImpressions	Integer	最大展示量	20000
searchModel	Integer	搜索模式： 1：热门市场 2：异动市场 3：持续增长市场 4：快速飙升市场 5：潜力市场 6：长尾市场	1
page	Integer	页码，从 1 开始	默认：1
size	Integer	每页条数，最大15	默认：15
order	Object	排序
└field	String	排序字段	见表2.4
└desc	boolean	true为降序 false为升序	默认降序

返回参数

参数名称	参数类型	参数说明	举例
marketplace	String	市场	US
date	String	查询日期	202306(reverseType=M时),20230610(reverseType=W时，且限定为周六的日期）
keyword	String	关键词	portable charger
keywordCn	Integer	关键词中文	便携式充电器
keywordJp	String	关键词日文
departments	List	类目	["Cell Phones & Accessories"]
searchRank	Integer	搜索排名	62
searchRankCv	Integer	排名增长量	19
searchRankCr	Double	排名增长率	0.2346
searches	Integer	搜索量	46147979
purchases	Integer	购买量	2492
purchaseRate	Double	购买率	0.0054
clicks	Integer	点击量	1380
impressions	BigInteger	展示量	73560
titleDensityExact	Integer	首页商品标题中包含该关键词的商品数(精确匹配)
cprExact	Integer	精确 CPR（8天内确保关键词上首页的销量数）
w1SearchRank	Integer	上周的排名
w1RankGrowthValue	Integer	上周的排名变化值
w1RankGrowthRate	Double	上周的排名变化率
w4SearchRank	Integer	4周前的排名
w4RankGrowthValue	Integer	4周前的排名变化值
w4RankGrowthRate	Double	4周前的排名变化率
w12SearchRank	Integer	12周前的排名
w12RankGrowthValue	Integer	12周前的排名变化值
w12RankGrowthRate	Double	12周前的排名变化率
top3Brands	List	点击前三品牌
bid	Float	ppc竞价
bidMax	Float	最大ppc竞价
bidMin	Float	最小ppc竞价
top3AsinDtoList	List	前三点击asin
-asin	String	asin
-imageUrl	String	图片URL
-clickRate	Double	点击集中度
-conversionRate	Double	转化率
clickShareRate	Double	前三点击比	54.2
cvsShareRate	Double	前三转化总比	43.5

请求示例

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

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

-H 'content-type: application/json;charset=UTF-8' \

-d'{"marketplace":"US","rankGrowthType":"W1","date":"20220129"}'

ABA数据选品周数据

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

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场	见表 1.2	✓
date	String	为空时，查最新周	20230610，限定为周六的日期）
departments	List	类目列表	["automotive","baby-products"]
keyword	List	关键词	phone
excludeKeywords	String	排除关键词	portable
includeKeyword	String	包含关键词
rankGrowthValue	Integer	搜索增长量
rankGrowthRate	Double	搜索增长率
minRankGrowthRate	Double	最小排名增长率
maxRankGrowthRate	Double	最大排名增长率
minSearchRank	Integer	最小排名
maxSearchRank	Integer	最大排名
minSearches	Integer	最小搜索量
maxSearches	Integer	最大搜索量
minMonopolyClickRate	Double	最小点击集中度
maxMonopolyClickRate	Double	最大点击集中度
minConversionRate	Double	最小转化占比
maxConversionRate	Double	最大转化占比
minWordCount	Integer	最小单词数
maxWordCount	Integer	最大单词数
minSPR	Integer	最小SPR
maxSPR	Integer	最大SPR
minTitleDensity	Integer	最小标题密度
maxTitleDensity	Integer	最大标题密度
minClicks	Integer	最小点击量	1
maxClicks	Integer	最大点击量	10000
minImpressions	Integer	最小展示量	10000
maxImpressions	Integer	最大展示量	20000
searchModel	Integer	搜索模式： 1：热门市场 2：异动市场 3：持续增长市场 4：快速飙升市场 5：潜力市场 6：长尾市场	1
page	Integer	页码，从 1 开始	默认：1
size	Integer	每页条数，最大40	默认：40
order	Object	排序
└field	String	排序字段	见表2.4
└desc	boolean	true为降序 false为升序	默认降序

返回参数

参数名称	参数类型	参数说明	举例
marketplace	String	市场	US
date	String	查询日期	20230610，限定为周六的日期
keyword	String	关键词	portable charger
keywordCn	Integer	关键词中文	便携式充电器
keywordJp	String	关键词日文
departments	List	类目	["Cell Phones & Accessories"]
searchRank	Integer	搜索排名	62
searchRankCv	Integer	排名增长量	19
searchRankCr	Double	排名增长率	0.2346
searches	Integer	搜索量	46147979
purchases	Integer	购买量	2492
purchaseRate	Double	购买率	0.0054
clicks	Integer	点击量	1380
impressions	BigInteger	展示量	73560
titleDensityExact	Integer	首页商品标题中包含该关键词的商品数(精确匹配)
cprExact	Integer	精确 CPR（8天内确保关键词上首页的销量数）
w1SearchRank	Integer	上周的排名
w1RankGrowthValue	Integer	上周的排名变化值
w1RankGrowthRate	Double	上周的排名变化率
w4SearchRank	Integer	4周前的排名
w4RankGrowthValue	Integer	4周前的排名变化值
w4RankGrowthRate	Double	4周前的排名变化率
w12SearchRank	Integer	12周前的排名
w12RankGrowthValue	Integer	12周前的排名变化值
w12RankGrowthRate	Double	12周前的排名变化率
top3Brands	List	点击前三品牌
bid	Float	ppc竞价
bidMax	Float	最大ppc竞价
bidMin	Float	最小ppc竞价
top3AsinDtoList	List	前三点击asin
-asin	String	asin
-imageUrl	String	图片URL
-clickRate	Double	点击集中度
-conversionRate	Double	转化率
clickShareRate	Double	前三点击比	54.2
cvsShareRate	Double	前三转化总比	43.5

请求示例

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

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

-H 'content-type: application/json;charset=UTF-8' \

-d'{"marketplace":"US","rankGrowthType":"W1","date":"20220129"}'

ABA数据选品月数据

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

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketplace	String	市场	见表 1.2	✓
date	String	为空时，查最近30天，目前支持到2023年1月	202306
departments	List	类目列表	["automotive","baby-products"]
keyword	String	关键词列表	phone
excludeKeywords	String	排除关键词	portable
includeKeywords	String	包含关键词
minRankGrowthRate	Double	最小排名增长率
maxRankGrowthRate	Double	最大排名增长率
minSearchRank	Integer	最小排名
maxSearchRank	Integer	最大排名
minSearches	Integer	最小搜索量
maxSearches	Integer	最大搜索量
minMonopolyClickRate	Double	最小点击集中度
maxMonopolyClickRate	Double	最大点击集中度
minConversionRate	Double	最小转化占比
maxConversionRate	Double	最大转化占比
minWordCount	Integer	最小单词数
maxWordCount	Integer	最大单词数
minSPR	Integer	最小SPR
maxSPR	Integer	最大SPR
minTitleDensity	Integer	最小标题密度
maxTitleDensity	Integer	最大标题密度
minClicks	Integer	最小点击量	1
maxClicks	Integer	最大点击量	10000
minImpressions	Integer	最小展示量	10000
maxImpressions	Integer	最大展示量	20000
searchModel	Integer	搜索模式： 1：热门市场 2：异动市场 3：持续增长市场 4：快速飙升市场 5：潜力市场 6：长尾市场	1
page	Integer	页码，从 1 开始	默认：1
size	Integer	每页条数，最大15	默认：15
order	Object	排序
└field	String	排序字段	见表2.4
└desc	boolean	true为降序 false为升序	默认降序

返回参数

参数名称	参数类型	参数说明	举例
marketplace	String	市场	US
date	String	查询日期	202306
keyword	String	关键词	portable charger
keywordCn	Integer	关键词中文	便携式充电器
keywordJp	String	关键词日文
departments	List	类目	["Cell Phones & Accessories"]
searchRank	Integer	搜索排名	62
searchRankCv	Integer	排名增长量	19
searchRankCr	Double	排名增长率	0.2346
searches	Integer	搜索量	46147979
purchases	Integer	购买量	2492
purchaseRate	Double	购买率	0.0054
clicks	Integer	点击量	1380
impressions	BigInteger	展示量	73560
titleDensityExact	Integer	首页商品标题中包含该关键词的商品数(精确匹配)
cprExact	Integer	精确 CPR（8天内确保关键词上首页的销量数）
w1SearchRank	Integer	上周的排名
w1RankGrowthValue	Integer	上周的排名变化值
w1RankGrowthRate	Double	上周的排名变化率
w4SearchRank	Integer	4周前的排名
w4RankGrowthValue	Integer	4周前的排名变化值
w4RankGrowthRate	Double	4周前的排名变化率
w12SearchRank	Integer	12周前的排名
w12RankGrowthValue	Integer	12周前的排名变化值
w12RankGrowthRate	Double	12周前的排名变化率
top3Brands	List	点击前三品牌
bid	Float	ppc竞价
bidMax	Float	最大ppc竞价
bidMin	Float	最小ppc竞价
top3AsinDtoList	List	前三点击asin
-asin	String	asin
-imageUrl	String	图片URL
-clickRate	Double	点击集中度
-conversionRate	Double	转化率
clickShareRate	Double	前三点击比	54.2
cvsShareRate	Double	前三转化总比	43.5

请求示例

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

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

-H 'content-type: application/json;charset=UTF-8' \

-d'{"marketplace":"US","rankGrowthType":"W1","date":"20220129"}'

图片文字识别

1.请求 URL:/v1/ocr/identify,请求方式 POST,请求Content-Type:multipart/form-data

请求参数

参数名称	参数类型	参数说明	举例	是否必传
type	Integer	0：远程图片；1：base64字符串；2：图片文件	2	✓
fn	String	需要识别的语言种类 CHINESE:中文 LATIN:拉丁文	CHINESE	✓
url	String	远程url	https://o.sellersprite.com/docs/202310/sellersprite-2023101210394300742.jpg
base64	String	base64字符串
image	File	上传的文件	C:\fakepath\人像.jpeg

返回参数

参数名称	参数类型	参数说明	举例
data	String	识别的文字	卖家精灵
code	Integer	状态码	OK
message	String	状态码描述	成功

请求示例

curl 'https://api.sellersprite.com/v1/ocr/identify' \

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

-H 'content-type: multipart/form-data' \

-F 'image=@/home/image/人像.jpeg' -F 'base64=' -F 'fn=CHINESE' -F 'type=2' -F 'url=' \

--compressed

Listing生成器

1.请求 URL:/v1/listing/generate-listing,请求方式 POST

请求参数

参数名称	参数类型	参数说明	举例	是否必传
marketId	Integer	1-美国站，3-英国站，4-德国站，5-法国站，6-日本站，7-加拿大站，35691-意大利站，44551-西班牙站	1	✓
productFeature	String	产品特征，逗号分隔	blue,light	✓
keywords	String	参考关键词，逗号分隔	phone holder,car phone stable	✓
purchaserFeature	String	客户特征，逗号分隔	young man,boys who like play
excludeWords	String	不希望含有的关键词，逗号分隔	bad,china
type	String	选择哪个内容生成 Title-标题 SellingPoints-卖点描述 ProductDesc-产品描述 SearchKeywords-搜索词 All-生成所有	All	✓

返回参数

参数名称	参数类型	参数说明	举例
data	Map	生成的内容	{ "1-标题:": "Authentic Mihoyo Honkai Star Rail Japanese Figure for Young Otaku and Anime Fans"}
code	Integer	状态码	OK
message	String	状态码描述	成功

请求示例

curl --location 'https://api.sellersprite.com/v1/listing/generate-listing' \

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

--data '{

"productFeature": "journey backpack",

"keywords": "journey,young man,backpack",

"purchaserFeature": "young man,people who like take journey",

"excludeWords": "bad",

"marketId": 1,

"type": "All"

全球商标库-数据范围

1.请求 URL:/v1/global/brand/range,请求方式 GET

返回参数

参数名称	参数类型	参数说明	举例
office	String	简码	AD
officeLabel	String	中文名称	安道尔

请求示例

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

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

-H 'content-type: application/json;charset=UTF-8' \

--compressed

全球商标库-统计

1.请求 URL:/v1/global/brand/stats,请求方式 POST,

请求Content-Type:multipart/form-data

请求参数

参数名称	参数类型	参数说明	举例	是否必传
office	List	数据范围，见上一个接口	["US"]	✓
text	String	查询文本	CHINESE	✓
imageBase64	String	base64字符串
imageFile	File	上传的文件	C:\fakepath\人像.jpeg

返回参数

参数名称	参数类型	参数说明	举例
office	List	知识产权局	[{"key":"US","count":2}]
└key	String	值	US
└count	Integer	数量	2
brandName	List	品牌名	格式同office
└key	String	值	ADVENTURE CLUB
└count	Integer	数量	4
status	List	状态	格式同office
└key	String	值	Registered
└count	Integer	数量	12
applicant	List	申请人	格式同office
└key	String	值	ANKER INC
└count	Integer	数量	4
niceClass	List	尼斯分类	格式同office
└key	String	值	5
└count	Integer	数量	2
└label	String	分类名称	医药用品
applicationYear	List	申请年份	格式同office
└key	String	值	1985
└count	Integer	数量	5
expiryYear	List	过期年份	格式同office
└key	String	值	2026
└count	Integer	数量	2

请求示例

curl 'https://api.sellersprite.com/v1/ocr/identify' \

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

-H 'content-type: multipart/form-data' \

-F "imageFile=@/home/image/人像.jpeg" -F "imageBase64=" -F "text=ANKER" -F "office=US" -F "office=CA" \

--compressed

全球商标库-列表

1.请求 URL:/v1/global/brand/list,请求方式 POST,

请求Content-Type:multipart/form-data

请求参数

参数名称	参数类型	参数说明	举例	是否必传
office	List	数据范围，见上一个接口	["US"]
text	String	查询文本	CHINESE	✓
imageBase64	String	base64字符串
imageFile	File	上传的文件	C:\fakepath\人像.jpeg
brandName	List	品牌名，字段参数见统计接口	["ADVENTURE CLUB"]
status	List	状态，字段参数见统计接口	["Registered"]
applicant	List	申请人，字段参数见统计接口	["ANKER INC"]
niceClass	List	尼斯分类，字段参数见统计接口	[5]
applicationYear	List	申请年份，字段参数见统计接口	["1985"]
expiryYear	List	过期年份，字段参数见统计接口	["2026"]
order.field	String	排序字段，默认相关度，applicationDate申请日期
order.desc	Boolean	true降序，false升序，默认true
page	Integer	页码	1
size	Integer	每页条数，最大100	20

返回参数

参数名称	参数类型	参数说明	举例
id	String	id	US502022097612203
applicant	List	申请人	ANKER INC
applicantCountryCode	Integer	申请人国家	US
applicants	List	申请人详情	格式同office
└kind	String	类型	Legal Entity
└identifier	String	标识	33744042
└countryCode	String	国家编码	US
└contact	JSONObject	联系方式
└fullAddress	List	完整地址
└└text	String	描述
└└languageCode	String	语言	en
└└imageUrl	String	图片URL	https://o.sellersprite.com/w/brands/ustm/US502022097612203/ee45f.jpg
└fullName	List	完整名称
└└text	String	描述	ANKER INC
└└languageCode	String	语言	en
applicationDate	String	申请日期	2022-09-29
applicationLanguageCode	String	申请语言	en
applicationNumber	String	申请编号	97612203
registrationNumber	String	注册号	4590785
applicationRefNumber	List	申请参考号
brandName	List	品牌名	[ "1ST AID"]
collection	String	数据集	ustm
designatedCountries	List	指定国家	["US"]
designation	List	指定国家	["US"]
filingPlace	String	申请地点
kind	List	商标类别	["Individual"]
logos	List	logo
└logo	String	logo
└logoUrl	String	logo url
markFeature	String	商标种类	Combined
niceClass	List	尼斯分类	[5]
office	String	知识产权局	US
status	String	状态	Pending
statusDate	String	状态更新日期	2023-05-02
type	String	类型	TRADEMARK

请求示例

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

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

-H 'content-type: multipart/form-data' \

-F "imageFile=" -F "imageBase64=" -F "text=ANKER" -F "office=US" -F "office=CA" \

--compressed

全球商标库-详情

1.请求 URL:/v1/global/brand/detail,请求方式 GET,

请求参数

参数名称	参数类型	参数说明	举例	是否必传
office	List	数据范围，见上一个接口	US	✓
brandId	String	id,见列表接口	US502022097612203	✓

返回参数

参数名称	参数类型	参数说明	举例
id	String	id	US502022097612203
applicant	List	申请人	ANKER INC
applicantCountryCode	Integer	申请人国家	US
applicants	List<AddressDto>	申请人详情	格式同office,结构见下表
applicationDate	String	申请日期	2022-09-29
applicationLanguageCode	String	申请语言	en
applicationNumber	String	申请编号	97612203
registrationNumber	String	注册号	4590785
applicationRefNumber	List	申请参考号
brandName	List	品牌名	[ "1ST AID"]
collection	String	数据集	ustm
designatedCountries	List	指定国家	["US"]
designation	List	指定国家	["US"]
filingPlace	String	申请地点
kind	List	商标类别	["Individual"]
logos	List	logo
└logo	String	logo
└logoUrl	String	logo url
markFeature	String	商标种类	Combined
niceClass	List	尼斯分类	[5]
office	String	知识产权局	US
status	String	状态	Pending
statusDate	String	状态更新日期	2023-05-02
type	String	类型	TRADEMARK
appeals	List	上诉信息
└date	String	日期
└kind	String	分类
correspondence	AddressDto	通信地址
events	List	事件
└date	String	日期
└officeKind	String	产权局分类
└gbdKind	String	品牌分析
└doc	String	文档
└country	String	国家
expiryDate	String	过期时间
extra	String	扩展信息
gbdStatus	String	品牌状态
goodsServicesClassification	Object	商品分类信息
└kind	String	类型
└version	String	版本
└classification	String	详情
└└code	String	code码
└└terms	Map	说明
goodsServicesUnclassified	Map	商品未分类信息
markDescriptionDetails	List	商标描述细节
└text	String	描述	ANKER INC
└languageCode	String	语言	en
markDisclaimerDetails	List	商标免责声明
└text	String	描述	ANKER INC
└languageCode	String	语言	en
markImageDetails	JSONArray	商标图形分类
nationalGoodsServicesClassification	Object	国际商品分类信息
└kind	String	类型
└version	String	版本
└classification	String	详情
└└code	String	code码
└└terms	Map	说明
officeStatus	String	办公状态
priorities	List	优先事项
└severity	String	级别
└code	String	code码
└field	String	字段
└type	String	类型
└message	String	说明
publicationDate	String	发表日期
publications	List	发表详情
└date	String	日期
└identifier	String	标志
└section	String	内容
qc	List	审核意见
└severity	String	级别
└code	String	code码
└field	String	字段
└type	String	类型
└message	String	说明
reference	Object	参考信息
└office	String	机构code
└application	Object	申请信息
└└date	String	日期
└└number	String	编号
└registration	Object	注册信息
└└date	String	日期
└└number	String	编号
refOffice	String	参考办公室
registrationDate	String	注册日期
registrationOfficeCode	String	注册国家
registrationRefNumber	List	注册参考号
representatives	List<AddressDto>	代表信息
secondLanguageCode	String	第二语言
st13	String	id
terminationDate	String	终止日期
wordMarkSpecification	Object	文字商标说明
└markTransliteration	String
└markTranslation	Object	商标翻译
└└text	String	内容
└└languageCode	String	语言类型
└markVerbalElement	Object
└└text	String	内容
└└languageCode	String	语言类型
└markSignificantVerbalElement	Object
└└text	String	内容	SONICARE
└└languageCode	String	语言类型	en

AddressDto结构：

参数名称	参数类型	参数说明	举例
kind	String	类型	Legal Entity
identifier	String	标识	33744042
countryCode	String	国家编码	US
contact	JSONObject	联系方式
fullAddress	List	完整地址
└text	String	描述
└languageCode	String	语言	en
└imageUrl	String	图片URL	https://o.sellersprite.com/w/brands/ustm/US502022097612203/ee45f.jpg
fullName	List	完整名称
└text	String	描述	ANKER INC
└languageCode	String	语言	en

请求示例

curl -X GET 'https://api.sellersprite.com/v1/global/brand/detail?brandId=US502016087116276&office=US' \

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

--compressed

附录

表 1.1 查询日期

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

表 1.2 市场

参数值	说明	货币
US	美国站	USD($)
UK	英国站	GBP(£)
DE	德国站	EUR(€)
FR	法国站	EUR(€)
JP	日本站	JPY(￥)
CA	加拿大站	C$($)
IT	意大利	EUR(€)
ES	西班牙	EUR(€)
MX	墨西哥	MXN(MX$)
AU	澳大利亚	AUD(A$)
TR	土耳其	TRY(₺)
IN	印度	INR(₹)

表 1.3 上架日期

参数值	说明
不传	不限制
1	近 30 天
3	近 3 个月
6	近半年
12	近 1 年
24	近 2 年

表 1.4 商品尺寸

美国站点

参数值	说明
ST	小号标准尺寸
LS	大号标准尺寸
SO	小号大件
MO	中号大件
LO	大号大件
SP	特殊大件
O	其他尺寸

日本站点商品尺寸

参数值	说明
SM	小号
ST	标准
OV	大件
SS	超大尺寸
O	其他尺寸

英国，法国，德国，意大利，西班牙站点商品尺寸

参数值	说明
SL	小号信封
NL	标准信封
LL	大号信封
SD	标准包裹
SB	小号大件
NB	标准大件
LB	大号大件
O	其他尺寸

加拿大商品尺寸

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

表 1.5 卖家所属地

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

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

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

参数值	说明
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增长率

表 1.7 市场周期

参数值	说明
N	一般性市场
S1,S2,S3	季节性市场(1-3月旺季)
S4,S5,S6	季节性市场(4-6月旺季)
S7,S8,S9	季节性市场(7-9月旺季)
S10,S11,S12	季节性市场(10-12月旺季)
I	持续增长市场
D	持续衰退市场

表 1.8 关键词选品排序字段

参数值	说明
searches	月搜索量
keywordsIsHide	月购买量
searches_growth	增长率
yearly_growth_rate	同比增长率
growth_rate_trend_min	近3个月增长率
monopoly_click_rate	点击集中度
goods_value	货流值

表 1.9 关键词趋势选品排序字段

参数值	说明
searchfrequencyrank	搜索排名
n1RankGrowthValue	周变化量
n1RankGrowthRate	周变化率
monopolyClickRate	点击集中度

表 1.10 流量分析曝光位置

参数值	说明
naturalSearching	自然搜索词
amazonChoice	AC推荐词
editorialRecommendations	ER推荐词
fourStar	四星推荐词
highlyRated	HR推荐词
sponsorBrand	品牌推荐词
sponsorVideo	视频推荐词
ads	SP广告词

表 2.0 流量分析流量占比类型

参数值	说明
primary	主要流量词
precise	精准流量词
preciseLongTail	转化流失词

表 2.1 流量分析流量转化类型

参数值	说明
excellent	转化优质词
stable	转化平稳词
lost	转化流失词
invalid	无效曝光词

表 2.2 关联流量关联类型

参数值	说明
mib	捆绑销售组合
fbt	组合购买
csi	相似产品
cob	品牌推荐
mie	更多相关
bab	买了又买
vav	看了又看
avp	看了还看
bav	看了商品却买了其他商品
asf	看了或买了的产品
cpf	低碳环保型产品
bca	类目品牌广告
fsa	4星及以上的商品广告
sp	商品广告

表 2.3 流量词列表排序字段

参数值	说明
rankPosition	自然排名
adPosition	广告排名
createdTime	更新时间
searchesRank	搜索量周排名
searches	月搜索量
purchases	月购买量
purchaseRate	购买率
products	商品数
supplyDemandRatio	供需比
latest1daysAds	广告竞品数
bid	PPC竞价
trafficPercentage	流量占比

表 2.4 ABA选品排序字段

参数值	说明
searchfrequencyrank	现排名
cprExact	spr
titleDensityExact	标题密度
searches	搜索量周排名

表 2.5 拓展流量词排序字段

参数值	说明
trafficPercentage	流量占比
relationAsin	相关ASIN
searchesRank	ABA周排名
searches	月搜索量
purchases	月购买量
purchaseRate	购买率
spr	spr
titleDensity	标题密度
products	商品数
supplyDemandRatio	供需比
adProduct	广告竞品数
monopolyClickRate	点击集中度
bid	PPC竞价

表 2.6 查单词反查排序字段

参数值	说明
searchRank	排名
searchRankGrowthValue	月变化量
searchRankGrowthRate	月变化率
sumClickRate	前3asin点击占比