京东店铺所有商品API接口解析（附 JSON 样例）

原创

用户1597063760

发布于 2026-09-14 08:48:31

280

文章被收录于专栏：经验经验

一、接口概述

京东店铺商品列表 API，用于获取指定京东店铺下的商品清单，可批量拉取店铺在售商品 ID、商品标题、主图、价格、上下架状态、类目等基础信息。很多开发同学初期会选择网页爬虫抓取店铺商品，缺点明显：页面结构频繁变更、IP 限流、反爬验证、数据不稳定。而官方 API 具备权限可控、返回结构化 JSON、数据稳定合规的优势，适合用于竞品监控、店铺商品巡检、比价系统、商品数据中台等业务场景。

请求基础信息：

接口名称：jd .item_search_shop（京东店铺商品搜索API，taobaoapi2014前往体验）

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

接口版本：2.0

调用限制：存在单秒频次、每日调用配额，高频场景需做限流、缓存处理。

核心作用：根据店铺 ID，获取商品列表数据，包括商品标题、价格、SKU、库存、图文、类目、销量、规格属性等全量详情数据。

适用业务场景

竞品店铺商品上新监控
批量同步店铺商品基础信息
多店铺商品价格巡检
电商数据分析、商品库存状态统计

二、接口基础信息

项目	说明
接口名称	店铺商品列表查询接口
请求方式	HTTP POST / GET（以开放平台文档为准）
入参格式	application/json
返回格式	JSON
权限要求	京东开放平台应用授权，需要店铺 ID、应用密钥

核心请求参数

参数名	类型	必填	说明
shop_id	string	是	京东店铺 ID，目标店铺唯一标识
page	int	是	分页页码，从 1 开始
page_size	int	是	每页返回商品数量，受接口限制，一般最大 20~100
status	int	否	商品状态：0 全部，1 在售，2 下架
fields	string	否	指定返回字段，按需裁剪减少返回数据体积

三、返回结果结构说明

返回 JSON 分为顶层通用字段与商品列表数组。

code：状态码，0 代表成功，非 0 为异常
msg：状态描述信息
data：业务数据主体
- total：店铺商品总条数
- page：当前页码
- page_size：当前页大小
- item_list：商品数组，每一项为单个商品信息

返回 JSON 样例

{
    "code": 0,
    "msg": "success",
    "data": {
        "total": 126,
        "page": 1,
        "page_size": 10,
        "item_list": [
            {
                "sku_id": "100012345678",
                "item_id": "100012345678",
                "title": "家用大容量保温壶 304不锈钢热水瓶",
                "main_img": "https://img14.360buyimg.com/n1/jfs/t1/xxx.jpg",
                "price": "79.00",
                "market_price": "129.00",
                "category_id": 12543,
                "category_name": "保温杯/壶",
                "stock_status": 1,
                "sale_status": 1,
                "brand_name": "某某家居",
                "publish_time": "2025-10-12"
            },
            {
                "sku_id": "100012345679",
                "item_id": "100012345679",
                "title": "厨房加厚硅胶隔热手套 耐高温",
                "main_img": "https://img14.360buyimg.com/n1/jfs/t2/xxx.jpg",
                "price": "19.90",
                "market_price": "39.90",
                "category_id": 12610,
                "category_name": "厨房小工具",
                "stock_status": 1,
                "sale_status": 1,
                "brand_name": "某某家居",
                "publish_time": "2025-11-03"
            }
        ]
    }
}

核心返回字段释义

字段	说明
item_id / sku_id	商品 ID，后续调用商品详情 API 的主键
title	商品标题
main_img	商品主图地址，可直接访问
price	销售价
market_price	市场价 / 划线价
stock_status	库存状态：1 有货，0 无货
sale_status	上下架状态：1 在售，2 下架
category_name	商品类目名称
brand_name	品牌名称
publish_time	商品上架时间