淘宝客高级API
限时整点抢购api接口
6069人使用

限时整点抢购api接口,最近三天时间段的抢购商品

接口地址: http://api.tbk.dingdanxia.com/spk/qiang 在线测试

非大陆服务器(含港澳台)调用接口会出现网络缓慢现象,请联系客服获取国外专线接口

请求参数、 调用方式 GET/POST

参数接口

参数类型

必填

示例

说明

apikey

string

接口秘钥,请登录后台获取

hour_type

Number

快抢时间点:1:昨天的0点,2:昨天10点,3:昨天12点,4:昨天15点,5:昨天20点,6:今天的0点,7:今天10点,8:今天12点,9:今天15点,10:今天20点,11:明天的0点,12:明天10点,13:明天12点,14:明天15点,15:明天20点

min_id

Number

分页,用于实现类似分页抓取效果,来源于上次获取后的数据的min_id值,默认开始请求值为1(该方案比单纯123分页的优势在于:数据更新的情况下保证不会重复也无需关注和计算页数)

返回参数说明

标记

类型

例子

说明

min_id

Number

2

作为请求地址中获取下一页的参数值

product_id

Number

2720653

自增ID

itemid

Number

553757100845

宝贝ID

itemtitle

String

南极人魅金创意不锈钢垃圾桶家用卫生间客厅卧室脚踏式厕所带盖筒

宝贝标题

itemshorttitle

String

南极人家用卫生间客厅垃圾袋60个

宝贝短标题

itemdesc

String

南极人加厚垃圾袋60支,采用高强度PE新材料韧性足、无异味、承重佳、封底结实不易漏,避免烂袋尴尬,千万家庭的选择,抢到就是赚!【送运费险】

宝贝推荐语

itemprice

float

8.10

在售价

itemsale

Number

33879

宝贝月销量

itemsale2

Number

5612

宝贝近2小时跑单

todaysale

Number

10493

当天销量

itempic

String

https://img.alicdn.com/imgextra/i2/3412518427/TB26gs7bb7U5uJjSZFFXXaYHpXa_!!3412518427.jpg

