做電商選品、聯(lián)盟推廣或市場(chǎng)分析時(shí)，京東商品關(guān)鍵詞搜索接口（jd.union.open.goods.search）是連接 “用戶需求” 與 “商業(yè)價(jià)值” 的核心樞紐。2026年京東開放平臺(tái)權(quán)限體系與數(shù)據(jù)維度升級(jí)后，該接口不僅能實(shí)現(xiàn)基礎(chǔ)檢索，更可結(jié)合實(shí)時(shí)銷量波動(dòng)、短視頻帶貨熱度等新字段，構(gòu)建從數(shù)據(jù)采集到?jīng)Q策落地的完整鏈路。本文基于最新平臺(tái)規(guī)則，保留核心技術(shù)實(shí)現(xiàn)的同時(shí)，補(bǔ)充市場(chǎng)前沿適配方案，幫從業(yè)者避開權(quán)限申請(qǐng)、數(shù)據(jù)解析的新坑。

一、接口定位與 2026年技術(shù)突破點(diǎn)

京東 jd.union.open.goods.search 接口作為電商數(shù)據(jù)挖掘的核心入口，2026年在 “檢索精度”“數(shù)據(jù)維度”“商業(yè)適配” 三方面實(shí)現(xiàn)升級(jí)，區(qū)別于常規(guī)基礎(chǔ)調(diào)用：

1.多維度檢索策略升級(jí)：新增 “短視頻熱度”“實(shí)時(shí)點(diǎn)擊轉(zhuǎn)化率” 2 個(gè)篩選條件，支持價(jià)格區(qū)間、促銷類型等 14 種組合篩選（原 12 種），適配直播 / 私域選品場(chǎng)景；

2.搜索流量分析引擎優(yōu)化：接入京東 “商品成長指數(shù)”，可提前 15 天識(shí)別潛在爆款（原僅能識(shí)別上升趨勢(shì)商品）；

3.用戶意圖解碼迭代：結(jié)合京東 2026年新增的 “搜索詞 - 商品點(diǎn)擊熱力圖” 數(shù)據(jù)，核心需求提取準(zhǔn)確率提升至 92%，價(jià)格敏感度判斷誤差縮小至 5% 以內(nèi)。

二、2026 年接口核心參數(shù)與權(quán)限體系（最新版）

1. 權(quán)限分級(jí)與申請(qǐng)新規(guī)（2026年京東開放平臺(tái)調(diào)整）

權(quán)限申請(qǐng)路徑：京東開放平臺(tái)聯(lián)盟 API → 商品搜索接口（jd.union.open.goods.search）→ 權(quán)限申請(qǐng)

注意：2026年高級(jí)權(quán)限審核周期從 3 個(gè)工作日延長至 5 個(gè)，建議提前規(guī)劃開發(fā)進(jìn)度。

2. 核心參數(shù)與 2026 年商業(yè)價(jià)值映射

三、2026 年差異化技術(shù)實(shí)現(xiàn)：代碼優(yōu)化與場(chǎng)景適配

1. 智能檢索引擎（兼容最新參數(shù)與 QPS 規(guī)則）

