一、核心接口选型
2026年淘宝官方合规的批量关键词获取商品核心接口为 taobao.item.search（也叫taobao.items.search），搭配taobao.items.list.get可实现全量商品列表同步，是选品、竞品监控、批量数据采集的官方标准通道，相比爬虫更稳定合规，无需处理页面反爬逻辑。
二、前置接入准备
完成淘宝开放平台企业实名认证，创建工具型/自用型应用，获取App Key、App Secret。
在应用权限管理页提交业务场景说明，申请「商品搜索接口」调用权限，企业认证账号可获得更高的QPS调用额度。
三、核心调用规则
必填核心参数：q（搜索关键词）、page_no（分页页码）、page_size（单页条数，平台最大限制20条）、sort（排序规则，支持销量/价格/新品排序）、start_price/end_price（可选价格区间筛选）。
签名生成逻辑：将所有请求参数按字母顺序排序，拼接键值对后末尾追加App Secret，用MD5加密生成32位小写签名，作为sign参数传入请求。
请求规范：固定网关地址为https://gw.api.taobao.com/router/rest，推荐用POST方式提交参数，返回标准JSON格式数据，可直接解析得到商品ID、标题、主图、价格、销量等基础字段。
四、批量采集落地要点
先通过关键词搜索接口批量拉取商品num_iid（唯一商品ID），再调用taobao.item.get接口传入ID，补全SKU、库存、详情图文等深层全量数据，形成完整采集链路。
控制请求频率避免触发限流，东八区时间戳与平台时差不能超过5分钟，天猫商品无需额外适配，直接通过num_iid即可兼容查询。
常见错误码排查：27为接口权限未申请、41为签名生成错误、42为请求频率超限、-1为商品ID不存在/已下架。
