京东商品详情API接口指南

一、前言

京东商品详情 API 是京东开放平台提供的核心接口之一，用于获取京东平台上商品的标题、价格、库存、规格、销量、评价等核心信息。该接口广泛应用于电商数据分析、比价工具开发、商品监控系统等场景。

二、接口概述

1. 核心接口信息

项⽬说明

接口名称商品详情查询（JD.item_get）

请求方式GET/POST（推荐 POST，避免参数暴露）

接口地址正式环境：c0b.cc/R4rbK2(前往体验接口测试，Taobaoapi2014添加V获取）。

响应格式JSON

2. 核心请求参数（必填）

参数名类型说明

app_keyString京东开放平台分配的应用 ID（创建应用后获取）

methodString接口方法名，固定值：jingdong.item.read.get

access_tokenString用户授权令牌（无需用户授权的场景可传空，需提前配置应用权限）

item_idString京东商品 ID（商品详情页 URL 中item.jd.com/xxxx.html的xxxx部分）

timestampString时间戳（格式：yyyy-MM-dd HH:mm:ss，如 2026-01-14 10:00:00）

vString接口版本号，固定值：2.0

signString接口签名（根据 appsecret + 参数拼接加密生成，京东有固定签名规则）

3. 核心返回参数

参数名类型说明

titleString商品标题

priceFloat商品售价（元）

stockInt商品库存数量

brandString商品品牌

categoryString商品所属分类

sales_countInt商品累计销量

sku_listArray商品规格（SKU）列表

总结

调用京东商品详情 API 的核心是获取有效的app_key/app_secret，并按规则生成sign签名；

Python 请求示例中，签名生成、参数构造、异常处理是保证接口调用成功的关键；

使用 API 时需遵守平台规范，优先做缓存优化，避免接口封禁或调用成本过高。

审核编辑 黄宇