一、摘要
京东按关键字搜索商品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)返回数据结构:
接口返回包含商品列表、分页信息、筛选条件等完整数据,涵盖商品基础信息、价格、评价、店铺等关键字段。