商品列表完整版

接口描述

可通过不同的筛选条件获取相应的ITEM完整信息列表。

URL

/ark/open_api/v1/items{?status}{?page_no}{?page_size}{?create_time_from}{?create_time_to}{update_time_from}{?update_time_to}{?buyable}{?stock_gte}{?stock_lte}

Method

GET

Query Parameter

字段名称 类型 必填 说明
status String 否 商品状态(0为编辑中，1为待审核，2为审核通过)
page_no Int 否 商品页数, 从第一页开始,默认为1
page_size Int 否 商品列表每页数量，默认为50，上限为50
buyable Bool 否 商品是否可售卖，true为在架上可售卖，false为已下架不可售卖
create_time_from Int 否 商品创建时间开始时间，Unix-Time时间戳
create_time_to Int 否 商品创建时间结束时间，Unix-Time时间戳
update_time_from Int 否 商品更新时间开始时间，Unix-Time时间戳
update_time_to Int 否 商品更新时间结束时间，Unix-Time时间戳
stock_gte Int 否 库存大于等于某数
stock_lte Int 否 库存小于等于某数

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

{
    "error_code":0,
    "error_msg":null,
    "success": true,
    "data": {
        "current_page": 1,
        "page_size": 50,
        "total": 100,
        "hits":[
             {
                "item": {
                    "spu_id": "58df57bd46283960f49562a5",
                    "update_time": 1491827455,
                    "ename": null,
                    "name": "RED test high heel 灰色 39",
                    "logistics": "auto",
                    "skucode": "6907315161898",
                    "tax": 52.700000000000003,   
                    "pre_tax_price": 200.0,   
                    "price": 252.69999999999999,   
                    "tax_rate": 0.26350000000000001,
                    "barcode": "6907315161898",
                    "available": true,
                    "buyable": true,
                    "spv_id": "58e5a8e4c9d7597de8649ab2",
                    "state": 1,
                    "create_time": 1491445988,
                    "pending_changes": null,
                    "status": 2,
                    "spl_id": "58e5a86d70e7526fcc5caaa7",
                    "top_image": null,
                    "barcode_type": "upc",
                    "id": "58e5a8e4c9d7597de8649ab5",
                    "stock": 0,
                    "is_frozen": false

                },
                "spl": {
                    "spu_id": "58df57bd46283960f49562a5",
                    "status": 2,
                    "id": "58e5a86d70e7526fcc5caaa7",
                    "state": 1,
                    "variants": [
                        {
                            "ename": "Color",
                            "id": "56d84f9a805d891008705275",
                            "value": "灰色",
                            "name": "颜色"
                        }
                    ],
                    "pending_change": null
                },
                "spu": {
                    "pending_changes": null,
                    "ename": "",
                    "name": "test high heel",
                    "short_name": "",
                    "brand": {
                        "ename": "RED",
                        "id": "55587773b424d669f47bed35",
                        "name": "RED"
                    },
                    "brand_id": "55587773b424d669f47bed35",
                    "category_id": "572dd173939e250d08ec59f2",
                    "id": "58df57bd46283960f49562a5",
                    "categories": [
                        {
                            "ename": "Shoes",
                            "id": "52ce1c02b4c4d649b58b892f",
                            "name": "鞋子"
                        },
                        {
                            "ename": "Women's shoes",
                            "id": "56a6eecd8e7989cd56fcea7f",
                            "name": "女鞋"
                        },
                        {
                            "ename": "Women's high heels",
                            "id": "572dd173939e250d08ec59f2",
                            "name": "女士高跟鞋"
                        }
                    ]
                },
                "spv": {
                    "spu_id": "58df57bd46283960f49562a5",
                    "pending_changes": null,
                    "import_cost": null,
                    "net_weight": 50,
                    "qty": 1,
                    "spl_id": "58e5a86d70e7526fcc5caaa7",
                    "id": "58e5a8e4c9d7597de8649ab2",
                    "unit": "双",
                    "barcode_type": "upc",
                    "non_desc_variants": [
                        {
                            "ename": "Shoes Size",
                            "id": "56d84f9a805d891008705276",
                            "value": "39",
                            "name": "尺码"
                        }
                    ],
                    "state": 1,
                    "usage": "",
                    "shelf_life": null,
                    "ingredient": "",
                    "status": 2,
                    "customs_photos_urls": [],
                    "barcode": "6907315161898",
                    "gross_weight": 100,
                    "customs_photos": [],
                    "manufacturer": "",
                    "customs_specification": "",
                    "country": "中国"
                },
                "spl_item": {
                    "spu_id": "58df57bd46283960f49562a5",
                    "status": 3,
                    "videos": null,
                    "spl_id": "58e5a86d70e7526fcc5caaa7",
                    "feature": "12345",
                    "image_urls": [],
                    "faqs": [
                        {
                            "answer": "answer",
                            "question": "question？"
                        }
                    ],
                    "state": 1,
                    "pending_changes": null,
                    "user_guide": null,
                    "image_desc": null,
                    "images": [
                        {
                            "name": null,
                            "extension": ".jpg",
                            "height": 1200,
                            "width": 1200,
                            "link": "http://img.xiaohongshu.com/items/5d9ff90785e29809429f6b7873363fe3",
                            "path": "items/5d9ff90785e29809429f6b7873363fe3"
                        }
                    ],
                    "attributes": [
                        {
                            "ename": null,
                            "name": "材质",
                            "image": null,
                            "value": "丝绒，羊里皮",
                            "image_url": null,
                            "property_id": "58450b30805d89635938325e"
                        },
                        {
                            "ename": null,
                            "name": "鞋跟高",
                            "image": null,
                            "value": "70mm",
                            "image_url": null,
                            "property_id": "58450b31805d89635938327e"
                        },
                        {
                            "ename": null,
                            "name": "产地",
                            "image": null,
                            "value": "中国",
                            "image_url": null,
                            "property_id": "58450b30805d89635938325f"
                        }
                    ],
                    "id": "58e5a86d70e7526fcc5caaaa",
                    "desc": ""
                }
            }
        ]
    }
}

