?
一、核心接口概覽
1. 官方核心搜索接口
接口名稱:jd.union.open.goods.search(京東聯(lián)盟開放平臺)
協(xié)議:HTTPS
請求方式:POST(推薦)/ GET
返回格式:JSON
適用場景:關(guān)鍵詞搜索、商品列表獲取、價格 / 促銷 / 傭金查詢、選品分析、CPS 推廣
2. 其他相關(guān)搜索類接口
jd.union.open.goods.promotion.query:聯(lián)盟商品推廣查詢(含優(yōu)惠券、傭金)
jingdong.ware.search:京東開放平臺商品搜索(商家 / 服務(wù)商側(cè))
jd.item_search / jd.item_get:第三方封裝 / 增強版搜索接口(非官方,需注意合規(guī))
二、核心參數(shù)(以 jd.union.open.goods.search 為例)
表格
| 參數(shù)名 | 類型 | 必選 | 說明 | 示例 |
|---|---|---|---|---|
| keyword | String | 是 | 搜索關(guān)鍵詞(空格分隔多詞) | 無線藍(lán)牙耳機 主動降噪 |
| page | Int | 否 | 頁碼(默認(rèn) 1,最大 50) | 1 |
| pageSize | Int | 否 | 每頁條數(shù)(默認(rèn) 30,最大 50) | 50 |
| sortType | String | 否 | 排序方式 | sales_desc(銷量降序) |
| priceFrom | Double | 否 | 價格下限 | 100.0 |
| priceTo | Double | 否 | 價格上限 | 500.0 |
| isSelf | Int | 否 | 是否自營(1 = 是,0 = 否) | 1 |
| hasCoupon | Int | 否 | 是否有優(yōu)惠券(1 = 有) | 1 |
| cid3 | Int | 否 | 三級分類 ID | 1234 |
三、返回核心數(shù)據(jù)字段(運營價值)
商品基礎(chǔ):skuId、skuName、imgUrl、brandName、shopName、isSelf
價格體系:price(原價)、lowPrice(到手價)、couponPrice(券后價)
銷量與評價:saleCount、goodRate、commentCount
推廣信息:commissionRate(傭金率)、coupon(優(yōu)惠券信息)
擴展指標(biāo):商品成長指數(shù)、短視頻熱度、點擊轉(zhuǎn)化率(高級權(quán)限)
四、接入流程(官方合規(guī))
注冊京東開放平臺賬號
個人:僅測試權(quán)限,商用受限
企業(yè):需營業(yè)執(zhí)照、法人信息,審核后可申請商用接口
入駐京東聯(lián)盟(jd.union.open.goods.search 必需)
訪問 union.jd.com 注冊并實名認(rèn)證
創(chuàng)建應(yīng)用并獲取憑證
開放平臺創(chuàng)建應(yīng)用 → 審核通過 → 獲取 App Key、App Secret
申請接口權(quán)限
申請 jd.union.open.goods.search 權(quán)限,填寫用途(選品分析 / 推廣等)
權(quán)限分級:基礎(chǔ)(5 次 / 秒)→ 進(jìn)階(20 次 / 秒)→ 高級(60 次 / 秒)
簽名與調(diào)用
按京東開放平臺規(guī)則生成簽名(sign)
組裝參數(shù)發(fā)起 HTTPS 請求,解析 JSON 結(jié)果
五、對賣家 / 開發(fā)者的核心幫助
1. 選品與市場分析
關(guān)鍵詞熱度與需求挖掘:通過搜索量、商品數(shù)、價格分布判斷市場容量
競品監(jiān)控:批量獲取競品列表、價格、銷量、評價,定位優(yōu)勢與短板
價格帶分析:不同價位段商品的銷量 / 評價分布,優(yōu)化定價策略
2. 聯(lián)盟推廣與 CPS 變現(xiàn)
高傭商品篩選:按傭金率、優(yōu)惠券、銷量排序,快速鎖定推廣品
推廣素材自動化:獲取商品標(biāo)題、主圖、鏈接、券信息,批量生成推廣文案
轉(zhuǎn)化追蹤:結(jié)合點擊 / 銷量數(shù)據(jù),優(yōu)化推廣渠道與關(guān)鍵詞
3. 店鋪運營優(yōu)化
關(guān)鍵詞布局:從搜索結(jié)果提取高轉(zhuǎn)化詞,優(yōu)化商品標(biāo)題、詳情頁
價格監(jiān)控:實時監(jiān)控競品到手價,自動調(diào)價 / 促銷
庫存與供應(yīng)鏈:通過銷量趨勢預(yù)判備貨,降低斷貨 / 積壓風(fēng)險
4. 數(shù)據(jù)驅(qū)動決策
實時數(shù)據(jù)獲取:替代手動采集,效率提升 80%+
結(jié)構(gòu)化分析:支持?jǐn)?shù)據(jù)導(dǎo)出 / 可視化,生成選品 / 推廣報表
合規(guī)穩(wěn)定:官方接口,無爬蟲封號 / 法律風(fēng)險
六、權(quán)限與調(diào)用限制(重要)
基礎(chǔ)權(quán)限:免費,5 次 / 秒,基礎(chǔ)信息(標(biāo)題、價格、主圖)
進(jìn)階權(quán)限:20 次 / 秒,含促銷、評價摘要
高級權(quán)限:60 次 / 秒,實時銷量、成長指數(shù)、短視頻熱度(需聯(lián)盟合作伙伴認(rèn)證)
嚴(yán)禁:高頻請求、數(shù)據(jù)倒賣、違規(guī)使用
七、快速落地建議
優(yōu)先走京東聯(lián)盟 + 開放平臺官方路徑,確保合規(guī)穩(wěn)定
先申請基礎(chǔ)權(quán)限測試,驗證數(shù)據(jù)與業(yè)務(wù)匹配度
聚焦核心場景:選品篩選、競品監(jiān)控、高傭推廣
配合 Python/Java SDK,簡化簽名與調(diào)用流程
有任何接口問題都可以聯(lián)系我祝大家馬年大吉?。?!
?
審核編輯 黃宇
-
接口
+關(guān)注
關(guān)注
33文章
9603瀏覽量
157650
發(fā)布評論請先 登錄
京東商品搜索API技術(shù)實踐指南
淘寶關(guān)鍵字搜索API接入后
京東商品詳情API接口詳解:獲取商品標(biāo)題、價格、庫存等核心數(shù)據(jù)
京東圖片搜索API深度解析:以圖搜貨賦能電商全場景
關(guān)鍵詞搜索京東列表 API 技術(shù)對接指南
使用京東關(guān)鍵詞搜索接口獲取商品數(shù)據(jù)的實操指南
京東關(guān)鍵詞API接口獲取
京東關(guān)鍵詞搜索接口獲取商品數(shù)據(jù)的實操指南
京東關(guān)鍵詞item_search-按關(guān)鍵字搜索京東商品
京東按關(guān)鍵字搜索商品 API接口item_search Pro
利用京東搜索關(guān)鍵詞 API 接口賦能電商運營
京東關(guān)鍵詞搜索商品列表的Python爬蟲實戰(zhàn)
京東API實時接口:京東商品評論數(shù)據(jù)接口
京東:利用商品管理API自動調(diào)整商品上下架狀態(tài),優(yōu)化搜索排名
產(chǎn)品搜索與過濾API接口
接入京東搜索接口
評論