小程序开放平台

文档中心
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
stringsku图片
origin_price
int64商品原始价格
sale_price
int64商品售卖价格
status
int32sku 状态
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
}

业务错误码

参见错误码