京東關(guān)鍵詞搜索（item_search）技術(shù)實(shí)現(xiàn)指南：合規(guī) API 調(diào)用 + 數(shù)據(jù)運(yùn)營(yíng)實(shí)戰(zhàn)

京東商品關(guān)鍵詞搜索（item_search）是電商技術(shù)從業(yè)者核心需求之一，需優(yōu)先采用京東官方開(kāi)放平臺(tái) API或合規(guī)第三方數(shù)據(jù)服務(wù)（避免直接爬取官網(wǎng)，存在反爬封禁、法律風(fēng)險(xiǎn)）。本文將從「接口接入、多語(yǔ)言代碼實(shí)現(xiàn)、數(shù)據(jù)提取、運(yùn)營(yíng)落地」四個(gè)維度，提供可直接落地的技術(shù)方案，覆蓋選品、定價(jià)、庫(kù)存監(jiān)控等核心場(chǎng)景。

一、合規(guī)前提：京東 item_search 接口類(lèi)型選擇

?? 重要提醒：京東官網(wǎng)（jd.com）禁止未經(jīng)授權(quán)的爬蟲(chóng)抓取，輕則 IP 封禁，重則涉及《反不正當(dāng)競(jìng)爭(zhēng)法》，優(yōu)先選擇上述合規(guī)接口！

二、京東開(kāi)放平臺(tái) item_search 接口接入流程（推薦）

1. 前期準(zhǔn)備

注冊(cè)京東開(kāi)放平臺(tái)開(kāi)發(fā)者賬號(hào)：https://open.jd.com/

創(chuàng)建應(yīng)用，申請(qǐng)「商品搜索」接口權(quán)限（需完成企業(yè) / 個(gè)人資質(zhì)認(rèn)證）

獲取核心憑證：AppKey、AppSecret（在應(yīng)用管理頁(yè)查看）

接口文檔參考：京東開(kāi)放平臺(tái) - 商品搜索接口（v3.0）：https://open.jd.com/doc/api.htm?apiId=34526

2. 核心接口參數(shù)（item_search）

3. 簽名算法（京東 API 核心驗(yàn)證步驟）

京東 API 采用HMAC-SHA256簽名機(jī)制，步驟如下：

按參數(shù)名 ASCII 升序排列所有請(qǐng)求參數(shù)（含公共參數(shù)：app_key、timestamp、format 等）

拼接為「key=value&key=value」格式的字符串（無(wú) url 編碼）

用AppSecret作為密鑰，對(duì)拼接字符串進(jìn)行 HMAC-SHA256 加密，得到簽名值（sign）

將簽名值加入請(qǐng)求參數(shù)，以 GET/POST 方式提交請(qǐng)求

公共參數(shù)說(shuō)明：必須包含app_key、timestamp（格式：yyyy-MM-dd HH:mm:ss）、format（默認(rèn) json）、v（接口版本，如 3.0）、sign（簽名值）

三、多語(yǔ)言代碼實(shí)現(xiàn)（item_search 接口調(diào)用）

以下代碼基于「京東開(kāi)放平臺(tái)商品搜索接口 v3.0」，包含 Python/Java/PHP 三種主流語(yǔ)言，直接替換AppKey、AppSecret即可運(yùn)行。

1. Python 實(shí)現(xiàn)（推薦，含數(shù)據(jù)解析）

python

運(yùn)行

import requests
import hashlib
import hmac
import time
from urllib.parse import urlencode, quote_plus

