小红书 API
  1. 商品 API
小红书 API
  • 开发文档
    • 应用开发
    • 新手指南
    • 应用测试
    • 授权流程(自研)
    • 授权流程(软件服务商)
    • 签名算法
    • 系统参数说明
    • 应用消息推送
    • SDK 使用说明
    • 发布服务
  • API 调用场景
    • 商品基础介绍
    • 订单基础介绍
    • 跨境订单介绍
    • 订单接入方案
    • 售后接入说明
  • 数据加解密
    • 数据加密对接方案
    • 加密算法介绍
  • 电子面单
    • 电子面单对接说明
    • 电子面单打印组件协议
  • 规则中心
    • 小红书开放平台开发者协议
    • 数据安全承诺函
    • 服务市场上架审核标准
    • 开发者角色说明
    • 小红书服务市场服务协议(服务商版)
    • 小红书服务市场管理规范
    • 企业管理类目管理规则
    • 商品管理类目管理规则
    • 订单管理类目管理规则
    • 内容工具类目管理规则
    • 小红书服务市场保证金要求
  • 公共 API
    • 批量获取发货时间规则
    • 获取地址信息(新)
    • 获取商家地址库
    • 获取分类列表
    • 由末级分类获取规格(新)
    • 由末级分类获取属性
    • 由属性获取属性值
    • 获取快递公司信息
    • 获取物流方案列表
    • 运费模版列表
    • 运费模版详情
    • 获取品牌信息
    • 获取物流模式列表
    • 获取地址信息
    • 获取老版本商家授权信息
    • cc资质检查
    • 商品标题类目预测
    • 由末级分类获取规格(旧)
  • 订单 API
    • 带货达人侧详情查询
    • 查询月度结算单下载地址
    • 订单列表
    • 订单详情
    • 订单收件人信息
    • 修改订单备注
    • 订单发货
    • 修改快递单号
    • 订单物流轨迹
    • 海关申报信息
    • 获取取消申请列表(即将下线)
    • 取消申请审核(即将下线)
    • 跨境清关支持口岸
    • 跨境重推支付单
    • 跨境商品备案信息同步
    • 跨境商品备案信息查询
    • 小包批次创建
    • 开票列表查询
    • 开票结果回传(正向蓝票开具)
    • 发票冲红(逆向冲红)
    • 批量解密
    • 批量脱敏
    • 批量获取索引串
  • 售后 API
    • 售后换货确认收货并发货
    • 获取售后列表
    • 售后详情
    • 售后审核(新)
    • 售后确认收货(新)
  • 商品 API
    • 商品列表基础版
      POST
    • 商品列表完整版(新)
      POST
    • 更新物流方案
      POST
    • 商品上下架
      POST
    • 创建ITEM
      POST
    • 更新TEM
      POST
    • 删除ITEM
      POST
    • 创建SKU
      POST
    • 更新SKU
      POST
    • 删除SKU
      POST
    • 查询Item列表
      POST
    • 获取ITEM详情
      POST
    • 修改价格
      POST
    • 修改商品主图、主图视频
      POST
    • 修改规格图
      POST
  • 库存 API
    • 获取商品库存
    • 同步库存
    • 增减库存
  • 素材中心 API
    • 素材列表
    • 上传素材
    • 修改素材
    • 删除素材
  • 消息文档
    • 商品新建
    • 商品上下架
    • 商品审核驳回
    • 商品删除
  • 物流 API
    • 查询电子面单订购关系
    • 查询电子面单模板列表
    • 批量取号
    • 更新面单
    • 取消面单
    • 查询面单
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  1. 商品 API

获取ITEM详情

