摘要：在电商选品、竞品监控、市场数据分析、ERP 系统开发场景下，经常需要批量获取平台商品列表数据集。淘宝商品列表 API taobao.item_search 支持关键词检索、类目筛选、分页获取商品基础信息。本文从工程实践角度，拆解接口入参、分页实现逻辑、数据解析流程，梳理限流、字段缺失、数据过滤等开发踩坑点，可供电商后端、数据采集类项目开发参考。
一、业务背景
很多电商相关系统，需要根据关键词或者类目批量获取商品集合：比如市场选品调研、竞品店铺商品抓取、行业价格分布统计、铺货系统前期候选商品池构建。
如果采用网页爬虫的方式，会面临页面结构频繁变动、反爬策略限制、解析维护成本高等问题。调用官方风格的商品列表 API，可以拿到结构化 JSON 数据，不用处理 HTML 页面解析，稳定性相对更高。
taobao.item_search 淘宝商品列表搜索接口，主要用来根据关键词、类目 ID 返回商品列表，输出商品 id、标题、价格、主图、销量等基础信息，一般搭配商品详情 API 做二次数据补齐。
二、接口核心入参说明
参数说明
q搜索关键词，商品搜索关键字
cat类目 ID，指定类目下搜索，可选
page页码，分页页码，从 1 开始
page_size每页返回条数，受接口本身最大限制，不可无限放大
sort排序规则：销量、价格、综合排序等
业务开发最核心难点就是分页逻辑处理，很多开发者在这里踩坑。部分搜索接口并不是无限分页，当页码到达上限之后，不会返回报错，而是直接返回空列表，代码中需要做该场景判断。
三、返回核心数据结构简介
接口标识：taobao.item_search （淘宝商品列表API，taobaoapi2014前往体验）
请求网关： c0b.cc/R4rbK2 （HTTPS，支持 GET/POST）
接口版本：2.0
基础元数据：SPU 商品 ID、skuId、商品标题、品牌、类目、售卖状态、货号
媒体资源：主图数组、详情图片、商品短视频素材
SKU 规格数据：规格名称、各 SKU 售价、促销价、库存状态、限购规则
商品属性参数：产品规格、材质、包装清单等属性信息
附属业务信息：促销标签、市场参考价、区域限制相关字段
接口返回顶层包含 code、message、 data内部主要字段：
total：搜索结果总数量
page：当前页码
page_size：当前页大小
item_list：商品数组集合，每一条为一个商品简要对象
四、整体业务处理流程
传入关键词 / 类目 ID、排序方式、页码，调用taobao.item_search获取商品列表。
解析返回item_list数组，循环拿到每一个商品num_iid。
将商品基础数据存入数据库，构建候选商品池。
判断是否还有下一页：判断返回 item_list 是否为空，不为空则 page+1 继续请求；为空终止分页。
业务按需：使用 num_iid 批量调用商品详情接口，补齐 SKU、详情、属性等完整数据。
数据清洗：过滤广告商品、过滤下架商品，得到可用数据集，供给选品、价格统计、竞品分析模块使用。
