# 聚划算&淘抢购商品获取

# 接口名称

taobao.tbk.ju.tqg.get

# 调用方法

https://api.taobaokeapi.com/?usertoken=[usertoken]&method=taobao.tbk.ju.tqg.get

# 请求参数

名称 类型 必须 示例值 描述
adzone_id Number true 123 推广位id(推广位申请方式:http://club.alimama.com/read.php?spm=0.0.0.0.npQdST&tid=6306396&ds=1&page=1&toread=1)
fields String true click_url,pic_url,reserve_price,zk_final_price,total_amount,sold_num,title,category_name,start_time,end_time 需返回的字段列表
start_time Date true 2016-08-09 09:00:00 最早开团时间
end_time Date true 2016-08-09 16:00:00 最晚开团时间
page_no Number false 1 第几页,默认1,1~100
page_size Number false 40 页大小,默认40,1~40

# 响应参数

名称 类型 示例值 描述
results Results [] tbkTqg 淘抢购对象
title String 连衣裙 商品标题
total_amount Number 100 总库存
click_url String http://s.click.taobao.com/t?e=x 商品链接(是淘客商品返回淘客链接,非淘客商品返回普通h5链接)
category_name String 潮流女装 类目名称
zk_final_price String 50.00 淘抢购活动价
end_time String 2016-08-09 13:00:00 结束时间
sold_num Number 50 已抢购数量
start_time String 2016-08-09 12:00:00 开团时间
reserve_price String 100.00 商品原价
pic_url String http: //img4.tbcdn.cn/tfscom/i4/189490253156622336/TB2bZuSsVXXXXcNXXXXXXXXXXXX_!!0-juitemmedia.jpg 商品主图
num_iid Number 123 商品ID
total_results Number 20 返回的结果数

# 响应示例

{
    "tbk_ju_tqg_get_response":{
        "results":{
            "results":[
                {
                    "title":"连衣裙",
                    "total_amount":100,
                    "click_url":"http:\/\/s.click.taobao.com\/t?e=x",
                    "category_name":"潮流女装",
                    "zk_final_price":"50.00",
                    "end_time":"2016-08-09 13:00:00",
                    "sold_num":50,
                    "start_time":"2016-08-09 12:00:00",
                    "reserve_price":"100.00",
                    "pic_url":"http: \/\/img4.tbcdn.cn\/tfscom\/i4\/189490253156622336\/TB2bZuSsVXXXXcNXXXXXXXXXXXX_!!0-juitemmedia.jpg",
                    "num_iid":123
                }
            ]
        },
        "total_results":20
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

# 异常示例

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

# 错误码解释

错误码 错误消息 解决方案
isv.invalid-parameter:adzone_id