淘宝 / 京东关键词搜索 API 接入与实战用途教程｜从 0 到 1 搭建电商选品 / 比价 / 爬虫替代系统

一、为什么要接入「关键词搜索 API」？（核心价值）

在电商开发、竞品分析、价格监控、选品工具、分销商城等场景里，按关键词批量获取商品列表是最刚需的能力。

不用写爬虫、不封 IP、不过反爬、长期稳定
一次请求返回：标题、图片、价格、销量、ID、店铺、链接
支持分页、价格区间、销量排序、新品排序
可直接用于：选品、比价、店铺搬家、数据分析、大促监控

本文以最常用的两个平台为例：淘宝 item_search + 京东 item_search统一接入规范、统一调用逻辑、一套代码兼容多平台。

二、接口能力总览（能做什么）

淘宝关键词搜索 API

按关键词搜索全淘宝 / 天猫商品
支持：价格区间、销量排序、综合排序、优惠券筛选
返回：商品 ID、标题、图片、现价、原价、销量、店铺、链接

京东关键词搜索 API

按关键词搜索京东全品类商品
支持：价格区间、销量排序、评论数排序、新品排序
返回：商品 ID、标题、主图、价格、销量、评论数、详情链接

三、接入前准备

开通平台开发者权限，获取 key + secret
确定接口网关（统一规范）
开发环境：Python3 + requests

bash

运行

复制代码

pip install requests

四、公共参数与规则（两套平台通用）

所有请求必须携带以下公共参数：

key：调用身份标识
secret：密钥
api_name：接口名（item_search）
cache：是否缓存（yes/no，默认 yes）
result_type：返回格式（json 默认）
lang：语言（cn）

五、京东 item_search 接口接入（详细）

请求地址

plaintext

复制代码

https://api-gw.平台域名/jd/item_search

请求参数

q：搜索关键词（必填）
page：页码（默认 1）
start_price：起始价格
end_price：结束价格
sort ：排序
- bid 价格
- sale 销量
- review 评论数
- new 新品
- 加_前缀：倒序（如 _sale 销量从高到低）

Python 调用示例

python

运行

复制代码

import requests

# 配置信息
KEY = "你的key"
SECRET = "你的secret"
API_URL = "https://api-gw.平台域名/jd/item_search"

def jd_item_search(keyword, page=1, start_price=0, end_price=99999):
    params = {
        "key": KEY,
        "secret": SECRET,
        "api_name": "item_search",
        "q": keyword,
        "page": page,
        "start_price": start_price,
        "end_price": end_price,
        "sort": "_sale",  # 销量从高到低
        "cache": "yes",
        "result_type": "json",
        "lang": "cn"
    }
    try:
        resp = requests.get(API_URL, params=params, timeout=15)
        return resp.json()
    except Exception as e:
        print("请求异常", e)
        return None

# 测试搜索
if __name__ == "__main__":
    result = jd_item_search(keyword="连衣裙", page=1)
    if result and result.get("error_code") == "0000":
        items = result.get("items", {}).get("item", [])
        for item in items:
            print("="*50)
            print("商品ID:", item.get("num_iid"))
            print("标题:", item.get("title"))
            print("价格:", item.get("price"))
            print("图片:", item.get("pic_url"))
            print("链接:", item.get("detail_url"))

六、淘宝 item_search 接口接入（详细）

请求地址

plaintext

复制代码

https://api-gw.平台域名/taobao/item_search

请求参数

q：关键词
page：页码
start_price / end_price：价格区间
sort：排序（销量、价格、新品、信用）
discount_only：是否只显示优惠商品

Python 调用示例

python

运行

复制代码

import requests

# 配置信息
KEY = "你的key"
SECRET = "你的secret"
API_URL = "https://api-gw.平台域名/taobao/item_search"

def tb_item_search(keyword, page=1):
    params = {
        "key": KEY,
        "secret": SECRET,
        "api_name": "item_search",
        "q": keyword,
        "page": page,
        "start_price": 0,
        "end_price": 99999,
        "sort": "_sale",
        "cache": "yes",
        "lang": "cn"
    }
    try:
        resp = requests.get(API_URL, params=params, timeout=15)
        return resp.json()
    except Exception as e:
        print("请求异常", e)
        return None

# 测试
if __name__ == "__main__":
    data = tb_item_search("短袖T恤", page=1)
    # 解析逻辑同京东

七、返回数据解析（通用模板）

成功返回结构一般包含：

items：搜索结果
page：当前页
total_results：总数量
item [] 列表：
- num_iid：商品 ID
- title：标题
- pic_url：主图
- price：价格
- sales：销量
- detail_url：商品链接
- shop_name：店铺名称

八、关键词搜索 API 五大实战用途（可直接落地）

1. 电商选品系统（最常用）

按类目搜索爆款
按销量 / 价格 / 评分筛选潜力款
导出表格供运营选品

2. 跨平台比价工具

同一关键词同时搜淘宝 + 京东
自动对比价格、销量、优惠力度
输出最低价商品

3. 店铺 / 商城搬家工具

关键词批量采集商品
自动同步标题、图片、价格、参数
快速搭建自营商城 / 分销站

4. 价格监控与大促分析

618 / 双 11 定时搜索关键词
监控价格波动、销量暴涨商品
生成价格趋势图表

5. 市场调研与竞品分析

统计行业价格带分布
分析头部商家销量
挖掘新品趋势

九、接入必看避坑指南

关键词不要过长，精准词比长尾词返回更稳定
分页不要太深，超过 50 页可能无数据
请求频率不要过高，加 1~3 秒延时更稳定
价格筛选必须传数字，不能传空或字符串
排序参数写错会返回默认排序
cache=yes 速度更快，适合频繁查询

十、总结

淘宝、京东关键词搜索 API 是电商数据开发的基础核心接口 。一套规范、两套平台兼容、无需爬虫、稳定高效，可快速实现：选品、比价、数据分析、店铺搬家、价格监控、竞品分析等功能。

不管是毕设、课程设计、创业项目、企业工具，都能直接使用。