一、前言

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

二、接口概述

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

2.1 接口核心定位

接口名稱：jd.item_search

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

請(qǐng)求方式：POST

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

請(qǐng)求地址：c0b.cc/R4rbK2 （Taobaoapi2014獲?。?。

2.2 核心請(qǐng)求參數(shù)（關(guān)鍵詞搜索必備）

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

keyword：搜索關(guān)鍵詞，字符串類型，為接口核心入?yún)?，支持多關(guān)鍵詞組合（部分接口支持空格分隔）；

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

pageSize：?jiǎn)雾摂?shù)據(jù)量，整型，京東平臺(tái)對(duì)該參數(shù)有上限限制（通常為 20/50/100，依接口權(quán)限而定）；

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

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

accessKey：開發(fā)者身份標(biāo)識(shí)，由京東開放平臺(tái)審核通過后分配，用于接口權(quán)限驗(yàn)證；

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

2.3 核心返回?cái)?shù)據(jù)字段

接口返回?cái)?shù)據(jù)格式以JSON 為主，數(shù)據(jù)結(jié)構(gòu)標(biāo)準(zhǔn)化，包含商品列表核心公開信息，無敏感數(shù)據(jù)，核心返回字段如下（均為電商業(yè)務(wù)開發(fā)高頻使用字段）：

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

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

productName：商品標(biāo)題，字符串類型，包含京東平臺(tái)的商品官方名稱及核心賣點(diǎn)；

price：商品售價(jià)，浮點(diǎn)型，為京東平臺(tái)的實(shí)時(shí)標(biāo)價(jià)（部分接口返回原價(jià)、優(yōu)惠價(jià)雙字段）；

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

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

mainImage：商品主圖 URL，字符串類型，為京東平臺(tái)的圖片存儲(chǔ)地址，支持直接調(diào)用；

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

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

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

三、結(jié)語

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

審核編輯 黃宇