一、摘要
你所需的京东商品列表 API 是京东开放平台（含京东万象）提供的核心接口，主要用于获取京东平台 / 指定店铺的商品列表数据，支持按关键词、商品分类、价格区间、销量、店铺 ID 等条件筛选，返回商品标题、价格、库存、销量、图片、SKU 等结构化信息。该接口是实现京东店铺运营管理、商品价格监控、竞品分析、电商数据同步等场景的核心能力，需通过京东开发者认证并获取合法授权后调用。
二、接口概述
1. 前置条件
使用京东商品列表 API 前，需完成以下准备工作：
创建应用：在开发者后台创建应用（选择 “服务型应用”/“工具型应用”），审核通过后获取 appkey（应用 ID）、appsecret（应用密钥）；
获取访问凭证：通过 appkey 和 appsecret 获取 access_token（接口调用凭证，有效期通常为 30 天，部分接口为 2 小时）；
权限申请：在应用后台申请 “商品信息读取” 相关权限（不同商品列表接口权限不同，需提前审核）。
2. 核心接口信息（以京东万象「商品搜索 API」为例）
京东商品列表相关接口分多个版本（店铺商品列表、平台商品搜索、类目商品列表），以下为最常用的平台商品搜索 API 核心信息：
接口名称京东商品搜索（多条件筛选）。
接口地址：c0b.cc/R4rbK2 。
请求方式GET（推荐）/ POST。
数据格式JSON（请求 / 响应均为 UTF-8 编码）。
计费方式京东万象接口多为按量计费（免费额度 / 付费调用）。
3. 关键请求参数（核心必选 + 常用可选）
参数名是否必选类型说明
appkey是字符串开发者应用 ID（京东开放平台 / 万象分配）。
keyword是字符串商品搜索关键词（如 “手机”“笔记本电脑”）。
page否整数页码，默认 1。
pagesize否整数每页条数，默认 20，最大 50。
sort否字符串排序方式：price（价格）、sales（销量）、uptime（上架时间）。
pricefrom否浮点数价格区间下限（如 1000）。
priceto否浮点数价格区间上限（如 5000）。
cid否整数商品分类 ID（京东类目 ID，可通过类目 API 获取）。
三、Python 请求示例
# coding:utf-8
""" Compatible for python2.x and python3.x requirement: pip install requests """
from __future__ import print_function
import requests
# 配置参数 API_URL = "c0b.cc/R4rbK2 wechatid:Taobaoapi2014 "
# 请求示例 url 默认请求参数已经做URL编码
url = "jd/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&seller_info=no&nick=&seller_info=&nick=&ppath=&imgid=&filter=" headers = { "Accept-Encoding": "gzip", "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)
代码关键说明
参数适配：sort 参数需严格遵循接口文档（如京东开放平台官方接口排序参数为 sort_type）；
异常处理：覆盖了网络超时、HTTP 错误、响应字段缺失等常见问题，避免程序崩溃；
限流控制：若需批量获取多页数据，建议添加 time.sleep(1) 延时，避免触发频率限制。
总结
调用京东商品列表 API 的核心前提：获取合法的appkey/appsecret、access_token（开放平台），并申请对应接口权限；
关键避坑点：严格遵循参数格式、做好签名验证（开放平台）、控制调用频率、处理access_token过期问题。
若需实现多页商品数据爬取、商品价格监控等进阶功能，可基于示例代码扩展（如循环分页、数据存储到 CSV / 数据库）。