class JDItemSearch:
    def __init__(self, app_key, app_secret):
        self.app_key = app_key
        self.app_secret = app_secret
        self.url = "https://api.jd.com/routerjson"  # 京東API網(wǎng)關(guān)地址

    # 生成簽名
    def generate_sign(self, params):
        # 按ASCII升序排序參數(shù)
        sorted_params = sorted(params.items(), key=lambda x: x[0])
        # 拼接為key=value字符串（無(wú)url編碼）
        sign_str = "&".join([f"{k}={v}" for k, v in sorted_params])
        # HMAC-SHA256加密
        hmac_obj = hmac.new(self.app_secret.encode("utf-8"), sign_str.encode("utf-8"), hashlib.sha256)
        return hmac_obj.hexdigest().upper()

    # 執(zhí)行搜索
    def search(self, keyword, page=1, page_size=30, sort_type="sales_desc"):
        # 公共參數(shù)
        params = {
            "app_key": self.app_key,
            "method": "jd.union.open.goods.search",  # 京東聯(lián)盟搜索接口（或官方商品搜索接口）
            "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
        }
        # 生成簽名
        params["sign"] = self.generate_sign(params)
        # 發(fā)送請(qǐng)求
        response = requests.get(self.url, params=params, timeout=10)
        if response.status_code == 200:
            return response.json()
        else:
            raise Exception(f"請(qǐng)求失敗：狀態(tài)碼{response.status_code}，響應(yīng)內(nèi)容{response.text}")

# ------------------- 實(shí)戰(zhàn)調(diào)用 -------------------
if __name__ == "__main__":
    # 替換為你的AppKey和AppSecret
    APP_KEY = "你的京東開(kāi)放平臺(tái)AppKey"
    APP_SECRET = "你的京東開(kāi)放平臺(tái)AppSecret"
    
    jd_search = JDItemSearch(APP_KEY, APP_SECRET)
    # 搜索「無(wú)線藍(lán)牙耳機(jī) 主動(dòng)降噪」，按銷(xiāo)量排序，第1頁(yè)，50條/頁(yè)
    result = jd_search.search(
        keyword="無(wú)線藍(lán)牙耳機(jī) 主動(dòng)降噪",
        page=1,
        page_size=50,
        sort_type="sales_desc"
    )
    
    # 解析核心數(shù)據(jù)（選品/運(yùn)營(yíng)關(guān)鍵字段）
    goods_list = result.get("jd_union_open_goods_search_response", {}).get("result", {}).get("data", [])
    for goods in goods_list:
        print("="*50)
        print(f"商品ID：{goods.get('skuId')}")
        print(f"商品標(biāo)題：{goods.get('goodsName')}")
        print(f"售價(jià)：{goods.get('price')}元")
        print(f"銷(xiāo)量：{goods.get('salesCount')}件")
        print(f"傭金比例：{goods.get('commissionRatio')}%")
        print(f"庫(kù)存狀態(tài)：{'有貨' if goods.get('stock') > 0 else '缺貨'}")
        print(f"店鋪名稱(chēng)：{goods.get('shopName')}")
        print(f"優(yōu)惠券金額：{goods.get('couponInfo', {}).get('discount', 0)}元")

2. Java 實(shí)現(xiàn)（含簽名工具類(lèi)）

java

運(yùn)行

import org.apache.commons.codec.digest.HmacUtils;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;
import com.alibaba.fastjson.JSONObject;
import java.util.*;

public class JDItemSearch {
    private static final String APP_KEY = "你的京東開(kāi)放平臺(tái)AppKey";
    private static final String APP_SECRET = "你的京東開(kāi)放平臺(tái)AppSecret";
    private static final String API_URL = "https://api.jd.com/routerjson";

    // 生成簽名
    private static String generateSign(Map params) {
        // 按ASCII升序排序
        List> entryList = new ArrayList(params.entrySet());
        entryList.sort(Map.Entry.comparingByKey());
        // 拼接字符串
        StringBuilder signStr = new StringBuilder();
        for (Map.Entry entry : entryList) {
            signStr.append(entry.getKey()).append("=").append(entry.getValue()).append("&");
        }
        signStr.deleteCharAt(signStr.length() - 1);
        // HMAC-SHA256加密
        return new HmacUtils("HmacSHA256", APP_SECRET).hmacHex(signStr.toString()).toUpperCase();
    }

    // 搜索商品
    public static JSONObject search(String keyword, int page, int pageSize, String sortType) throws Exception {
        Map params = new HashMap();
        // 公共參數(shù)
        params.put("app_key", APP_KEY);
        params.put("method", "jd.union.open.goods.search");
        params.put("format", "json");
        params.put("v", "3.0");
        params.put("timestamp", new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date()));
        // 業(yè)務(wù)參數(shù)
        params.put("keyword", keyword);
        params.put("page", String.valueOf(page));
        params.put("page_size", String.valueOf(pageSize));
        params.put("sort_type", sortType);
        // 生成簽名
        params.put("sign", generateSign(params));

