# 聚划算&淘抢购商品获取
# 接口名称
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
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
2
3
4
5
6
7
8
# 错误码解释
错误码 | 错误消息 | 解决方案 |
---|---|---|
isv.invalid-parameter:adzone_id |