京东按关键字搜索商品 API接口item_search Pro

京东搜索商品 API（item_search Pro）赋能电商运营全指南

item_search Pro 是京东商品搜索接口的增强版（第三方封装或官方增强能力），核心用于按关键词 / 条件检索商品列表，获取商品基础信息、价格、销量、店铺、库存等核心数据，是电商选品、竞品分析、价格监控、市场调研的关键技术工具。

一、接口核心定位与官方关系

官方接口对应：本质是京东开放平台jingdong.ware.search（商品搜索）或联盟平台jd.union.open.goods.search的增强封装，提供更丰富筛选与数据字段

核心价值：从 “人工采集” 升级为 “数据驱动”，支撑选品决策、竞品监控、价格优化、市场分析四大核心运营场景，效率提升 80%+

数据维度：覆盖商品基础信息、价格体系、销量数据、店铺信息、库存状态、评分评价等 12 + 核心字段

二、核心参数与数据字段详解

1. 必选参数（调用基础）

参数名	类型	说明	示例
keyword	String	搜索关键词	无线耳机 降噪
appkey	String	开发者密钥	32 位字符串（京东开放平台获取）
timestamp	Long	时间戳（毫秒）	1672502400000
sign	String	签名（MD5 加密）	按参数排序 + 密钥生成

2. 可选筛选参数（精准定位商品）

参数名	类型	说明	有效值
categoryId	Long	商品分类 ID	3258（耳机类目，通过类目 API 获取）
page	Int	页码	1-50（默认 1）
pageSize	Int	每页数量	10-50（默认 20）
sortType	String	排序方式	price_asc/price_desc/sale_desc（销量降序）
start_price/end_price	Float	价格区间	100-500（筛选 100-500 元商品）
brand	String	品牌筛选	华为 / 小米
seller_id	Long	店铺 ID 筛选	123456（指定店铺商品）
is_stock	Int	库存筛选	1（仅显示有货）

3. 返回核心数据字段（运营价值）

字段名	类型	运营应用场景
skuId	String	商品唯一标识（用于详情查询 / 竞品跟踪）
skuName	String	商品标题（标题优化参考）
price	Float	售价（定价策略 / 价格监控）
originalPrice	Float	原价（折扣力度分析）
saleCount	Int	销量（爆款判断 / 市场热度）
shopName	String	店铺名称（竞品店铺识别）
shopId	Long	店铺 ID（店铺监控）
stock	Int	库存（补货提醒 / 市场供给分析）
score	Float	商品评分（品质筛选）
commentCount	Int	评价数（口碑判断）
imgUrl	String	商品主图（素材参考）
productUrl	String	商品链接（详情页访问）

三、完整调用流程与代码实现（多语言）

1. 前置准备（关键步骤）

注册京东开放平台开发者账号（https://open.jd.com/）

创建应用，获取appkey + appsecret

开通商品搜索 API 权限（部分接口需企业资质 / 付费）

熟悉签名规则：按参数名 ASCII 排序→拼接密钥→MD5 加密→转大写

2. Python 代码示例（推荐，数据处理高效）

python

运行

 

import requests
import hashlib
import time

# 配置信息
APP_KEY = "你的appkey"
APP_SECRET = "你的appsecret"
KEYWORD = "无线耳机 降噪"
CATEGORY_ID = 3258
PAGE = 1
PAGE_SIZE = 30

# 生成签名（核心步骤）
def generate_sign(params):
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    sign_str = APP_SECRET + ''.join([f"{k}{v}" for k, v in sorted_params]) + APP_SECRET
    return hashlib.md5(sign_str.encode()).hexdigest().upper()

# 构造请求参数
params = {
    "appkey": APP_KEY,
    "keyword": KEYWORD,
    "categoryId": CATEGORY_ID,
    "page": PAGE,
    "pageSize": PAGE_SIZE,
    "sortType": "sale_desc",
    "timestamp": str(int(time.time()*1000)),
    "format": "json"
}
params["sign"] = generate_sign(params)

# 发送请求
url = "https://api.jd.com/routerjson"
response = requests.get(url, params=params, timeout=10)
result = response.json()

