从踩坑到高效落地：关键词搜索京东商品列表 API 的实操心得

京东商品列表 API 是获取京东平台商品数据的核心接口，支持关键词搜索、分类筛选、价格区间、销量排序等多条件查询，返回商品标题、价格、图片、销量、店铺等核心信息，广泛用于选品、比价、数据采集、电商系统集成等场景。

1. 公共必填参数

请求地址：c0b.cc/R4rbK2（Taobaoapi2014 获取体验）

请求方式：POST（推荐）/ GET

数据格式：JSON

业务参数:q:搜索关键字 、sort:排序[bid,_bid,_sale,_review,_new] 、 (bid:总价,sale:销量,review评论数,new新品,加_前缀为从大到小排序)<

page；

method：接口方法名，固定填jd.item_search

app_key：申请的AppKey

timestamp：请求时间戳，格式为YYYY-MM-DD HH:MM:SS

format：响应格式，填json

v：接口版本，填2.0

sign_method：签名方式，填md5

sign：签名串，需按规则生成

2. 业务筛选参数

keyword：搜索关键词（如手机、家电）

pageNo/pageSize：分页配置，按需调整

pricefrom/priceto：价格区间筛选

sortName/sort：排序规则，sale（销量）+desc（降序）为常用配置

3. 核心响应字段

调用成功后返回JSON数据，核心字段包含：商品SKU、商品标题、主图链接、售价、销量、店铺名称、是否自营等，直接提取即可使用。

4.签名生成（核心步骤）

京东API需校验签名，生成流程极简：

收集所有请求参数（不含sign），按参数名字典升序排序；

拼接参数名+参数值，末尾追加AppSecret；

对拼接字符串做MD5加密，结果转大写，即为sign。

审核编辑 黄宇