京东API系列 | 京东商品详情API指南

一、前言
京东商品详情API是京东开放平台提供的标准化数据接口，开发者可通过编程方式获取京东商品的详细信息，包括基础属性、价格、库存、销量、评价等120+字段，适用于价格监控、竞品分析、库存同步等多种电商场景。该接口采用HTTPS协议和JSON响应格式，支持分钟级数据更新，为电商数据集成提供高效解决方案。

二、接口概述及调用

1. 京东价格获取
   通过jd.item.get接口可获取商品实时价格数据，包括基础售价、促销价及优惠信息。价格数据具有分钟级更新频率，支持批量查询最多200个SKU。返回字段包含price(当前售价)、original_price(原价)及promotion_info(促销详情)。

2. 京东图片获取
   接口返回商品主图、详情图及视频链接，字段包括images(主图URL数组)和video_url(视频链接)。通过skuList子节点可获取不同SKU对应的规格图片，图片资源采用CDN加速，建议客户端实现懒加载优化。

3. 京东详情获取
   核心字段包含title(商品标题)、description(HTML格式详情)、brand(品牌信息)及category(类目路径)。SKU规格通过skuList数组返回，包含各变体的skuId、name及独立库存数据，支持结构化解析商品参数如颜色、尺寸等属性。

4. 京东评论获取
   需调用独立接口item_review，返回数据包括rating(平均评分)、review_count(评论总数)及分页评论详情。评论数据更新频率为小时级，可通过sort_type参数按时间/有用性排序。

5. 公共请求地址：c0b.cc/R4rbK2 。

三、Python代码示例

# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 配置参数 API_URL = "c0b.cc/R4rbK2 wechatid:Taobaoapi2014 " 
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.实现签名生成算法，符合京东安全规范。
2.支持单商品多字段查询，可扩展批量请求。
3.返回标准JSON结构，包含状态码和数据体。

四、数据处理与优化
‌缓存机制‌：对价格/库存等高频变更数据设置5-10分钟本地缓存，减少API调用。
‌错误重试‌：对限频错误(HTTP 429)实现指数退避重试策略。
‌数据压缩‌：启用Accept-Encoding: gzip请求头降低传输开销。
‌批量处理‌：合并多个SKU查询请求，减少网络往返次数。
‌异步采集‌：使用aiohttp等库实现并发请求，提升吞吐量。