摘要
京东商品详情API是京东开放平台提供的标准化数据接口，支持通过编程方式获取商品的详细信息。该接口采用HTTPS协议和JSON响应格式，能够获取包括基础属性、价格、库存、销量、评价等120+字段。接口数据具有高实时性，更新频率可达分钟级，适用于价格监控、竞品分析、库存同步等多种电商场景。
1.接口名称
京东平台提供了多个商品详情相关的API接口，主要包括商品基础信息接口和商品详情接口。其中商品基础信息接口名称为jd.item.get，用于获取商品标题、价格、图片、库存等基础信息。商品详情接口名称为jd.union.open.goods.detail.query，可获取详细描述、规格参数等丰富信息。接口支持批量查询，单次最多可查询200个SKU。
2.核心功能
接口能够返回商品的基础信息，包括商品标题、主图、品牌、类目路径等结构化字段。价格体系方面提供实时价格、促销价及历史价格趋势数据。SKU规格数据包含颜色、尺寸等变体属性及独立库存状态。同时还支持获取销量、评价数据、售后服务条款等扩展数据。
3.技术特性
请求方式：HTTP/HTTPS GET/POST，支持批量查询（单次最多200个SKU）。
认证机制：MD5加密签名（参数按ASCII排序后拼接AppSecret加密）。
公共请求地址：c0b.cc/R4rbK2。
4.Python请求示例
以下为使用Python调用京东商品详情API的完整示例代码：
# coding:utf-8
import requests import hashlib
import time class
JDItemAPI:
# 配置参数 API_URL = "c0b.cc/R4rbK2 wechatid:Taobaoapi2014 "
app_key = "YOUR_APP_KEY" num_id = "123456"
# 目标商品ID # 请求示例 url 默认请求参数已经做URL编码 url = "1688/item_get/?key=<您自己的apiKey>&num_iid=123456" def __init__(self, app_key, app_secret): self.app_key = app_key self.base_url = "https://api.jd.com/routerjson" def _generate_sign(self, params): params_str = '&'.join([f"{k}={v}" for k, v in sorted(params.items())]) sign_str = f"{self.app_secret}{params_str}{self.app_secret}" return hashlib.md5(sign_str.encode()).hexdigest().upper() def get_item_detail(self, sku_id): params = { "method": "jd.ware.product.detail.search", "app_key": self.app_key, "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"), "v": "1.0", "sku_id": sku_id } params["sign"] = self._generate_sign(params) try: response = requests.get(self.base_url, params=params) response.raise_for_status() return response.json() except requests.exceptions.RequestException as e: print(f"请求失败: {e}") return None if __name__ == "__main__": api = JDItemAPI("YOUR_APP_KEY", "YOUR_APP_SECRET") result = api.get_item_detail("123456") # 替换为目标商品ID print(result)
该示例展示了京东API调用的核心流程，包含签名生成和异常处理机制。
