taobao.item.get(淘宝天猫商品详情 TOP API)全业务场景手册

简介: 淘宝TOP核心接口taobao.item.get,通过商品ID(num_iid)获取结构化全量数据,支持铺货、ERP、竞品监控、跨境供应链等八大场景。HTTPS协议,返回JSON/XML,限流QPS=2,需按需传fields字段并规范签名。

一、接口简介
1.接口全称:taobao.item.get
协议:HTTPS GET/POST,返回 JSON/XML
定位:淘宝开放平台 TOP 核心单品查询接口,根据商品 num_iid(商品 ID)获取淘宝 / 天猫商品结构化全量数据,是铺货、ERP、竞品监控、导购、跨境供应链底层依赖接口
限流基准:基础应用 QPS=2,企业级可提额;单次仅支持 1 个商品 ID 批量查用taobao.item.batchget

  1. 业务核心入参
    num_iid:商品唯一数字 ID(URL id=xxxx 取值),单请求仅支持 1 个
    fields:核心控制字段,按需传入,过度请求会限流 / 无权限
    场景化 fields 组合(直接复制使用)
    轻量比价 / 卡片展示
    num_iid,title,price,pic_url,item_imgs,approve_status
    无货源跨平台铺货(最全)
    num_iid,title,price,desc,item_imgs,sku,skus,props_name,cid,category,stock_num,outer_id,delist_time,item_weight,item_size
    ERP 库存价格监控
    num_iid,price,sku,skus,stock_num,approve_status,modified
    竞品数据分析
    num_iid,title,price,sold,volume,shop_id,shop_name,cid,props_name,desc
    仅商品图文详情
    num_iid,desc,item_imgs,pic_url
  2. 签名生成标准流程
    剔除sign参数,剩余参数按 key ASCII 升序排序
    拼接 app_secret + k1v1k2v2... + app_secret
    MD5 UTF-8 加密,转大写字符串作为 sign
    Python 标准签名函数见文末代码示例

二、八大全业务场景(落地逻辑 + 字段需求 + 开发方案)
场景 1:无货源跨平台铺货(最高频场景:淘宝→拼多多 / 抖音 / 1688/Ozon/Temu)
业务需求
批量采集淘宝商品,自动清洗图片、标题、SKU、规格,一键上架多电商平台,搭建铺货 ERP
依赖 fields
num_iid,title,price,item_imgs,desc,skus,props_name,cid,stock_num,item_weight
完整落地流程
批量商品 ID 队列,循环调用 item.get 获取全素材
数据清洗规则:
标题:过滤 “天猫 / 旗舰店 / 限时特惠” 等平台专属词,适配目标平台标题长度限制
图片:阿里 cdn 链接转存自有图床,避免盗图拦截
SKU 规格:拆分properties为颜色 / 尺码二维数组,匹配目标平台规格模板
价格:设置加价倍率,区分划线价、售价、活动价
调用目标平台上架 API 批量提交商品
定时轮询 item.get 监控源商品价格 / 库存变动,同步更新下游店铺
痛点与优化
限流 QPS=2:添加 Redis 缓存,单商品缓存 30 分钟,减少重复调用
详情 HTML 含悬浮窗、天猫活动标签:正则过滤无用 DOM 标签
场景 2:ERP / 自有店铺商品管理系统
业务需求
自有天猫 / 淘宝店铺内部商品库管理、库存预警、价格统一管控、上下架状态同步
依赖 fields
num_iid,title,price,skus,stock_num,approve_status,modified,delist_time
落地逻辑
全店商品定时全量拉取,存入数据库建立商品主表 + SKU 子表
增量同步:对比modified字段,仅更新变更商品
库存预警:单 SKU quantity 低于阈值推送企业微信 / 钉钉告警
价格监控:检测原价 / 活动价变动,记录价格日志,防止错价亏损
下架商品自动标记,前台商城隐藏商品入口
场景 3:淘客返利 / 导购小程序 / 比价网站
业务需求
商品卡片展示、实时券后价、同款比价、降价提醒、好物推荐
依赖 fields
num_iid,title,price,pic_url,item_imgs,shop_name,sold,volume
佣金、优惠券需搭配tbk.item.info.get淘客接口组合使用
业务流程
用户输入商品 ID / 粘贴链接,调用 item.get 渲染商品详情卡片
多商品批量拉取,做同款价格排序比价
定时轮询价格,价格下跌触发公众号 / 短信降价提醒
提取销量sold做爆款排序推荐
场景 4:竞品监控 & 行业市场数据分析
业务需求
同行竞品价格、销量、库存、规格变动监测,行业价格带分析、爆款挖掘
依赖 fields
num_iid,title,price,sold,volume,shop_id,cid,props_name,skus
落地方案
竞品清单入库,每 10 分钟轮询 item.get
指标采集:售价、SKU 阶梯价、月销量、总库存、规格增减
数据入库做时序图表:价格波动曲线、销量趋势
预警规则:竞品大幅降价、新增规格、库存清仓触发运营提醒
类目批量采集,统计类目主流定价区间,辅助选品定价
场景 5:跨境电商供应链 / 一件代发系统
业务需求
跨境 Temu/Ozon/Shopee 货源采集、国内代发货源库搭建、重量尺寸获取用于物流报价
依赖 fields
num_iid,title,price,item_imgs,desc,skus,item_weight,item_size,stock_num
核心业务逻辑
采集淘宝货源商品,翻译标题 / 详情为英文、俄文等多语言
通过item_weight计算国际物流运费,自动生成跨境售价
SKU 库存实时同步,避免跨境超卖
详情图批量本地化,适配跨境平台图片尺寸规范
场景 6:电商内容工具 / 自媒体好物库
业务需求
短视频 / 图文带货素材自动生成、商品文案批量产出、素材库搭建
依赖 fields
num_iid,title,pic_url,item_imgs,desc,props_name
使用方式
拉取商品主图、详情图自动打包素材包
解析商品参数props_name自动生成种草文案、短视频标题
搭建商品素材库,支持按类目、价格筛选带货商品
场景 7:商品质检 / 违规风控工具
业务需求
监控商品违规下架、库存清零、价格异常,批量排查店铺违规商品
依赖 fields
num_iid,approve_status,delist_time,stock_num,price
流程
批量拉取店铺全部商品状态
识别forbidden封禁商品、instock下架商品,记录下架时间
检测价格异常(0 元、超低价)标记风险商品,人工复核
场景 8:以图搜款配套数据源(CV 识图系统)
业务需求
识图返回商品 ID 后,调用 item.get 补齐完整商品信息,用于同款推荐
依赖 fields
num_iid,title,price,pic_url,item_imgs,skus
联动逻辑
图片检索返回 num_iid 列表
批量调用 item.get 获取商品基础信息,渲染同款商品列表

