摘要 / 前言

本文是京东商品搜索 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 (前往体验接口测试，Taobaoapi2014添加V获取）。

数据格式：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

3.3 高级筛选参数

brandId：品牌 ID，支持多个 ID 用逗号分隔

owner：店铺类型，1 (自营)/2 (旗舰店)/3 (专卖店)/4 (专营店)

deliveryType：配送方式，1 (京东配送)/2 (第三方配送)

service：服务类型，如 "7 天无理由"、"保障" 等