一、摘要
你所需的京东商品列表 API 是京东开放平台（含京东万象）提供的核心接口，主要用于获取京东平台 / 指定店铺的商品列表数据，支持按关键词、商品分类、价格区间、销量、店铺 ID 等条件筛选，返回商品标题、价格、库存、销量、图片、SKU 等结构化信息。该接口是实现京东店铺运营管理、商品价格监控、竞品分析、电商数据同步等场景的核心能力，需通过京东开发者认证并获取合法授权后调用。
二、接口概述
- 前置条件
使用京东商品列表 API 前，需完成以下准备工作：
创建应用：在开发者后台创建应用（选择 “服务型应用”/“工具型应用”），审核通过后获取 appkey（应用 ID）、appsecret（应用密钥）；
获取访问凭证：通过 appkey 和 appsecret 获取 access_token（接口调用凭证，有效期通常为 30 天，部分接口为 2 小时）；
权限申请：在应用后台申请 “商品信息读取” 相关权限（不同商品列表接口权限不同，需提前审核）。
- 核心接口信息（以京东万象「商品搜索 API」为例）
京东商品列表相关接口分多个版本（店铺商品列表、平台商品搜索、类目商品列表），以下为最常用的平台商品搜索 API 核心信息：
接口名称京东商品搜索（多条件筛选）。
请求方式GET（推荐）/ POST。
数据格式JSON（请求 / 响应均为 UTF-8 编码）。
计费方式京东万象接口多为按量计费（免费额度 / 付费调用）。
- 关键请求参数（核心必选 + 常用可选）
参数名是否必选类型说明
appkey是字符串开发者应用 ID（京东开放平台 / 万象分配）。
keyword是字符串商品搜索关键词（如 “手机”“笔记本电脑”）。
page否整数页码，默认 1。
pagesize否整数每页条数，默认 20，最大 50。
sort否字符串排序方式：price（价格）、sales（销量）、uptime（上架时间）。
pricefrom否浮点数价格区间下限（如 1000）。
priceto否浮点数价格区间上限（如 5000）。
cid否整数商品分类 ID（京东类目 ID，可通过类目 API 获取）。
