京東關(guān)鍵詞搜索接口獲取商品數(shù)據(jù) 實(shí)操指南

本指南聚焦京東開放平臺合規(guī)接口（item_search基礎(chǔ)版 / item_search_pro增強(qiáng)版），提供從賬號準(zhǔn)備→接口調(diào)用→數(shù)據(jù)解析→落地應(yīng)用的全流程實(shí)操步驟，確保新手也能快速完成商品數(shù)據(jù)獲取，適配電商選品、競品分析、運(yùn)營監(jiān)控等核心場景。

一、 實(shí)操前置：合規(guī)準(zhǔn)備與核心憑證獲取

京東關(guān)鍵詞接口屬于官方開放接口，需完成開發(fā)者認(rèn)證與權(quán)限申請，嚴(yán)禁未經(jīng)授權(quán)的爬蟲抓取，否則會面臨 IP 封禁、法律風(fēng)險(xiǎn)。

1. 賬號與權(quán)限準(zhǔn)備（3 步完成）

注意：item_search_pro屬于高級接口，需單獨(dú)申請權(quán)限，審核周期比基礎(chǔ)版長 1-2 個(gè)工作日。

2. 工具準(zhǔn)備

開發(fā)環(huán)境：Python/Java/PHP（推薦 Python，代碼簡潔易上手）

依賴工具：Python 需安裝requests庫（pip install requests）、Java 需安裝HttpClient、PHP 需開啟curl擴(kuò)展

輔助工具：Postman（接口調(diào)試）、Excel/MySQL（數(shù)據(jù)存儲）

二、 核心配置：接口參數(shù)與簽名算法（必掌握）

京東 API 采用 “參數(shù) + 簽名” 驗(yàn)證機(jī)制，簽名錯(cuò)誤是調(diào)用失敗的最常見原因，需嚴(yán)格按以下步驟配置。

1. 接口參數(shù)分類（公共參數(shù) + 業(yè)務(wù)參數(shù)）

（1） 公共參數(shù)（所有接口通用，必填）

（2） 業(yè)務(wù)參數(shù)（關(guān)鍵詞搜索核心參數(shù)）

2. 簽名算法實(shí)操（3 步生成，以 Python 為例）

簽名是京東 API 的核心驗(yàn)證環(huán)節(jié)，步驟如下：

參數(shù)排序：將所有公共參數(shù) + 業(yè)務(wù)參數(shù)，按參數(shù)名 ASCII 碼升序排列（如app_key→format→keyword→method...）

拼接字符串：按 key=value&key=value 格式拼接排序后的參數(shù)（不進(jìn)行 URL 編碼）

HMAC-SHA256 加密：用AppSecret作為密鑰，對拼接字符串進(jìn)行加密，結(jié)果轉(zhuǎn)大寫即為sign

python

運(yùn)行

# 簽名生成示例代碼（直接復(fù)用）
import hashlib
import hmac

def generate_sign(params, app_secret):
    # 步驟1：按參數(shù)名ASCII升序排序
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    # 步驟2：拼接字符串
    sign_str = "&".join([f"{k}={v}" for k, v in sorted_params])
    # 步驟3：HMAC-SHA256加密并轉(zhuǎn)大寫
    sign = hmac.new(
        app_secret.encode("utf-8"),
        sign_str.encode("utf-8"),
        hashlib.sha256
    ).hexdigest().upper()
    return sign

三、 實(shí)戰(zhàn)調(diào)用：Python 代碼實(shí)現(xiàn)（基礎(chǔ)版 / 增強(qiáng)版通用）

以下代碼為可直接運(yùn)行版本，只需替換APP_KEY、APP_SECRET即可完成調(diào)用，包含「接口請求 + 數(shù)據(jù)解析 + 結(jié)果輸出」全流程。

1. 完整代碼（基礎(chǔ)版item_search）

python

運(yùn)行

import requests
import hashlib
import hmac
import time

# ------------------- 配置區(qū)（替換為你的憑證） -------------------
APP_KEY = "你的AppKey"
APP_SECRET = "你的AppSecret"
API_URL = "https://api.jd.com/routerjson"  # 京東API網(wǎng)關(guān)地址

# ------------------- 簽名生成函數(shù) -------------------
def generate_sign(params, app_secret):
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    sign_str = "&".join([f"{k}={v}" for k, v in sorted_params])
    sign = hmac.new(
        app_secret.encode("utf-8"),
        sign_str.encode("utf-8"),
        hashlib.sha256
    ).hexdigest().upper()
    return sign

# ------------------- 接口調(diào)用函數(shù) -------------------
def jd_item_search(keyword, page=1, page_size=30, sort_type="sales_desc"):
    # 1. 組裝參數(shù)（公共參數(shù)+業(yè)務(wù)參數(shù)）
    params = {
        "app_key": APP_KEY,
        "method": "jd.union.open.goods.search",  # 基礎(chǔ)版接口名
        "format": "json",
        "v": "3.0",
        "timestamp": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()),
        "keyword": keyword,
        "page": str(page),
        "page_size": str(page_size),
        "sort_type": sort_type
    }
    # 2. 生成簽名并加入?yún)?shù)
    params["sign"] = generate_sign(params, APP_SECRET)
    # 3. 發(fā)送請求
    try:
        response = requests.get(API_URL, params=params, timeout=10)
        response.raise_for_status()  # 拋出HTTP異常
        return response.json()
    except Exception as e:
        print(f"接口調(diào)用失?。簕str(e)}")
        return None