import time import hashlib import json import logging import requests from typing import Dict, List, Optional, Tuple from datetime import datetime, timedelta import pandas as pd import numpy as np from collections import defaultdict # 配置日志（2026年新增“請(qǐng)求耗時(shí)”記錄，便于排查接口延遲問題） logging.basicConfig( level=logging.INFO, format='%(asctime)s - %(levelname)s - 請(qǐng)求耗時(shí):%(elapsed)s秒 - %(message)s' ) logger = logging.getLogger(__name__) class JDGoodsSearchAPI: def __init__(self, app_key: str, app_secret: str, access_token: str): self.app_key = app_key self.app_secret = app_secret self.access_token = access_token self.api_url = "https://api.jd.com/routerjson" self.session = self._init_session() # 2026年新增字段：商品成長指數(shù)、實(shí)時(shí)點(diǎn)擊轉(zhuǎn)化率、短視頻熱度 self.core_fields = ( "skuId,spuId,name,brandName,categoryName,price,marketPrice," "commission,commissionShare,couponInfo,goodComments,totalComments," "shopId,shopName,isSelf,score,volume,imgUrl,materialUrl," "hotScore,priceHistory,seckillInfo,promotionInfo," "growthScore,clickRate,shortVideoHot (2026年京東新增字段)" ) # 2026年新增排序映射：商品成長指數(shù)排序 self.sort_mapping = { "price_asc": ("price", "asc"), "price_desc": ("price", "desc"), "sales_asc": ("volume", "asc"), "sales_desc": ("volume", "desc"), "rating_asc": ("score", "asc"), "rating_desc": ("score", "desc"), "hot_asc": ("hotScore", "asc"), "hot_desc": ("hotScore", "desc"), "growth_asc": ("growthScore", "asc"), # 新增成長指數(shù)升序 "growth_desc": ("growthScore", "desc") # 新增成長指數(shù)降序 } def _init_session(self) -> requests.Session: """初始化會(huì)話，2026年調(diào)整連接池參數(shù)，適配京東API新的流量管控""" session = requests.Session() adapter = requests.adapters.HTTPAdapter( pool_connections=15, # 原10，提升并發(fā)能力 pool_maxsize=30, # 原20，減少連接等待 max_retries=3 ) session.mount('https://', adapter) return session def _generate_sign(self, params: Dict) -> str: """生成京東API簽名（2026年簽名規(guī)則未變，保持原邏輯）""" sorted_params = sorted(params.items(), key=lambda x: x[0]) sign_str = self.app_secret for k, v in sorted_params: if v is not None and v != "": sign_str += f"{k}{v}" sign_str += self.app_secret return hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper() def search_goods(self, keyword: str, **kwargs) -> Tuple[List[Dict], int]: """ 多條件搜索商品，支持2026年新增參數(shù)（商品成長指數(shù)、短視頻熱度） :param keyword: 搜索關(guān)鍵詞 :param **kwargs: 新增參數(shù)： - growth_score: 商品成長指數(shù)閾值（≥80優(yōu)先） - short_video_hot: 短視頻熱度（1=高熱度，0=不限） """ start_time = time.time() # 記錄請(qǐng)求開始時(shí)間，用于計(jì)算耗時(shí) page = kwargs.get('page', 1) page_size = kwargs.get('page_size', 20) if page_size < 1 or page_size > 50: page_size = 20 # 構(gòu)建基礎(chǔ)搜索參數(shù) search_params = { "keyword": keyword, "pageIndex": page, "pageSize": page_size, "fields": self.core_fields } # 2026年新增：商品成長指數(shù)篩選 growth_score = kwargs.get('growth_score') if growth_score and 0 <= growth_score <= 100: search_params["growthScore"] = growth_score # 2026年新增：短視頻熱度篩選（適配直播帶貨選品） if kwargs.get('short_video_hot', False): search_params["shortVideoHot"] = 1 # 原有參數(shù)處理（價(jià)格區(qū)間、排序、優(yōu)惠券等） price_range = kwargs.get('price_range') if price_range and len(price_range) == 2: search_params["priceFrom"] = price_range[0] search_params["priceTo"] = price_range[1] sort = kwargs.get('sort') if sort in self.sort_mapping: search_params["sortName"], search_params["sort"] = self.sort_mapping[sort] if kwargs.get('has_coupon', False): search_params["hasCoupon"] = 1 good_rate = kwargs.get('good_rate') if good_rate and 0 <= good_rate <= 100: search_params["goodRate"] = good_rate is_self = kwargs.get('is_self') if is_self is not None: search_params["isSelf"] = 1 if is_self else 0 category_id = kwargs.get('category_id') if category_id: search_params["cid3"] = category_id brand_ids = kwargs.get('brand_ids') if brand_ids: search_params["brandIds"] = ",".join(map(str, brand_ids)) try: # 構(gòu)建API請(qǐng)求參數(shù) params = { "method": "jd.union.open.goods.search", "app_key": self.app_key, "access_token": self.access_token, "timestamp": datetime.now().strftime("%Y-%m-%d %H:%M:%S"), "format": "json", "v": "1.0", "sign_method": "md5", "360buy_param_json": json.dumps(search_params) } params["sign"] = self._generate_sign(params) # 發(fā)送請(qǐng)求（2026年京東API超時(shí)調(diào)整，設(shè)為15秒） response = self.session.get( self.api_url, params=params, timeout=(10, 15) # 連接超時(shí)10秒，讀取超時(shí)15秒 ) response.raise_for_status() result = response.json() elapsed = round(time.time() - start_time, 2) # 計(jì)算請(qǐng)求耗時(shí) # 處理錯(cuò)誤響應(yīng)（新增2026年常見錯(cuò)誤碼：10008-成長指數(shù)參數(shù)無效） if "error_response" in result: error = result["error_response"] error_code = error.get('code') error_msg = error.get('msg') if error_code == 10008: error_msg += "（請(qǐng)確認(rèn)growthScore參數(shù)在0-100范圍內(nèi)）" logger.error(f"搜索接口錯(cuò)誤: {error_msg} (錯(cuò)誤碼: {error_code})", extra={"elapsed": elapsed}) return [], 0 # 解析結(jié)果 data = result.get("jd_union_open_goods_search_response", {}) search_result = data.get("result", {}) goods_list = search_result.get("data", []) total_count = search_result.get("totalCount", 0) # 解析商品數(shù)據(jù) parsed_goods = [self._parse_goods(item) for item in goods_list] # 2026年QPS規(guī)則未變，保持1.5秒間隔 time.sleep(1.5) logger.info(f"搜索關(guān)鍵詞[{keyword}]第{page}頁成功，獲取{len(parsed_goods)}個(gè)商品", extra={"elapsed": elapsed}) return parsed_goods, total_count except requests.exceptions.RequestException as e: elapsed = round(time.time() - start_time, 2) logger.error(f"請(qǐng)求異常: {str(e)}", extra={"elapsed": elapsed}) return [], 0 except Exception as e: elapsed = round(time.time() - start_time, 2) logger.error(f"處理搜索結(jié)果異常: {str(e)}", extra={"elapsed": elapsed}) return [], 0

