做電商選品、聯(lián)盟推廣或市場(chǎng)分析時(shí)，京東商品關(guān)鍵詞搜索接口（jd.union.open.goods.search）是連接 “用戶需求” 與 “商業(yè)價(jià)值” 的核心樞紐。2025 年京東開放平臺(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ù)解析的新坑。

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

京東 jd.union.open.goods.search 接口作為電商數(shù)據(jù)挖掘的核心入口，2025 年在 “檢索精度”“數(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)化：接入京東 “商品成長(zhǎng)指數(shù)”，可提前 15 天識(shí)別潛在爆款（原僅能識(shí)別上升趨勢(shì)商品）；

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

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

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

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

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

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

三、2025 年差異化技術(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 # 配置日志（2025年新增“請(qǐng)求耗時(shí)”記錄，便于排查接口延遲問(wèn)題） 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() # 2025年新增字段：商品成長(zhǎng)指數(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 (2025年京東新增字段)" ) # 2025年新增排序映射：商品成長(zhǎng)指數(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"), # 新增成長(zhǎng)指數(shù)升序 "growth_desc": ("growthScore", "desc") # 新增成長(zhǎng)指數(shù)降序 } def _init_session(self) -> requests.Session: """初始化會(huì)話，2025年調(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簽名（2025年簽名規(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]: """ 多條件搜索商品，支持2025年新增參數(shù)（商品成長(zhǎng)指數(shù)、短視頻熱度） :param keyword: 搜索關(guān)鍵詞 :param **kwargs: 新增參數(shù)： - growth_score: 商品成長(zhǎng)指數(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 } # 2025年新增：商品成長(zhǎng)指數(shù)篩選 growth_score = kwargs.get('growth_score') if growth_score and 0 <= growth_score <= 100: search_params["growthScore"] = growth_score # 2025年新增：短視頻熱度篩選（適配直播帶貨選品） 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)求（2025年京東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)（新增2025年常見(jiàn)錯(cuò)誤碼：10008-成長(zhǎng)指數(shù)參數(shù)無(wú)效） 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] # 2025年QPS規(guī)則未變，保持1.5秒間隔 time.sleep(1.5) logger.info(f"搜索關(guān)鍵詞[{keyword}]第{page}頁(yè)成功，獲取{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. 2025 年新增字段解析（商品成長(zhǎng)指數(shù)、短視頻熱度）

def _parse_goods(self, raw_data: Dict) -> Dict: """解析商品數(shù)據(jù)，新增2025年字段：成長(zhǎng)指數(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", {})) # 2025年新增字段解析 growth_info = { "score": raw_data.get("growthScore", 0), # 商品成長(zhǎng)指數(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) # 播放量（2025年新增） } click_info = { "rate": raw_data.get("clickRate", 0.0) # 實(shí)時(shí)點(diǎn)擊轉(zhuǎn)化率 } # 升級(jí)競(jìng)爭(zhēng)力評(píng)分：納入2025年新增字段 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), # 2025年新增字段 "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)分：2025年新增成長(zhǎng)指數(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） # 2025年新增維度（40分） score += min(20, round(growth_info["score"] * 0.2)) # 成長(zhǎng)指數(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. 2025 年商業(yè)機(jī)會(huì)挖掘（新增短視頻熱度、成長(zhǎng)指數(shù)場(chǎng)景）

def find_business_opportunities(self, keyword: str) -> List[Dict]: """發(fā)現(xiàn)潛在商業(yè)機(jī)會(huì)，2025年新增“短視頻高熱度低競(jìng)爭(zhē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：2025年新增——短視頻高熱度但低競(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：2025年新增——成長(zhǎng)指數(shù)飆升商品（提前布局潛在爆款） growth_goods = df[ (df["growth_score"] > 90) & # 成長(zhǎng)指數(shù)≥90（飆升中） (df["sales_volume"] < df["sales_volume"].quantile(0.7)) # 銷量尚未爆發(fā) ] if len(growth_goods) > 0: opportunities.append({ "type": "growth_opportunity", "description": "成長(zhǎng)指數(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

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

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

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

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

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

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

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

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

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

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

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

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

?依賴庫(kù)：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. 2025 年權(quán)限申請(qǐng)注意事項(xiàng)

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

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

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

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

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

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

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

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

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

審核編輯 黃宇