选产品

Support MCP

version

根据销量销额增长等各个维度设定条件来筛选产品

Http Method	POST
Http Request URL	https://api.sellersprite.com/v1/product/research

-> 请求参数折叠

#	参数	参数类型	是否必填	参数名称	参数描述
1	marketplace	String	✓	市场编码	见表 1.2
2	month	String		查询月份	格式：yyyyMM，示例：202507，见表 1.1
3	keyword	String		关键字	N95
4	includeSellers	String		包含卖家
5	excludeSellers	String		排除卖家
6	matchType	Integer		匹配方式，1词组匹配 2模糊匹配 3精准匹配；默认2	2
7	excludeKeywords	String		排除的关键字	portable
8	minPrice	Float		最低价格	10
9	maxPrice	Float		最高价格	30
10	minRating	Float		最低评分值	1
11	maxRating	Float		最高评分值	5
12	minRatings	Integer		最低评分数	1
13	maxRatings	Integer		最高评分数	90
14	minRatingsCv	Integer		最低月新增评分数	1
15	maxRatingsCv	Integer		最高月新增评分数	5
16	minSellers	Integer		最小卖家数量	3
17	maxSellers	Integer		最大卖家数量	10
18	minProfit	Float		最小毛利率	10
19	maxProfit	Float		最大毛利率	20
20	minBsr	Integer		大类 BSR 最高排名	1
21	maxBsr	Integer		大类 BSR 最低排名	100
22	minBsrCv	Integer		BSR 最低增长数	3
23	maxBsrCv	Integer		BSR 最高增长数	5
24	minBsrCr	Float		BSR 最低增长率	30
25	maxBsrCr	Float		BSR 最高增长率	60
26	minUnits	Integer		最低月销量	20
27	maxUnits	Integer		最高月销量	50
28	minRevenue	Float		最低月销售额	60
29	maxRevenue	Float		最高月销售额	200
30	minRevenueCr	Float		月销售额最低增长率	20
31	maxRevenueCr	Float		月销售额最高增长率	30
32	minUnitsCr	Float		月销量最低增长率	20
33	maxUnitsCr	Float		月销量最高增长率	30
34	weightUnit	String		重量单位，默认：g	见表2.7
35	minWeights	Float		最小重量	20
36	maxWeights	Float		最大重量	30
37	minVariations	Integer		最低变体数	1
38	maxVariations	Integer		最高变体数	3
39	filterSub	String		是否筛选子类目，Y：是	只有在指定类目时才会生效
40	minSubBsrRank	Integer		最小子类排名	只有参数 filterSub=Y 时才生效
41	maxSubBsrRank	Integer		最大子类排名	只有参数 filterSub=Y 时才生效
42	includeBrands	String		包含品牌	Apple
43	excludeBrands	String		排除品牌	Apple
44	nodeIdPaths	List		类目节点字符串列表	见查产品类目接口
45	nodeIdPathEqual	boolean		true为类目精确查询 false为查询当前及子类目	默认false
46	availableMonth	Integer		上架月份	见表 1.3，默认不限制
47	dimensionType	String		尺寸类型集合,逗号分隔，默认不限制	见表 1.4
48	minFba	Float		FBA 最低运费	10
49	maxFba	Float		FBA 最高运费	20
50	minLqs	Float		最低 Listing 页面质量分	0
51	maxLqs	Float		最高 Listing 页面质量分	10
52	sellerNation	String		卖家所属地，默认不限制，多条件查询用逗号隔开	见表 1.5
53	badgeBS	String		是否有热销标识 Best Seller	Y:是
54	badgeAC	String		是否有热销标识 Amazon's Choice	Y:是
55	badgeNR	String		是否有新品标识 New Release	Y:是
56	fulfillment	String		配送方式，多条件查询用逗号隔开	AMZ or FBA or FBM
57	variation	String		是否查询变体 asin	Y:否 N:是，默认N
58	page	Integer		页码，从 1 开始	默认：1，总条数限制2000条，可以细分条件拉取整个类目数据
59	size	Integer		每页条数	默认：50，最大：100
60	order	Object		排序
61	└field	String		排序字段，默认：total_units	见表1.6
62	└desc	boolean		排序方式	true：desc，false：asc；Default：true

返回参数 <- 折叠

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

-> 请求示例折叠

curl --location --request POST 'https://api.sellersprite.com/v1/product/research' \
--header 'secret-key: Your Secret' \
--header 'Content-Type: application/json' \
--data-raw '{
"marketplace": "US",
"month":"202507",
"minPrice":100,
"maxPrice":101,
"variation":"N",
"page":1,
"size":1
}'

返回示例 <- 折叠

{
"code": "OK",
"message": "成功",
"data": {
"guestId": null,
"pages": 64754,
"page": 1,
"size": 1,
"total": 64754,
"took": 17,
"url": null,
"order": {
"field": "",
"desc": true
},
"items": [
{
"asin": "B0DB5VT4QJ",
"brand": "OLANLY",
"brandUrl": "https://www.amazon.com/s?k=OLANLY",
"imageUrl": "https://images-na.ssl-images-amazon.com/images/I/81ZghGzYgkL._AC_US200_.jpg",
"title": "OLANLY Bathroom Rugs 70x46, Extra Soft Absorbent Chenille Bath Rugs, Rubber Backing Quick Dry, Machine Washable Bath Mats for Bathroom Floor, Tub and Shower, Home Decor Accessories, Navy",
"parent": "B0DP268C4Y",
"nodeLabelPath": "Home & Kitchen:Bath:Bath Rugs",
"nodeIdPath": "1055398:1063236:1063242",
"nodeId": 1063242,
"bsrId": "home-garden",
"bsr": 13,
"bsrCv": -1,
"bsrCr": -8.33,
"amzUnit": null,
"amzUnitDate": null,
"amzSales": null,
"units": 158113,
"unitsGr": null,
"revenue": 1.6059537E7,
"price": 100.89,
"averagePrice": 101.57,
"primePrice": -1.0,
"profit": 71.71,
"fba": 13.41,
"ratings": 18821,
"ratingsRate": 1.38,
"rating": 4.4,
"ratingsCv": 2179,
"ratingDelta": 0,
"availableDate": 1721779200000,
"fulfillment": "FBA",
"variations": 449,
"sellers": 1,
"sellerName": "OLANLY",
"sellerId": "A1MCYUGJD2ILFU",
"sellerNation": "CN",
"lqs": 96,
"weight": "10.41 pounds",
"dimension": "46 x 70 x 1 inches",
"pkgDimensions": "18.9 x 7.8 x 7.4 inches",
"pkgDimensionType": "LB",
"pkgWeight": "10.43 pounds",
"sku": "Size: 70\" x 46\" | Color: Navy",
"dimensionsType": "ELO",
"deliveryPrice": -1.0,
"badge": {
"bestSeller": "#1 Best Seller in Bath Rugs",
"amazonChoice": "N",
"newRelease": "N",
"ebc": "Y",
"video": "N"
},
"subcategories": [
{
"code": "1063242",
"rank": 1,
"label": "Bath Rugs"
}
]
}
],
"terminal": null,
"hasNextPage": null,
"guestVisited": false
}
}

投诉或建议： 186-2151-2959

企微

飞书

钉钉

卖家精灵数据开放平台

选产品

联系我们