一、前言

在電商數(shù)據(jù)服務、代購集運系統(tǒng)搭建、電商平臺競品分析、自有商城商品同步等業(yè)務場景中，京東商品列表的精準、實時獲取是核心環(huán)節(jié)之一。

二、接口概述

關鍵詞搜索京東列表 API，核心是通過京東開放生態(tài)的標準化接口，傳入搜索關鍵詞等篩選參數(shù)，獲取京東平臺對應的商品列表結構化數(shù)據(jù)，目前主流的合規(guī)對接渠道為京東開放平臺（JD Open Platform）和京東聯(lián)盟開放平臺，前者適用于京東商家自有店鋪 / 平臺合作的數(shù)據(jù)對接，后者更適用于第三方數(shù)據(jù)服務、導購、代購等場景的商品列表獲取，二者的關鍵詞搜索核心邏輯一致，以下為通用化的接口對接核心信息：

2.1 接口核心定位

接口名稱：jd.item_search

接口類型：REST API（HTTP/HTTPS）

請求方式：POST

數(shù)據(jù)格式：JSON

請求地址：c0b.cc/R4rbK2 （Taobaoapi2014獲取）。

2.2 核心請求參數(shù)（關鍵詞搜索必備）

所有京東列表 API 的關鍵詞搜索請求均基于HTTP/HTTPS 協(xié)議，采用 RESTful 風格或 RPC 風格，請求方式以 GET/POST 為主，參數(shù)需遵循京東開放平臺的編碼規(guī)范（如 UTF-8），核心必備參數(shù)如下：

keyword：搜索關鍵詞，字符串類型，為接口核心入?yún)ⅲС侄嚓P鍵詞組合（部分接口支持空格分隔）；

pageNo：頁碼，整型，默認值 1，用于分頁獲取商品列表，避免單頁返回數(shù)據(jù)量過大；

pageSize：單頁數(shù)據(jù)量，整型，京東平臺對該參數(shù)有上限限制（通常為 20/50/100，依接口權限而定）；

categoryId（可選）：商品品類 ID，整型，可配合關鍵詞實現(xiàn)精準篩選，縮小搜索范圍；

sort（可選）：排序方式，字符串類型，主流支持price_asc（價格升序）、price_desc（價格降序）、sales_desc（銷量降序）、score_desc（綜合排序）等；

accessKey：開發(fā)者身份標識，由京東開放平臺審核通過后分配，用于接口權限驗證；

sign：簽名串，由開發(fā)者根據(jù)京東平臺的簽名算法（如 MD5/HMAC-SHA256）生成，結合 accessKey、secretKey、請求參數(shù)、時間戳等，是接口調用的安全驗證核心，防止參數(shù)篡改。

2.3 核心返回數(shù)據(jù)字段

接口返回數(shù)據(jù)格式以JSON 為主，數(shù)據(jù)結構標準化，包含商品列表核心公開信息，無敏感數(shù)據(jù)，核心返回字段如下（均為電商業(yè)務開發(fā)高頻使用字段）：

skuId：京東商品唯一標識，整型，為商品數(shù)據(jù)的核心主鍵；

spuId：商品系列唯一標識，整型，用于關聯(lián)同款商品的不同規(guī)格；

productName：商品標題，字符串類型，包含京東平臺的商品官方名稱及核心賣點；

price：商品售價，浮點型，為京東平臺的實時標價（部分接口返回原價、優(yōu)惠價雙字段）；

salesVolume：商品銷量，整型 / 字符串類型，部分接口返回累計銷量或近期銷量；

stockStatus：庫存狀態(tài)，枚舉類型，如0（無貨）、1（有貨）、2（預售），適配代購、商城等場景的庫存判斷；

mainImage：商品主圖 URL，字符串類型，為京東平臺的圖片存儲地址，支持直接調用；

shopName：店鋪名稱，字符串類型，返回商品所屬京東店鋪 / 自營店信息；

shopType：店鋪類型，枚舉類型，如0（京東自營）、1（第三方店鋪），是代購、選品場景的重要篩選依據(jù)；

pageTotal：總頁碼，整型，用于前端分頁控件渲染和后端循環(huán)拉取全量數(shù)據(jù)。

三、結語

關鍵詞搜索京東列表 API 是對接京東電商數(shù)據(jù)的基礎且核心的接口，其標準化、合規(guī)化的特性，讓電商數(shù)據(jù)服務商、系統(tǒng)開發(fā)企業(yè)擺脫了傳統(tǒng)爬取的諸多弊端，成為搭建代購集運系統(tǒng)、電商數(shù)據(jù)分析系統(tǒng)、商品同步系統(tǒng)的重要技術支撐。

審核編輯 黃宇