小程序开放平台

文档中心
API 简介
登录
接口调用凭证
小程序码与链接
小程序基础信息
本地担保交易能力
业务接入流程
API列表
商品-获取信息
商品-批量获取信息
商品同步-生活服务
专业号主页商品排序
sku商品-批量删除
sku商品-批量上架
sku商品-批量下架
订单新增
订单-状态同步
获取订单支付token
担保支付订单-获取订单信息
凭证核销
预约单状态同步
发起预约
售后单-新增
同步售后单状态
获取售后订单详情
查询结算
结算咨询
结算明细查询
查询核销信息
通用担保交易能力
电商担保交易能力
地点管理能力
客服能力
群聊能力
小说能力
短剧能力
服务组件能力
直播能力

[交易组件]商品-批量获取信息

开发
>
服务端 API
>
本地担保交易能力
>
API列表
>
商品-批量获取信息
>
更新时间:2025-05-22 21:08:40

支持第三方调用

支持沙箱环境调用

禁止个人开发者调用

请求地址

POST https://miniapp.xiaohongshu.com/api/rmp/mp/deal/product/batch_get

公共请求参数

名称
类型
是否必须
描述
app_idstring是小程序appid
access_tokenstring是小程序调用凭证

业务请求参数

名称
类型
是否必须
描述
page_noint32否页号
page_sizeint32否页大小
statusint32否状态

请求示例

{
    "page_no":0,
    "page_size":0,
    "status":0
}

响应参数

名称
类型
是否必须
描述
data
struct否
list
list_struct否商品SPU列表
out_product_id
string否外部商品id
name
string否商品名
desc
string否小红书用户openId
path
string否商品详情
top_image
string否商品图片
category_id
string否商品类目
biz_create_time
int64否业务创建时间
biz_update_time
int64否业务修改时间
skus
list_struct否商品 skus
out_sku_id
string否外部商品 skuId
name
string否商品名
short_title
string否已废弃
sku_image
string否sku图片
origin_price
int64否商品原始价格
sale_price
int64否商品售卖价格
status
int32否sku 状态
sku_id
string否小红书内部 skuid
status
int32否状态
short_title
string否短标题
audit_info
struct否商品审核信息
submit_time
int64否最近一次提交时间
audit_time
int64否最近一次审核时间
reject_reason
string否拒绝原因
product_type
int32否商品类型,1-团购,2-酒旅预售券,3-酒旅日历商品
settle_type
int32否结算方式,1-总店结算,2-门店结算,3-区域结算,开通担保支付的商家下必传,使用门店或区域结算的前提是已认领门店并提交了门店资质
category_id_v2
string否新商品类目id
item_id
string否小红书内部商品id
total
int64否商品SPU总数
successbool否是否成功
msgstring否说明,正确响应时为 success,错误响应时为错误描述
codeint32否错误码,正确响应时为 0,错误响应时非0

响应示例

{
    "data":{
        "list":[
            {
                "out_product_id":"string",
                "name":"string",
                "desc":"string",
                "path":"string",
                "top_image":"string",
                "category_id":"string",
                "biz_create_time":0,
                "biz_update_time":0,
                "skus":[
                    {
                        "out_sku_id":"string",
                        "name":"string",
                        "short_title":"string",
                        "sku_image":"string",
                        "origin_price":0,
                        "sale_price":0,
                        "status":0,
                        "sku_id":"string"
                    }
                ],
                "status":0,
                "short_title":"string",
                "audit_info":{
                    "submit_time":0,
                    "audit_time":0,
                    "reject_reason":"string"
                },
                "product_type":0,
                "settle_type":0,
                "category_id_v2":"string",
                "item_id":"string"
            }
        ],
        "total":0
    },
    "success":true,
    "msg":"string",
    "code":0
}

业务错误码

参见错误码