接口简介: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 系统货源候选商品池批量采集
竞品监控系统,定时抓取类目商品快照
选品工具,筛选类目爆款商品