        // 構(gòu)建請(qǐng)求URL
        StringBuilder urlBuilder = new StringBuilder(API_URL).append("?");
        for (Map.Entry entry : params.entrySet()) {
            urlBuilder.append(entry.getKey()).append("=").append(URLEncoder.encode(entry.getValue(), "UTF-8")).append("&");
        }
        String url = urlBuilder.deleteCharAt(urlBuilder.length() - 1).toString();

        // 發(fā)送請(qǐng)求
        try (CloseableHttpClient client = HttpClients.createDefault()) {
            HttpGet request = new HttpGet(url);
            return JSONObject.parseObject(EntityUtils.toString(client.execute(request).getEntity()));
        }
    }

    // 主函數(shù)調(diào)用
    public static void main(String[] args) throws Exception {
        JSONObject result = search("無(wú)線藍(lán)牙耳機(jī) 主動(dòng)降噪", 1, 50, "sales_desc");
        // 解析核心字段
        JSONArray goodsList = result.getJSONObject("jd_union_open_goods_search_response")
                .getJSONObject("result")
                .getJSONArray("data");
        for (Object obj : goodsList) {
            JSONObject goods = (JSONObject) obj;
            System.out.println("商品ID：" + goods.getString("skuId"));
            System.out.println("商品標(biāo)題：" + goods.getString("goodsName"));
            System.out.println("售價(jià)：" + goods.getBigDecimal("price") + "元");
            System.out.println("銷(xiāo)量：" + goods.getIntValue("salesCount") + "件");
            System.out.println("庫(kù)存狀態(tài)：" + (goods.getIntValue("stock") > 0 ? "有貨" : "缺貨"));
            System.out.println("---------------------");
        }
    }
}

3. PHP 實(shí)現(xiàn)（簡(jiǎn)潔版）

php

運(yùn)行

appSecret));
    }

    // 搜索商品
    public function search($keyword, $page = 1, $pageSize = 30, $sortType = "sales_desc") {
        $params = [
            'app_key' => $this->appKey,
            'method' => 'jd.union.open.goods.search',
            'format' => 'json',
            'v' => '3.0',
            'timestamp' => date('Y-m-d H:i:s'),
            'keyword' => $keyword,
            'page' => (string)$page,
            'page_size' => (string)$pageSize,
            'sort_type' => $sortType
        ];
        $params['sign'] = $this->generateSign($params);

        // 發(fā)送請(qǐng)求
        $url = $this->apiUrl . '?' . http_build_query($params);
        $response = file_get_contents($url);
        return json_decode($response, true);
    }
}

// 調(diào)用示例
$jdSearch = new JDItemSearch();
$result = $jdSearch->search("無(wú)線藍(lán)牙耳機(jī) 主動(dòng)降噪", 1, 50, "sales_desc");

// 解析數(shù)據(jù)
$goodsList = $result['jd_union_open_goods_search_response']['result']['data'] ?? [];
foreach ($goodsList as $goods) {
    echo "商品ID：" . $goods['skuId'] . "n";
    echo "商品標(biāo)題：" . $goods['goodsName'] . "n";
    echo "售價(jià)：" . $goods['price'] . "元n";
    echo "銷(xiāo)量：" . $goods['salesCount'] . "件n";
    echo "-----------------n";
}
?>

四、數(shù)據(jù)提取與運(yùn)營(yíng)實(shí)戰(zhàn)（選品 / 定價(jià) / 庫(kù)存）

調(diào)用接口后，核心是從返回?cái)?shù)據(jù)中提取運(yùn)營(yíng)關(guān)鍵字段，并落地到業(yè)務(wù)場(chǎng)景：

1. 核心字段提取（JSON 結(jié)構(gòu)示例）

json

