京东 API 接口实战：获取商品详情数据|价格|主图|详情图|评价-CSDN博客

本文链接：https://blog.csdn.net/Ob_API20230201/article/details/147501559

item_get 获得JD商品详情
item_search 按关键字搜索商品
item_search_img 按图搜索京东商品（拍立淘）
item_search_shop 获得店铺的所有商品
item_history_price 获取商品历史价格信息
item_recommend 获取推荐商品列表
buyer_order_list 获取购买到的商品订单列表
buyer_order_datail 获取购买到的商品订单详情
upload_img 上传图片到JD
item_review 获得JD商品评论
cat_get 获得jd商品分类

在电商应用开发与数据分析领域，精准获取商品详情数据是构建功能强大、体验优质平台的核心需求。京东作为头部电商平台，其开放的 API 接口为开发者提供了获取商品全维度数据的通道。本文将围绕 “京东 API 接口实战：获取商品详情数据、价格、主图、详情图、评价” 展开，带你从入门到精通，实现高效的数据抓取与应用。

一、前期准备：入驻京东开放平台

想要调用京东 API 接口获取商品数据，首先需要在京东开放平台完成开发者入驻，具体步骤如下：

注册与认证：访问京东开放平台官网，使用京东账号进行注册，并完成实名认证。实名认证有助于提升账号权限，确保接口调用的稳定性与安全性。

创建应用：在开放平台控制台中，点击 “创建应用” 按钮，按照提示填写应用名称、应用类型（如电商应用）、应用描述等信息。应用创建成功后，将获得唯一的 AppKey 和 AppSecret，这两个参数是调用 API 接口的重要凭证，务必妥善保管。

申请 API 权限：在 “我的应用” 页面中，找到已创建的应用，点击进入应用详情。在 “API 权限申请” 模块，搜索并勾选与商品详情、价格、图片、评价相关的 API 接口，例如 “商品信息查询接口”“商品价格查询接口”“商品评价查询接口” 等。提交申请后，等待京东官方审核，审核通过后即可正式使用这些接口。

二、核心接口解析与调用

（一）商品详情数据获取

京东item_get是获取商品基础信息的关键。通过传入商品 ID 参数，接口将返回包含商品标题、品牌、类目、规格参数等详细信息的 JSON 数据。

import requests

import hashlib

import time

app_key = "你的AppKey"

app_secret = "你的AppSecret"

method = "jd.union.open.goods.query" # 示例接口，需根据实际调整

timestamp = time.strftime('%Y-%m-%d %H:%M:%S', time.localtime())

# 构造请求参数

params = {

"app_key": app_key,

"method": method,

"timestamp": timestamp,

"goods_id": "123456789" # 替换为实际商品ID

}

# 生成签名

params["sign"] = hashlib.md5((app_secret + "".join([f"{k}{v}" for k, v in sorted(params.items())]) + app_secret).encode()).hexdigest().upper()

url = "https://api.jd.com/routerjson"

response = requests.get(url, params=params)

print(response.json())

在上述代码中，通过拼接参数并使用 MD5 算法生成签名，确保请求的合法性与安全性。

（二）商品价格获取

“商品价格查询接口” 可实时获取商品价格信息。接口返回数据通常包含原价、促销价、划线价等，满足不同场景下的价格展示需求。调用该接口时，同样需注意参数传递与签名生成，确保请求准确无误。

（三）商品图片获取

主图获取：商品信息接口返回的结果中，包含商品主图的 URL 地址。开发者可直接通过该 URL 下载主图，为商品展示提供视觉素材。

详情图获取：部分商品详情图需通过特定接口或解析商品详情页 HTML 代码获取。通常，京东商品详情页的图片链接存储在特定标签中，开发者可利用 Python 的BeautifulSoup库或正则表达式提取图片 URL，再进行下载操作。

from bs4 import BeautifulSoup

import requests

url = "https://item.jd.com/123456789.html" # 替换为实际商品详情页URL

response = requests.get(url)

soup = BeautifulSoup(response.text, 'html.parser')

img_tags = soup.find_all('img', class_="errloading") # 根据实际标签名调整

for img in img_tags:

img_url = img.get('src')

if img_url:

# 下载图片逻辑

pass

（四）商品评价获取

“商品评价查询接口” 是了解用户反馈的重要途径。接口支持按商品 ID、页码、评价类型（好评、差评、中评）等条件筛选评价数据。返回结果包含评价内容、用户昵称、评分、评价时间等信息，可用于商品口碑分析与用户互动。

# 示例代码：获取商品评价

import requests

import hashlib

import time

app_key = "你的AppKey"

app_secret = "你的AppSecret"

method = "jd.union.open.goods.comment.query" # 示例接口，需根据实际调整

timestamp = time.strftime('%Y-%m-%d %H:%M:%S', time.localtime())

params = {

"app_key": app_key,

"method": method,

"timestamp": timestamp,

"skuId": "123456789", # 商品SKU ID

"pageIndex": 1, # 页码

"pageSize": 10 # 每页数量

}

params["sign"] = hashlib.md5((app_secret + "".join([f"{k}{v}" for k, v in sorted(params.items())]) + app_secret).encode()).hexdigest().upper()

url = "https://api.jd.com/routerjson"

response = requests.get(url, params=params)

print(response.json())

三、数据处理与应用优化

（一）数据清洗与整合

从 API 接口获取的原始数据可能包含冗余信息或格式不规范的情况，需要进行数据清洗。例如，去除商品描述中的 HTML 标签、统一价格数据格式、处理评价中的特殊字符等。通过数据清洗，可提升数据质量，便于后续分析与展示。

（二）缓存机制

为减少接口调用频率，降低服务器压力，可引入缓存机制。对于不常变动的数据（如商品基础信息），可设置合理的缓存时间，在缓存有效期内直接读取缓存数据，避免重复调用接口。常见的缓存工具包括 Redis、Memcached 等。

（三）异常处理

在接口调用过程中，可能会遇到网络异常、接口返回错误码等情况。开发者需完善异常处理机制，通过捕获异常并进行相应处理（如重试请求、记录错误日志），确保应用的稳定性与数据获取的完整性。

四、注意事项与合规要求

遵守接口调用规则：京东开放平台对接口调用频率、调用时段等有明确限制，开发者需严格遵守相关规则，避免因违规操作导致接口权限被封禁。

数据使用合规性：获取的商品数据仅可用于合法的商业或开发用途，不得将数据泄露给第三方或用于非法活动。同时，需尊重用户隐私，对评价数据中的敏感信息进行脱敏处理。

接口版本更新：京东会不定期对 API 接口进行升级优化，开发者应及时关注接口文档更新，确保代码适配最新版本，避免因接口变动导致功能失效。

通过以上实战步骤，开发者能够熟练掌握京东 API 接口的使用方法，高效获取商品详情数据、价格、主图、详情图、评价等信息。结合实际业务需求，合理应用这些数据，将为电商应用开发、市场分析、用户运营等场景注入强大动力，助力项目实现更高价值。

以上文章覆盖了从准备到应用的全流程，并给出了代码示例。若你在实际操作中有特定需求，或想对某部分内容深入探讨，欢迎随时和我说。