一、核心接口信息
1. 常用接口
基础接口:jd.item_get(获取核心商品数据)
全量接口:jd.item_get_pro(获取完整详情,含图文、售后、运费)
请求方式:POST/GET,返回格式:JSON
2. 必传参数
接口地址:无需自主申请接口(如添加 TaoxiJd-api),直接调用封装API,一键获取已封装的商品详情页面数据,适合批量查询、中小卖家使用。
item_id/sku_id:商品ID,精准定位商品
timestamp:请求时间戳
二、Python请求示例
以下代码演示了如何调用京东商品详情API,并处理返回的JSON数据:
# coding:utf-8
""" Compatible for python2.x and python3.x requirement: pip install requests """
from __future__ import print_function
import requests
# 配置参数 API_URL = "o0b.cn/ibrad"
app_key = "YOUR_APP_KEY" num_id = "123456" # 目标商品ID
# 请求示例 url 默认请求参数已经做URL编码 url = "jd/item_get/?key=<您自己的apiKey>&num_iid=123456" headers = { "Accept-Encoding": "gzip", "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)
三、标准数据模型
核心字段详解
1. 基础信息(base)
skuId:最小库存单元ID(唯一标识)
spuId:商品聚合ID
productName:商品标题
brandName:品牌名称
category:类目路径
2. 价格促销(price)
jdPrice:京东售价
marketPrice:市场价(划线价)
promotionPrice:活动促销价
coupon:优惠券信息
3. 库存状态(stock)
stockNum:可售库存
stockState:库存状态(有货/无货/预售)
isPreSale:是否预售
4. 规格SKU(spec)
specList:规格属性(颜色、尺寸等)
skuList:多规格SKU集合
props:详细参数
5. 图片资源(image)
mainImage:商品主图
imageList:详情图集
videoUrl:商品视频
6. 销量评价(sales)
saleCount:销量数据
commentCount:评价总数
goodCommentRate:好评率
四、关键标识说明
京东商品详情API通过标准化接口和批量处理能力,为开发者提供了高效、灵活的数据获取方式。其高实时性和丰富的数据维度,使其成为电商应用开发、数据分析等场景的理想选择。开发者需注意遵守平台规则,合理使用API以避免频繁调用限制。