2. 2026 年新增字段解析（商品成長指數(shù)、短視頻熱度）

def _parse_goods(self, raw_data: Dict) -> Dict: """解析商品數(shù)據(jù)，新增2026年字段：成長指數(shù)、短視頻熱度、點(diǎn)擊轉(zhuǎn)化率""" # 原有解析邏輯（價(jià)格、傭金、優(yōu)惠券等） price_info = self._parse_price_info(raw_data) commission_info = self._parse_commission(raw_data) coupon_info = self._parse_coupon(raw_data.get("couponInfo", {})) comment_info = self._parse_comment(raw_data) promotion_info = self._parse_promotion(raw_data.get("promotionInfo", {})) # 2026年新增字段解析 growth_info = { "score": raw_data.get("growthScore", 0), # 商品成長指數(shù) "trend": "up" if raw_data.get("growthScore", 0) > 80 else "stable" # 趨勢(shì)判斷 } short_video_info = { "is_hot": raw_data.get("shortVideoHot", 0) == 1, # 是否高熱度 "play_count": raw_data.get("shortVideoPlayCount", 0) # 播放量（2026年新增） } click_info = { "rate": raw_data.get("clickRate", 0.0) # 實(shí)時(shí)點(diǎn)擊轉(zhuǎn)化率 } # 升級(jí)競(jìng)爭(zhēng)力評(píng)分：納入2026年新增字段 competitiveness_score = self._calculate_competitiveness( price_info, comment_info, commission_info, coupon_info, growth_info, click_info # 新增評(píng)分維度 ) return { "sku_id": raw_data.get("skuId", ""), "spu_id": raw_data.get("spuId", ""), "name": raw_data.get("name", ""), "brand": { "id": raw_data.get("brandId", ""), "name": raw_data.get("brandName", "") }, "category": { "id": raw_data.get("categoryId", ""), "name": raw_data.get("categoryName", "") }, "price": price_info, "commission": commission_info, "coupon": coupon_info, "comments": comment_info, "sales": { "volume": raw_data.get("volume", 0), "30d_trend": self._parse_sales_trend(raw_data.get("priceHistory", [])) }, "shop": { "id": raw_data.get("shopId", ""), "name": raw_data.get("shopName", ""), "is_self": raw_data.get("isSelf", False), "score": raw_data.get("score", 0) }, "promotion": promotion_info, "images": { "main": raw_data.get("imgUrl", ""), "detail": raw_data.get("materialUrl", "") }, "hot_score": raw_data.get("hotScore", 0), # 2026年新增字段 "growth_info": growth_info, "short_video_info": short_video_info, "click_info": click_info, "competitiveness_score": competitiveness_score, "seckill": self._parse_seckill(raw_data.get("seckillInfo", {})) } def _calculate_competitiveness(self, price_info: Dict, comment_info: Dict, commission_info: Dict, coupon_info: Dict, growth_info: Dict, click_info: Dict) -> int: """升級(jí)競(jìng)爭(zhēng)力評(píng)分：2026年新增成長指數(shù)、點(diǎn)擊轉(zhuǎn)化率維度（總分120，最終歸一為100）""" score = 0 # 原有維度（80分） score += min(20, round(20 * (1 - price_info["discount_rate"]))) # 價(jià)格（20） score += min(20, round(comment_info["good_rate"] * 0.2)) # 評(píng)價(jià)（20） score += min(20, round(commission_info["rate"] * 0.5)) # 傭金（20） score += min(20, round(coupon_info["strength"] * 20)) # 優(yōu)惠券（20） # 2026年新增維度（40分） score += min(20, round(growth_info["score"] * 0.2)) # 成長指數(shù)（20） score += min(20, round(click_info["rate"] * 100)) # 點(diǎn)擊轉(zhuǎn)化率（20） # 歸一為0-100分 return min(100, round(score * 100 / 120))

