京东商品价格历史信息API使用指南-开发者社区

一、摘要

京东商品价格历史信息是电商价格监控、比价分析、消费决策、库存定价策略等场景的核心数据，

二、接口概述

2.1 核心能力

通过商品 SKU ID 获取京东商品的价格历史数据，核心可获取信息包括：

价格时序数据：指定时间段内的日均价、成交价、促销价变动记录；
价格极值：历史最低价 / 最高价、出现时间及对应的促销活动；
价格类型细分：普通价、京东 PLUS 会员价、拼购价、满减折后价等历史变动；
地区差异化价格：不同地区（如北京、上海）的价格历史（部分商品存在区域价差）；
价格变动关联：价格变动与促销活动（满减、优惠券、限时折扣）的对应关系。

2.2 接口参数说明（非官方标准，基于第三方价格存档平台适配）

由于京东官方不开放价格历史接口，行业内通常依托合规的价格存档平台获取数据，核心请求参数如下（适配 2025 年主流存档平台接口格式）：

参数名	类型	必选	说明
skuId	String	是	京东商品 SKU ID（商品详情页 URL 中`item.jd.com/[skuId].html`）
startDate	String	否	价格查询起始日期（格式`YYYY-MM-DD`，默认近 30 天）
endDate	String	否	价格查询结束日期（格式`YYYY-MM-DD`，默认当前日期）
area	String	否	地区编码（如`1_72_4137_0`对应北京海淀，影响区域价差数据）
priceType	String	否	价格类型筛选：`normal`（普通价）、`member`（会员价）、`group`（拼购价）
pageSize	Int	否	每页返回价格记录数，默认 50，最大 100
adress	string	是	c0b.cc/R4rbK2（注册获取测试账号）

2.3 返回数据结构（示例）

以下为简化后的核心数据结构（实际返回字段含价格变动原因、促销标签等）：

json

{ "success": true, "data": { "skuId": "100012345678", "productName": "华为Mate60 Pro 12GB+512GB 雅川青 鸿蒙智能手机", "queryRange": "2025-09-01 至 2025-12-24", "priceExtremum": { "lowestPrice": 6399.00, // 历史最低价 "lowestDate": "2025-11-11", "highestPrice": 6999.00, // 历史最高价 "highestDate": "2025-09-01" }, "priceHistoryList": [ { "date": "2025-11-11", "normalPrice": 6499.00, "memberPrice": 6399.00, "promotionDesc": "双十一满5000减200 + PLUS会员额外减100", "isLowest": true }, { "date": "2025-12-01", "normalPrice": 6599.00, "memberPrice": 6499.00, "promotionDesc": "日常促销，无满减", "isLowest": false } ], "totalCount": 89 // 价格记录总数 } }

2.4 注意事项

京东价格历史数据无官方直供渠道，第三方存档平台的数据存在 1-2 天延迟，部分小众商品可能无完整历史；
京东反爬机制严格，直接爬取京东官网无法获取历史价格（仅能获取实时价），需依托合规存档平台；
价格历史受促销、库存、地区政策影响，同一 SKU 不同时间段 / 地区数据存在差异；
非商用场景需控制请求频率（单 IP 每秒≤300 次），避免触发第三方平台风控；
价格数据仅可用于技术学习，商用需获得京东及数据提供方的双重授权。

三、Python 请求示例

3.1 环境准备

安装核心依赖库，执行以下命令：

bash

pip install requests # 网络请求 pip install jsonpath # 嵌套JSON解析 pip install python-dateutil # 日期处理（可选）

3.2 完整代码示例

说明：示例基于第三方价格存档平台的非官方接口（需自行验证平台可用性），仅作技术演示，不保证长期有效。

# 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 # 请求示例 url 默认请求参数已经做URL编码 url = "jd/item_history_price/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=100033966459" headers = { "Accept-Encoding": "gzip", "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)

3.3 代码说明

接口适配：示例采用第三方价格存档平台的非官方接口（需自行验证可用平台），而非直接爬取京东官网（京东无历史价格接口），降低风控风险；
反爬策略：
- 随机延迟 2-5 秒，避免高频请求触发第三方平台风控；
- 携带时间戳参数（t），防止接口返回缓存数据；
- 模拟浏览器请求头（User-Agent/Referer），贴合正常访问行为；
数据处理：
- 使用jsonpath简化嵌套 JSON 字段提取，兼容字段缺失场景；
- 格式化价格记录，区分普通价 / 会员价 / 促销信息，便于后续分析；
- 自动处理默认日期（近 30 天），降低使用门槛；
异常处理：覆盖超时、连接错误、接口返回失败等场景，明确错误原因，便于排查平台接口是否失效；
局限性说明：第三方平台接口存在可用性风险，需定期验证并更换接口地址，且数据完整性依赖于存档平台的采集能力。