PHP获取淘宝商品详情返回参数详解

发布于：2025-08-06 ⋅ 阅读:(12) ⋅ 点赞:(0)

通过PHP获取淘宝商品详情通常是通过淘宝开放平台(TOP)的API实现的，主要使用taobao.tbk.item.info.get(淘宝客商品详情)或taobao.item.get(普通商品详情)等接口。以下是返回参数的详细解析：

主要返回参数结构

1. 商品基本信息



php



 
  

   $response = [
  

  

   'item' => [
  

  

   'num_iid' => '123456789', // 商品数字ID
  

  

   'title' => '商品标题', // 商品标题
  

  

   'pict_url' => 'http://xxx.jpg', // 商品主图
  

  

   'small_images' => [ // 商品小图列表
  

  

   'string' => ['http://img1.jpg', 'http://img2.jpg']
  

  

   ],
  

  

   'reserve_price' => '100.00', // 商品原价
  

  

   'zk_final_price' => '80.00', // 商品折扣价
  

  

   'volume' => 1000, // 30天销量
  

  

   'provcity' => '浙江 杭州', // 商品所在地
  

  

   'item_url' => 'http://item.taobao.com/item.htm?id=123456789', // 商品链接
  

  

   ],
  

  

   // 其他信息...
  

  

   ];
  

 



2. 详细参数说明


商品ID相关


    
 
  • num_iid: 商品数字ID（重要参数，用于后续操作）
    • 
 
  • outer_id: 商家外部编码（可自定义）
    • 



价格相关


    
 
  • price: 商品价格（单位：元）
    • 
 
  • zk_final_price: 折扣价格（如果有促销）
    • 
 
  • coupon_price: 优惠券后的价格（如果有优惠券）
    • 



销售相关


    
 
  • volume: 30天内交易量
    • 
 
  • total_sales: 总销量
    • 
 
  • sold_quantity: 实时销量
    • 



描述信息


    
 
  • title: 商品标题
    • 
 
  • subtitle: 副标题
    • 
 
  • desc: 商品描述（可能需要额外权限）
    • 



图片信息


    
 
  • pict_url: 商品主图URL
    • 
 
  • small_images: 商品小图列表（数组）
    • 



店铺信息


    
 
  • nick: 卖家昵称
    • 
 
  • seller_id: 卖家ID
    • 
 
  • shop_title: 店铺名称
    • 
 
  • shop_url: 店铺链接
    • 



物流信息


    
 
  • item_weight: 商品重量（克）
    • 
 
  • item_size: 商品尺寸
    • 
 
  • freight_payer: 运费承担方式（0-买家承担，1-卖家承担）
    • 



PHP获取示例代码




php



 
  

   <?php
  

  

   // 使用淘宝开放平台SDK
  

  

   require_once 'TopSdk.php';
  

  

   
  

  

   $c = new TopClient;
  

  

   $c->appkey = '你的AppKey';
  

  

   $c->secretKey = '你的AppSecret';
  

  

   $c->format = 'json';
  

  

   
  

  

   $req = new TbkItemInfoGetRequest;
  

  

   $req->setNumIids("123456789"); // 商品ID，多个用逗号分隔
  

  

   $req->setPlatform("2"); // 链接形式：1：PC，2：无线
  

  

   
  

  

   $resp = $c->execute($req);
  

  

   
  

  

   // 解析返回数据
  

  

   if(isset($resp->results->n_tbk_item)) {
  

  

   foreach($resp->results->n_tbk_item as $item) {
  

  

   echo "商品ID: " . $item->num_iid . "\n";
  

  

   echo "标题: " . $item->title . "\n";
  

  

   echo "价格: " . $item->zk_final_price . "\n";
  

  

   echo "主图: " . $item->pict_url . "\n";
  

  

   // 其他字段...
  

  

   }
  

  

   } else {
  

  

   echo "获取商品信息失败";
  

  

   }
  

  

   ?>
  

 



注意事项


    
 
  1. 权限申请：使用淘宝API需要先在开放平台申请相应权限
    2. 
 
  2. API调用限制：有调用频率限制，需遵守淘宝API规则
    3. 
 
  3. 数据格式：返回数据可能是JSON或XML，需根据设置解析
    4. 
 
  4. 错误处理：务必检查返回结果中的错误信息
    5. 
 
  5. 签名验证：所有请求都需要签名验证
    6. 



常见问题


    
 
  1. 图片无法显示：检查图片URL是否完整，有时需要拼接域名
    2. 
 
  2. 价格不准确：注意区分原价、折扣价和优惠券后价格
    3. 
 
  3. 销量数据延迟：淘宝销量数据可能有15-30分钟延迟
    4. 
 
  4. 下架商品：查询已下架商品可能返回空或错误
    5. 



如需更详细的参数说明，建议参考淘宝开放平台官方文档：淘宝开放平台

                        
                        

                        

                            
                            
                        

                        
                        

                            

                            
                        

                            

                                
                            

                        

                    


                



            


            

                
                

    

        

            网站公告
        

    

    

        
        
    



                

    

        

            今日签到
        

    

    

        
点亮在社区的每一天

        
        去签到
    



                

    

        

            热门文章
        

    

    

        
        

        

    

    
    
    


    



                

    

        

            最新发布