宝贝主图原始图像(由于图片原图过大影响加载速度,建议加上后缀_310x310.jpg,如https://img.alicdn.com/imgextra/i2/3412518427/TB26gs7bb7U5uJjSZFFXXaYHpXa_!!3412518427.jpg_310x310.jpg)

itempic_copy

String

0_553757100845_1509175123.jpg

推广长图(带http://img.haodanku.com/0_553757100845_1509175123.jpg-600进行访问)

fqcat

Number

10

商品类目: 1女装,2男装,3内衣,4美妆,5配饰,6鞋品,7箱包,8儿童,9母婴,10居家,11美食,12数码,13家电,14其他,15车品,16文体,17宠物

itemendprice

float

3.10

宝贝券后价

shoptype

String

B

店铺类型: 天猫店(B) 淘宝店(C)

couponurl

String

https://uland.taobao.com/quan/detail??sellerId=3162813958&activityId=1d5771905a774f01ad345d26ad8a55b2

优惠券链接

couponmoney

float

5.6

优惠券金额

videoid

Number

0

商品视频ID(id大于0的为有视频单,视频拼接地址http://cloud.video.taobao.com/play/u/1/p/1/e/6/t/1/+videoid+.mp4)

activity_type

string

普通活动

活动类型: 普通活动 聚划算 淘抢购

planlink

String

https://s.click.taobao.com/KjSknfw

营销计划链接

userid

Number

3162813958

店主的userid

sellernick

String

南极人唯欲专卖店

店铺掌柜名

tkrates

float

70.50

佣金比例

tkmoney

float

2.19

预计可得(宝贝价格 * 佣金比例 / 100)

couponstarttime

Number

1509120000

优惠券开始时间

couponendtime

Number

1509292799

优惠券结束时间

start_time

Number

1509174000

快抢开始时间

end_time

Number

1509292799

快抢结束时间

starttime

Number

1509174000

发布时间

down_type

Number

0

下架类型: 1用户自主下架;2被拉黑下架;3被举报下架;4取消认证下架;5过期下架;6结算下架;7优惠券失效下架;8平台下架(一般7是已抢光的情况)

general_index

Number

344

好单指数

seller_name

Strng

若梦****追梦

放单人名号

material_id

Strng

15

素材id

short_itemdesc

Strng

让味道留住你卧龙的记忆

导购短语

material_info

Strng

****

素材内容,里面含image是更多实拍图,seckill_content是图文素材(图片调用方法http://img.haodanku.com/{image}-600)

main_video_url

Strng

http:\/\/video.haodanku.com\/3YMFGz-lZxvmSH99SNqRz3mtU2s=\/FpU1L80LuAE1VrKUCcqPDSnMKYo0

实拍视频地址

detail_video_url

Strng

http:\/\/video.haodanku.com\/3YMFGz-lZxvmSH99SNqRz3mtU2s=\/FkKQiCloerAraG1B5hG6K0EwVwBL

更多实拍视频地址

detial_video_cover

Strng

10

实拍视频封面,可以通过改变链接中的w和h值分别改变宽高

main_video_cover

Strng

15

更多实拍视频封面,可以通过改变链接中的w和h值分别改变宽高

grab_type

Strng

3

快抢开抢状态:1快抢即将开始;2快抢商品已抢光;3快抢商品正在快抢中

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"min_id": 2,
	"data": {
		"data": [{
			"product_id": "6760",
			"itemid": "586111571880",
			"itemtitle": "新款纯棉t恤男士短袖韩版潮流圆领上衣白夏季打底衫男装体恤夏天",
			"itemshorttitle": "4.9高评分~纯棉圆领短袖T恤",
			"itemdesc": "【4.9高评分,100%纯棉,百位宝妈验货】50种印花及颜色可选,件件出彩,不起球不掉色,简约有型,反季促销才有的特价!速抢",
			"itemprice": "39.80",
			"itemsale": "150974",
			"itemsale2": "926",
			"todaysale": 87192,
			"admin_todaysale": "0",
			"basesale": "63782",
			"itempic": "http:\/\/img.alicdn.com\/imgextra\/i4\/1782714901\/O1CN01DkFMhm1m4hcThbHHJ_!!0-item_pic.jpg",
			"itempic_copy": "0_586111571880_1552493060.jpg",
			"itemendprice": "19.80",
			"shoptype": "B",
			"couponurl": "https:\/\/uland.taobao.com\/quan\/detail?sellerId=1782714901&activityId=dffcdc4edf8a4eb0bb90dfaf738f1bc6",
			"couponmoney": "20",
			"clickurl": null,
			"sellernick": "欧萨威帝旗舰店",
			"shopname": "欧萨威帝旗舰店",
			"tkmoney": "5.94",
			"tkrates": "30.00",
			"material_id": "52740",
			"short_itemdesc": "超值促销,活动价不容错过",
			"down_type": "0",
			"start_time": "1553738400",
			"is_foreshow": "2",
			"couponnum": "100000",
			"couponsurplus": "94000",
			"couponreceive": "6000",
			"grab_type": "3",
			"main_video_cover": "http:\/\/video.haodanku.com\/lt_0Oko8LEvEUMBJVQCpLQr5BknU?vframe\/jpg\/offset\/0|imageView2\/1\/w\/320\/h\/320\/q\/75|imageslim",
			"detial_video_cover": "",
			"material_info": {
				"image": "",
				"seckill_content": "[{\"img\":\"6bf1e572974810eb63f31e87f1395879\",\"text\":\"【验货实拍】印花T恤,超级百搭,质量很好做工精细T恤清洗过无褪色,码数正物超所值,值得购买~<br>\",\"copy_text\":\"【验货实拍】印花T恤,超级百搭,质量很好做工精细T恤清洗过无褪色,码数正物超所值,值得购买~<br>\",\"show_text\":\"【验货实拍】印花T恤,超级百搭,质量很好做工精细T恤清洗过无褪色,码数正物超所值,值得购买~<br>\"},{\"img\":\"550a73707cfadfba7b5c5fe5989d7221\",\"text\":\"【验货实拍】反季促销,疯了!所有图案一口价!180g优质精梳棉啊,质量绝对不输大牌!久穿不变形,常洗不褪色,晾晒不起褶,简洁大气,低调休闲范!<br>\",\"copy_text\":\"【验货实拍】反季促销,疯了!所有图案一口价!180g优质精梳棉啊,质量绝对不输大牌!久穿不变形,常洗不褪色,晾晒不起褶,简洁大气,低调休闲范!<br>\",\"show_text\":\"【验货实拍】反季促销,疯了!所有图案一口价!180g优质精梳棉啊,质量绝对不输大牌!久穿不变形,常洗不褪色,晾晒不起褶,简洁大气,低调休闲范!<br>\"}]",
				"main_video_url": "http:\/\/video.haodanku.com\/3YMFGz-lZxvmSH99SNqRz3mtU2s=\/lt_0Oko8LEvEUMBJVQCpLQr5BknU",
				"detail_video_url": ""
			}
		}]
	}
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完,请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。

4015

系统异常

服务端处理异常,请等待......或联系网站在线客服反馈。