️ 淘宝商品详情APItaobao.item.getPython/Java调用实战与字段解析淘宝开放平台的taobao.item.get是做商品同步、比价、铺货系统的核心接口用来根据num_iid淘宝/天猫商品ID获取标题、价格、SKU、库存、主图、详情HTML等结构化数据。一、接口关键信息项目说明API名​taobao.item.get网关​生产https://gw.api.taobao.com/router/rest沙箱https://gw.api.tbsandbox.com/router/rest必传参数​num_iid商品数字ID、fields指定返回字段可选​session某些敏感字段需卖家授权基础展示可不传权限​需在开放平台应用勾选「商品详情查询(taobao.item.get)」⚠️淘宝商品IDnum_iid可从商品URL中提取https://item.taobao.com/item.htm?id654321098765→num_iid654321098765二、Python完整调用封装复用TOP签名Client# top_item_get.py 淘宝商品详情 taobao.item.get 调用示例 依赖: top_api_client.py (TaobaoTopClient from 上文) from top_api_client import TaobaoTopClient # 封装好API供应商demo urlhttps://console.open.onebound.cn/console/?iLex def get_tb_item_detail(num_iid: str, fields: str None, app_keyNone, app_secretNone, sessionNone, sandboxTrue): 获取淘宝/天猫商品详情 Args: num_iid: 商品ID (num_iid) fields: 返回字段逗号分隔 推荐: num_iid,title,price,org_price,pic_url,item_imgs,skus, props_name,desc,approve_status,num,outer_id session: 卖家授权token取SKU库存等需传 sandbox: True沙箱 False生产 Returns: item 字典 client TaobaoTopClient( app_keyapp_key, app_secretapp_secret, sandboxsandbox ) fields fields or ( num_iid,title,price,org_price,pic_url,item_imgs, skus,props_name,desc,approve_status,num,outer_id, seller_nick,cid,input_str ) result client.call( taobao.item.get, biz_params{num_iid: num_iid, fields: fields}, sessionsession ) return result.get(item, result) # 使用示例 if __name__ __main__: ITEM_ID 654321098765 # ← 替换真实商品ID自己的店铺商品或公开商品 try: item get_tb_item_detail( num_iidITEM_ID, app_keyYOUR_TOP_APP_KEY, app_secretYOUR_TOP_APP_SECRET, sandboxTrue # 生产切 False公开商品沙箱返回mock # sessionSELLER_SESSION # 查自己店铺商品SKU库存需传 ) print(✅ 商品标题:, item.get(title)) print( 一口价:, item.get(price)) print( 主图:, item.get(pic_url)) print( 库存:, item.get(num)) print( SKU数:, len(item.get(skus) or [])) # 解析SKU for sku in (item.get(skus) or [])[:3]: print(f SKU {sku.get(properties_name)} → 价:{sku.get(price)} 库:{sku.get(quantity)}) if not item.get(skus): print( ℹ️ skus为空 → 若是自己店铺商品需传 seller session 再查) except Exception as e: print(❌, e)三、核心返回字段解析B2B/B2C铺货重点TOP返回字段类型含义铺货用途num_iidlong商品唯一ID外部单号关联titlestring商品标题含营销词截取适配目标平台长度pricestring一口价元零售价比价基准org_pricestring原价划线价促销展示pic_urlstring主图URL首图item_imgs[].urllist所有商品图片副图/详情图skus[].pricestringSKU价格多规格定价skus[].quantityintSKU库存需seller session采购/超卖判断skus[].properties_namestringSKU规格描述颜色:红;尺码:MSKU映射skus[].outer_idstring商家编码内部SKU匹配props_namestring关键属性品牌/材质等补充信息descstring详情HTML可能截断详情页approve_statusstringonsale/instock/deleted过滤下架cidlong后台类目ID类目映射SKU 典型结构{ sku_id: 1234567890, properties: 1627207:28335;20509:28381, properties_name: 颜色:红色;尺码:M, price: 199.00, quantity: 50, outer_id: SKU-RED-M }四、Java调用核心片段TOP Java SDK// TaobaoClient JsonParser 由 top-sdk-java 提供 TaobaoClient client new DefaultTaobaoClient( https://gw.api.taobao.com/router/rest, APP_KEY, APP_SECRET ); ItemGetRequest req new ItemGetRequest(); req.setNumIid(654321098765L); req.setFields(num_iid,title,price,pic_url,skus,desc,num); ItemGetResponse rsp client.execute(req); // session传null查公开字段 Item item rsp.getItem(); System.out.println(item.getTitle()); System.out.println(item.getPrice());五、高频避坑问题原因解决skus返回空公开查询不返回库存SKU用卖家账号OAuth授权得 session 再查desc为空/截断部分类目详情在独立接口taobao.item.desc.get补调 desc 接口第三方商品403未申请权限或AppKey无权限控制台申请taobao.item.get天猫商品拿不到num_iid正确但仍无数据确认商品未删除 应用有权限天猫多需额外审核价格字段类型price是字符串不是数字Decimal(price)转再运算六、面试/方案一句话taobao.item.get按num_iidfields获取商品结构化数据公开字段标题/价格/主图可不传sessionSKU库存和商家编码需卖家AccessToken返回SKU用properties_name做规格映射图片需转存目标平台图床再上架。需要我补taoboba.item.desc.get详情HTML获取 图片本地化转存脚本​ 或淘宝→1688/抖音/Shopify铺货字段映射模板​ 吗