一、前言

你想要對接京東開放平臺的「店鋪所有商品 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"http:// 商品創建時間},// 更多商品...]}}

三、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 并對比數據差異；

調試工具：開放平臺提供「在線調試工具」，可先在網頁端驗證接口參數和簽名正確性，再編寫代碼。

審核編輯 黃宇