在此以京東商品相關(guān)數(shù)據(jù)采集API接口為例
- item_get 獲得JD商品詳情
- item_search 按關(guān)鍵字搜索商品
- 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商品分類
簽名生成
- 準(zhǔn)備參數(shù):在調(diào)用淘寶商品圖片 API 時,通常需要準(zhǔn)備以下參數(shù):
- App Key測試:作為 API 使用者身份的憑證,在淘寶開放平臺創(chuàng)建應(yīng)用后獲得。
- Timestamp:用于防止請求重放攻擊,一般為當(dāng)前的日期和時間,格式通常為
YYYY-MM-DD HH:MM:SS
。 - 其他業(yè)務(wù)參數(shù):如商品 ID 等與具體業(yè)務(wù)相關(guān)的參數(shù),例如調(diào)用 “JD.item.get” 接口獲取商品主圖時,“num_iid” 參數(shù)指定商品的數(shù)字 ID
二、核心接口:商品詳情采集(item_get 類似接口)
1. 接口功能
- 獲取單個商品的詳細(xì)信息,包括商品 ID、標(biāo)題、價格、品牌、分類、圖片、SKU 列表、等。
2. 公共參數(shù)
名稱 | 類型 | 必須 | 描述 |
---|---|---|---|
key | String | 是 | 調(diào)用key(必須以GET方式拼接在URL中) |
secret | String | 是 | 調(diào)用密鑰 |
api_name | String | 是 | API接口名稱(包括在請求地址中)[item_search,item_get,item_search_shop等] |
cache | String | 否 | [yes,no]默認(rèn)yes,將調(diào)用緩存的數(shù)據(jù),速度比較快 |
result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回數(shù)據(jù)格式,默認(rèn)為json,jsonu輸出的內(nèi)容中文可以直接閱讀 |
lang | String | 否 | [cn,en,ru]翻譯語言,默認(rèn)cn簡體中文 |
version | String | 否 | API版本 |
3. 簽名生成規(guī)則
京東 API 采用 HMAC-SHA256 簽名算法,步驟如下:
- 按參數(shù)名 ASCII 碼升序排列所有請求參數(shù)(除
sign
外),拼接成key=value
格式的字符串。 - 在字符串前后拼接
App Secret
(即secret + 拼接字符串 + secret
)。 - 對拼接后的字符串進(jìn)行 SHA256 哈希,生成最終簽名(需轉(zhuǎn)為大寫)。
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 請求示例 url 默認(rèn)請求參數(shù)已經(jīng)做URL編碼
# 封裝好API供應(yīng)商demo url=o0b.cn/ibrad, wechat : TaoxiJd 復(fù)制鏈接獲取測試
# 小編: TaoxiJd-api 前往體驗(yàn)API:o0b.cn/ibrad
url = “key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=10335871600&domain_type=jd"
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)
三、代碼示例(Python)
1. 接口調(diào)用流程
{
"items": {
"page": "1",
"real_total_results": "13",
"total_results": "13",
"page_size": 10,
"pagecount": "3",
"_ddf": "szx",
"item": [
{
"title": "黃金香無添加劑豬肉絨",
"pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01XcpM1O1Pf8VBSz2rU_!!6000000001867-0-sm.jpg",
"promotion_price": "79.00",
"orginal_price": "79.00",
"price": "79.00",
"sales": 0,
"num_iid": "720686218372",
"seller_id": "725677994",
"detail_url": "https://item.taobao.com/item.htm?id=720686218372"
},
{
"title": "黃金香老字號招牌營養(yǎng)豬肉絨500g壽司烘焙肉松老人兒童早餐豬肉松",
"pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN012zWHLs2IlMfmHMpar_!!2218029889326.jpg",
"promotion_price": "68.30",
"orginal_price": "68.30",
"price": "68.30",
"sales": 0,
"num_iid": "804964622085",
"seller_id": "2218029889326",
"detail_url": "https://item.taobao.com/item.htm?id=804964622085"
},
{
"title": "黃金香老字號招牌營養(yǎng)豬肉絨500g壽司烘焙肉松老人兒童早餐豬肉松",
"pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01Hoemjp2DuSX7QU51c_!!4611686018427383501-0-item_pic.jpg",
"promotion_price": "119.60",
"orginal_price": "119.60",
"price": "119.60",
"sales": 0,
"num_iid": "902332828102",
"seller_id": "2219529439065",
"detail_url": "https://item.taobao.com/item.htm?id=902332828102"
},
{
"title": "黃金香老字號招牌營養(yǎng)豬肉絨500g壽司烘焙肉松老人兒童早餐豬肉松",
"pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01zhvQuR2GvmX9JkqZr_!!4611686018427385398-0-item_pic.jpg",
"promotion_price": "91.90",
"orginal_price": "91.90",
"price": "91.90",
"sales": 0,
"num_iid": "911581791874",
"seller_id": "2219082755054",
"detail_url": "https://item.taobao.com/item.htm?id=911581791874"
},
{
"title": "黃金香老字號招牌營養(yǎng)豬肉絨500g壽司烘焙肉松老人兒童早餐豬肉松",
"pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01Gw5baS212AAvmCCDs_!!2218898946926.jpg",
"promotion_price": "119.60",
"orginal_price": "119.60",
"price": "119.60",
"sales": 0,
"num_iid": "869171431282",
"seller_id": "2218898946926",
"detail_url": "https://item.taobao.com/item.htm?id=869171431282"
},
{
"title": "黃金香單片包裝午餐肉36g×5袋",
"pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01EvWPZr1i88fN238vK_!!6000000004367-0-sm.jpg",
"promotion_price": "59.00",
"orginal_price": "59.00",
"price": "59.00",
"sales": 0,
"num_iid": "742893951632",
"seller_id": "725677994",
"detail_url": "https://item.taobao.com/item.htm?id=742893951632"
},
{
"title": "黃金香廈門特產(chǎn)早餐零食金絲肉松",
"pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01jLfNlI1vzLcJrae7m_!!0-item_pic.jpg",
"promotion_price": "129.00",
"orginal_price": "129.00",
"price": "129.00",
"sales": 0,
"num_iid": "14124757541",
"seller_id": "594726243",
"detail_url": "https://item.taobao.com/item.htm?id=14124757541"
},
{
"title": "黃金香黑豬午餐肉36g×25袋",
"pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01W3dgge1rhhy5TaThI_!!6000000005663-0-sm.jpg",
"promotion_price": "259.00",
"orginal_price": "259.00",
"price": "259.00",
"sales": 0,
"num_iid": "750620016960",
"seller_id": "725677994",
"detail_url": "https://item.taobao.com/item.htm?id=750620016960"
},
{
"title": "黃金香老字號午餐肉36g×15袋",
"pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01Mj9iA71l3373iWvAj_!!6000000004762-0-sm.jpg",
"promotion_price": "159.00",
"orginal_price": "159.00",
"price": "159.00",
"sales": 0,
"num_iid": "750734657002",
"seller_id": "725677994",
"detail_url": "https://item.taobao.com/item.htm?id=750734657002"
},
{
"title": "黃金香玉米味黑豬午餐肉36g×5袋",
"pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01bFyWqY1nEcLf5BBWt_!!6000000005058-0-sm.jpg",
"promotion_price": "59.00",
"orginal_price": "59.00",
"price": "59.00",
"sales": 0,
"num_iid": "788135806724",
"seller_id": "725677994",
"detail_url": "https://item.taobao.com/item.htm?id=788135806724"
}
],
"item_weight_update": 0
},
"error_code": "0000",
"reason": "ok",
"secache": "45bbee2fa06a3b93da048c4db78c4bca",
"secache_time": 1744948338,
"secache_date": "2025-04-18 11:52:18",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"cache": 0,
"api_info": "today:3 max:10000 all[65=3+1+61];expires:2030-10-30",
"execution_time": "3.321",
"server_time": "Beijing/2025-04-18 11:52:18",
"client_ip": "117.44.142.101",
"call_args": {
"q": "黃金香老字號招牌營養(yǎng)豬肉絨",
"start_price": "0",
"end_price": "0",
"page": "1",
"cat": "0"
},
"api_type": "taobao",
"translate_language": "zh-CN",
"translate_engine": "google_new",
"server_memory": "4.37MB",
"request_id": "gw-3.6801cc6f51cea",
"last_id": "4292984242"
}
2. 響應(yīng)數(shù)據(jù)解析
{
"jingdong": {
"item": {
"sku": "100012345678",
"title": "小米 Redmi Note 12 5G 智能手機(jī)",
"price": {
"currentPrice": "1599.00", # 當(dāng)前價格
"originalPrice": "1799.00" # 原價
},
"brand": {
"brandId": "1363",
"brandName": "小米"
},
"stock": {
"stockNum": 100, # 庫存數(shù)量
"stockStatus": 1 # 庫存狀態(tài)(1=有貨,2=無貨)
},
"skus": [ # SKU列表(多規(guī)格商品)
{
"skuId": "100012345678",
"color": "藍(lán)色",
"memory": "8GB+128GB"
}
]
}
},
"error_code": 0, # 0表示成功,非0為錯誤碼
"error_msg": ""
}
通過以上方案,可合法、高效地采集京東商品數(shù)據(jù)。建議先從單個商品接口入手,逐步擴(kuò)展到批量數(shù)據(jù)處理,確保接口調(diào)用的穩(wěn)定性和合規(guī)性。