商品详情

接口描述

该接口可通过商品id，条形码或小红书编码查询商品详情。

URL

/ark/open_api/v1/items{?id}{?barcode}{?skucode}

URL Parameters

字段名称 类型 说明
id String 商品id
barcode String 条形码，只能输入“字母 数字 / -” (创建商品时手动填入，首选upc码，但不介意商家使用自定义商品编码)
skucode String 小红书编码(小红书系统内自动生成，无需填写)

Method

GET

Response 200 (application/json;charset=utf-8)

{
  "error_code": 0,
  "data": {
    "total": 1,
    "hits": [
      {
        "spv": {
          "spu_id": "58e5b5f5af0a672afacf4564",
          "pending_changes": null,
          "import_cost": 123,
          "net_weight": 25,
          "qty": 1,
          "spl_id": "58e5b5f5af0a672afacf4565",
          "id": "58e5b5f6af0a672afacf4568",
          "unit": "件",
          "barcode_type": "upc",
          "non_desc_variants": [],
          "state": 1,
          "usage": "test modified",
          "shelf_life": 270,
          "ingredient": "test modified",
          "status": 2,
          "customs_photos_urls": [],
          "barcode": "test01",
          "gross_weight": 45,
          "customs_photos": [
            {
              "path": "items/d84d018842bbff888a8a132fcf445769",
              "link": "http://img.xiaohongshu.com/items/d84d018842bbff888a8a132fcf445769",
              "name": "test01-1491486124643",
              "extension": ".jpg"
            }
          ],
          "manufacturer": "test modified",
          "customs_specification": "test modified",
          "country": "中国"
        },
        "item": {
          "spu_id": "58e5b5f5af0a672afacf4564",
          "update_time": 1491459994,
          "ename": "GUCCI testupdatespu white",
          "name": "GUCCI古驰 testupdatespu white",
          "logistics": "auto",
          "skucode": "test01",
          "original_price": 699.0,
          "tax": 52.700000000000003,   
          "pre_tax_price": 200.0,   
          "price": 252.69999999999999,   
          "tax_rate": 0.26350000000000001,
          "barcode": "test01",
          "pending_changes": null,
          "buyable": false,
          "spv_id": "58e5b5f6af0a672afacf4568",
          "state": 1,
          "create_time": 1491449335,
          "status": 2,
          "spl_id": "58e5b5f5af0a672afacf4565",
          "is_frozen": false,
          "top_image": null,
          "id": "58e5b5f7af0a672afacf456a",
          "barcode_type": "upc"
        },
        "spl": {
          "spu_id": "58e5b5f5af0a672afacf4564",
          "status": 2,
          "id": "58e5b5f5af0a672afacf4565",
          "state": 1,
          "variants": [
            {
              "ename": "Color",
              "id": "56d84f9a805d891008705275",
              "value": "white",
              "name": "颜色"
            }
          ],
          "pending_change": null
        },
        "spu": {
          "pending_changes": null,
          "ename": "testupdatespu",
          "name": "testupdatespu",
          "short_name": "testupdatespu",
          "brand": {
            "ename": "GUCCI",
            "id": "52d0deb1b4c4d655316b7d4b",
            "name": "古驰"
          },
          "brand_id": "52d0deb1b4c4d655316b7d4b",
          "category_id": "572dd173939e250d08ec59f2",
          "id": "58e5b5f5af0a672afacf4564",
          "categories": [
            {
              "ename": "Shoes",
              "id": "52ce1c02b4c4d649b58b892f",
              "name": "鞋子"
            },
            {
              "ename": "Women's shoes",
              "id": "56a6eecd8e7989cd56fcea7f",
              "name": "女鞋"
            },
            {
              "ename": "Women's high heels",
              "id": "572dd173939e250d08ec59f2",
              "name": "女士高跟鞋"
            }
          ]
        },
        "spl_item": {
          "spu_id": "58e5b5f5af0a672afacf4564",
          "status": 2,
          "videos": null,
          "spl_id": "58e5b5f5af0a672afacf4565",
          "feature": "initial",
          "image_urls": [],
          "faqs": [
            {
              "answer": "answer",
              "question": "question"
            }
          ],
          "state": 1,
          "pending_changes": {
            "status": 0,
            "videos": null,
            "feature": "test modified",
            "faqs": [
              {
                "answer": "modified",
                "question": "modified"
              }
            ],
            "images": [
              {
                "name": null,
                "extension": ".jpg",
                "height": 1200,
                "width": 900,
                "link": "http://img.xiaohongshu.com/items/d84d018842bbff888a8a132fcf445769",
                "path": "items/d84d018842bbff888a8a132fcf445769"
              }
            ],
            "attributes": null,
            "desc": "test modified"
          },
          "user_guide": {
            "images": [
              {
                "name": null,
                "extension": ".jpg",
                "height": 1200,
                "width": 900,
                "link": "//img.xiaohongshu.com/items/d84d018842bbff888a8a132fcf445769",
                "path": "items/d84d018842bbff888a8a132fcf445769"
              }
            ],
            "videos": []
          },
          "image_desc": {
            "images": [
              {
                "name": null,
                "extension": ".jpg",
                "height": 1200,
                "width": 900,
                "link": "//img.xiaohongshu.com/items/d84d018842bbff888a8a132fcf445769",
                "path": "items/d84d018842bbff888a8a132fcf445769"
              }
            ],
            "image_urls": []
          },
          "images": null,
          "attributes": [
            {
              "ename": null,
              "name": "材质",
              "image": null,
              "value": "TEST MATERIAL",
              "image_url": null,
              "property_id": "58450b30805d89635938325e"
            },
            {
              "ename": null,
              "name": "产地",
              "image": null,
              "value": "CHINA",
              "image_url": null,
              "property_id": "58450b30805d89635938325f"
            }
          ],
          "id": "58e5b5f5af0a672afacf4566",
          "desc": "initial"
        }
      }
    ],
    "current_page": 1,
    "page_size": 50
  },
  "error_msg": null,
  "success": true
}

