jd.item_search 京东商品列表 API 返回值说明

接口简介：jd.item_search，通过关键词、类目 ID 检索京东商品列表，支持分页、排序、价格区间筛选；接口仅返回商品摘要数据，SKU、详情 HTML、完整参数需要拿着num_iid调用京东商品详情 API 补齐，返回格式为 JSON。

jd.item_search 京东商品列表 API 返回值说明

接口说明：jd.item_search，关键词 / 类目搜索获取淘宝商品列表，支持分页、排序，返回商品摘要数据；如需 SKU、详情图文，需要拿着num_iid调用商品详情接口二次补齐。返回格式 JSON。

接口标识：jd.item_search （京东商品列表API，taobaoapi2014前往体验）

请求网关： c0b.cc/R4rbK2 （HTTPS，支持 GET/POST）

接口版本：2.0

基础元数据：SPU 商品 ID、skuId、商品标题、品牌、类目、售卖状态、货号

媒体资源：主图数组、详情图片、商品短视频素材

SKU 规格数据：规格名称、各 SKU 售价、促销价、库存状态、限购规则

商品属性参数：产品规格、材质、包装清单等属性信息

附属业务信息：促销标签、市场参考价、区域限制相关字段

顶层响应结构

字段类型说明

codeint状态码，0代表调用成功；非 0 为异常错误码

messagestring返回提示，成功返回ok，失败返回错误描述

dataobject搜索业务主体对象

data 对象字段

字段类型说明

totalint搜索预估总商品数量，仅做参考，不能作为分页循环依据

pageint当前请求页码

page_sizeint每页返回条数

page_countint预估总页数，京东存在深层分页限制，该数值不可信

item_listarray[object]商品摘要数组，核心业务数据集

item_list 单条商品对象字段

字段类型说明

num_iidbigint京东商品 SKU 编号，调用商品详情接口的入参

titlestring商品完整标题

pricefloat当前售卖促销价

original_pricefloat划线市场价，无则返回 0

pic_urlstring商品主图 CDN 地址

salesint商品近 30 天销量

comment_countint商品总评价数量

scorefloat商品店铺评分

shop_idbigint店铺 ID

seller_nickstring店铺名称

is_selfboolean是否京东自营，true = 自营

cat_idint商品类目 ID

cat_namestring类目名称

provincestring发货省份

citystring发货城市

item_urlstring商品 H5 详情访问链接

is_adboolean是否广告推广商品，true 为付费广告，统计分析建议过滤

适用业务场景

电商市场调研，类目价格、销量分布统计

ERP 系统货源候选商品池批量采集

竞品监控系统，定时抓取类目商品快照

选品工具，筛选类目爆款商品