当前位置：首页 > news >正文

淘宝关键词商品搜索API接入实践（附完整代码+签名逻辑）

news 2026/4/17 18:16:16

在电商数据开发中，关键词搜索API是选品、竞品监控、价格跟踪的核心工具。相比自主爬虫，第三方API无需处理反爬、页面解析，稳定性和合规性更优。本文结合3类淘宝系关键词搜索接口（通用、天猫专属、高级搜索），分享接入流程、测试心得及完整可运行代码，新手也能快速落地。

一、核心接口说明（3类常用）

无需复杂配置，按需选择接口即可满足不同场景需求：

通用关键词搜索：覆盖淘宝全量商品，支持基础筛选（价格、销量、发货地），适合全平台选品；
天猫专属搜索：仅返回天猫店铺商品，适配品牌监控、正品比价场景；
高级搜索：支持优惠券、促销活动、店铺评分等细粒度筛选，适合精细化选品分析。

二、接入前置准备

核心是完成身份鉴权，步骤简单：

注册对应平台账号，获取app_key（应用标识）和app_secret（密钥）；
确认接口请求方式（GET/POST），默认返回JSON格式，支持分页；
核心原则：所有请求必须携带合法签名，避免权限异常。

三、核心参数与签名逻辑（关键）

1. 常用核心参数

所有关键词搜索接口，核心参数一致，按需补充筛选条件：

q：搜索关键词（必填，支持中文/英文，长尾关键词更精准）；
page_no：页码（默认1，支持分页加载）；
page_size：单页条数（建议20-50条，避免超时）；
sort：排序方式（sale=销量、price=价格、new=新品）；
start_price/end_price：价格区间筛选（可选）。

2. 签名生成逻辑（避坑重点）

签名是接口鉴权的核心，目的是防止参数篡改，步骤如下：

将所有请求参数（含app_key，不含sign）按字母顺序排序；
拼接参数键值对（格式：key1value1key2value2...）；
末尾拼接app_secret，使用MD5加密（小写），得到签名sign；
将sign加入请求参数，发起请求。

四、完整Python调用代码（可直接运行）

整合通用搜索接口、签名逻辑，替换自己的app_key和app_secret即可测试：

import requests import hashlib import time # 基础配置（替换为自己的密钥） base_url = "你的接口请求地址" app_key = "your_app_key" app_secret = "your_app_secret" def generate_sign(params, app_secret): """生成接口签名（MD5加密）""" # 1. 参数按字母排序 sorted_params = sorted(params.items(), key=lambda x: x[0]) # 2. 拼接键值对 sign_str = "" for key, value in sorted_params: sign_str += f"{key}{value}" # 3. 拼接密钥并加密 sign_str += app_secret sign = hashlib.md5(sign_str.encode("utf-8")).hexdigest().lower() return sign def search_taobao_goods(keyword, page_no=1, page_size=20, sort="sale"): """ 淘宝关键词搜索接口调用 :param keyword: 搜索关键词 :param page_no: 页码 :param page_size: 单页条数 :param sort: 排序方式（sale/price/new） :return: 商品列表 """ # 1. 组装请求参数 params = { "app_key": app_key, "q": keyword, "page_no": page_no, "page_size": page_size, "sort": sort, "format": "json", "timestamp": int(time.time()) # 时间戳，避免请求重复 } # 2. 生成签名 params["sign"] = generate_sign(params, app_secret) # 3. 发起请求 try: response = requests.get(base_url, params=params, timeout=10) data = response.json() # 4. 解析结果 if data.get("code") == 0: return data.get("result", {}).get("items", []) else: print(f"请求失败：{data.get('msg')}") return [] except Exception as e: print(f"接口调用异常：{str(e)}") return [] # 测试调用 if __name__ == "__main__": goods_list = search_taobao_goods(keyword="无线蓝牙耳机", page_no=1, page_size=10) print(f"获取到{len(goods_list)}件商品：") for idx, goods in enumerate(goods_list, 1): print(f"\n{idx}. 商品标题：{goods.get('title')}") print(f" 商品价格：{goods.get('price')}元") print(f" 店铺名称：{goods.get('nick')}") print(f" 商品销量：{goods.get('sale_num')}")