3. 2026年商業(yè)機(jī)會(huì)挖掘（新增短視頻熱度、成長指數(shù)場(chǎng)景）

def find_business_opportunities(self, keyword: str) -> List[Dict]: """發(fā)現(xiàn)潛在商業(yè)機(jī)會(huì)，2026年新增“短視頻高熱度低競(jìng)爭(zhēng)”“成長指數(shù)飆升”場(chǎng)景""" trends = self.analyze_search_trends(keyword) if "error" in trends: return [] opportunities = [] _, df = self.batch_search(keyword) if df.empty: return opportunities # 機(jī)會(huì)1：2026年新增——短視頻高熱度但低競(jìng)爭(zhēng)商品（適配直播帶貨選品） short_video_goods = df[ (df["short_video_is_hot"] == True) & # 短視頻高熱度 (df["competitiveness_score"] > 70) & # 競(jìng)爭(zhēng)力高 (df["hot_score"] < df["hot_score"].mean()) # 搜索熱度低（競(jìng)爭(zhēng)?。?] if len(short_video_goods) > 0: opportunities.append({ "type": "short_video_opportunity", "description": "短視頻高熱度但搜索競(jìng)爭(zhēng)小的商品，適合直播帶貨預(yù)熱", "count": len(short_video_goods), "examples": short_video_goods.head(3)[["sku_id", "name", "current_price", "short_video_play_count"]].to_dict("records") }) # 機(jī)會(huì)2：2026年新增——成長指數(shù)飆升商品（提前布局潛在爆款） growth_goods = df[ (df["growth_score"] > 90) & # 成長指數(shù)≥90（飆升中） (df["sales_volume"] < df["sales_volume"].quantile(0.7)) # 銷量尚未爆發(fā) ] if len(growth_goods) > 0: opportunities.append({ "type": "growth_opportunity", "description": "成長指數(shù)飆升但銷量未爆發(fā)的商品，可提前備貨/推廣", "count": len(growth_goods), "examples": growth_goods.head(3)[["sku_id", "name", "current_price", "growth_score"]].to_dict("records") }) # 原有機(jī)會(huì)場(chǎng)景：高競(jìng)爭(zhēng)力低熱度、價(jià)格帶空缺、高傭金高好評(píng) underrated_goods = df[ (df["competitiveness_score"] > 70) & (df["hot_score"] < df["hot_score"].mean()) ] if len(underrated_goods) > 0: opportunities.append({ "type": "underrated_goods", "description": "高競(jìng)爭(zhēng)力但低熱度的被低估優(yōu)質(zhì)商品，有推廣潛力", "count": len(underrated_goods), "examples": underrated_goods.head(3)[["sku_id", "name", "current_price"]].to_dict("records") }) price_dist = trends["price_distribution"] total = sum(price_dist.values()) for price_range, count in price_dist.items(): ratio = count / total if ratio < 0.05: opportunities.append({ "type": "price_gap", "description": f"{price_range}元價(jià)格區(qū)間商品稀缺，存在市場(chǎng)空缺", "current_ratio": round(ratio * 100, 1), "suggestion": f"考慮補(bǔ)充{price_range}元價(jià)格區(qū)間的相關(guān)商品" }) high_commission_goods = df[ (df["commission_rate"] > df["commission_rate"].mean()) & (df["good_rate"] > 90) ] if len(high_commission_goods) > 0: opportunities.append({ "type": "high_commission_promotion", "description": "高傭金且高好評(píng)商品，適合聯(lián)盟推廣賺取傭金", "count": len(high_commission_goods), "examples": high_commission_goods.head(3)[ ["sku_id", "name", "commission_rate", "good_rate"] ].to_dict("records") }) return opportunities

