京东商品列表 API 是京东开放平台提供的核心数据接口，主要用于获取京东平台或指定店铺的商品列表数据，支持多条件筛选与分页查询，返回结构化商品信息。以下从核心接口、接入流程、参数与响应、调用示例等方面详细说明：
一、核心接口分类
京东商品列表相关接口主要分为两类，满足不同业务场景：
平台商品搜索
京东万象商品搜索 API
全网商品检索、竞品分析、价格监控
关键词、分类、价格、销量筛选，多维度排序
店铺商品查询
JD.item_search_shop
自有店铺管理、商品上下架监控
按店铺 ID、商品状态（上架 / 下架）查询
二、接入与认证流程
1. 注册开发者账号：请求地址：c0b.cc/R4rbK2 （Taobaoapi2014 获取体验）。
2. 获取授权：
◦ 平台商品搜索 API：部分接口需在京东万象申请权限，按量计费（含免费额度）。
◦ 店铺商品查询 API：需获取店铺授权，生成access_token（令牌）。
3. 接口调用：通过 HTTPS 请求接口，携带公共参数与业务参数，签名验证后获取数据。
三、核心接口详情（以店铺商品查询为例）
1. 基础信息
• 请求方式：POST（推荐）/ GET
• 数据格式：JSON（UTF-8 编码）
• 认证方式：AppKey + AppSecret 签名验证
2. 业务参数（JD.item_search_shop）
参数名 是否必选 说明 seller_id 是
京东店铺 ID page_no 是 页码，默认 1 page_size 是
每页条数，最大 100 status 否 商品状态：1（上架）、2（下架）
3. 响应示例
json
{ "code": 0, "message": "success", "data": { "total": 500, "items": [ { "sku_id": "100012345678", "title": "京东自营商品示例", "price": "199.00", "stock": 100, "sales": 5000, "image_url": "https://img14.360buyimg.com/xxx.jpg", "shop_name": "京东自营", "status": 1 } ] }}
四、调用注意事项
1. 签名规则：按京东开放平台签名规范，将公共参数与业务参数按字典序排序，拼接后用 AppSecret 加密生成 sign，防止请求被篡改。
2. 频率限制：接口有调用频率限制，需合理控制请求频次，避免触发限流。
3. 数据合规：仅用于合法业务场景，遵守京东开放平台协议，不得用于数据爬取、恶意竞争等违规行为。
4. 分页处理：单次返回数据量有限，需通过page_no分页获取全量数据。
五、常见应用场景
• 店铺运营：批量管理自有店铺商品，监控上下架状态与库存。
• 竞品分析：检索竞品商品列表，对比价格、销量、评价等数据。
• 价格监控：实时获取商品价格变动，用于价格策略调整。
• 数据同步：将京东商品数据同步至自有电商系统或数据分析平台。
