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