淘宝客高级API
淘宝客订单查询api接口(9月20日下线,请对接新订单接口)
需要授权
5151人使用

通过api接口将自己淘宝联盟账号下订单列表全部查出,可按多条件进行搜索,无需挂机任何辅助软件,快速实时查询账号下订单数据,返利必备接口!

本接口9月20日下线,请对接新淘宝客订单接口:https://www.dingdanxia.com/doc/60/8

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

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

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

start_time

Date

2019-05-11 15:05:11

订单查询开始时间

span

Number

1200

订单查询时间范围,最小值60,默认值1200,代表从start_time开始时间起到1200秒之内的所有订单数据

page_no

Number

1

第几页,默认1,1~100

page_size

Number

100

页大小,默认100,1~100

tk_status

Number

1

订单状态,1: 全部订单,3:订单结算,12:订单付款, 13:订单失效(也是维权成功后的订单状态),14:订单成功; 订单查询类型为‘结算时间’时,只能查订单结算状态

order_query_type

String

订单查询类型,创建时间“create_time”,或结算时间“settle_time”, 默认为 create_time

order_scene

Number

订单场景类型,1:常规订单,2:渠道订单,3:会员运营订单,默认为1,通过设置订单场景类型,媒体可以查询指定场景下的订单信息,例如不设置,或者设置为1,表示查询常规订单,常规订单包含淘宝客所有的订单数据,含渠道,及会员运营订单,但不包含3方分成,及维权订单

order_count_type

Number

订单数据统计类型,1: 2方订单,2: 3方订单,如果不设置,或者设置为1,表示2方订单

返回参数说明

标记

类型

例子

说明

trade_parent_id

Number

12345678

淘宝父订单号

trade_id

String

12345678

淘宝订单号

num_iid

Number

13232212

商品ID

item_title

String

女装....

商品标题

item_num

Number

100

商品数量

price

String

100

商品价格

pay_price

String

80

实际付款金额

seller_nick

String

xx服装店

卖家昵称

seller_shop_title

String

xx旗舰店

卖家店铺名称

commission

String

5.00

推广者获得的收入金额,对应联盟后台报表“预估收入”

commission_rate

String

20.00

推广者获得的分成比率,对应联盟后台报表“分成比率”

create_time

Date

2019-03-05 10:37:48

淘客订单创建时间

earning_time

Date

2019-03-05 10:37:48

淘客订单结算时间

tk_status

Number

1

淘客订单状态,3:订单结算,12:订单付款, 13:订单失效,14:订单成功

tk3rd_type

String

爱淘宝

第三方服务来源,没有第三方服务,取值为“--”

tk3rd_pub_id

Number

123

第三方推广者ID

order_type

String

天猫

订单类型,如天猫,淘宝

income_rate

String

0.008

收入比率,卖家设置佣金比率+平台补贴比率

pub_share_pre_fee

String

0.028

效果预估,付款金额*(佣金比率+补贴比率)*分成比率

subsidy_rate

String

0.028

补贴比率

subsidy_type

String

1

补贴类型,天猫:1,聚划算:2,航旅:3,阿里云:4

terminal_type

String

1

成交平台,PC:1,无线:2

auction_category

String

办公耗材

类目名称

site_id

String

123456

来源媒体ID

site_name

String

返利推广

来源媒体名称

adzone_id

String

123

广告位ID

adzone_name

String

右下角广告

广告位名称

alipay_total_price

String

3.6

付款金额

total_commission_rate

String

0.03

佣金比率

total_commission_fee

String

30.00

佣金金额

subsidy_fee

String

30.00

补贴金额

relation_id

Number

12345

渠道关系ID

special_id

Number

12345

会员运营id

click_time

Date

2015-03-05 10:37:48

跟踪点击时间

tk_status

Number

1

淘客订单状态,3:订单结算,12:订单付款, 13:订单失效,14:订单成功

tk_commission_pre_fee_for_media_platform

String

1.05

预估专项服务费:内容场景专项技术服务费,内容推广者在内容场景进行推广需要支付给阿里妈妈专项的技术服务费用。专项服务费=付款金额*专项服务费率。

tk_commission_fee_for_media_platform

String

1.05

结算专项服务费:内容场景专项技术服务费,内容推广者在内容场景进行推广需要支付给阿里妈妈专项的技术服务费用。专项服务费=结算金额*专项服务费率。

tk_commission_rate_for_media_platform

String

0.1

专项服务费率:内容场景专项技术服务费率,内容推广者在内容场景进行推广需要按结算金额支付一定比例给阿里妈妈作为内容场景专项技术服务费,用于提供与内容平台实现产品技术对接等服务。

返回示例
{
    "code": 200,
    "msg": "请求成功【success】",
    "data": [
        {
            "adzone_id": "174370427",
            "adzone_name": "扫券网官网",
            "alipay_total_price": "80.0000",
            "auction_category": "汽车用品",
            "click_time": "2018-12-26 10:02:43",
            "commission": "1.60",
            "commission_rate": "1.0000",
            "create_time": "2018-12-26 10:44:04",
            "earning_time": "2019-01-02 10:36:25",
            "income_rate": "0.0200",
            "item_num": 1,
            "item_title": "第1现场行车记录仪安装服务费链接请勿乱拍全国安装",
            "num_iid": 557315183403,
            "order_type": "天猫",
            "pay_price": "80.00",
            "price": "80.00",
            "pub_share_pre_fee": "1.60",
            "seller_nick": "第1现场汽车用品旗舰店",
            "seller_shop_title": "第1现场汽车用品旗舰店",
            "site_id": "39844064",
            "site_name": "修改网",
            "subsidy_fee": "0.4000",
            "subsidy_rate": "0.0050",
            "subsidy_type": "1",
            "terminal_type": "1",
            "total_commission_fee": "1.2000",
            "total_commission_rate": "0.0150",
            "trade_id": 307083650984171460,
            "trade_parent_id": 307083650984171460
        },
        {
            "adzone_id": "174370427",
            "adzone_name": "扫券网官网",
            "alipay_total_price": "649.0000",
            "auction_category": "汽车用品",
            "click_time": "2018-12-26 10:02:43",
            "commission": "129.80",
            "commission_rate": "1.0000",
            "create_time": "2018-12-26 10:38:41",
            "earning_time": "2019-01-02 10:36:47",
            "income_rate": "0.2000",
            "item_num": 1,
            "item_title": "第一现场后视镜行车记录仪高清夜视双镜头导航测速电子狗倒车影像",
            "num_iid": 568602364229,
            "order_type": "天猫",
            "pay_price": "649.00",
            "price": "1498.00",
            "pub_share_pre_fee": "129.80",
            "seller_nick": "第1现场汽车用品旗舰店",
            "seller_shop_title": "第1现场汽车用品旗舰店",
            "site_id": "39844064",
            "site_name": "修改网",
            "subsidy_fee": "0.0000",
            "subsidy_rate": "0.0000",
            "subsidy_type": "-1",
            "terminal_type": "1",
            "total_commission_fee": "129.8000",
            "total_commission_rate": "0.2000",
            "trade_id": 306767328278171460,
            "trade_parent_id": 306767328278171460
        }
    ]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

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