# 淘宝客商品详情查询(简版)
# 接口名称
taobao.tbk.item.info.get
# 调用方法
https://api.taobaokeapi.com/?usertoken=[usertoken]&method=taobao.tbk.item.info.get
# 请求参数
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
num_iids | String | true | 123,456 | 商品ID串,用,分割,最大40个 |
platform | Number | false | 1 | 链接形式:1:PC,2:无线,默认:1 |
ip | String | false | 11.22.33.43 | ip地址,影响邮费获取,如果不传或者传入不准确,邮费无法精准提供 |
# 响应参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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表示商城 |
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:营销商品主推库,2. 内容商品库,如果值为空则不属于1,2这两种商品类型 |
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 | 预售商品-定金(元) |
# 响应示例
{
"tbk_item_info_get_response":{
"results":{
"n_tbk_item":[
{
"cat_name":"女装",
"num_iid":123,
"title":"连衣裙",
"pict_url":"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":"102.00",
"zk_final_price":"88.00",
"user_type":1,
"provcity":"杭州",
"item_url":"http:\/\/detail.m.tmall.com\/item.htm?id=xxx",
"seller_id":123,
"volume":1,
"nick":"xx旗舰店",
"cat_leaf_name":"情趣内衣",
"is_prepay":true,
"shop_dsr":23,
"ratesum":13,
"i_rfd_rate":true,
"h_good_rate":true,
"h_pay_rate30":true,
"free_shipment":true,
"material_lib_type":"1",
"presale_discount_fee_text":"付定金立减20元",
"presale_tail_end_time":1937297392332,
"presale_tail_start_time":1937297392332,
"presale_end_time":1937297392332,
"presale_start_time":1937297392332,
"presale_deposit":"100"
}
]
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
# 异常示例
{
"error_response":{
"sub_msg":"非法参数",
"code":50,
"sub_code":"isv.invalid-parameter",
"msg":"Remote service error"
}
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
# 错误码解释
错误码 | 错误消息 | 解决方案 |
---|---|---|
50001 | 无结果 | 更换商品查询 |
40001 | 内部调用失败 | 稍后重试 |
50002 | 调用频率过高 | 稍后重试 |
2 | pid不正确 | 检查除pid之外的相关入参adzoneId和siteId |
4 | adzoneId不存在 | 检查入参adzoneId |
5 | pid校验出错 | 检查pid相关入参,稍后重试 |
1 |