ITPub博客

首页 > 大数据 > 数据分析 > 获得淘宝商品详情item_getAPI接口返回参数讲解

获得淘宝商品详情item_getAPI接口返回参数讲解

原创 数据分析 作者:OneLafite 时间:2025-12-11 16:29:06 31 删除 编辑

淘宝商品详情 item_get API接口的返回参数涵盖商品基础信息、价格、库存、属性、图片、促销信息等多个维度,以下结合官方文档及实战案例整理核心参数详解:

基础信息类

  • num_iid:商品唯一ID(如 520813250866),用于精准定位商品。
  • title:商品标题(如“三刃木过安检创意迷你钥匙扣”)。
  • nick:卖家昵称(如“欢乐购客栈”)。
  • detail_url:商品详情页URL(如 http://item.taobao.com/item.htm?id=520813250866)。
  • pic_url:商品主图URL(如 //img.alicdn.com/imgextra/i4/2596264565/TB2p30elFXXXXXQXpXXXXXXXXXX_!!2596264565.jpg),支持多图列表( pics字段)。

价格与库存类

  • price:当前销售价(如 25.8),可能为基准价,需结合促销价字段使用。
  • orginal_price:原价(如 25.80),用于对比显示折扣。
  • total_price:总价(如含运费等附加费用)。
  • num:库存数量(如 832)。
  • stock:实时库存状态,部分接口返回具体库存数值。

属性与规格类

  • props:商品属性列表(如 {"颜色": ["红色", "蓝色"]}),包含颜色、尺码、材质等维度。
  • sku_properties_name/value:SKU属性名称及对应值(如“颜色:红色,尺码:L”)。
  • skus:SKU详细信息数组,包含价格、库存、属性组合(如 {"price": "90.00", "quantity": 100, "properties": "0:3;1:0"})。
  • prop_imgs:属性对应图片(如不同颜色的实物图)。

描述与详情类

  • desc:商品描述(HTML格式,含图片、文字详情),可能包含广告脚本或内链,需清洗处理。
  • item_imgs:商品详情图列表(如多角度展示图)。
  • desc_img:描述中的图片URL集合。

促销与推广类

  • promotion_price:促销价(如 80.00),需设置 is_promotion=1获取。
  • coupon_amount:优惠券金额(如 50.00),结合推广链接使用。
  • commission_rate:淘宝客佣金比例(如 30.00%),用于分佣计算。

分类与品牌类

  • rootCatId:分类ID(如 50013886)。
  • cid:子分类ID(如 50014822)。
  • brand:品牌名称(如“三刃木”)。
  • brandId:品牌ID(如 4036703)。

销量与评价类

  • sold_quantity:已售数量(如 5万+),部分接口返回具体数值。
  • favcount:收藏数(如 4824)。
  • fanscount:粉丝数(如 1469)。

其他关键参数

  • location:商品所在地(如“浙江杭州”)。
  • post_fee:运费(如 10.00),需结合地区ID获取。
  • video_id:商品视频ID(如有)。
  • is_promotion:是否启用促销( 1为是, 0为否)。

调用注意事项:

  • 需通过淘宝开放平台申请App Key/App Secret,完成身份认证及权限开通。
  • 请求参数需包含 num_iid(商品ID)、 fields(指定返回字段)、 sign(签名验证)等。
  • 返回数据为JSON格式,需解析嵌套结构(如 tbk_item_get_response → item)。
  • 遵守API调用频率限制,避免高频请求被封禁。
  • 关注接口更新日志,适配字段变更(如新增 coupon_click_url推广链接)。

实战示例:
通过Python调用 taobao.item.get接口,构造请求参数并生成MD5签名,解析返回的商品标题、价格、SKU列表等核心字段,实现商品详情展示或数据分析。

建议参考淘宝开放平台官方文档及最新接口规范,确保代码兼容性与数据准确性。


来自 “ ITPUB博客 ” ,链接:https://blog.itpub.net/70046834/viewspace-3104981/ ,如需转载,请注明出处,否则将追究法律责任。

请登录后发表评论 登录
全部评论
专业研发电商平台API开放接口,搭建独立站系统,反向海淘代购系统十年+,https://o0b.cn/lafite。

注册时间:2025-06-20

  • 博文量
    231
  • 访问量
    258377