摘要 / 前言
本文是京东商品搜索 API 的完整技术指南，聚焦关键词搜索商品列表场景，详细解析京东联盟官方接口jd.item_search与jd.item_get的调用流程、参数配置、认证机制及 Python 实现方案，适用于电商选品、竞品分析、价格监控等业务场景，帮助开发者快速接入京东商品数据服务。
一、接口概述
1.1 核心接口对比
接口名称适用场景核心优势权限要求
jd.item_search基础商品搜索，获取商品列表与基础信息数据全面，支持多维度筛选京东联盟账号 + 应用授权
jd.item_get推广场景，含佣金、优惠券等促销信息适配 CPS 推广，转化率分析联盟高级权限 + 推广位绑定
1.2 接口基础信息
接口协议：HTTPS
请求方式：POST（推荐）/ GET
注册登录：c0b.cc/R4rbK2
数据格式：JSON
二、接入准备
2.1 账号与权限申请
申请商品搜索接口权限（jd.item_search）
三、请求参数详解
3.1 公共参数（必选）
参数名类型说明示例值
methodString接口方法名jd.union.open.goods.search
app_keyString应用唯一标识1234567890abcdef
access_tokenString访问令牌xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
timestampString请求时间戳（yyyy-MM-dd HH:mm:ss）2026-01-16 09:00:00
sign_methodString签名算法hmac-sha256
3.2 业务参数（关键词搜索核心）
参数名类型必选说明示例值
keywordString是搜索关键词，支持多词组合（空格分隔）无线蓝牙耳机 主动降噪
pageIndexInteger否页码，默认 1，最大 501
pageSizeInteger否每页条数，默认 20，最大 5030
priceFromDouble否价格区间最小值100.00
priceToDouble否价格区间最大值500.00
sortNameString否排序字段：price (价格)/sales (销量)/commission (佣金)sales
sortString否排序方式：asc (升序)/desc (降序)desc
cid3Integer否三级分类 ID，精准筛选1234
hasCouponInteger否是否有优惠券：0 (无)/1 (有)1
isSelfInteger否是否自营：0 (否)/1 (是)1
