京东API系列 | 京东商品详情API指南-CRMEB社区

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

管理

编辑

删除

一、前言

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

二、接口概述及调用

京东价格获取

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

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

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

需调用独立接口item_review，返回数据包括rating(平均评分)、review_count(评论总数)及分页评论详情。评论数据更新频率为小时级，可通过sort_type参数按时间/有用性排序。
公共请求地址：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结构，包含状态码和数据体。

四、数据处理与优化

‌1.缓存机制‌：对价格/库存等高频变更数据设置5-10分钟本地缓存，减少API调用。

‌2.错误重试‌：对限频错误(HTTP 429)实现指数退避重试策略。

‌3.数据压缩‌：启用Accept-Encoding: gzip请求头降低传输开销。

‌4.批量处理‌：合并多个SKU查询请求，减少网络往返次数。

‌5.异步采集‌：使用aiohttp等库实现并发请求，提升吞吐量。