淘宝客API参考文档

# 淘宝客商品详情查询(简版)

# 接口名称

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：无线，默认：１
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

# 异常示例

{
	"error_response":{
		"sub_msg":"非法参数",
		"code":50,
		"sub_code":"isv.invalid-parameter",
		"msg":"Remote service error"
	}
}
1
2
3
4
5
6
7
8

# 错误码解释

错误码 错误消息 解决方案
50001 无结果 更换商品查询
40001 内部调用失败 稍后重试
50002 调用频率过高 稍后重试
2 pid不正确 检查除pid之外的相关入参adzoneId和siteId
4 adzoneId不存在 检查入参adzoneId
5 pid校验出错 检查pid相关入参，稍后重试
1

← 店铺搜索 →