商品列表基础版 - 小红书 API

	错误码	错误码描述
	-4002005	接口报错

curl --location --request POST 'https://ark.xiaohongshu.com/ark/open_api/v3/common_controller' \ --header 'Content-Type: application/json;charset=utf-8' \ --data-raw '{ "id": "607***450", "createTimeFrom": 1612518379000, "createTimeTo": 1612518379000, "updateTimeFrom": 1612518379000, "updateTimeTo": 1612518379000, "buyable": true, "stockGte": 10, "stockLte": 100, "pageNo": 1, "pageSize": 50, "barcode": "690***466", "skucode": "690***772", "freeze": true, "singlePackOnly": true, "lastId": "61694f367133c30009f8a76d", "isChannel": true }'

{ "currentPage": 1, "pageSize": 50, "total": 500, "hits": [ { "itemId": "607***450", "name": "607***450", "splId": "58e***450", "spvId": "15e***450", "spuId": "587***450", "price": 100, "skucode": "690***466", "buyable": true, "barcode": "690***452", "stock": 1000, "status": 1, "freeze": true, "createTime": 1612518379, "updateTime": 1612518379 } ] }

请求参数

Header 参数

Content-Type

string

可选

默认值:

application/json;charset=utf-8

Body 参数application/json

string

可选

商品编号，使用id查询其他条件可以不填

createTimeFrom

integer

可选

商品创建时间开始时间，Unix-Time时间戳

createTimeTo

integer

可选

商品创建时间结束时间，Unix-Time时间戳

updateTimeFrom

integer

可选

商品更新时间开始时间，Unix-Time时间戳

updateTimeTo

integer

可选

商品更新时间结束时间，Unix-Time时间戳

buyable

boolean

是否在架上

可选

stockGte

integer

库存大于等于某数

可选

stockLte

integer

库存小于等于某数

可选

pageNo

integer

可选

返回页码默认 1，页码从 1 开始 PS：当前采用分页返回，数量和页数会一起传，如果不传，则采用默认值

pageSize

integer

可选

返回数量，默认50最大100

barcode

string

商品条码

可选

skucode

string

小红书编码

可选

freeze

boolean

可选

是否被冻结 true为已冻结，false为未冻结

singlePackOnly

boolean

可选

只返回单品类型的商品

lastId

string

可选

查询起始商品id，全店商品时间倒序

isChannel

boolean

可选

不传返回全部，传true只返回渠道商品，传false只返回非渠道商品

timestamp

string

必需

接口调用时的时间戳，即当前时间戳（时间戳：当前距离Epoch（1970年1月1日) 以秒计算的时间，即unix-timestamp

appId

string

必需

第三方获取到的appid

sign

string

输入参数的签名结果

必需

version

string

必需

版本号，采用oauth2授权后均填入2.0

method

string

具体调用方法

必需

accessToken

string

可选

业务接口鉴权。非必须，调用商家业务接口必须使用

示例

返回响应

🟢200成功

application/json

Body

currentPage

integer

当前返回页

必需

pageSize

integer

查询总数

必需

total

integer

总商品数

必需

hits

array [object {14}]

商品基础信息列表

必需

itemId

string

商品编号

可选

name

string

商品名

可选

splId

string

spl编号

可选

spvId

string

spv编号

可选

spuId

string

spu编号

可选

price

integer

商品售价

可选

skucode

string

小红书编码

可选

buyable

boolean

是否可售卖

可选

barcode

string

可选

条形码，只能输入“字母数字 / -” (创建商品时手动填入，首选upc码，但不介意商家使用自定义商品编码)

stock

integer

商品可售普通库存数

可选

status

integer

审核状态(已弃用)

可选

freeze

boolean

可选

是否被冻结 true为已冻结，false为未冻结

createTime

integer

创建时间

可选

updateTime

integer

更新时间

可选