阿里大于 -

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	描述
page_size	Number	可选	10	页大小，最大10
pid	String	可选	mm_1_2_3	pid
type	Number	可选	1	归因类型 1、按照点击 2、按照事件
page_no	Number	可选	1	页码
q_time	String	必须	2026-02-01	天粒度

名称	类型	示例值	描述
data	PageResult		结果
└ page_no Number 1 当前页码 └ page_size Number 10 每页条数 └ total_count Number 123 总数 result BusinessAdvisorPidRes [] 结果列表 └ pid String m_1_2_3 pid └ date_time String 2026-02-01 时间 traffic_driving_data TrafficDrivingData 引流数据 └ click_pv String 12 点击次数 └ click_uv String 11 点击人数 payment_data PaymentData 付款数据 └ pay_ord_uv String 123 付款人数 └ pay_ord_amt String 123.4 付款金额(元) └ pay_ord_num String 12 付款笔数 └ union_cvr String 0.3457 付款转化率 └ pay2nd_tk_disp_tfee String 123 付款预估收入(元) └ pay2nd_tk_disp_tfee_rate String 0.1237 付款预估提成率 └ pay2nd_tk_tfee String 123 付款预估实际收入(元) └ hl_pay_ord_uv String 12 非低佣付款人数 └ hl_pay_ord_amt String 1 非低佣付款金额(元) └ hl_pay_ord_num String 213 非低佣付款笔数 └ hl_pay_tk_disp_tfee String 213.12 非低佣付款预估收入(元) └ pay_amt_pre_pay_uv String 12 客单价(元) effect_payment_data EffectPaymentData 有效付款数据 └ eff_ord_num String 12 有效付款笔数 └ eff_ord_amt String 13.45 有效付款金额(元) └ eff2nd_tk_tfee String 12.4 有效付款预估收入(元) └ eff2nd_tk_disp_tfee String 11 有效付款预估实际收入(元) cpa_data CpaData cpa数据 └ pay_tk_icpa_tfee String 12 预估实际总收入(元) └ pay_tk_icpa_tfee_per_uclk_uv String 13.01 单引流UV实际收入(元) └ pay_cpa_fee String 11 预估cpa收入(元) settle_data SettleData 结算数据 └ sett_ord_uv String 112 结算人数 └ sett_ord_amt String 123.11 结算金额(元) └ sett_ord_num String 11 结算笔数 └ sett_tk_icpa_tfee String 123 结算实际总收入(元) └ sett2nd_tk_disp_tfee String 1234.12 结算预估收入(元) └ eff_sett_ord_amt String 11.1 付款归因结算金额(元) └ eff_sett2nd_tk_disp_tfee String 1.3 付款归因结算预估收入(元) └ eff_sett2nd_tk_tfee String 12.3 付款归因结算预估实际收入(元) └ sett_cpa_fee String 123 结算cpa收入(元) └ sett2nd_tk_tfee String 213 结算预估实际收入(元) └ update_time String 2026-02-27 13:29:52 cpa数据更新时间

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkDgBusinessAdvisorRequest req = new TbkDgBusinessAdvisorRequest();
req.setPageSize(10L);
req.setPid("mm_1_2_3");
req.setType(1L);
req.setPageNo(1L);
req.setQTime("2026-02-01");
TbkDgBusinessAdvisorResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TbkDgBusinessAdvisorRequest req = new TbkDgBusinessAdvisorRequest();
req.PageSize = 10L;
req.Pid = "mm_1_2_3";
req.Type = 1L;
req.PageNo = 1L;
req.QTime = "2026-02-01";
TbkDgBusinessAdvisorResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TbkDgBusinessAdvisorRequest;
$req->setPageSize("10");
$req->setPid("mm_1_2_3");
$req->setType("1");
$req->setPageNo("1");
$req->setQTime("2026-02-01");
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.tbk.dg.business.advisor' \
-d 'partner_id=apidoc' \
-d 'sign=6654D066FAE9D5DE3508622660CF669E' \
-d 'sign_method=hmac' \
-d 'timestamp=2026-04-01+15%3A09%3A18' \
-d 'v=2.0' \
-d 'page_no=1' \
-d 'page_size=10' \
-d 'pid=mm_1_2_3' \
-d 'q_time=2026-02-01' \
-d 'type=1'

# -*- coding: utf-8 -*-
import top.api

req=top.api.TbkDgBusinessAdvisorRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.page_size=10
req.pid="mm_1_2_3"
req.type=1
req.page_no=1
req.q_time="2026-02-01"
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.tbk.dg.business.advisor");
add_param(pRequest,"page_size","10");
add_param(pRequest,"pid","mm_1_2_3");
add_param(pRequest,"type","1");
add_param(pRequest,"page_no","1");
add_param(pRequest,"q_time","2026-02-01");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'url': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.tbk.dg.business.advisor', {
	'page_size':'10',
	'pid':'mm_1_2_3',
	'type':'1',
	'page_no':'1',
	'q_time':'2026-02-01'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<tbk_dg_business_advisor_response>
    <data>
        <page_no>1</page_no>
        <page_size>10</page_size>
        <total_count>123</total_count>
        <result>
            <business_advisor_pid_res>
                <pid>m_1_2_3</pid>
                <date_time>2026-02-01</date_time>
                <traffic_driving_data>
                    <click_pv>12</click_pv>
                    <click_uv>11</click_uv>
                </traffic_driving_data>
                <payment_data>
                    <pay_ord_uv>123</pay_ord_uv>
                    <pay_ord_amt>123.4</pay_ord_amt>
                    <pay_ord_num>12</pay_ord_num>
                    <union_cvr>0.3457</union_cvr>
                    <pay2nd_tk_disp_tfee>123</pay2nd_tk_disp_tfee>
                    <pay2nd_tk_disp_tfee_rate>0.1237</pay2nd_tk_disp_tfee_rate>
                    <pay2nd_tk_tfee>123</pay2nd_tk_tfee>
                    <hl_pay_ord_uv>12</hl_pay_ord_uv>
                    <hl_pay_ord_amt>1</hl_pay_ord_amt>
                    <hl_pay_ord_num>213</hl_pay_ord_num>
                    <hl_pay_tk_disp_tfee>213.12</hl_pay_tk_disp_tfee>
                    <pay_amt_pre_pay_uv>12</pay_amt_pre_pay_uv>
                </payment_data>
                <effect_payment_data>
                    <eff_ord_num>12</eff_ord_num>
                    <eff_ord_amt>13.45</eff_ord_amt>
                    <eff2nd_tk_tfee>12.4</eff2nd_tk_tfee>
                    <eff2nd_tk_disp_tfee>11</eff2nd_tk_disp_tfee>
                </effect_payment_data>
                <cpa_data>
                    <pay_tk_icpa_tfee>12</pay_tk_icpa_tfee>
                    <pay_tk_icpa_tfee_per_uclk_uv>13.01</pay_tk_icpa_tfee_per_uclk_uv>
                    <pay_cpa_fee>11</pay_cpa_fee>
                </cpa_data>
                <settle_data>
                    <sett_ord_uv>112</sett_ord_uv>
                    <sett_ord_amt>123.11</sett_ord_amt>
                    <sett_ord_num>11</sett_ord_num>
                    <sett_tk_icpa_tfee>123</sett_tk_icpa_tfee>
                    <sett2nd_tk_disp_tfee>1234.12</sett2nd_tk_disp_tfee>
                    <eff_sett_ord_amt>11.1</eff_sett_ord_amt>
                    <eff_sett2nd_tk_disp_tfee>1.3</eff_sett2nd_tk_disp_tfee>
                    <eff_sett2nd_tk_tfee>12.3</eff_sett2nd_tk_tfee>
                    <sett_cpa_fee>123</sett_cpa_fee>
                    <sett2nd_tk_tfee>213</sett2nd_tk_tfee>
                </settle_data>
                <update_time>2026-02-27 13:29:52</update_time>
            </business_advisor_pid_res>
        </result>
    </data>
</tbk_dg_business_advisor_response>

{
    "tbk_dg_business_advisor_response":{
        "data":{
            "page_no":1,
            "page_size":10,
            "total_count":123,
            "result":{
                "business_advisor_pid_res":[
                    {
                        "pid":"m_1_2_3",
                        "date_time":"2026-02-01",
                        "traffic_driving_data":{
                            "click_pv":"12",
                            "click_uv":"11"
                        },
                        "payment_data":{
                            "pay_ord_uv":"123",
                            "pay_ord_amt":"123.4",
                            "pay_ord_num":"12",
                            "union_cvr":"0.3457",
                            "pay2nd_tk_disp_tfee":"123",
                            "pay2nd_tk_disp_tfee_rate":"0.1237",
                            "pay2nd_tk_tfee":"123",
                            "hl_pay_ord_uv":"12",
                            "hl_pay_ord_amt":"1",
                            "hl_pay_ord_num":"213",
                            "hl_pay_tk_disp_tfee":"213.12",
                            "pay_amt_pre_pay_uv":"12"
                        },
                        "effect_payment_data":{
                            "eff_ord_num":"12",
                            "eff_ord_amt":"13.45",
                            "eff2nd_tk_tfee":"12.4",
                            "eff2nd_tk_disp_tfee":"11"
                        },
                        "cpa_data":{
                            "pay_tk_icpa_tfee":"12",
                            "pay_tk_icpa_tfee_per_uclk_uv":"13.01",
                            "pay_cpa_fee":"11"
                        },
                        "settle_data":{
                            "sett_ord_uv":"112",
                            "sett_ord_amt":"123.11",
                            "sett_ord_num":"11",
                            "sett_tk_icpa_tfee":"123",
                            "sett2nd_tk_disp_tfee":"1234.12",
                            "eff_sett_ord_amt":"11.1",
                            "eff_sett2nd_tk_disp_tfee":"1.3",
                            "eff_sett2nd_tk_tfee":"12.3",
                            "sett_cpa_fee":"123",
                            "sett2nd_tk_tfee":"213"
                        },
                        "update_time":"2026-02-27 13:29:52"
                    }
                ]
            }
        }
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

淘宝客API

taobao.tbk.dg.business.advisor (淘宝客-推广者-采量经营数据)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