Response parameter

名称 类型 说明
pending_changes Array 待审核的更改信息
spu Dict SPU模块信息
id String SPU ID
name String SPU中文名称
ename String SPU英文名称
brand_id String 品牌ID
short_name String 商品简称（不超过15个字符）
categories Array 分类列表，从一级分类到末级分类
spl Dict SPL模块信息
id String SPV ID
variants Array SPL规格列表
id String 规格ID
value String 规格值
spl_item Dict SPL ITEM模块信息
id String SPL ID
image_urls Array 商品图片URL列表
feature String 商品特色 (8字真言，不超过八个字符)
desc String 商品描述
user_guide Dict 使用指南,支持上传图片url
image_urls Array 使用指南的图片url列表
image_desc Dict 图文详情
image_urls Array 图文详情的图片url列表
attributes Array 产品参数，补充信息
property_id String 产品参数id
value String 产品参数信息
faqs Array 常见问题
question String 常见问题中的问题
answer String 常见问题中的答案
spv Dict spv模块信息
id String SPV ID
barcode String 商品条形码，只能输入“字母 数字 / -”
barcode_type String 条码类型
non_desc_variants Array SPV规格, 无SPV规格可不填
id String SPV规格id
value String SPV规格值
net_weight Float 净重
gross_weight Float 毛重
country String 原产国
qty Int 件数，内含数量
unit String 单位
shelf_life Int 保质期(天)
import_cost Float 进口成本价(CNY)(可粗略估计)
manufacturer String 生产厂家(填写全称，中文／英文)
customs_specification String 规格型号(例如，液体：10ml，10ml/支 (等其他计量单位) ；固体：10g，10g/支 (等其他计量单位)；配饰/鞋子/服装：尺寸、尺码、颜色。)
ingredient String 材质或成分含量(例如，水、二氧化碳等；帆布、牛皮等)
usage String 用途(例如，护肤等；背包、双肩包、凉鞋等)
customs_photos_urls Array 商品图片（用于海关备案）
item Dict item模块信息
id String ITEM ID
available Bool true为可选择上架，false为不可选择上架
buyable Bool true为可售卖，实际上架状态， false为不可售卖，实际下架状态
top_image String 天王图
create_time Int 商品创建时间
update_time Int 最后更新时间
original_price Float 商品原价
tax Float 税金
pre_tax_price Float 税前价,跨境税商家必填
price Float 税后价,非跨境税商家必填
tax_rate Float 税率
is_frozen Bool true为已冻结，false为未冻结
logistics String ITEM的物流模式
spu_id String SPU ID
spl_id String SPL ID
spv_id String SPV ID

补充说明

  1. state & status 具体状态码请参考商品状态码