京东关键词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))