Response parameter

字段名称 类型 说明
current_page Int 商品列表当前的页数
page_size Int 商品每页的商品数量
total Int 商品的总个数
hits Array 商品列表
name String app内商品名称
barcode String 商品条码，只能输入“字母 数字 / -” (创建商品时手动填入，首选upc码，但不介意商家使用自定义商品编码)
spv_id String SPV id
spl_id String SPL id
skucode String 小红书编码(小红书系统内自动生成，无需填写)
spu_id String spu id
update_time Int 最后修改时间
create_time Int 商品创建时间
available Bool true为可选择上架，false为不可选择上架
buyable Bool true为可售卖，实际上架状态， false为不可售卖，实际下架状态
status String 商品状态(0为编辑中，1为待审核，2为审核通过)
stock Int 库存数量
spu Dict SPU模块信息
name String SPU中文名称
ename String SPU英文名称
brand_id String 品牌ID
short_name String 商品简称（不超过15个字符）
category_id String 分类ID (必须是最末级分类ID)
spl Dict SPL模块信息
variants Array SPL规格列表
id String 规格ID
value String 规格值
spl_item Dict SPL ITEM模块信息
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模块信息
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 商品id
original_price Float 商品原价
tax Float 税金
pre_tax_price Float 税前价,跨境税商家必填
price Float 税后价,非跨境税商家必填
tax_rate Float 税率
is_frozen Bool true为已冻结，false为未冻结
logistics String ITEM的物流模式

补充说明

  1. 请注意库存由于实时变化所以使用库存筛选条件不一定完全匹配。

  2. 该接口返回数据较多，建议使用时设置timeout为30s。

  3. status&state参见商品状态码