淘宝商品采集API|关键字搜索商品列表|获取商品详情API接入指南
一、接口作用简介
做选品、铺货、竞品监控、ERP 多店管理，离不开淘宝商品数据。TOP 开放平台提供两大核心采集接口：
taobao.items.search：关键词检索商品列表，批量获取商品 ID、标题、售价、主图、销量；
taobao.item.get：传入商品 ID，调取完整详情，含 SKU 规格、详情图、库存、属性、优惠券等全量数据。
二、接入前置准备
登录开放平台完成个人 / 企业实名认证；
创建工具型应用，审核通过拿到App Key、App Secret；
在权限管理申请商品搜索、商品详情接口调用权限，等待平台审核；
接口网关统一地址：
https://gw.api.taobao.com/router/rest淘宝开放平台。
三、基础调用规则
所有请求需携带公共参数：app_key、method、timestamp、v=2.0、sign（MD5 签名）、format=json。
1. 关键词搜索商品列表
method 填taobao.items.search，核心业务参数：
q：搜索关键词
page_no、page_size：分页控制
sort：销量 / 价格排序 返回分页商品基础列表，批量拿到 num_iid 商品 ID。
2. 获取单商品详情
method 填taobao.item.get，必填 num_iid（搜索接口返回的商品 ID）； fields 自定义返回字段，按需拉取价格、SKU、详情描述、产地等，减少冗余数据传输。
四、简易调用流程
拼接全部参数，按规则生成 MD5 签名 sign；
HTTPS GET/POST 请求网关地址；
接收 JSON 返回数据，解析商品信息；
分页循环搜索，再批量调取详情入库。
五、开发注意事项
控制调用频率，避免超流被限流；
App Secret 禁止明文存前端，做好加密保管；
仅用于合规选品、自有店铺管理，禁止恶意爬虫采集；
时间戳与平台时差不能超过 5 分钟，否则签名失效。
六、适用场景
跨境铺货、电商比价工具、竞品价格监控、ERP 商品同步、淘客选品系统。
七、响应示例
"items": {
"page": "1",
"real_total_results": 20000,
"total_results": 20000,
"page_size": 20,
"pagecount": 1000,
"_ddf": "zzz",
"item": [
{
"title": "能用哥[53-517]专柜品牌正品新款女装时尚上衣打底T恤0.28KG",
"pic_url": "https://img.alicdn.com/imgextra/i2/2239126873/O1CN01n9m5Gx20dtJ51yrMh_!!2239126873.jpg",
"promotion_price": 135.57,
"orginal_price": 135.57,
"price": 135.57,
"num_iid": "1057600102542",
"detail_url": "https://item.taobao.com/item.htm?id=1057600102542"
},
{
"title": "2026新款夏季大码t恤女短袖大码女装显瘦中长款宽松韩版印花上衣",
"pic_url": "https://img.alicdn.com/imgextra/i2/4008314555/O1CN014237lw1jWEmSOdHvw_!!0-item_pic.jpg",
"promotion_price": 10.33,
"orginal_price": 10.33,
"price": 10.33,
"num_iid": "653756974542",
"detail_url": "https://item.taobao.com/item.htm?id=653756974542"
},
{
"title": "九分弯刀裤女2026夏季新款女裤爆款气球裤显瘦大码休闲裤子小个子",
"pic_url": "https://img.alicdn.com/imgextra/i2/1911245643/O1CN01FmRLxN1rYY8svCLb6~crop,0,113,750,750~_!!1911245643.jpg",
"promotion_price": 16.71,
"orginal_price": 16.71,
"price": 16.71,
"num_iid": "1054911949540",
"detail_url": "https://item.taobao.com/item.htm?id=1054911949540"
},
{
"title": "防晒衣女士短外套洋气2023年新款夏季防晒服减龄漂亮时尚女装薄款",
"pic_url": "https://img.alicdn.com/imgextra/i2/2215848228060/O1CN010KFZ0e29PXFBLpCQr_!!2215848228060.jpg",
"promotion_price": 29.02,
"orginal_price": 29.02,
"price": 29.02,
"num_iid": "791612741866",
"detail_url": "https://item.taobao.com/item.htm?id=791612741866"
},
{
"title": "苏苏优选！小禾！圆领涂鸦钩花钉珠小象印花短袖26585",
"pic_url": "https://img.alicdn.com/imgextra/i3/2222060602327/O1CN01bzKPNk1T3on29AG5w~crop,500,0,1279,1279~_!!2222060602327.jpg",
"promotion_price": 41.27,
"orginal_price": 41.27,
"price": 41.27,
"num_iid": "1057840880422",
"detail_url": "https://item.taobao.com/item.htm?id=1057840880422"
},
{
"title": "莎莎福利.Z929-1618-2标准尺码6.16跟高7",
"pic_url": "https://img.alicdn.com/imgextra/i3/2222218741810/O1CN01g6ECmf1PF21gwNFBa_!!2222218741810.jpg",
"promotion_price": 41.84,
"orginal_price": 41.84,
"price": 41.84,
"num_iid": "1059650281333",
"detail_url": "https://item.taobao.com/item.htm?id=1059650281333"
},
{
"title": "清仓捡漏~外贸夏季女士t恤短袖时尚穿搭洋气潮妈polo上衣气质减龄",
"pic_url": "https://img.alicdn.com/imgextra/i1/1049599078/O1CN01TWtfnp2GvmWfgKCiS_!!1049599078.jpg",
"promotion_price": 15.18,
"orginal_price": 15.18,
"price": 15.18,
"num_iid": "905909703729",
"detail_url": "https://item.taobao.com/item.htm?id=905909703729"
},
{
"title": "清仓捡漏~爆款高档大码韩版衣服宽松短袖条纹中长款修身连衣裙女",
"pic_url": "https://img.alicdn.com/imgextra/i1/2240378902/O1CN01jNSTwR2FdAoVYNurl_!!2240378902.jpg",
"promotion_price": 23.27,
"orginal_price": 23.27,
"price": 23.27,
"num_iid": "892544654833",
"detail_url": "https://item.taobao.com/item.htm?id=892544654833"
},
{
"title": "清仓捡漏~外贸夏季女士t恤短袖时尚穿搭洋气潮妈polo上衣气质减龄",
"pic_url": "https://img.alicdn.com/imgextra/i3/1049599078/O1CN01QX1Cnf2GvmWf23cBP_!!1049599078.jpg",
"promotion_price": 14.94,
"orginal_price": 14.94,
"price": 14.94,
"num_iid": "905910079084",
"detail_url": "https://item.taobao.com/item.htm?id=905910079084"
},
{
"title": "冰丝半身裙夏季薄款百搭大码2026新款高腰显瘦休闲大摆垂感中长裙",
"pic_url": "https://img.alicdn.com/imgextra/i2/1621971457/O1CN01hcLmvC1MdM2JWZL9R_!!1621971457.jpg",
"promotion_price": 22.89,
"orginal_price": 22.89,
"price": 22.89,
"num_iid": "810683440104",
"detail_url": "https://item.taobao.com/item.htm?id=810683440104"
},
{
"title": "【买1送1】冰丝裤女夏季新款垂感宽松九分束脚休闲裤防蚊凉凉花裤",
"pic_url": "https://img.alicdn.com/imgextra/i3/1911245643/O1CN01g1hBr91rYXxKX9TFW_!!1911245643.png",
"promotion_price": 13.37,
"orginal_price": 13.37,
"price": 13.37,
"num_iid": "796258620839",
"detail_url": "https://item.taobao.com/item.htm?id=796258620839"
},
{
"title": "清仓捡漏~夏季薄款女装妈妈吊带背心睡衣裙大码洋气休闲遮肚显瘦",
"pic_url": "https://img.alicdn.com/imgextra/i1/859028308/O1CN01iXHJ1F2BF7UYn00Nl_!!859028308.jpg",
"promotion_price": 11.17,
"orginal_price": 11.17,
"price": 11.17,
"num_iid": "821556771214",
"detail_url": "https://item.taobao.com/item.htm?id=821556771214"
},
{
"title": "速干潮流短裤女2026夏季新款甜美宽松多巴胺百搭休闲显瘦运动跑步",
"pic_url": "https://img.alicdn.com/imgextra/i1/3004712203/O1CN01YiTp2Y1S91fiaYTNS_!!3004712203.jpg",
"promotion_price": 19.6,
"orginal_price": 19.6,
"price": 19.6,
"num_iid": "1048388275502",
"detail_url": "https://item.taobao.com/item.htm?id=1048388275502"
},
{
"title": "大码女新中式冰丝雪纺阔腿裤2026夏装薄款宽松复古水墨国风直筒裤",
"pic_url": "https://img.alicdn.com/imgextra/i4/1661411306/O1CN01ZAN11q1LWC6zHGpeS_!!1661411306.jpg",
"promotion_price": 44.58,
"orginal_price": 44.58,
"price": 44.58,
"num_iid": "724033963851",
"detail_url": "https://item.taobao.com/item.htm?id=724033963851"
},
{
"title": "美式复古半高领卡通印花背心上衣女设计感修身甜辣妹气质无袖上衣",
"pic_url": "https://img.alicdn.com/imgextra/i2/2206427357525/O1CN01VXWJRr25SVTp5oXQB_!!4611686018427380053-0-item_pic.jpg",
"promotion_price": 10.23,
"orginal_price": 10.23,
"price": 10.23,
"num_iid": "967158547132",
"detail_url": "https://item.taobao.com/item.htm?id=967158547132"
},
{
"title": "清仓外贸~品牌折扣正品捡漏女装宽松短袖T恤女韩版印花纯棉上衣",
"pic_url": "https://img.alicdn.com/imgextra/i3/2644945582/O1CN01kZc3S41r6bmBnOYV5_!!2644945582.jpg",
"promotion_price": 17.13,
"orginal_price": 17.13,
"price": 17.13,
"num_iid": "774783614128",
"detail_url": "https://item.taobao.com/item.htm?id=774783614128"
},
{
"title": "慵懒风休闲短袖女宽松舒适韩系法式印花学院风减龄显瘦学生党上衣",
"pic_url": "https://img.alicdn.com/imgextra/i2/3410811042/O1CN01zDiqlk1JZHpuhtNS4_!!3410811042.jpg",
"promotion_price": 29.87,
"orginal_price": 29.87,
"price": 29.87,
"num_iid": "1046394309931",
"detail_url": "https://item.taobao.com/item.htm?id=1046394309931"
},
{
"title": "短袖t恤女夏季新款时尚百搭宽松显瘦大码女装遮肉遮肚上衣体恤衫",
"pic_url": "https://img.alicdn.com/imgextra/i4/2230760830/O1CN01J0jqIR1I0BhUDXC1o_!!2230760830.jpg",
"promotion_price": 12.15,
"orginal_price": 12.15,
"price": 12.15,
"num_iid": "806980016980",
"detail_url": "https://item.taobao.com/item.htm?id=806980016980"
},
{
"title": "2025百搭格子衬衫女春秋时尚复古宽松显瘦外套女装气质穿搭休闲",
"pic_url": "https://img.alicdn.com/imgextra/i4/2212891651715/O1CN01bz7amt1OXWHrRZHI7_!!2212891651715.jpg",
"promotion_price": 12.33,
"orginal_price": 12.33,
"price": 12.33,
"num_iid": "889271309818",
"detail_url": "https://item.taobao.com/item.htm?id=889271309818"
},
{
"title": "单/两件 大码女装宽松短袖T恤女夏季新款显瘦时尚印花中长款ins潮",
"pic_url": "https://img.alicdn.com/imgextra/i4/1967766253/O1CN01zpkETC1w3vY1YZVsX_!!1967766253.jpg",
"promotion_price": 26.57,
"orginal_price": 26.57,
"price": 26.57,
"num_iid": "787082386816",
"detail_url": "https://item.taobao.com/item.htm?id=787082386816"
}
],
"item_weight_update": 0
},