# ------------------- 數(shù)據(jù)解析函數(shù) -------------------
def parse_goods_data(result):
    """提取商品核心字段：ID、標(biāo)題、價(jià)格、銷量、庫存"""
    goods_list = []
    if not result:
        return goods_list
    # 解析返回結(jié)果（按京東API格式）
    data = result.get("jd_union_open_goods_search_response", {}) 
                .get("result", {}) 
                .get("data", [])
    for goods in data:
        goods_info = {
            "sku_id": goods.get("skuId", ""),          # 商品唯一ID
            "title": goods.get("goodsName", ""),       # 商品標(biāo)題
            "price": goods.get("price", 0.0),          # 現(xiàn)價(jià)
            "original_price": goods.get("originalPrice", 0.0),  # 原價(jià)
            "sales": goods.get("salesCount", 0),       # 累計(jì)銷量
            "stock": goods.get("stock", 0),            # 庫存
            "shop_name": goods.get("shopName", "")     # 店鋪名稱
        }
        goods_list.append(goods_info)
    return goods_list

# ------------------- 主函數(shù)調(diào)用 -------------------
if __name__ == "__main__":
    # 搜索關(guān)鍵詞：無線藍(lán)牙耳機(jī) 主動降噪，按銷量排序
    result = jd_item_search(
        keyword="無線藍(lán)牙耳機(jī) 主動降噪",
        page=1,
        page_size=50,
        sort_type="sales_desc"
    )
    # 解析數(shù)據(jù)
    goods_data = parse_goods_data(result)
    # 輸出結(jié)果
    print(f"共獲取 {len(goods_data)} 條商品數(shù)據(jù)n")
    for idx, goods in enumerate(goods_data[:5]):  # 打印前5條
        print(f"【{idx+1}】")
        print(f"商品ID：{goods['sku_id']}")
        print(f"標(biāo)題：{goods['title']}")
        print(f"價(jià)格：{goods['price']}元（原價(jià)：{goods['original_price']}元）")
        print(f"銷量：{goods['sales']} 庫存：{goods['stock']}")
        print(f"店鋪：{goods['shop_name']}n")

2. 增強(qiáng)版item_search_pro適配修改

只需修改兩處即可切換到增強(qiáng)版：

接口名改為 method": "jd.union.open.goods.search.pro

接口版本改為 v": "4.0

可選添加增強(qiáng)版參數(shù)（如price_from、price_to、brand_id）

四、 數(shù)據(jù)落地：清洗、存儲與應(yīng)用

調(diào)用接口獲取數(shù)據(jù)后，需進(jìn)行數(shù)據(jù)清洗→存儲→業(yè)務(wù)應(yīng)用，才能轉(zhuǎn)化為運(yùn)營價(jià)值。

1. 數(shù)據(jù)清洗（解決 3 個(gè)常見問題）

去重：以sku_id為唯一標(biāo)識，剔除重復(fù)商品（分頁調(diào)用易出現(xiàn)重復(fù)）

過濾無效數(shù)據(jù)：刪除stock=0（無庫存）、price=0（價(jià)格異常）的商品

字段標(biāo)準(zhǔn)化：統(tǒng)一價(jià)格格式（保留 2 位小數(shù)）、截取過長標(biāo)題（避免存儲溢出）

python

運(yùn)行

# 數(shù)據(jù)清洗示例代碼
def clean_goods_data(goods_list):
    cleaned = []
    sku_ids = set()  # 用于去重
    for goods in goods_list:
        sku = goods["sku_id"]
        if sku in sku_ids or goods["stock"] <= 0 or goods["price"] <= 0:
            continue
        # 價(jià)格標(biāo)準(zhǔn)化
        goods["price"] = round(float(goods["price"]), 2)
        goods["original_price"] = round(float(goods["original_price"]), 2)
        # 標(biāo)題截?。ㄇ?0字）
        goods["title"] = goods["title"][:50] + "..." if len(goods["title"]) > 50 else goods["title"]
        sku_ids.add(sku)
        cleaned.append(goods)
    return cleaned

2. 數(shù)據(jù)存儲（2 種常用方式）

3. 業(yè)務(wù)應(yīng)用（3 個(gè)核心場景）

選品分析：篩選sales>5000、price在目標(biāo)區(qū)間的商品，統(tǒng)計(jì)熱銷規(guī)格

競品監(jiān)控：定期調(diào)用接口，對比競品價(jià)格、銷量變化，觸發(fā)調(diào)價(jià) / 補(bǔ)貨預(yù)警

庫存管理：監(jiān)控爆款商品庫存，當(dāng)stock<100時(shí)發(fā)送郵件 / 短信提醒

五、 常見問題與排障指南（避坑必備）

六、 合規(guī)與風(fēng)險(xiǎn)提示

僅使用官方開放接口：嚴(yán)禁爬取京東官網(wǎng)（jd.com）數(shù)據(jù)，僅可調(diào)用京東開放平臺 / 京東聯(lián)盟 API

數(shù)據(jù)使用邊界：采集的數(shù)據(jù)僅用于自身運(yùn)營分析，不得轉(zhuǎn)售、泄露或用于商業(yè)競爭

憑證安全：AppKey和AppSecret避免上傳至代碼倉庫（如 GitHub），可通過環(huán)境變量注入

審核編輯 黃宇