当前位置：首页 > news >正文

商品详情 API 返回数据字段说明

news 来源：原创 2025/6/26 1:39:26

京东商品详情 API 返回的数据是一个结构化的 JSON 对象，包含了商品的多个关键字段。以下是一些常见的返回值字段及其说明：

1. 商品基本信息

num_iid：商品唯一标识符。
title：商品标题。
desc_short：商品简短描述。
brand：商品品牌。
category：商品分类。
origin：商品产地。

2. 价格信息

price：商品当前价格。
original_price：商品原价。
discount_price：商品促销价。
promotion_info：活动信息，如满减、折扣等。

3. 库存信息

stock_quantity：当前库存数量。
sales_volume：销量。

4. 评价信息

rating：用户评分。
comment_count：评论数量。
comments：评论内容列表（可能需要额外请求）。

5. 图片和媒体信息

pic_url：商品主图 URL。
images：商品图片列表。
videos：商品视频（如果有的话）。

6. 规格参数

skuList：商品的 SKU 列表，每个 SKU 代表一个具体的商品规格和价格组合。
- skuId：SKU 的 ID。
- name：SKU 的名称。
- price：SKU 的价格。
- stock：SKU 的库存数量。
props_list：商品属性列表，如尺码、颜色等。

7. 店铺信息

seller_info：卖家信息，包括卖家 ID、店铺 ID 等。

8. 其他信息

detail_url：商品详情页 URL。
description：商品详细描述。

示例 JSON 数据

JSON

{
    "code": "0",
    "errorMessage": "success",
    "jingdong_item_detail_response": {
        "items": [
            {
                "num_iid": "1234567890",
                "title": "商品标题",
                "desc_short": "商品简短描述",
                "brand": "品牌名称",
                "category": "分类名称",
                "origin": "产地",
                "price": "120.00",
                "original_price": "150.00",
                "discount_price": "100.00",
                "promotion_info": "满减信息",
                "stock_quantity": 100,
                "sales_volume": 500,
                "rating": 4.5,
                "comment_count": 200,
                "pic_url": "https://img10.360buyimg.com/n1/s200x200_jfs/t1/123456/1/1234567890.jpg",
                "images": [
                    "https://img10.360buyimg.com/n1/s200x200_jfs/t1/123456/1/1234567890.jpg",
                    "https://img10.360buyimg.com/n1/s200x200_jfs/t1/123456/2/1234567890.jpg"
                ],
                "videos": [
                    "https://video.jd.com/1234567890.mp4"
                ],
                "skuList": [
                    {
                        "skuId": "123456",
                        "name": "红色",
                        "price": "120.00",
                        "stock": 50
                    }
                ],
                "props_list": {
                    "color": "红色",
                    "size": "L"
                },
                "seller_info": {
                    "seller_id": "123456",
                    "shop_id": "789012"
                },
                "detail_url": "https://item.jd.com/1234567890.html",
                "description": "商品详细描述"
            }
        ]
    }
}