相关文章
|
4天前
|
缓存 人工智能 安全
GPT-5.6 Terra与GPT-5.5性能实测:成本减半后的跑分对比与快速迁移指南
GPT-5.6 Terra 的定价为每百万 token 输入 2.50/输出 15。GPT-5.5 则是 5/ 30。Terra 的每一项费率,包括 $0.25/M 的缓存读取,都恰好是 GPT-5.5 的一半,因此在任何工作负载组合下,Terra 都固定 便宜 2.0x。以每天 10 万次请求、3K token 提示词计算,大约是 Terra 每天 2,000,GPT−5.5每天 4,000,即每月约 60,000对 120,000。问题在于:OpenAI 没有发布任何针对 Terra 的编码基准。那个著名的 91.9% Terminal-Bench 数字是 Sol 在 Ul
|
3天前
|
SQL 人工智能 自然语言处理
大模型内容安全实时防护:恶意Prompt注入拦截、越权阻断与熔断机制方案.166
本文系统阐述大模型输入安全防护体系,涵盖提示词注入、恶意Prompt拦截、越权阻断与输入熔断四大核心风险及应对方案。提出四层防护架构(预处理、检测、鉴权、熔断),结合规则引擎、语义识别与RBAC权限控制,实现全链路实时防护,保障业务合规、数据安全与服务稳定。
228 1
|
27天前
|
Linux 程序员 数据格式
【2026最新】Notepad++下载、安装和使用一篇搞定(附中文版安装包)
Notepad++ 是一款免费开源、轻量高效的 Windows 文本编辑器,支持 C/Python/HTML 等 80+ 语言语法高亮、代码折叠、正则替换、编码转换及插件扩展,专为程序员与文本处理用户打造,完美替代系统记事本。(239字)
|
11天前
|
人工智能 编解码 物联网
2026 最新Stable Diffusion 本地部署教程 下载安装使用详细图解(含官网安装包)
Stable Diffusion(SD)是2022年发布的开源文生图模型,由Stability AI等联合开发。支持文生图、图生图、局部重绘等,依托VAE降低算力需求,可在消费级显卡运行。本文提供秋葉aaaki制作的Windows整合包(含图形界面与插件),开箱即用,零配置启动。
|
12天前
|
人工智能 缓存 安全
Claude Code 封号真实原因曝光,这次彻底不装了,直接针对国内开发者的账号下手?
Claude Code 封号潮背后:逆向扒出客户端隐写区域标记,Anthropic 政策收紧叠加 DeepSeek 7 月涨价,国产替代更紧迫。
|
21天前
|
存储 人工智能 监控
QoderWork完全指南:从入门到精通,把“AI实习生”变成你的全能工作搭档
阿里云2026年推出的桌面端AI工作助手QoderWork,不止聊天,更可动手干活:本地运行、安全可控,支持文件整理、数据分析、PPT生成、网页开发等;内置专家套件、多Agent协作与自定义Skills,让AI真正成为你身边的“AI实习生”。
|
18天前
|
人工智能 JSON 自然语言处理
让教学更智慧:用阿里云百炼工作流,自动生成中小学教材内容#小有可为#有温度的AI
通过可视化工作流编排,将大模型推理能力转化为标准化的教学内容生成引擎。教师只需输入教材标题和适用学段,即可自动获得结构完整、符合课程标准的章节内容,大幅降低备课门槛,助力教育资源均衡化。
514 127
|
4天前
|
人工智能 缓存 JSON
刚刚 GPT-5.6 发布,吊打 Claude 5 和 Grok 4.5?一手实测来啦!
GPT-5.6 刚发布,跑分号称超越 Fable 5,真的假的?附一手实测,让 3 个最强 AI 编程模型 GPT-5.6 Sol、Claude Fable 5、Grok 4.5 在 Cursor 里同时一把梭开发网页游戏,看看最新模型到底谁更能打。
276 0