京东商品详情API调用教程：Python 30行代码搞定商品数据采集

admin2个月前 (09-07)京东API104

一、为什么我劝你别再自己写爬虫

做比价、选品、店铺分析、竞品监控的朋友，大概率都经历过这条血泪路：

写个爬虫抓京东商品页 → 跑两天还行；
某天突然全是滑块验证、risk 风控页面、请求被限流；
换 IP、调 headers、解滑块……花的时间比业务本身还多；
页面改版，XPath/CSS 选择器全部失效，又要重写。

核心问题：爬虫是"对抗"，数据接口是"合作"。

使用正规的商品详情数据API（由服务商对接平台官方授权数据通道），好处很直接：

稳定：不会因为页面改版就挂；
合规：走授权数据源，规避法律风险；
省事：一个接口返回结构化字段，不用自己解析 HTML；
数据全：标题、价格、主图、SKU规格、销量、店铺信息一次拿齐。

二、准备工作

对接京东商品详情API，你需要：点此申请appkey

项	说明
AppKey / AppSecret	向 API 服务商申请，用于身份认证与签名
接口地址	如 https://api.你的服务商域名.com/jd/item/get（以实际文档为准）
item_id	京东商品ID，即商品URL中 http://item.jd.com/100012043978.html 的 100012043978

本文代码为通用演示写法，不同服务商的域名、字段名、签名算法略有差异，请以你所接入服务商的 API 文档为准。

三、核心代码：约30行搞定

import time
import hashlib
import requests

APP_KEY = "你的AppKey"
APP_SECRET = "你的AppSecret"
API_URL = "https://api.你的服务商域名.com/jd/item/get"

def sign(params: dict) -> str:
    """参数排序拼接 + 密钥做MD5签名（算法以文档为准）"""
    text = "&".join(f"{k}={params[k]}" for k in sorted(params))
    text += "&key=" + APP_SECRET
    return hashlib.md5(text.encode("utf-8")).hexdigest()

def get_jd_item(item_id: str) -> dict:
    params = {
        "app_key": APP_KEY,
        "timestamp": str(int(time.time())),
        "item_id": item_id,
    }
    params["sign"] = sign(params)
    resp = requests.get(API_URL, params=params, timeout=10).json()
    if resp.get("code") != 0:
        raise RuntimeError(f"接口异常: {resp}")
    return resp["data"]   # 核心商品数据

if __name__ == "__main__":
    data = get_jd_item("100012043978")   # 换成你要采集的商品ID
    print("标题:", data["title"])
    print("价格:", data["price"])
    print("主图:", data["images"][0])
    print("SKU数:", len(data["skus"]))
    for sku in data["skus"][:3]:          # 打印前3个规格
        print("  ", sku["name"], "->", sku["price"])

以上核心逻辑就是：拼参数 → 签名 → 请求 → 解析返回，约30行。批量采集只需在外面套一层循环 + 限速，即可做成自己的选品库。

四、返回数据长什么样

接口返回为 JSON，核心字段示例如下（演示结构）：

{
"code"
:
0
,
"data"
:
{
"item_id"
:
"100012043978"
,
"title"
:
"商品标题"
,
"price"
:
99.00
,
"origin_price"
:
129.00
,
"images"
:
[
"主图URL1"
,
"主图URL2"
]
,
"category"
:
"手机配件"
,
"shop_name"
:
"店铺名称"
,
"skus"
:
[
{
"sku_id"
:
"1"
,
"name"
:
"黑色"
,
"price"
:
99.00
,
"stock"
:
500
}
]
,
"sales"
:
12000
}
}

字段	含义	常见用途
title	商品标题	上架、比价
price / origin_price	现价 / 原价	价格监控、利润测算
images	主图列表	独立站/店铺上架素材
skus	规格明细（ID/名称/价格/库存）	下单对接、库存同步
sales	销量	选品判断
shop_name	店铺名	供应商评估