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

通过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. API调用限制：有调用频率限制，需遵守淘宝API规则
3. 数据格式：返回数据可能是JSON或XML，需根据设置解析
4. 错误处理：务必检查返回结果中的错误信息
5. 签名验证：所有请求都需要签名验证

常见问题

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

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