请求地址: https://api-gw.onebound.cn/taobao/item_get
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
key | String | 是 | 调用key(必须以GET方式拼接在URL中) |
secret | String | 是 | 调用密钥 |
api_name | String | 是 | API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等] |
cache | String | 否 | [yes,no]默认yes,将调用缓存的数据,速度比较快 |
result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读 |
lang | String | 否 | [cn,en,ru]翻译语言,默认cn简体中文 |
version | String | 否 | API版本 |
请求参数
请求参数:num_iid=520813250866&is_promotion=1
参数说明:num_iid:淘宝商品ID
is_promotion:是否获取取促销价
API测试工具 点击申请试用
响应参数
Version: Date:2022-04-04
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
item | item[] | 1 | 宝贝详情数据 | |
num_iid | Bigint | 1 | 520813250866 | 宝贝ID |
title | String | 1 | 三刃木折叠刀过安检创意迷你钥匙扣钥匙刀军刀随身多功能小刀包邮 | 宝贝标题 |
desc_short | String | 0 | 商品简介 | |
promotion_price | Int | 0 | 优惠价 | |
price | Float | 1 | 25.8 | 价格 |
total_price | Float | 0 | 0 | |
suggestive_price | Float | 0 | 0 | |
orginal_price | String | 0 | 25.80 | 原价 |
nick | String | 0 | 欢乐购客栈 | 掌柜昵称 |
num | Int | 0 | 3836 | 库存 |
min_num | Int | 0 | 0 | 最小购买数 |
detail_url | String | 0 | http://item.taobao.com/item.htm?id=520813250866 | 宝贝链接 |
pic_url | String | 1 | //gd2.alicdn.com/imgextra/i4/2596264565/TB2p30elFXXXXXQXpXXXXXXXXXX_!!2596264565.jpg | 宝贝图片 |
brand | String | 0 | 三刃木 | 品牌名称 |
brandId | Int | 0 | 8879363 | 品牌ID |
rootCatId | Int | 0 | 50013886 | 顶级分类ID |
cid | Int | 1 | 50014822 | |
crumbs | Mix | 0 | [] | 导航菜单 |
created_time | String | 0 | ||
modified_time | String | 0 | ||
delist_time | String | 0 | ||
desc | String | 0 | 商品详情 | |
desc_img | Mix | 0 | [] | 商品详情图片 |
item_imgs | Mix | 0 | item_imgs[] | 商品图片 |
item_weight | String | 0 | ||
item_size | String | 0 | ||
location | String | 0 | 发货地 | |
express_fee | Float | 0 | 0.00 | 快递费用 |
ems_fee | Float | 0 | EMS费用 | |
post_fee | Float | 0 | 物流费用 | |
shipping_to | String | 0 | 发货至 | |
has_discount | Boolean | 0 | false | 是否有优惠 |
video | video[] | 0 | 商品视频 | |
is_virtual | String | 0 | ||
sample_id | String | 0 | 商品风格标识ID | |
is_promotion | Boolean | 0 | false | 是否促销 |
props_name | String | 0 | 1627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子;1627207:1347647753:颜色分类:椭圆形带开瓶器+送工具刀卡+链子; | 商品属性名。格式为pid1:vid1:name1:value1;pid1:vid2:name2:value2。 |
prop_imgs | prop_imgs[] | 0 | 商品属性图片列表 | |
property_alias | String | 0 | 20509:9974422:36;1627207:28326:红色;20509:9975710:38;1627207:28326:红色;20509:9981357:40;1627207:28326:红色 | 销售属性值别名。格式为pid1:vid1:alias1;pid1:vid2:alia2。 |
props | Mix | 0 | [{ "name": "产地","value": "中国" }] | 商品属性 |
total_sold | Int | 0 | ||
skus | skus[] | 0 | 商品规格信息列表 | |
seller_id | Int | 0 | 2844096782 | 卖家ID |
sales | Int | 0 | 138 | 销量 |
shop_id | Int | 0 | 151372205 | 店铺ID |
props_list | Mix | 0 | {20509:9974422: 尺码:36} | 商品属性 |
seller_info | seller_info[] | 1 | 卖家信息 | |
tmall | Boolean | 0 | false | 是否天猫 |
error | String | 0 | 错误信息 | |
warning | String | 0 | 警告信息 | |
url_log | Mix | 0 | [] | |
favcount | Int | 0 | 0 | |
fanscount | Int | 0 | 0 | |
method | String | 0 | item_tmall:pget_item | |
promo_type | String | 0 | ||
props_img | Mix | 0 | 1627207:28326": "//img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE_!!2844096782.jpg | 属性图片 |
shop_item | Mix | 0 | [] | |
relate_items | Mix | 0 | [] |
请求示例
<?php
// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输,若要加密请参考:https://open.onebound.cn/help/demo/sdk/demo-sign.php
$method = "GET";
$url = "https://api-gw.onebound.cn/taobao/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=520813250866&is_promotion=1";
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
var_dump(curl_exec($curl));
?>
API返回结果
---------------------------------------
{
"item": {
"num_iid": "642095769499",
"title": "IFIK denim Bra 2色 小巧却不玲珑的内搭牛仔系带挂脖文胸内衣",
"desc_short": "",
"price": "89.10",
"total_price": 0,
"suggestive_price": 0,
"orginal_price": "99.00",
"nick": "ifiker",
"num": "75",
"min_num": 0,
"detail_url": "https://item.taobao.com/item.htm?id=642095769499",
"pic_url": "//img.alicdn.com/imgextra/i1/2209411885160/O1CN01zUnrpF1nzKRCdzZZn_!!2209411885160.jpg",
"brand": "iFIK",
"brandId": "1584893553",
"rootCatId": "16",
"cid": "121412004",
"crumbs": [],
"created_time": "",
"modified_time": "",
"delist_time": "",
"desc": "<p><img align=\"absmiddle\" src=\"http://img.alicdn.com/imgextra/i2/2209411885160/O1CN01fyp6GY1nzKNAOeTuc_!!2209411885160.jpg\" /><img align=\"absmiddle\" src=\"http://img.alicdn.com/imgextra/i4/2209411885160/O1CN013SI3WG1nzKNBuKULc_!!2209411885160.jpg\" /><img align=\"absmiddle\" src=\"http://img.alicdn.com/imgextra/i3/2209411885160/O1CN01LYtT4P1nzKNCTBPkx_!!2209411885160.jpg\" /><img align=\"absmiddle\" src=\"http://img.alicdn.com/imgextra/i4/2209411885160/O1CN01mmz5W51nzKN6kQ50j_!!2209411885160.jpg\" /><img align=\"absmiddle\" src=\"http://img.alicdn.com/imgextra/i2/2209411885160/O1CN01VumO731nzKNAOZicU_!!2209411885160.jpg\" /><img align=\"absmiddle\" src=\"http://img.alicdn.com/imgextra/i2/2209411885160/O1CN010Yxqrg1nzKN5zlJuR_!!2209411885160.jpg\" /><img align=\"absmiddle\" src=\"http://img.alicdn.com/imgextra/i3/2209411885160/O1CN01dNhLuq1nzKN6kTERf_!!2209411885160.jpg\" /><img align=\"absmiddle\" src=\"http://img.alicdn.com/imgextra/i3/2209411885160/O1CN01JkHOnD1nzKNGTvAFq_!!2209411885160.jpg\" /></p><img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-1.634fb6521f76f&p=1973600427&k=i_key&t=1666168403\" style=\"display:none\" />",
"desc_img": [
"http://img.alicdn.com/imgextra/i2/2209411885160/O1CN01fyp6GY1nzKNAOeTuc_!!2209411885160.jpg",
"http://img.alicdn.com/imgextra/i4/2209411885160/O1CN013SI3WG1nzKNBuKULc_!!2209411885160.jpg",
"http://img.alicdn.com/imgextra/i3/2209411885160/O1CN01LYtT4P1nzKNCTBPkx_!!2209411885160.jpg",
"http://img.alicdn.com/imgextra/i4/2209411885160/O1CN01mmz5W51nzKN6kQ50j_!!2209411885160.jpg",
"http://img.alicdn.com/imgextra/i2/2209411885160/O1CN01VumO731nzKNAOZicU_!!2209411885160.jpg",
"http://img.alicdn.com/imgextra/i2/2209411885160/O1CN010Yxqrg1nzKN5zlJuR_!!2209411885160.jpg",
"http://img.alicdn.com/imgextra/i3/2209411885160/O1CN01dNhLuq1nzKN6kTERf_!!2209411885160.jpg",
"http://img.alicdn.com/imgextra/i3/2209411885160/O1CN01JkHOnD1nzKNGTvAFq_!!2209411885160.jpg"
],
"item_imgs": [
{
"url": "//img.alicdn.com/imgextra/i1/2209411885160/O1CN01zUnrpF1nzKRCdzZZn_!!2209411885160.jpg"
},
{
"url": "//img.alicdn.com/imgextra/i2/2209411885160/O1CN01iw48U41nzKRNkjFHe_!!2209411885160.jpg"
},
{
"url": "//img.alicdn.com/imgextra/i2/2209411885160/O1CN01Z9O2DY1nzKRBxLwvZ_!!2209411885160.jpg"
},
{
"url": "//img.alicdn.com/imgextra/i1/2209411885160/O1CN01e2LVCG1nzKN2J6bE0_!!2209411885160.jpg"
},
{
"url": "//img.alicdn.com/imgextra/i4/2209411885160/O1CN01K2empQ1nzKSXrGrCh_!!2209411885160.jpg"
}
],
"item_weight": "",
"item_size": "",
"location": "广东广州",
"post_fee": 0,
"express_fee": null,
"ems_fee": "",
"shipping_to": "",
"has_discount": "true",
"video": [],
"is_virtual": "",
"sample_id": "",
"is_promotion": "true",
"props_name": "20509:28383:尺码:均码;1627207:10522860:颜色分类:牛仔色;1627207:28320:颜色分类:白色",
"prop_imgs": {
"prop_img": [
{
"properties": "1627207:10522860",
"url": "//img.alicdn.com/imgextra/i1/2209411885160/O1CN01Alm2N81nzKNCpWryf_!!2209411885160.jpg"
},
{
"properties": "1627207:28320",
"url": "//img.alicdn.com/imgextra/i4/2209411885160/O1CN017ZSLvL1nzKRNkjeFf_!!2209411885160.jpg"
}
]
},
"property_alias": "",
"props": [
{
"name": "品牌",
"value": "iFIK"
},
{
"name": "适用年龄",
"value": "18-24周岁"
},
{
"name": "尺码",
"value": "均码"
},
{
"name": "图案",
"value": "其他/other"
},
{
"name": "风格",
"value": "其他"
},
{
"name": "流行元素",
"value": "系带"
},
{
"name": "颜色分类",
"value": "白色,牛仔色"
},
{
"name": "组合形式",
"value": "单件"
},
{
"name": "年份季节",
"value": "2021年夏季"
},
{
"name": "衣长",
"value": "常规"
},
{
"name": "服装版型",
"value": "修身型"
},
{
"name": "款式",
"value": "其他"
},
{
"name": "材质成分",
"value": "棉100%"
}
],
"total_sold": "252",
"skus": {
"sku": [
{
"price": "89.1",
"total_price": 0,
"orginal_price": "89.1",
"properties": "20509:28383;1627207:10522860",
"properties_name": "20509:28383:尺码:均码;1627207:10522860:颜色分类:牛仔色",
"quantity": "0",
"sku_id": "4615000332274"
},
{
"price": "89.1",
"total_price": 0,
"orginal_price": "89.1",
"properties": "20509:28383;1627207:28320",
"properties_name": "20509:28383:尺码:均码;1627207:28320:颜色分类:白色",
"quantity": "75",
"sku_id": "4815412564292"
}
]
},
"seller_id": "2209411885160",
"sales": 18,
"shop_id": "433655136",
"props_list": {
"20509:28383": "尺码:均码",
"1627207:10522860": "颜色分类:牛仔色",
"1627207:28320": "颜色分类:白色"
},
"seller_info": {
"nick": "ifiker",
"item_score": "4.8 ",
"score_p": "4.9 ",
"delivery_score": "4.9 ",
"shop_type": "C",
"user_num_id": "2209411885160",
"sid": "433655136",
"title": "IFIK",
"zhuy": "https://shop433655136.taobao.com/",
"shop_name": "IFIK"
},
"tmall": false,
"error": "",
"warning": "",
"url_log": [],
"fav_count": "3996",
"fans_count": "22.0万",
"freight": "快递: 快递包邮",
"props_imgs": {
"prop_img": [
{
"properties": "1627207:10522860",
"url": "//img.alicdn.com/imgextra/i1/2209411885160/O1CN01Alm2N81nzKNCpWryf_!!2209411885160.jpg"
},
{
"properties": "1627207:28320",
"url": "//img.alicdn.com/imgextra/i4/2209411885160/O1CN017ZSLvL1nzKRNkjeFf_!!2209411885160.jpg"
}
]
},
"_ddf": "xdl",
"promo_type": null,
"props_img": {
"1627207:10522860": "//img.alicdn.com/imgextra/i1/2209411885160/O1CN01Alm2N81nzKNCpWryf_!!2209411885160.jpg",
"1627207:28320": "//img.alicdn.com/imgextra/i4/2209411885160/O1CN017ZSLvL1nzKRNkjeFf_!!2209411885160.jpg"
},
"format_check": "ok",
"shop_item": [],
"relate_items": []
},
"error": "",
"secache": "c4943eedecdd883f6d03630692384b29",
"secache_time": 1666168403,
"secache_date": "2022-10-19 16:33:23",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:92 max:10000 all[259=92+102+65];expires:2030-12-31",
"execution_time": "1.769",
"server_time": "Beijing/2022-10-19 16:33:23",
"client_ip": "117.162.192.171",
"call_args": {
"num_iid": "642095769499",
"is_promotion": "1"
},
"api_type": "taobao",
"translate_language": "zh-CN",
"translate_engine": "baidu",
"server_memory": "5.99MB",
"request_id": "gw-1.634fb6521f76f",
"last_id": "1294363899"
}