POST
/ark/open_api/v3/common_controller
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://ark.xiaohongshu.com/ark/open_api/v3/common_controller' \
--header 'Content-Type: application/json;charset=utf-8' \
--data-raw '{
    "pageSize": 1,
    "pageNo": 1,
    "itemId": "1"
}'
响应示例响应示例
{
  "total": "",
  "skuInfos": [
    {
      "itemId": "64ff12f***fd12f1",
      "ipq": 100,
      "originalPrice": 88,
      "price": 80,
      "stock": 5000,
      "logisticsPlanId": "5e37***a9f0",
      "whcode": "C01",
      "priceType": 1,
      "erpCode": "001231",
      "variants": [
        {
          "id": "5a60***9ce6",
          "name": "尺码",
          "value": "36",
          "valueId": "f423***921f"
        }
      ],
      "deliveryTime": {
        "time": "2021/06/01",
        "type": "ABSOLUTE_TIME"
      },
      "specImage": "http://img.xiaohongshu.com/items/123456789",
      "barcode": "RedTest20200507001",
      "rowNumber": "",
      "id": "6123**5132",
      "scSkucode": "XHSd12f1r1f",
      "logisticsName": "red_auto",
      "buyable": true,
      "unionItemDetails": [
        {
          "id": "607***450",
          "name": "口红",
          "scSkuCode": "690***466",
          "barcode": "690***452",
          "ipq": 100,
          "erpCode": "dq123da"
        }
      ],
      "createTime": "",
      "updateTime": "",
      "name": "",
      "isGift": true
    }
  ],
  "itemInfo": {
    "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": ""
  },
  "pageNO": "",
  "pageSize": ""
}

请求参数

Header 参数
Content-Type
string 
可选
默认值:
application/json;charset=utf-8
Body 参数application/json
itemId
string 
itemId
必需
pageNo
integer 
页码数
可选
pageSize
integer 
页面大小
可选
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
itemInfo
array [object {22}] 
item信息
必需
spuId
string 
spu编号
可选
ipq
integer 
打包数
可选
originalPrice
integer 
市场价
可选
price
integer 
售价
可选
stock
integer 
库存
可选
logisticsPlanId
string 
物流方案Id
可选
whcode
string 
仓库号
可选
priceType
integer 
可选
商品是否包税,0:不包税;1:包税
erpCode
string 
商家编码
可选
variants
array [object {4}] 
规格列表
可选
deliveryTime
object 
发货时间信息
可选
specImageUrl
string 
规格图
可选
barcode
string 
可选
商品条形码,创建特定品类必填,普通品类可不填
id
string 
itemId
可选
skucode
string 
sku编号
可选
logisticsName
string 
物流模式名
可选
buyable
boolean 
可选
是否在架上,仅用于返回
unionItemDetails
array [object {6}] 
可选
组合商品子商品信息,仅返回使用
createTime
string 
可选
商品创建时间,仅返回使用
updateTime
string 
可选
商品更新时间,仅返回使用
name
string 
可选
商品名称,仅返回使用
isGift
boolean 
是否是赠品,
可选
total
integer 
返回的商品总数
必需
pageNO
integer 
页码
必需
pageSize
integer 
页大小
必需
skuInfos
array [object {23}] 
sku列表
必需
itemId
string 
item编号
必需
ipq
integer 
必需
打包数,只允许创建ipq为1的商品,该字段查询使用
originalPrice
integer 
市场价,单位分
必需
price
integer 
必需
售价,单位分,要求小于市场价,上限10w元,即10000000分
stock
integer 
库存
必需
logisticsPlanId
string 
物流方案Id
必需
whcode
string 
仓库号
必需
priceType
integer 
是否包税
必需
erpCode
string 
商家编码
必需
variants
array [object {4}] 
规格列表
必需
deliveryTime
object 
发货时间信息
必需
specImage
string 
规格图
必需
barcode
string 
必需
商品条形码,创建特定品类必填
rowNumber
integer 
必需
sku在item中的顺序,不支持更新
id
string 
skuId
必需
scSkucode
string 
必需
scSkuCode编号,小红书编码
logisticsName
string 
物流模式名
必需
buyable
boolean 
必需
是否在架上,仅用于返回
unionItemDetails
array [object {6}] 
必需
组合商品子商品信息,仅返回使用
createTime
integer 
必需
商品创建时间,仅返回使用
updateTime
integer 
必需
商品更新时间,仅返回使用
name
string 
必需
商品名称,仅返回使用
isGift
boolean 
是否是赠品,
必需

【小红书】API开发者 微信交流群

用微信扫右侧二维码,加入【小红书】API开发者 交流群,互助沟通

扫码加入交流群
上一页
查询Item列表
下一页
修改价格
Built with