京东店铺所有商品API接口使用指南

一、前言

你想要对接京东开放平台的「店铺所有商品 API」，核心目标是通过编程方式获取指定京东 POP 店铺 / 自营店铺的全部商品信息（如商品 ID、标题、价格、库存、规格、类目等），该需求常见于店铺运营分析、商品库存监控、电商数据采集、供应链管理等场景。

二、接口概述

1. 核心接口（POP 店铺商品查询）

京东开放平台提供多个店铺商品查询接口，以下是最常用、最稳定的「店铺商品列表查询接口」：

接口信息具体内容

接口名称：JD.item_search_shop

请求方式HTTP POST（推荐）/GET

请求地址：c0b.cc/R4rbK2 。

2. 核心请求参数

京东 API 参数分为「公共参数」（所有接口必传）和「业务参数」（接口专属）：

（1）公共参数

参数名必选说明

app_key是你的应用 AppKey（开放平台应用详情页获取）

format是响应格式，固定为json

timestamp是时间戳（秒级），格式如1735689600（需与京东服务器时间误差≤10 分钟）

access_token否店铺授权令牌（无需授权）

（2）业务参数

参数名必选说明

seller_id是店铺 ID（京东店铺详情页可提取，或通过授权接口获取）

page_no是页码，默认1（分页查询，避免单次返回数据量过大）

page_size是每页条数，最大100（建议设为 50-100，平衡请求次数和性能）

status否商品状态筛选：1（上架）、2（下架），默认查询全部

3. 响应参数（核心字段）

接口返回的 JSON 格式核心数据如下（已简化非关键字段）：

json

{"code":0,// 0=成功，非0=失败"message":"success","result":{"total_count":120,// 店铺商品总数"page_no":1,// 当前页码"page_size":50,// 每页条数"item_list":[// 商品列表{"sku_id":100987654321,// 京东商品SKU ID（唯一标识）"title":"2025新款京东自营XX商品",// 商品标题"price":99.90,// 商品售价（元）"cost_price":80.00,// 成本价（需权限）"stock_num":1000,// 库存数量"category_id":12345,// 商品类目ID"status":1,// 1=上架，2=下架"create_time":"2025-01-01 10:00:00"// 商品创建时间},// 更多商品...]}}

三、Python 请求示例

1. 前置准备

安装依赖库（仅需requests处理 HTTP 请求）：

pipinstallrequests

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_search_shop/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&shop_id=12693679&page=1&sort=" headers = { "Accept-Encoding": "gzip", "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)

3. 代码关键说明

签名生成：generate_sign方法是京东 API 调用的核心，必须严格遵循「参数升序→拼接→加秘钥→MD5→大写」的规则，签名错误会直接返回sign check fail；

分页逻辑：get_all_shop_items方法封装了自动分页逻辑，通过判断当前页数据量是否小于page_size来终止分页，同时加入time.sleep(0.5)控制请求频率，避免触发 QPS 限制；

异常处理：捕获请求异常并返回友好的错误信息，便于排查问题（如网络超时、参数错误）；

令牌可选：部分开放查询接口无需access_token，但自有店铺的精准查询需传入授权令牌。

四、结语

京东店铺商品 API 的调用核心是「合规凭证 + 正确签名 + 分页逻辑」，你在实际使用中需注意以下要点：

合规性：严格遵守京东开放平台的《开发者协议》，禁止超范围采集、滥用数据，避免应用被封禁；

性能优化：分页查询时建议将page_size设为 100（最大值），减少请求次数；加入频率控制（如time.sleep(0.5)），避免触发 QPS 限制；

数据处理：接口返回的商品价格、库存等数据为实时数据，需按需缓存（避免频繁调用）；商品标题可能包含特殊字符，需做转义处理；

扩展场景：若需获取商品详情（如规格、图片、详情页），可调用jingdong.pop.item.detail.query接口（参数为sku_id）；若需监控商品状态变化，可定时调用 API 并对比数据差异；

调试工具：开放平台提供「在线调试工具」，可先在网页端验证接口参数和签名正确性，再编写代码。

审核编辑 黄宇