京东平台关键字搜索接口开发指南：Python实现与代码详解

一、接口概述

京东关键字搜索接口允许开发者通过HTTP请求获取平台商品的关键字搜索结果，常用于商品比价、数据分析等场景。本文基于Python演示如何调用京东搜索接口，解析返回数据并实现基础功能。

二、技术实现步骤

接口地址分析‌
京东未完全公开API文档，需通过浏览器开发者工具（F12）抓取搜索请求。示例接口格式：

python
Copy Code
SEARCH_URL = "https://search.jd.com/Search"

核心参数说明‌

参数名    说明    示例值
keyword    搜索关键词    "手机"
page    分页页码（每页30条）    1
sort    排序方式    "price_asc"

请求头伪装‌
需模拟浏览器请求，避免被反爬拦截：

python
Copy Code
headers = {
"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36",
"Referer": "https://www.jd.com/"
}

三、Python代码实现
python
Copy Code
import requests
from urllib.parse import urlencode
import json

def jd_keyword_search(keyword, page=1, sort=None):
    base_url = "https://search.jd.com/Search?"

    # 构造查询参数
    params = {
        "keyword": keyword,
        "page": page,
        "s": (page-1)*30 + 1 # 京东分页计算逻辑
    }
    if sort:
        params["sort"] = sort

    # 发送GET请求
    try:
        response = requests.get(
            url=base_url + urlencode(params),
            headers=headers,
            timeout=10
        )
        response.raise_for_status()
        return parse_search_result(response.text)
    except Exception as e:
        print(f"请求失败: {str(e)}")
        return None

def parse_search_result(html):
    # 京东页面数据通常嵌入在HTML的JS变量中
    start_str = "window.pageConfig = "
    start = html.find(start_str) + len(start_str)
    end = html.find("};", start) + 1
    json_data = json.loads(html[start:end])

    # 提取商品信息
    products = []
    for item in json_data["product"]:
        product = {
            "name": item.get("name", ""),
            "price": item.get("op", "无价格"),
            "shop": item.get("shop", {}).get("name", ""),
            "comments": item.get("commentCount", 0)
        }
        products.append(product)
    return products

# 示例调用
if __name__ == "__main__":
    headers = {
        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)..."
    }
    result = jd_keyword_search("蓝牙耳机", page=1, sort="price_asc")
    print(json.dumps(result[:2], indent=2, ensure_ascii=False))

四、响应数据处理示例
json
Copy Code
[
{
    "name": "华为FreeBuds 4E 无线蓝牙耳机",
    "price": "599.00",
    "shop": "华为京东自营旗舰店",
    "comments": 200000
},
{
    "name": "小米Redmi Buds 4 青春版",
    "price": "99.00",
    "shop": "小米京东自营旗舰店",
    "comments": 150000
}
]