淘宝客高级API
品牌首单礼金商品API
510人使用

该接口返回具有首单礼金的商品数据,礼金金额为预估金额,随账号、领取时间变动,接口返回的商品数据需要进行转链后再进行推广

转链接口:https://www.dingdanxia.com/doc/2/8

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

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

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

参数接口

参数类型

必填

示例

说明

apikey

string

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

cat_id

integer

0

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

back

integer

10

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

received_price

integer

5

已领礼金金额(2-7元)

order

integer

1

自定义排序(1.今日销量倒序;2.今日销量正序;3.预估支付价格正序;4.预估支付价格倒序;5.人气倒序;6.人气正序;7.最新倒序;8.最新正序)

min_id

integer

1

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

keyword

string

四川洪雅新鲜藤椒400g

关键词搜索

返回参数说明

标记

类型

例子

说明

min_id

Integer

2

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

itemid

Integer

553757100845

商品ID

itemtitle

string

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

商品标题

itemshorttitle

string

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

宝贝短标题

itemdesc

string

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

宝贝推荐语

itemprice

float

8.10

在售价

itemsale

integer

33879

宝贝月销量

itemsale2

integer

5612

宝贝近2小时跑单

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.cdn.fudaiapp.com/0_553757100845_1509175123.jpg-600进行访问)

taobao_image

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)

fqcat

integer

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

优惠券金额

is_brand

integer

0

是否为品牌产品(1是)

is_live

integer

0

是否为直播(1是)

guide_article

string

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

推广导购文案

videoid

integer

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

integer

3162813958

店主的userid

sellernick

string

南极人唯欲专卖店

店铺掌柜名

shopname

string

南极人唯欲专卖店

店铺名

tktype

string

营销计划

佣金计划: 隐藏 营销

tkrates

float

70.50

佣金比例

cuntao

integer

0

是否村淘(1是)

tkmoney

float

2.19

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

couponreceive2

integer

0

当天优惠券领取量

couponsurplus

integer

100000

优惠券剩余量

couponnum

integer

100000

优惠券总数量

couponexplain

string

单笔满8元可用

优惠券使用条件

couponstarttime

integer

1509120000

优惠券开始时间

couponendtime

integer

1509292799

优惠券结束时间

start_time

integer

1509174000

活动开始时间

end_time

integer

1509292799

活动结束时间

discount

float

5.0

折扣力度

deposit

float

5.0

双十一定金

deposit_deduct

float

5.0

双十一定金抵扣金额

is_shipping

integer

0

是否包邮商品:1为是

frist_order

string

0

首单礼金金额

estimate_price

string

1.02

预估支付金额

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"min_id": 2,
	"data": [{
		"itemendprice": 10.1,
		"discount": 4,
		"couponreceive2": 3300,
		"couponmoney": 15,
		"starttime": 1614664800,
		"userid": 2206479201445,
		"tkurl": "",
		"itemdesc": "在家也能做出鲜美,麻辣好吃的小龙虾,就选它,充分释放爆爽滋味,一料多用,解锁多种地道川味,麻辣烫,香锅,火锅都适用,家中必备!",
		"xid": "",
		"sellernick": "麻辣江湖食品旗舰店",
		"seller_name": "梭哈联盟",
		"me": "",
		"isquality": "",
		"seller_id": 43878,
		"tkrates": 60,
		"original_img": "",
		"todaycouponreceive": 8700,
		"deposit_deduct": 0,
		"itemtitle": "麻辣江湖地道川味麻辣小龙虾调料蒜蓉蒜香干锅香锅160g香辣虾蟹",
		"videoid": 0,
		"general_index": 223,
		"online_users": 0,
		"couponexplain": "单笔满25.0元可用",
		"start_time": 1614664800,
		"couponstarttime": 1614614400,
		"coupon_condition": 25,
		"tkmoney": 6.06,
		"couponreceive": 14700,
		"itempic": "https://img.alicdn.com/imgextra/i4/2206479201445/O1CN01CEazPT1MXqtpMvjxF_!!2206479201445.jpg",
		"deposit": 0,
		"shopid": 461958663,
		"tktype": "营销计划",
		"down_type": 0,
		"frist_order": 6,
		"estimate_price": 5.1,
		"couponurl": "https://uland.taobao.com/quan/detail?sellerId=2206479201445&activityId=7740db12caaa4715bbc7a492cd1ca7c2",
		"is_shipping": -1,
		"planlink": "",
		"shoptype": "B",
		"report_status": 0,
		"couponendtime": 1614873599,
		"is_brand": 0,
		"couponsurplus": 15300,
		"itemid": 612239633202,
		"activity_type": "普通活动",
		"itemprice": 25.1,
		"dx_rates": 0,
		"couponnum": 30000,
		"son_category": 50009822,
		"taobao_image": "https://img.alicdn.com/imgextra/i2/2206479201445/O1CN01xaszEO1MXqyYwaxk6_!!2206479201445.jpg,
		https: //img.alicdn.com/imgextra/i4/2206479201445/O1CN01CEazPT1MXqtpMvjxF_!!2206479201445.jpg,
			https: //img.alicdn.com/imgextra/i2/2206479201445/O1CN01U9e7mY1MXqvGeBqin_!!2206479201445.jpg,
			https: //img.alicdn.com/imgextra/i4/2206479201445/O1CN01ZVnN5P1MXqu6VMpOv_!!2206479201445.jpg,
			https: //img.alicdn.com/imgextra/i3/2206479201445/O1CN01YaiFmM1MXqtmlK37N_!!2206479201445.jpg",
			"itemsale": 6530,
		"end_time": 1614873599,
		"itemshorttitle": "麻辣小龙虾调料160g",
		"original_article": "",
		"itemsale2": 1112,
		"todaysale": 1147,
		"activityid": "7740db12caaa4715bbc7a492cd1ca7c2",
		"cuntao": 0,
		"shopname": "麻辣江湖食品旗舰店",
		"itempic_copy": "0_612239633202_1614667918.jpg",
		"is_live": 0,
		"fqcat": 11,
		"guide_article": "在家也能做出鲜美,麻辣好吃的小龙虾,就选它,充分释放爆爽滋味,一料多用,解锁多种地道川味,麻辣烫,香锅,火锅都适用,家中必备!",
		"is_explosion": 0,
		"product_id": 24146132,
		"tlj_price": 5.1,
		"seller_pay": 0
	}]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

调用请求被拒绝,您的账号状态存在异常,请联系平台管理员解除限制。