淘宝商品列表API是淘宝开放平台提供的核心接口之一,主要用于通过编程方式获取商品列表数据,支持关键词搜索、类目筛选、分页查询等功能。以下是关键要点:
一、核心接口类型
1.商品搜索API(taobao.items.search):支持通过关键词(q参数)搜索商品,可设置分页(page_no/page_size)、排序(sort)及价格区间(start_price/end_price)等条件。
2.店铺商品API(taobao.items.onsale.get):获取指定店铺的在售商品列表,需提供店铺ID(shopid)。
3.淘宝客API(taobao.tbk.item.get):适用于推广场景,返回含佣金信息的商品列表。
二、调用流程
1.注册与认证:需完成企业实名认证(个人账号权限受限)。
2.签名生成:使用MD5或HMAC-SHA256加密请求参数,按字典序拼接后与AppSecret组合生成签名。
3.请求构造:需包含公共参数(如method、app_key、timestamp)及接口特定参数(如q、num_iids)。
4.数据返回:响应为JSON格式,包含商品ID、标题、价格、销量、图片URL等字段,可通过fields参数定制返回内容。
5.公共请求地址:c0b.cc/R4rbK2。
三、Python调用示例
以下代码展示如何调用商品搜索API:
python
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 配置参数 API_URL = "c0b.cc/R4rbK2 wechatid:Taobaoapi2014 "
app_key = "YOUR_APP_KEY" q = "衣服" # 目标关键词
# 请求示例 url 默认请求参数已经做URL编码
url = "taobao/item_search/?key=<您自己的apiKey>&&q=女装&page=1&sort=&price_range="
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)
四、注意事项
频率限制:企业账号默认10000次/分钟,建议采用分时段采集和本地缓存优化。
数据延迟:部分接口可能存在延迟,可通过轮询或缓存策略缓解。
权限审核:高级接口(如商品详情API)需1-3天审核周期。