关键词搜索京东列表 API 技术对接指南

一、前言

在电商数据服务、代购集运系统搭建、电商平台竞品分析、自有商城商品同步等业务场景中，京东商品列表的精准、实时获取是核心环节之一。

二、接口概述

关键词搜索京东列表 API，核心是通过京东开放生态的标准化接口，传入搜索关键词等筛选参数，获取京东平台对应的商品列表结构化数据，以下为通用化的接口对接核心信息：

2.1 接口核心定位

接口名称：jd.item_search

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

请求方式：POST

数据格式：JSON

请求地址：c0b.cc/R4rbK2 （Taobaoapi2014 获取）。

2.2 核心返回数据字段接口返回数据格式以 JSON 为主，数据结构标准化，包含商品列表核心公开信息，无敏感数据，核心返回字段如下（均为电商业务开发高频使用字段）：

skuId：京东商品唯一标识，整型，为商品数据的核心主键；

spuId：商品系列唯一标识，整型，用于关联同款商品的不同规格；

productName：商品标题，字符串类型，包含京东平台的商品官方名称及核心卖点；

price：商品售价，浮点型，为京东平台的实时标价（部分接口返回原价、优惠价双字段）；salesVolume：商品销量，整型 / 字符串类型，部分接口返回累计销量或近期销量；

stockStatus：库存状态，枚举类型，如 0（无货）、1（有货）、2（预售），适配代购、商城等场景的库存判断；mainImage：商品主图 URL，字符串类型，为京东平台的图片存储地址，支持直接调用；shopName：店铺名称，字符串类型，返回商品所属京东店铺 / 自营店信息；

shopType：店铺类型，枚举类型，如 0（京东自营）、1（第三方店铺），是代购、选品场景的重要筛选依据；

pageTotal：总页码，整型，用于前端分页控件渲染和后端循环拉取全量数据。

三、结语

关键词搜索京东列表 API 是对接京东电商数据的基础且核心的接口，其标准化、合规化的特性，让电商数据服务商、系统开发企业摆脱了传统爬取的诸多弊端，成为搭建代购集运系统、电商数据分析系统、商品同步系统的重要技术支撑。