京东商品列表API接口开发指南
一、摘要
京东按关键字搜索商品API是京东开放平台提供的重要接口，允许开发者通过关键词检索京东平台上的商品信息。该接口支持多种搜索参数配置，能够返回丰富的商品数据，为电商应用开发、价格监控、商品比价等场景提供数据支持。
二、接口概述
1.接口基本信息
接口名称：商品关键词搜索接口
接口功能：根据关键词搜索京东商品
请求方式：HTTP GET/POST
数据格式：JSON/XML
调用限制：存在频率限制，具体以官方文档为准
公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| key | String | 是 | 调用key（必须以GET方式拼接在URL中） |
| adress | String | 是 | c0b.cc/R4rbK2 (切换真实请求账号） |
| api_name | String | 是 | API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等] |
| cache | String | 否 | [yes,no]默认yes，将调用缓存的数据，速度比较快 |
| result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读 |
| lang | String | 否 | [cn,en,ru]翻译语言，默认cn简体中文 |
| version | String | 否 | API版本 |
2.主要参数说明
keyword：搜索关键词，必填参数
page：页码，用于分页查询
pageSize：每页显示数量
sort：排序方式（价格、销量、评价等）
priceRange：价格区间筛选
category：商品分类筛选
三、Python请求示例
# coding:utf-8 """ Compatible for python2.x and python3.x requirement: pip install requests """ from __future__ import print_function import requests # 请求示例 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)返回数据结构:
接口返回包含商品列表、分页信息、筛选条件等完整数据，涵盖商品基础信息、价格、评价、店铺等关键字段。