{
  "jd_union_open_goods_search_response": {
    "result": {
      "data": [
        {
          "skuId": "100062888888", // 商品唯一ID（關(guān)鍵）
          "goodsName": "無(wú)線藍(lán)牙耳機(jī) 主動(dòng)降噪...", // 商品標(biāo)題
          "price": 299.00, // 現(xiàn)價(jià)
          "originalPrice": 399.00, // 原價(jià)
          "salesCount": 12560, // 累計(jì)銷(xiāo)量
          "reviewCount": 3280, // 評(píng)價(jià)數(shù)
          "stock": 568, // 庫(kù)存數(shù)量
          "shopName": "XX官方旗艦店", // 店鋪名稱(chēng)
          "shopType": "JD_MALL", // 店鋪類(lèi)型（京東自營(yíng)/第三方）
          "commissionRatio": 15.00, // 傭金比例（聯(lián)盟API特有）
          "couponInfo": {
            "discount": 50, // 優(yōu)惠券金額
            "startTime": "2024-01-01", // 優(yōu)惠券生效時(shí)間
            "endTime": "2024-01-31" // 優(yōu)惠券失效時(shí)間
          },
          "categoryId": "6528", // 分類(lèi)ID
          "brandName": "XX品牌" // 品牌名稱(chēng)
        }
      ]
    }
  }
}

2. 運(yùn)營(yíng)場(chǎng)景落地

（1）選品分析（高銷(xiāo)量低競(jìng)爭(zhēng)）

篩選條件：salesCount > 5000（高銷(xiāo)量）、reviewCount/salesCount < 0.3（低評(píng)價(jià)占比，競(jìng)爭(zhēng)小）、couponInfo.discount > 30（有大額優(yōu)惠券）

代碼示例（Python）：

python

運(yùn)行

# 篩選高銷(xiāo)量、大額券、低競(jìng)爭(zhēng)商品
high_potential_goods = []
for goods in goods_list:
    sales = goods.get('salesCount', 0)
    review = goods.get('reviewCount', 0)
    coupon = goods.get('couponInfo', {}).get('discount', 0)
    # 篩選條件
    if sales > 5000 and coupon > 30 and (review/sales < 0.3 if sales > 0 else False):
        high_potential_goods.append({
            'skuId': goods['skuId'],
            'goodsName': goods['goodsName'],
            'price': goods['price'],
            'sales': sales,
            'coupon': coupon
        })
print("高潛力選品：", high_potential_goods)

（2）定價(jià)策略參考

提取同類(lèi)商品價(jià)格區(qū)間：min_price = min([g['price'] for g in goods_list])、max_price = max([g['price'] for g in goods_list])

定價(jià)建議：若為第三方店鋪，定價(jià)可低于區(qū)間均值 5%-10%；若為自營(yíng)，可參考區(qū)間中位數(shù)，搭配優(yōu)惠券提升競(jìng)爭(zhēng)力。

（3）庫(kù)存監(jiān)控

實(shí)時(shí)監(jiān)控爆款庫(kù)存：for goods in goods_list: if goods['salesCount'] > 10000: print(f"爆款{goods['goodsName']}庫(kù)存：{goods['stock']}")

觸發(fā)預(yù)警：當(dāng)庫(kù)存goods['stock'] < 100時(shí)，發(fā)送郵件 / 短信提醒補(bǔ)貨。

五、常見(jiàn)問(wèn)題與解決方案

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

禁止使用爬蟲(chóng)爬取京東官網(wǎng)（jd.com）、京東超市等非開(kāi)放平臺(tái)頁(yè)面，僅允許調(diào)用官方開(kāi)放平臺(tái)或合規(guī)第三方 API。

數(shù)據(jù)使用范圍：僅用于自身店鋪運(yùn)營(yíng)、選品分析，不得泄露、轉(zhuǎn)售他人數(shù)據(jù)，遵守《京東開(kāi)放平臺(tái)服務(wù)協(xié)議》。

接口調(diào)用規(guī)范：嚴(yán)格遵守 QPS 限制，避免高頻次惡意調(diào)用，否則會(huì)導(dǎo)致 AppKey 封禁。

審核編輯 黃宇