全部
淘宝客
在线测试
淘宝客-公用-淘宝客商品详情查询(简版)
接口地址： http://api.vv-tool.com/tool/taobaoke/tbkiteminfoget
接口介绍： 淘宝客商品详情查询（简版）点击查看详情
必须用户授权 : 需要用户的授权，才能拿到被授权的数据
请求方式： POST
返回格式： JSON
接口收费： 联系运营
频率限制： 10 次/秒
请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| num_iids | String | true | 123,456 | 商品 ID 串，用，分割，最大 40 个 |
| platform | Number | false | 1 | 链接形式：1：PC，2：无线，默认：１ |
| ip | String | false | 11.22.33.43 | ip 地址，影响邮费获取，如果不传或者传入不准确，邮费无法精准提供 |
| taobao_user_id | Int | true | 123 | 授权的用户 ID |
请求示例
{
"num_iids": "598129827832",
"taobao_user_id": 123
}
请求代码示例
cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/taobaoke/tbkiteminfoget' \
--header 'Authorization: Bearer XXXXXXXXXXXXXXXXXX' \
--header 'Content-Type: application/json' \
--header 'Cookie: __yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=23cb193174e4095b141ccd6f6007733f; _csrf=2cd19402adae1c3113d9f645faab88a25cbaa984b70d96822c180b7eb5a081e2a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22yN3ZzOyIK8RcBRyag4P7WS66SlTkGj-Q%22%3B%7D' \
--data-raw '{
"num_iids": "598129827832",
"taobao_user_id": 2208551696445
}'
PHP请求代码示例
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'http://api.vv-tool.com/tool/taobaoke/tbkiteminfoget',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"num_iids": "598129827832",
"taobao_user_id": 2208551696445
}',
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer XXXXXXXXXXXXXXXXXX',
'Content-Type: application/json',
'Cookie: __yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=23cb193174e4095b141ccd6f6007733f; _csrf=2cd19402adae1c3113d9f645faab88a25cbaa984b70d96822c180b7eb5a081e2a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22yN3ZzOyIK8RcBRyag4P7WS66SlTkGj-Q%22%3B%7D'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
JAVA请求代码示例
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n \"num_iids\": \"598129827832\",\r\n \"taobao_user_id\": 2208551696445\r\n}");
Request request = new Request.Builder()
.url("http://api.vv-tool.com/tool/taobaoke/tbkiteminfoget")
.method("POST", body)
.addHeader("Authorization", "Bearer XXXXXXXXXXXXXXXXXX")
.addHeader("Content-Type", "application/json")
.addHeader("Cookie", "__yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=23cb193174e4095b141ccd6f6007733f; _csrf=2cd19402adae1c3113d9f645faab88a25cbaa984b70d96822c180b7eb5a081e2a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22yN3ZzOyIK8RcBRyag4P7WS66SlTkGj-Q%22%3B%7D")
.build();
Response response = client.newCall(request).execute();
响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| results | NTbkItem [] | 淘宝客商品 | |
| cat_name | String | 女装 | 一级类目名称 |
| num_iid | Number | 123 | 商品 ID |
| title | String | 连衣裙 | 商品标题 |
| pict_url | String | http://gi4.md.alicdn.com/bao/uploaded/i4/xxx.jpg | 商品主图 |
| small_images | String[] | http://gi4.md.alicdn.com/bao/uploaded/i4/xxx.jpg | 商品小图列表 |
| reserve_price | String | 102.00 | 商品一口价格 |
| zk_final_price | String | 88.00 | 折扣价（元） 若属于预售商品，付定金时间内，折扣价 = 预售价 |
| user_type | Number | 1 | 卖家类型，0 表示集市，1 表示商城，3 表示特价版 |
| provcity | String | 杭州 | 商品所在地 |
| item_url | String | http://detail.m.tmall.com/item.htm?id=xxx | 商品链接 |
| seller_id | Number | 123 | 卖家 id |
| volume | Number | 1 | 30 天销量 |
| nick | String | xx 旗舰店 | 店铺名称 |
| cat_leaf_name | String | 情趣内衣 | 叶子类目名称 |
| is_prepay | Boolean | true | 是否加入消费者保障 |
| shop_dsr | Number | 23 | 店铺 dsr 评分 |
| ratesum | Number | 13 | 卖家等级 |
| i_rfd_rate | Boolean | true | 退款率是否低于行业均值 |
| h_good_rate | Boolean | true | 好评率是否高于行业均值 |
| h_pay_rate30 | Boolean | true | 成交转化是否高于行业均值 |
| free_shipment | Boolean | true | 是否包邮 |
| material_lib_type | String | 1 | 商品库类型，支持多库类型输出，以英文逗号分隔“,”分隔，1:营销商品主推库，如果值为空则不属于 1 这种商品类型 |
| presale_discount_fee_text | String | 付定金立减 20 元 | 预售商品-商品优惠信息 |
| presale_tail_end_time | Number | 1937297392332 | 预售商品-付定金结束时间（毫秒） |
| presale_tail_start_time | Number | 1937297392332 | 预售商品-付尾款开始时间（毫秒） |
| presale_end_time | Number | 1937297392332 | 预售商品-付定金结束时间（毫秒） |
| presale_start_time | Number | 1937297392332 | 预售商品-付定金开始时间（毫秒） |
| presale_deposit | String | 100 | 预售商品-定金（元） |
| ju_play_end_time | Number | 1937297392332 | 聚划算满减 -结束时间（毫秒） |
| ju_play_start_time | Number | 1937297392332 | 聚划算满减 -开始时间（毫秒） |
| play_info | String | 玩法 | 1 聚划算满减：满 N 件减 X 元，满 N 件 X 折，满 N 件 X 元） 2 天猫限时抢：前 N 分钟每件 X 元，前 N 分钟满 N 件每件 X 元，前 N 件每件 X 元） |
| tmall_play_activity_end_time | Number | 1937297392332 | 天猫限时抢可售 -结束时间（毫秒） |
| tmall_play_activity_start_time | Number | 1937297392332 | 天猫限时抢可售 -开始时间（毫秒） |
| ju_online_start_time | String | 1581868800000 | 聚划算信息-聚淘开始时间（毫秒） |
| ju_online_end_time | String | 1582300799000 | 聚划算信息-聚淘结束时间（毫秒） |
| ju_pre_show_start_time | String | 1581868800000 | 聚划算信息-商品预热开始时间（毫秒） |
| ju_pre_show_end_time | String | 1582300799000 | 聚划算信息-商品预热结束时间（毫秒） |
| sale_price | String | 168 | 活动价 |
| kuadian_promotion_info | String | ["每 100 减 20","每 200 减 50"] | 跨店满减信息 |
| superior_brand | String | 1 | 是否品牌精选，0 不是，1 是 |
| hot_flag | String | 1 | 是否是热门商品，0 不是，1 是 |
| withholding_money | INT | 11 | 该接口扣费金额（点券） |
返回数据
{
"code": 0,
"msg": "成功",
"msec": 418,
"time": 1659923337,
"data": {
"request_id": "15rx513bgty8m",
"Body": "",
"results": [
{
"cat_name": "美容护肤/美体/精油",
"num_iid": 598129827832,
"title": "红石榴六件套装护肤品补水保湿水乳全套学生化妆品正品男女士",
"pict_url": "https://img.alicdn.com/bao/uploaded/i2/1586515126/O1CN01LJbS2l1njksyPKJK1_!!0-item_pic.jpg",
"small_images": [
"https://img.alicdn.com/i4/1586515126/O1CN01PuOljL1njkvNMM2Ko_!!1586515126.jpg",
"https://img.alicdn.com/i2/1586515126/O1CN01RpcvCe1njkvPvsUAC_!!1586515126.jpg",
"https://img.alicdn.com/i4/1586515126/O1CN01dzlcMv1njkvARp9Qk_!!1586515126.jpg",
"https://img.alicdn.com/i1/1586515126/O1CN01yD8yjg1njkvP5DXUx_!!1586515126.jpg"
],
"reserve_price": "338",
"zk_final_price": "338",
"user_type": 1,
"provcity": "广东 广州",
"item_url": "https://detail.tmall.com/item.htm?id=598129827832",
"seller_id": 1586515126,
"volume": 200,
"nick": "一枝春旗舰店",
"cat_leaf_name": "面部护理套装",
"free_shipment": true,
"material_lib_type": "1,2",
"presale_tail_end_time": 0,
"presale_tail_start_time": 0,
"presale_end_time": 0,
"presale_start_time": 0,
"presale_deposit": "0",
"tmall_play_activity_end_time": 0,
"tmall_play_activity_start_time": 0,
"ju_online_start_time": "0",
"ju_online_end_time": "0",
"ju_pre_show_start_time": "0",
"ju_pre_show_end_time": "0",
"superior_brand": "0",
"hot_flag": "1"
}
],
"withholding_money": 0
}
}
响应代码
| 代码 | 代码描述 | 解决方案 |
|---|---|---|
| 0 | 成功 | |
| 100 | 请求参数错误 | 检查您的请求参数是否正确 |
| 101 | 请求超时，请重试 | 检查您的网络情况或者联系客服解决 |
| 103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
| 200 | 系统错误，请联系客服 | 检查您的接口地址填写是否正确，其他问题联系客服解决 |
| 202 | 系统错误，请稍后再试 | 稍后重试，或者联系对接群 |
| 203 | 暂不支持当前接口 | |
| 204 | 请求异常：无该接口权限，请前往官网开通正式接口。 | 前往官网开通该接口权限 |
| 204 | 请求异常：API 调用次数不足，请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
| 302 | 未授权店铺 | 根据返回链接进行扫码授权 |
| 401 | 身份凭证无效 | 在请求头中添加 access_token，重新更新 token |
| 404 | 请求路径或请求方式错误 | 请更换请求方式或者检查路径是否正确 |