Python采集京东商品API接口概述及JSON格式数据参考

最新推荐文章于 2025-07-31 21:59:30 发布

ID_18007905473

最新推荐文章于 2025-07-31 21:59:30 发布

阅读量3.6k

点赞数 5

CC 4.0 BY-SA版权

分类专栏： python API 文章标签：数据库 python 开发语言

本文链接：https://blog.csdn.net/ID_18007905473/article/details/148420794

API 同时被 2 个专栏收录

27 篇文章

订阅专栏

python

25 篇文章

订阅专栏

前言

一、接口概述

京东商品详情API接口是京东开放平台为开发者提供的服务，用于获取京东平台上商品的详细信息。通过调用该接口，开发者可以获取商品的名称、价格、库存、图片、规格参数、用户评价等结构化数据，适用于电商应用、价格监控、数据分析等场景。

二、接口特点

数据全面性
接口返回的数据涵盖多个维度，包括：
- 商品基本信息：名称、品牌、型号、分类等。
- 价格信息：当前售价、原价、促销价、折扣信息等。
- 库存信息：库存数量、库存状态等。
- 图片信息：主图、详情图、视频链接等。
- 规格参数：颜色、尺寸、重量等。
- 售后服务：退换货政策、保修期等。
- 用户评价：评价总数、好评率、示例评价等。
实时性
接口数据与京东平台实时同步，确保价格、库存等信息的及时性。
稳定性
京东作为大型电商平台，API接口经过严格测试，支持高并发访问，适合电商大促等场景。
安全性
接口采用签名验证机制（如MD5加密），确保请求的合法性，防止数据泄露。

三、Python采集示例代码

以下是一个使用Python调用京东商品详情API的示例代码：

	`import requests`
	`import hashlib`
	`import time`

	`class JDAPI:`
	`def __init__(self, app_key, app_secret):`
	`self.app_key = app_key`
	`self.app_secret = app_secret`
	`self.base_url = "https://api.jd.com/routerjson"`

	`def _generate_sign(self, params):`
	`# 参数排序并拼接`
	`sorted_params = sorted(params.items(), key=lambda x: x[0])`
	`query_string = '&'.join([f"{k}={v}" for k, v in sorted_params]) + self.app_secret`
	`# MD5加密生成签名`
	`return hashlib.md5(query_string.encode('utf-8')).hexdigest().upper()`

	`def call_api(self, method, params):`
	`# 公共参数`
	`common_params = {`
	`'app_key': self.app_key,`
	`'method': method,`
	`'timestamp': str(int(time.time())),`
	`'format': 'json',`
	`'v': '2.0',`
	`'sign_method': 'md5'`
	`}`
	`# 合并参数`
	`all_params = {common_params, params}`
	`# 生成签名`
	`all_params['sign'] = self._generate_sign(all_params)`
	`# 发送请求`
	`response = requests.get(self.base_url, params=all_params)`
	`return response.json()`

	`# 使用示例`
	`api = JDAPI('your_app_key', 'your_app_secret')`

	`# 获取商品基础信息`
	`def get_goods_info(api, sku_id):`
	`params = {`
	`'sku_ids': sku_id, # 商品ID，多个用逗号分隔`
	`'fields': 'sku_id,name,price,image_path,stock_state' # 需要返回的字段`
	`}`
	`result = api.call_api('jd.union.open.goods.query', params)`
	`return result`

	`# 获取商品详细信息`
	`def get_goods_detail(api, sku_id):`
	`params = {`
	`'sku_id': sku_id,`
	`'fields': 'sku_id,name,price,image_path,stock_state,description,after_service,spec_info'`
	`}`
	`result = api.call_api('jd.union.open.goods.detail.query', params)`
	`return result`

	`# 调用接口`
	`goods_info = get_goods_info(api, '100012345678')`
	`goods_detail = get_goods_detail(api, '100012345678')`

	`print("商品基础信息:", goods_info)`
	`print("商品详细信息:", goods_detail)`

四、JSON格式数据参考

以下是一个典型的京东商品详情API返回的JSON数据示例：

	`{`
	`"code": 200,`
	`"message": "success",`
	`"data": {`
	`"goods_detail_response": {`
	`"sku_id": "100012345678",`
	`"name": "华为Mate 50 Pro 5G手机",`
	`"price": 5999.00,`
	`"description": "<p>华为Mate 50 Pro 5G手机，采用6.74英寸OLED屏幕...</p>",`
	`"after_service": "全国联保，享受三包服务",`
	`"spec_info": {`
	`"颜色": ["曜金黑", "冰霜银", "流光紫"],`
	`"内存": ["8GB+128GB", "8GB+256GB", "12GB+512GB"]`
	`},`
	`"images": [`
	`"https://img10.360buyimg.com/n1/s450x450_jfs/t1/123456/78/12345/123456/12345678/1234567890abcdef.jpg"`
	`],`
	`"evaluation": {`
	`"total_reviews": 1000,`
	`"positive_rate": "95%"`
	`}`
	`}`
	`}`
	`}`