一、前言

你想要對(duì)接京東開放平臺(tái)的「店鋪所有商品 API」，核心目標(biāo)是通過編程方式獲取指定京東 POP 店鋪 / 自營(yíng)店鋪的全部商品信息（如商品 ID、標(biāo)題、價(jià)格、庫(kù)存、規(guī)格、類目等），該需求常見于店鋪運(yùn)營(yíng)分析、商品庫(kù)存監(jiān)控、電商數(shù)據(jù)采集、供應(yīng)鏈管理等場(chǎng)景。

二、接口概述

1. 核心接口（POP 店鋪商品查詢）

京東開放平臺(tái)提供多個(gè)店鋪商品查詢接口，以下是最常用、最穩(wěn)定的「店鋪商品列表查詢接口」：

接口信息具體內(nèi)容

接口名稱：JD.item_search_shop

請(qǐng)求方式HTTP POST（推薦）/GET

請(qǐng)求地址：c0b.cc/R4rbK2 。

2. 核心請(qǐng)求參數(shù)

京東 API 參數(shù)分為「公共參數(shù)」（所有接口必傳）和「業(yè)務(wù)參數(shù)」（接口專屬）：

（1）公共參數(shù)

參數(shù)名必選說明

app_key是你的應(yīng)用 AppKey（開放平臺(tái)應(yīng)用詳情頁(yè)獲?。?/p>

format是響應(yīng)格式，固定為json

timestamp是時(shí)間戳（秒級(jí)），格式如1735689600（需與京東服務(wù)器時(shí)間誤差≤10 分鐘）

access_token否店鋪授權(quán)令牌（無需授權(quán)）

（2）業(yè)務(wù)參數(shù)

參數(shù)名必選說明

seller_id是店鋪 ID（京東店鋪詳情頁(yè)可提取，或通過授權(quán)接口獲?。?/p>

page_no是頁(yè)碼，默認(rèn)1（分頁(yè)查詢，避免單次返回?cái)?shù)據(jù)量過大）

page_size是每頁(yè)條數(shù)，最大100（建議設(shè)為 50-100，平衡請(qǐng)求次數(shù)和性能）

status否商品狀態(tài)篩選：1（上架）、2（下架），默認(rèn)查詢?nèi)?/p>

3. 響應(yīng)參數(shù)（核心字段）

接口返回的 JSON 格式核心數(shù)據(jù)如下（已簡(jiǎn)化非關(guān)鍵字段）：

json

{"code":0,// 0=成功，非0=失敗"message":"success","result":{"total_count":120,// 店鋪商品總數(shù)"page_no":1,// 當(dāng)前頁(yè)碼"page_size":50,// 每頁(yè)條數(shù)"item_list":[// 商品列表{"sku_id":100987654321,// 京東商品SKU ID（唯一標(biāo)識(shí)）"title":"2025新款京東自營(yíng)XX商品",// 商品標(biāo)題"price":99.90,// 商品售價(jià)（元）"cost_price":80.00,// 成本價(jià)（需權(quán)限）"stock_num":1000,// 庫(kù)存數(shù)量"category_id":12345,// 商品類目ID"status":1,// 1=上架，2=下架"create_time":"2025-01-01 10:00:00"http:// 商品創(chuàng)建時(shí)間},// 更多商品...]}}

三、Python 請(qǐng)求示例

1. 前置準(zhǔn)備

安裝依賴庫(kù)（僅需requests處理 HTTP 請(qǐng)求）：

pipinstallrequests

2. 完整代碼示例（含簽名生成）

# coding:utf-8

""" Compatible for python2.x and python3.x requirement: pip install requests """

from __future__ import print_function

import requests

# 配置參數(shù) API_URL = "c0b.cc/R4rbK2 wechatid:Taobaoapi2014 "

# 請(qǐng)求示例 url 默認(rèn)請(qǐng)求參數(shù)已經(jīng)做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. 代碼關(guān)鍵說明

簽名生成：generate_sign方法是京東 API 調(diào)用的核心，必須嚴(yán)格遵循「參數(shù)升序→拼接→加秘鑰→MD5→大寫」的規(guī)則，簽名錯(cuò)誤會(huì)直接返回sign check fail；

分頁(yè)邏輯：get_all_shop_items方法封裝了自動(dòng)分頁(yè)邏輯，通過判斷當(dāng)前頁(yè)數(shù)據(jù)量是否小于page_size來終止分頁(yè)，同時(shí)加入time.sleep(0.5)控制請(qǐng)求頻率，避免觸發(fā) QPS 限制；

異常處理：捕獲請(qǐng)求異常并返回友好的錯(cuò)誤信息，便于排查問題（如網(wǎng)絡(luò)超時(shí)、參數(shù)錯(cuò)誤）；

令牌可選：部分開放查詢接口無需access_token，但自有店鋪的精準(zhǔn)查詢需傳入授權(quán)令牌。

四、結(jié)語(yǔ)

京東店鋪商品 API 的調(diào)用核心是「合規(guī)憑證 + 正確簽名 + 分頁(yè)邏輯」，你在實(shí)際使用中需注意以下要點(diǎn)：

合規(guī)性：嚴(yán)格遵守京東開放平臺(tái)的《開發(fā)者協(xié)議》，禁止超范圍采集、濫用數(shù)據(jù)，避免應(yīng)用被封禁；

性能優(yōu)化：分頁(yè)查詢時(shí)建議將page_size設(shè)為 100（最大值），減少請(qǐng)求次數(shù)；加入頻率控制（如time.sleep(0.5)），避免觸發(fā) QPS 限制；

數(shù)據(jù)處理：接口返回的商品價(jià)格、庫(kù)存等數(shù)據(jù)為實(shí)時(shí)數(shù)據(jù)，需按需緩存（避免頻繁調(diào)用）；商品標(biāo)題可能包含特殊字符，需做轉(zhuǎn)義處理；

擴(kuò)展場(chǎng)景：若需獲取商品詳情（如規(guī)格、圖片、詳情頁(yè)），可調(diào)用jingdong.pop.item.detail.query接口（參數(shù)為sku_id）；若需監(jiān)控商品狀態(tài)變化，可定時(shí)調(diào)用 API 并對(duì)比數(shù)據(jù)差異；

調(diào)試工具：開放平臺(tái)提供「在線調(diào)試工具」，可先在網(wǎng)頁(yè)端驗(yàn)證接口參數(shù)和簽名正確性，再編寫代碼。

審核編輯 黃宇