# 解析数据
if result.get("code") == 0:
    items = result["data"]["items"]
    print(f"搜索结果：共{len(items)}件商品")
    for item in items[:5]:  # 输出前5件
        print(f"商品ID：{item['skuId']} | 标题：{item['skuName'][:30]}... | 价格：{item['price']} | 销量：{item['saleCount']}")
else:
    print(f"调用失败：{result.get('msg', '未知错误')}")

 

3. Java 代码示例（企业级系统集成）

java

运行

 

import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;
import java.util.*;
import java.security.MessageDigest;

public class JdItemSearchPro {
    private static final String APP_KEY = "你的appkey";
    private static final String APP_SECRET = "你的appsecret";
    private static final String API_URL = "https://api.jd.com/routerjson";

    public static void main(String[] args) {
        Map< String, String > params = new HashMap<  >();
        params.put("appkey", APP_KEY);
        params.put("keyword", "无线耳机 降噪");
        params.put("categoryId", "3258");
        params.put("page", "1");
        params.put("pageSize", "30");
        params.put("sortType", "sale_desc");
        params.put("timestamp", String.valueOf(System.currentTimeMillis()));
        params.put("format", "json");
        params.put("sign", generateSign(params));

        try (CloseableHttpClient client = HttpClients.createDefault()) {
            StringBuilder url = new StringBuilder(API_URL).append("?");
            for (Map.Entry< String, String > entry : params.entrySet()) {
                url.append(entry.getKey()).append("=").append(entry.getValue()).append("&");
            }
            HttpGet request = new HttpGet(url.substring(0, url.length()-1));
            String response = EntityUtils.toString(client.execute(request).getEntity(), "UTF-8");
            System.out.println("响应结果：" + response);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    private static String generateSign(Map< String, String > params) {
        List< Map.Entry< String, String >> list = new ArrayList<  >(params.entrySet());
        list.sort(Map.Entry.comparingByKey());
        StringBuilder sb = new StringBuilder(APP_SECRET);
        for (Map.Entry< String, String > entry : list) {
            sb.append(entry.getKey()).append(entry.getValue());
        }
        sb.append(APP_SECRET);
        return md5(sb.toString()).toUpperCase();
    }

    private static String md5(String str) {
        try {
            MessageDigest md = MessageDigest.getInstance("MD5");
            byte[] bytes = md.digest(str.getBytes());
            StringBuilder sb = new StringBuilder();
            for (byte b : bytes) {
                String hex = Integer.toHexString(b & 0xFF);
                if (hex.length() == 1) sb.append("0");
                sb.append(hex);
            }
            return sb.toString();
        } catch (Exception e) {
            return "";
        }
    }
}

 

4. PHP 代码示例（店铺后台快速集成）

php

运行

 

< ?php
$appkey = "你的appkey";
$appsecret = "你的appsecret";
$keyword = "无线耳机 降噪";
$categoryId = 3258;
$page = 1;
$pageSize = 30;
$timestamp = (string)round(microtime(true)*1000);

// 构造参数并排序
$params = [
    "appkey" = > $appkey,
    "keyword" = > $keyword,
    "categoryId" = > $categoryId,
    "page" = > $page,
    "pageSize" = > $pageSize,
    "sortType" = > "sale_desc",
    "timestamp" = > $timestamp,
    "format" = > "json"
];
ksort($params);

// 生成签名
$signStr = $appsecret;
foreach ($params as $k = > $v) {
    $signStr .= $k . $v;
}
$signStr .= $appsecret;
$params["sign"] = strtoupper(md5($signStr));

// 发送请求
$url = "https://api.jd.com/routerjson?" . http_build_query($params);
$response = file_get_contents($url);
$result = json_decode($response, true);

// 解析数据
if ($result["code"] == 0) {
    $items = $result["data"]["items"];
    echo "搜索结果：共" . count($items) . "件商品n";
    foreach (array_slice($items, 0, 5) as $item) {
        echo "商品ID：{$item['skuId']} | 标题：" . mb_substr($item['skuName'], 0, 30) . "... | 价格：{$item['price']}n";
    }
} else {
    echo "调用失败：{$result['msg']}n";
}
? >

 

四、四大核心运营场景落地（直接见效）

1. 数据驱动选品：挖掘潜力爆款

操作流程：

批量获取类目 TOP 关键词（通过搜索关键词 API）

用 item_search Pro 查询每个关键词下销量 TOP20 商品

筛选条件：30 天销量 > 1000 + 好评率 > 95%+ 价格区间在类目均价 ±20%

结合关键词热度与竞争度，锁定 “高热度 + 低竞争” 潜力款

案例：某 3C 商家通过该流程筛选出 “无线耳机 超长续航 100 小时”，30 天销量 1200+，好评率 96%，上架后月销突破 5000 单，自然流量占比 65%。

2. 竞品监控：实时跟踪对手动态

监控维度：

价格监控：每日定时（每 4 小时）调用接口，跟踪竞品价格变动，阈值触发（降价 > 10%）自动预警

销量追踪：统计竞品周 / 月销量增长，判断其推广力度与市场接受度

标题优化：分析竞品标题关键词布局，提取高转化词用于自身标题优化

库存监测：监控竞品库存，判断其补货周期与断货风险

工具化：开发自动化监控系统，每日生成竞品分析报告，包含价格趋势、销量对比、标题变化等维度。

3. 动态定价：避免价格战，锁定利润

定价策略：

用 item_search Pro 获取类目价格分布（低价段 <均价 70%，中价段 70%-130%，高价段> 130%）

若中价段商品占比 < 40% 且自身成本有优势，定在中价段（均价 + 10%），保证利润

若低价段占比 > 60%，避开低价竞争，主打功能差异化（如 “进口芯片 + 终身保修”），定价高于均价 15%-20%

实时监控类目价格变动，动态调整价格，保持竞争力同时最大化利润

4. 广告优化：提升京东快车 ROI

操作步骤：

筛选高转化关键词（通过搜索关键词 API 获取 “高热度 + 高转化率 + 低竞争度” 词）

用 item_search Pro 查询这些关键词下前 10 商品的价格与销量，确定广告出价区间

按关键词等级分配预算：A 级（核心词）高价抢位（前 5），B 级（关联词）中价稳定（6-10），C 级（长尾词）低价铺量

实时监控广告排名，调整出价，确保 CPC 低于行业均值，ROI>3

五、API 调用避坑指南（合规 + 高效）

1. 合规性要求（避免账号封禁）

调用频率：严格遵守京东 QPS 限制（建议≤5），批量调用设置1-2 秒间隔

数据使用：仅用于自身店铺运营，不得泄露、转售或用于恶意竞争

权限管理：敏感数据（如精准销量、转化率）需申请专项权限，未授权不得抓取

法律风险：遵守《电子商务法》《数据安全法》，避免数据滥用

2. 技术避坑（确保调用稳定）

签名错误：参数必须按ASCII 码排序，否则签名验证失败（最常见问题）

分类 ID 错误：通过京东类目查询 API 获取准确 ID，否则返回数据与目标类目不匹配

分页限制：最大支持 50 页，每页最多 50 条，超出部分无返回

异常处理：添加网络超时、数据缺失、错误码捕获，避免程序崩溃

数据缓存：高频查询数据（如类目价格分布）设置1-3 小时缓存，减轻接口压力

3. 数据应用避坑（避免决策失误）

单一数据依赖：结合店铺自身数据（转化率、复购率）综合决策，API 数据仅作参考

忽略长尾词：长尾词虽流量小，但转化率高（通常是核心词的 2-3 倍），需均衡布局

实时性误区：部分数据（如销量）存在延迟（约 1-2 小时），避免基于实时数据做紧急决策

六、总结与进阶建议

item_search Pro 的核心价值在于将京东海量商品数据转化为可执行的运营动作，构建 “数据采集→分析→优化→监控→迭代” 的闭环。对于电商运营者，掌握该接口意味着：

从 “经验驱动” 升级为 “数据驱动”，决策更精准

运营效率提升 80%+，减少人工采集成本

市场响应速度提升至小时级，抢占竞争先机

审核编辑 黄宇