四、2026年完整應(yīng)用示例（含最新字段調(diào)用）

if __name__ == "__main__": # 初始化API客戶端（替換為官方申請(qǐng)的密鑰） APP_KEY = "your_2026_jd_app_key" APP_SECRET = "your_2026_jd_app_secret" ACCESS_TOKEN = "your_2026_jd_access_token" search_api = JDGoodsSearchAPI(APP_KEY, APP_SECRET, ACCESS_TOKEN) KEYWORD = "無線藍(lán)牙耳機(jī)" # 2026年熱門品類詞 try: # 1. 基礎(chǔ)搜索（含2026年新增篩選：成長指數(shù)≥80、短視頻高熱度） print(f"===== 搜索關(guān)鍵詞: {KEYWORD}（2026年新增篩選） =====") goods, total = search_api.search_goods( KEYWORD, page=1, page_size=20, price_range=(200, 800), # 2026年無線藍(lán)牙耳機(jī)中端價(jià)格帶 sort="growth_desc", # 按成長指數(shù)降序（優(yōu)先潛力款） has_coupon=True, good_rate=92, # 2026年消費(fèi)者對(duì)耳機(jī)好評(píng)率要求提升至92% growth_score=80, # 成長指數(shù)≥80 short_video_hot=True # 短視頻高熱度 ) print(f"找到 {total} 個(gè)符合2026年篩選條件的商品") if goods: sample = goods[0] print(f"第一個(gè)商品: {sample['name']}") print(f"價(jià)格: {sample['price']['current']}元 | 成長指數(shù): {sample['growth_info']['score']}") print(f"短視頻熱度: {'高' if sample['short_video_info']['is_hot'] else '低'}（播放量: {sample['short_video_info']['play_count']}）") # 2. 2026年趨勢(shì)分析（含成長指數(shù)、短視頻熱度分布） print("n===== 2026年搜索趨勢(shì)分析 =====") trends = search_api.analyze_search_trends( KEYWORD, page_size=30, max_pages=3 ) print(f"價(jià)格分布（2026年中端占比）: {trends['price_distribution']}") print(f"成長指數(shù)≥90的商品數(shù): {len([g for g in trends['top_competitive'] if g['growth_score']>=90])}") print(f"短視頻高熱度商品占比: {round(trends['short_video_hot_ratio'], 1)}%") # 3. 2026年商業(yè)機(jī)會(huì)挖掘 print("n===== 2026年潛在商業(yè)機(jī)會(huì) =====") opportunities = search_api.find_business_opportunities(KEYWORD) for i, opp in enumerate(opportunities, 1): print(f"{i}. {opp['description']}") if "examples" in opp: print(" 示例商品:") for item in opp["examples"][:2]: print(f" - {item['name']}（￥{item['current_price']}）") # 4. 導(dǎo)出2026年版分析報(bào)告（含新增字段sheet） report_path = f"jd_2026_search_analysis_{KEYWORD.replace(' ', '_')}.xlsx" if search_api.export_analysis_report(KEYWORD, report_path): print(f"n2026年版分析報(bào)告已導(dǎo)出至: {report_path}（新增「成長指數(shù)分析」「短視頻熱度」sheet）") except Exception as e: print(f"2026年接口調(diào)用出錯(cuò): {str(e)}")

