京东关键词API接口获取

你想要获取京东关键词相关的 API 接口，以此替代传统爬虫，更合规、稳定地获取商品列表等信息，我会先讲解官方合规的 API 获取与使用方式（推荐），再说明非官方接口的情况（仅供学习），并给出具体的调用示例。

一、核心前提说明

京东没有向普通个人用户开放免费的关键词搜索 API，所有合法可用的接口均需通过「京东开放平台」申请，且多数接口要求企业资质，同时有调用频率限制和费用规则；非官方的第三方接口存在合规性、稳定性风险，仅建议用于技术学习。

二、京东开放平台（官方合规 API）

这是获取京东关键词相关数据的唯一合法途径，适合商用或合规的开发场景。

1. 京东开放平台入口

官网地址：https://open.jd.com/home/home#/index

2. 官方 API 申请与使用流程（分步详解）

步骤 1：注册开发者账号

进入开放平台后，点击「注册」→ 选择「开发者注册」；

「个人开发者」：仅能申请部分测试接口，商用功能（如商品搜索）受限；

「企业开发者」：需提供营业执照、法人信息等资质，审核通过后可申请商用接口（推荐合规场景使用）。

步骤 2：创建应用，获取核心凭证

账号登录后，进入「应用管理」→「创建应用」，填写应用名称、用途、回调地址等信息；

应用审核通过后，可在「应用详情」页获取：

AppKey：应用唯一标识（调用 API 时必填）；

AppSecret：应用密钥（用于生成 API 签名，需严格保密）。

步骤 3：对接商品搜索相关 API

京东开放平台中，与「关键词搜索商品」匹配的核心接口是：

接口名称：jingdong.union.open.goods.promotion.query（京东联盟商品搜索接口）；

核心功能：根据关键词、分类、价格区间等条件查询商品信息（含标题、价格、佣金、链接等）；

权限要求：需先入驻「京东联盟」（https://union.jd.com/），再在开放平台绑定联盟账号。

步骤 4：Python 调用官方 API 示例（完整可运行）

官方 API 调用的核心是签名生成（京东采用 MD5 签名防篡改），以下是简化示例：

python

运行

import requests
import hashlib
import time
import json

class JdOfficialAPI:
    def __init__(self, app_key, app_secret):
        self.app_key = app_key  # 替换为你的AppKey
        self.app_secret = app_secret  # 替换为你的AppSecret
        self.base_url = "https://router.jd.com/api"  # 京东API网关固定地址

    def _generate_sign(self, params):
        """生成API签名（京东API必填，规则必须严格遵循）"""
        # 1. 按参数名ASCII升序排序
        sorted_params = sorted(params.items(), key=lambda x: x[0])
        # 2. 拼接签名字符串（AppSecret + 参数名值对 + AppSecret）
        sign_str = self.app_secret
        for k, v in sorted_params:
            if v:  # 跳过空值参数
                sign_str += f"{k}{v}"
        sign_str += self.app_secret
        # 3. MD5加密并转大写
        sign = hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper()
        return sign

    def search_goods(self, keyword, page=1, page_size=20):
        """
        调用京东联盟商品搜索API
        :param keyword: 搜索关键词
        :param page: 页码（从1开始）
        :param page_size: 每页商品数（最大20）
        :return: 商品列表字典，失败返回None
        """
        # 1. 构造基础参数（接口要求的固定参数）
        params = {
            "method": "jingdong.union.open.goods.promotion.query",  # 接口方法名
            "app_key": self.app_key,
            "format": "json",  # 返回格式（固定为json）
            "v": "1.0",  # 接口版本（固定为1.0）
            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),  # 北京时间戳
            "page_index": page,  # 页码
            "page_size": page_size,  # 每页条数
            "keyword": keyword  # 搜索关键词
        }
        # 2. 生成签名并添加到参数中
        params["sign"] = self._generate_sign(params)
        
        # 3. 发送请求
        try:
            response = requests.get(self.base_url, params=params, timeout=10)
            result = response.json()
            # 校验调用结果
            if result.get("code") == 0:
                return result.get("data", {})  # 返回商品数据
            else:
                print(f"API调用失败：{result.get('msg')}（错误码：{result.get('code')}）")
                return None
        except Exception as e:
            print(f"请求异常：{str(e)}")
            return None

# 调用示例
if __name__ == "__main__":
    # 替换为你从开放平台获取的真实凭证
    APP_KEY = "你的AppKey"
    APP_SECRET = "你的AppSecret"
    
    # 初始化API对象
    jd_api = JdOfficialAPI(APP_KEY, APP_SECRET)
    # 调用关键词搜索接口
    goods_data = jd_api.search_goods(keyword="Python编程", page=1, page_size=20)
    
    if goods_data:
        print("获取到的商品数据：")
        print(json.dumps(goods_data, ensure_ascii=False, indent=2))

步骤 5：官方 API 关键注意事项

权限申请：商品搜索接口属于「京东联盟」权限，需先入驻京东联盟并绑定开放平台账号；

调用限制：官方 API 有 QPS（每秒调用次数）限制（通常 10 次 / 秒），超出会被限流；

费用规则：接口本身免费，但商品推广佣金需按京东联盟规则分成，部分高级接口按调用量收费；

签名规则：签名是调用成功的核心，参数必须 ASCII 升序排序、MD5 加密后转大写，否则会直接调用失败。

三、非官方 API 接口（仅供学习）

非官方接口是第三方开发者基于爬虫封装的 API，无需企业资质，但风险极高，仅适合个人技术学习。

1. 核心风险说明

合规性：未经京东授权，使用此类接口违反京东用户协议，商用可能被追责；

稳定性：接口随时可能失效（京东反爬升级 / 第三方服务器关停）；

安全性：可能泄露你的请求数据，或被植入恶意代码。

2. 非官方 API 调用示例（仅学习）

python

运行

import requests
import json

def get_jd_goods_unofficial(keyword, page=1):
    """
    非官方京东商品搜索API调用（示例，接口可能已失效）
    """
    # 替换为开源/口碑较好的非官方API地址
    url = "https://api.example.com/jd/search"
    params = {
        "keyword": keyword,
        "page": page,
        "page_size": 20,
        "token": "test_token"  # 部分非官方API需临时token
    }
    try:
        response = requests.get(url, params=params, timeout=10)
        if response.status_code == 200:
            return response.json()
        else:
            print(f"调用失败，状态码：{response.status_code}")
            return None
    except Exception as e:
        print(f"请求异常：{str(e)}")
        return None

# 学习用调用示例
if __name__ == "__main__":
    data = get_jd_goods_unofficial("Python编程", page=1)
    if data:
        print(json.dumps(data, ensure_ascii=False, indent=2))

3. 学习用注意事项

切勿将非官方 API 用于商业项目；

优先选择 GitHub 开源的非官方 API 项目（可自查代码安全性），避免未知来源的接口；

调用频率控制在「几分钟 1 次」，避免给第三方服务器造成压力。

审核编辑 黄宇