淘宝客高级API
9.9元包邮/九块九包邮api接口
8772人使用

淘宝9.9元包邮商品信息

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

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

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

参数接口

参数类型

必填

示例

说明

apikey

string

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

nav

Number

默认全部商品(1实时跑单商品,2爆单榜商品,3全部商品,4纯视频单,5聚淘专区)

page_size

Number

每页返回条数(请在1,2,10,20,50,100,120,200,500中选择一个数值返回)

min_id

Number

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

sort

Number

0.综合(最新),1.券后价(低到高),2.券后价(高到低),3.券面额(高到低),4.月销量(高到低),5.佣金比例(高到低),6.券面额(低到高),7.月销量(低到高),8.佣金比例(低到高),9.全天销量(高到低),10全天销量(低到高),11.近2小时销量(高到低),12.近2小时销量(低到高),13.优惠券领取量(高到低)注意:该排序仅对nav=3,4,5有效,1,2无效

sale_min

Number

销量筛选,筛选大于等于所设置的销量的商品

sale_max

Number

销量筛选,筛选小于等于所设置的销量的商品

coupon_min

Number

券金额筛选,筛选大于等于所设置的券金额的商品

coupon_max

Number

券金额筛选,筛选小于等于所设置的券金额的商品

tkrates_min

Number

佣金比例筛选,筛选大于等于所设置的佣金比例的商品

tkrates_max

Number

佣金比例筛选,筛选小于所设置的佣金比例的商品

tkmoney_min

Number

佣金筛选,筛选大于等于所设置的佣金的商品

item_type

String

是否只获取营销返利商品,1是,0否

cid

Number

商品类目:0全部,1女装,2母婴,3美妆,4居家日用,5鞋品,6美食,7文娱车品,8数码家电,9男装,10内衣,11箱包,12配饰,13户外运动,14家装家纺 对应 http://www.dingdanxia.com/doc/21/30 商品分类一级分类 cid

返回参数说明

标记

类型

例子

说明

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进行访问)

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

优惠券金额

is_brand

Number

0

是否为品牌产品(1是)

is_live

Number

0

是否为直播(1是)

guide_article

String

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

推广导购文案

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

南极人唯欲专卖店

店铺掌柜名

shopname

String

南极人唯欲专卖店

店铺名

tktype

String

营销计划

佣金计划: 隐藏 营销

tkrates

float

70.50

佣金比例

cuntao

Number

0

是否村淘(1是)

tkmoney

float

2.19

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

couponreceive2

Number

0

当天优惠券领取量

couponsurplus

Number

100000

优惠券剩余量

couponnum

Number

100000

优惠券总数量

couponexplain

String

单笔满8元可用

优惠券使用条件

couponstarttime

Number

1509120000

优惠券开始时间

couponendtime

Number

1509292799

优惠券结束时间

start_time

Number

1509174000

活动开始时间

end_time

Number

1509292799

活动结束时间

starttime

Number

1509174000

发布时间

discount

float

5.0

折扣力度

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"min_id": 9722480,
	"data": {
		"data": [{
			"product_id": "9723078",
			"itemid": "535055152061",
			"seller_id": "2242",
			"itemtitle": "成人行书练字帖凹槽硬笔字贴英语 楷书钢笔练字魔幻 行书学生褪色笔练字板套装 硬笔书法纸",
			"itemshorttitle": "行书练字帖凹槽硬笔字贴",
			"itemdesc": "魔幻练字帖套装,每一份字帖,我们用心制作,自动褪色,加厚卡纸,买两套的话,多送一份笔芯",
			"itemprice": "19.90",
			"itemsale": "26",
			"itemsale2": "0",
			"todaysale": "0",
			"itempic": "http:\/\/img.haodanku.com\/oimg_535055152061_1553759502.jpg",
			"itempic_copy": "0_535055152061_1553759480.jpg",
			"fqcat": "16",
			"itemendprice": "9.90",
			"shoptype": "B",
			"tktype": "营销计划",
			"tkrates": "20.00",
			"cuntao": "0",
			"tkmoney": "1.98",
			"couponurl": "https:\/\/uland.taobao.com\/quan\/detail?sellerId=2186924570&activityId=2c6a28f0e39c40d988ae1eed3c65a6fb",
			"couponmoney": "10",
			"couponsurplus": "10000",
			"couponreceive": "0",
			"couponreceive2": "0",
			"todaycouponreceive": "0",
			"couponnum": "10000",
			"couponexplain": "单笔满19.9元可用",
			"couponstarttime": "1553702400",
			"couponendtime": "1554307199",
			"start_time": "1553756400",
			"end_time": "1554307199",
			"starttime": "1553756400",
			"isquality": null,
			"report_status": "0",
			"is_brand": "0",
			"is_live": "0",
			"guide_article": "魔幻练字帖套装,每一份字帖,我们用心制作,自动褪色,加厚卡纸,买两套的话,多送一份笔芯",
			"videoid": "0",
			"activity_type": "普通活动",
			"general_index": "112",
			"planlink": null,
			"seller_name": "橙领会",
			"userid": "2186924570",
			"sellernick": "湖韵旗舰店",
			"shopname": "湖韵旗舰店",
			"online_users": "0",
			"original_img": "",
			"original_article": "",
			"discount": "5.00",
			"is_explosion": "0",
			"me": null,
			"activityid": "2c6a28f0e39c40d988ae1eed3c65a6fb",
			"coupon_condition": "19.90",
			"taobao_image": "http:\/\/img.alicdn.com\/imgextra\/i1\/2186924570\/TB2oxjHxnlYBeNjSszcXXbwhFXa_!!2186924570.jpg,http:\/\/img.alicdn.com\/imgextra\/i2\/2186924570\/TB2hTWXxkKWBuNjy1zjXXcOypXa_!!2186924570.jpg,http:\/\/img.alicdn.com\/imgextra\/i4\/2186924570\/TB22Fd8iXkoBKNjSZFEXXbrEVXa_!!2186924570.jpg,http:\/\/img.alicdn.com\/imgextra\/i4\/2186924570\/TB2KqKrxbSYBuNjSspiXXXNzpXa_!!2186924570.jpg,http:\/\/img.alicdn.com\/imgextra\/i2\/2186924570\/TB2gSWexXGWBuNjy0FbXXb4sXXa_!!2186924570.jpg",
			"shopid": "112821379"
		}]
	}
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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