查询Item列表 - 小红书 API

curl --location --request POST 'https://ark.xiaohongshu.com/ark/open_api/v3/common_controller' \ --header 'Content-Type: application/json;charset=utf-8' \ --data-raw '{ "pageNo": 1, "pageSize": 50, "searchParam": { "keyword": "null", "topCategoryIds": [ "string" ], "lvl2CategoryIds": [ "string" ], "lvl3CategoryIds": [ "string" ], "lvl4CategoryIds": [ "string" ], "buyable": "", "keywords": [ "string" ], "logisticsPlanIds": [ "string" ], "createTimeFrom": 1625314893000, "createTimeTo": 1625314893000, "lastId": "6169406ff1404600095b96ed" } }'

{ "currentPage": 1, "pageSize": 50, "total": 1, "itemDetailV3s": [ { "name": "item标题", "ename": "itemEName", "brandId": "", "categoryId": "5a31****9df5", "attributes": [ { "propertyId": "5845****325e", "name": "测试属性名01", "value": "test", "valueId": "test", "valueList": [ { "valueId": "test", "value": "test" } ] } ], "shippingTemplateId": "null", "shippingGrossWeight": 100, "variantIds": [ "string" ], "images": [ "string" ], "videoUrl": "", "articleNo": "", "imageDescriptions": [ "string" ], "transparentImage": "", "description": "", "faq": [ { "question": "", "answer": "" } ], "isChannel": "", "deliveryMode": "", "freeReturn": "", "id": "64******412f1f", "createTime": "", "updateTime": "" } ] }

请求参数

Header 参数

Content-Type

string

可选

默认值:

application/json;charset=utf-8

Body 参数application/json

pageNo

integer

页码

必需

pageSize

integer

页大小

必需

searchParam

object

查询条件

必需

keyword

string

商品名称关键词

可选

topCategoryIds

array[string]

一级品类

可选

lvl2CategoryIds

array[string]

二级品类

可选

lvl3CategoryIds

array[string]

三级品类

可选

lvl4CategoryIds

array[string]

四级品类

可选

buyable

string

在架状态

可选

keywords

array[string]

可选

小红书编码/条形码/商品ID/SPUID/货号

logisticsPlanIds

array[string]

商品物流方案ID

可选

createTimeFrom

integer

商品创建时间大于

可选

createTimeTo

integer

商品创建时间小于

可选

lastId

string

可选

查询起始spuId，全店spu时间倒序

示例

返回响应

🟢200成功

application/json

Body

currentPage

integer

当前页码

必需

pageSize

integer

页大小

必需

total

integer

item总数

必需

itemDetailV3s

array [object {21}]

item列表

必需

name

string

item标题

可选

ename

string

item英文名

可选

brandId

integer

必需

品牌ID,目前查询品牌返回均为String但是是数字可以强转成Long使用

categoryId

string

末级商品类目ID

必需

attributes

array [object {5}]

item属性

必需

shippingTemplateId

string

运费模板ID

必需

shippingGrossWeight

string

必需

商品物流重量（克），当运费模版选择按重量计费时，该值必须大于0

variantIds

string

必需

item下商品规格列表

images

string

商品主图(必传)

必需

videoUrl

string

主图视频

必需

articleNo

string

商品货号

必需

imageDescriptions

string

商品详情描述图片

必需

transparentImage

string

透明图

必需

description

string

必需

商品描述文字，上限500字

faq

array [object {2}]

常见问题

必需

isChannel

boolean

是否是渠道商品

必需

deliveryMode

integer

必需

物流模式,0：普通，1：支持无物流发货（限定类目支持，不支持的类目创建会报错）

freeReturn

integer

必需

是否支持7天无理由,1：支持，2：不支持，不传会按照规则给默认值，必须支持则支持，不必须则不支持

string

必需

itemId,创建时不填，删除更新必填

createTime

integer

item创建时间

必需

updateTime

integer

item更新时间

必需