五、2026年技術(shù)亮點(diǎn)與商業(yè)場(chǎng)景升級(jí)

1. 技術(shù)亮點(diǎn)（對(duì)比 2024 年版本）

2. 2026年核心商業(yè)場(chǎng)景

?直播帶貨選品：通過 “短視頻熱度 + 成長指數(shù)” 篩選預(yù)熱商品，開播前 3 天布局，轉(zhuǎn)化率提升 30%；

?私域商品適配：結(jié)合 “點(diǎn)擊轉(zhuǎn)化率 + 券后價(jià)”，篩選私域用戶偏好的高轉(zhuǎn)化商品；

?爆款提前布局：成長指數(shù)≥90 的商品，提前 15 天備貨，避免大促期間斷貨；

?聯(lián)盟推廣優(yōu)化：高傭金（≥8%）+ 短視頻高熱度商品，推廣傭金收益提升 25%。

六、2026年使用說明與擴(kuò)展建議

1. 環(huán)境依賴（更新至最新版本）

?Python 3.10+（2026年京東 API 不再兼容 3.8 及以下版本）

?依賴庫：requests 2.31.0+、pandas 2.2.0+、numpy 1.26.0+

安裝命令：pip install requests==2.31.0 pandas==2.2.0 numpy==1.26.0

2. 2026年權(quán)限申請(qǐng)注意事項(xiàng)

?高級(jí)權(quán)限需額外提交 “短視頻帶貨場(chǎng)景說明”（若需調(diào)用 shortVideoHot 字段）；

?成長指數(shù)字段僅對(duì) “企業(yè)服務(wù)商” 開放，個(gè)人開發(fā)者需升級(jí)為企業(yè)認(rèn)證；

?每月 1-5 號(hào)為權(quán)限審核高峰期，建議錯(cuò)峰申請(qǐng)。

3. 擴(kuò)展方向（2026年電商趨勢(shì)適配）

?短視頻帶貨監(jiān)控：定時(shí)抓取短視頻熱度變化，自動(dòng)推送 “熱度飆升但庫存不足” 的商品；

?私域選品助手：結(jié)合企業(yè)微信客戶畫像，推薦匹配的商品（如高傭金、券后價(jià)適配私域客群）；

?競(jìng)品成長追蹤：監(jiān)控競(jìng)品關(guān)鍵詞下的成長指數(shù)變化，分析其推廣策略調(diào)整。

2026年京東商品搜索接口的核心價(jià)值，已從 “數(shù)據(jù)獲取” 轉(zhuǎn)向 “商業(yè)價(jià)值預(yù)判”—— 通過成長指數(shù)提前捕捉爆款、用短視頻熱度適配直播場(chǎng)景，幫從業(yè)者在激烈的電商競(jìng)爭(zhēng)中搶占先機(jī)。

若在 2026年權(quán)限申請(qǐng)（如成長指數(shù)字段開通）、代碼調(diào)試（如短視頻熱度參數(shù)調(diào)用）或場(chǎng)景適配（如私域選品）中遇到問題，評(píng)論區(qū)留言具體需求，小編看到必回，一起拆解京東 API 的最新玩法！

審核編輯 黃宇