淘宝宝贝详情数据一键获取,item_getAPI接口讲解

12 阅读1分钟

taobao.item.get 是淘宝开放平台获取单个宝贝完整详情的核心 API,通过商品 ID(num_iid)一键拉取结构化数据,是反向海淘、代购、比价、ERP 同步的基础能力。


一、接口定位与核心能力

1. 接口基本信息

  • 接口名taobao.item.get(基础版)
  • 完整版taobao.item_get_full(含详情 HTML、运费、售后)
  • 请求方式:POST/GET(推荐 POST)
  • 返回格式:JSON(默认)/ XML
  • 版本2.0

2. 核心数据能力(一键获取)

  • 基础信息num_iid、标题、主图、价格、原价、销量、类目、店铺信息
  • 规格 SKU:多规格价格、库存、属性、SKU 图
  • 商品属性:材质、品牌、尺寸、颜色等结构化属性
  • 营销信息:促销价、优惠券、包邮、活动标签
  • 详情内容:商品描述(HTML / 文本)、售后服务

3. 适用场景

  • 反向海淘 / 代购系统:商品采集、详情展示、价格监控
  • 电商 ERP:商品信息同步、库存管理
  • 比价 / 选品工具:竞品分析、价格预警
  • 自建商城:一键上架淘宝商品

二、调用前置条件(必做)

1. 账号与应用

  • 完成个人 / 企业认证(企业认证支持完整 SKU / 库存字段)
  • 创建服务型应用,获取 AppKey + AppSecret(核心凭证)

2. 权限申请

  • 在开放平台申请 taobao.item.get 权限
  • 免费版:基础字段、每日限额(个人约 1000 次 / 天)
  • 企业版:完整字段、更高调用量(需提交业务场景审核)

3. 关键限制(2026 最新)

  • 个人账号:≤10 次 / 分钟,QPS≤2,无 SKU / 库存权限
  • 企业账号:≤100 次 / 分钟,QPS≤50,支持完整字段
  • 触发限流返回 code=10014,需指数退避重试(1s→2s→4s)