一、前言
做电商竞品监控、店铺数据巡检时，很多开发第一反应就是写网页爬虫抓取京东店铺商品。但爬虫方案痛点非常突出：页面 DOM 经常改版、频繁遇到滑块验证码、IP 容易被封禁、数据返回不稳定，一旦京东前端页面更新，爬虫代码直接失效，维护成本极高。
京东开放平台提供官方店铺商品列表接口，通过标准化 API 获取店铺内商品清单，数据结构稳定、合规可控，非常适合用来替代爬虫方案，批量拉取店铺商品 ID、标题、价格、库存、类目等信息。本文结合项目实战，完整讲解接口接入流程、参数说明、返回 JSON 样例以及开发避坑要点。
请求基础信息：
接口名称：jd .item_search_shop（京东店铺商品搜索API，taobaoapi2014前往体验）
接口版本：2.0
请求网关： c0b.cc/R4rbK2 （HTTPS，支持 GET/POST）
调用限制：存在单秒频次、每日调用配额，高频场景需做限流、缓存 处理。
核心作用：根据店铺 ID，获取商品列表数据，包括商品标题、价格、SKU、库存、图文、类目、销量、规格属性等全量详情数据。
适用业务场景
- 竞品店铺上新监控，实时捕捉新品上架
- 批量同步店铺全量商品基础信息，构建商品数据库
- 多店铺价格巡检、库存状态监测
- 电商数据分析、竞品店铺商品结构统计
- 对接下游详情、评论 API，搭建完整电商数据中台
二、接口基础信息
| 项目 | 说明 |
|---|---|
| 接口用途 | 查询指定京东店铺下商品列表，支持分页获取 |
| 请求方式 | HTTP POST |
| 数据格式 | 请求与返回均为 JSON |
| 权限前提 | 京东开放平台创建应用，并且获得目标店铺授权，获取 AppKey、AppSecret |
请求核心参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| shop_id | string | 是 | 京东店铺 ID，区分店铺 ID 和商品 ID，不可混用 |
| page | int | 是 | 分页页码，起始值为 1 |
| page_size | int | 是 | 单页返回商品数量，受平台 QPS 限制，一般上限 20 |
| sale_status | int | 否 | 商品售卖状态：0 全部，1 在售，2 下架 |
| fields | string | 否 | 指定返回字段，按需选取，减少传输开销 |
三、返回数据结构与 JSON 样例
接口返回分为顶层通用状态字段与业务 data 主体：
- code：响应码，0 = 成功，非 0 代表异常
- msg：响应描述文本
- data：业务数据 total：店铺商品总数量 page：当前请求页码 page_size：当前页条数 item_list：商品信息数据
