阿里大于 -

请求地址：

环境	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	必须	2022-05-22	天粒度
activity_id	String	可选	123131	会场id

名称	类型	示例值	描述
data	PageResult		结果
└ page_no Number 1 当前页码 └ page_size Number 10 每页条数 └ total_count Number 123 总数 result BusinessAdvisorPageRes [] 结果列表 └ pid String mm_12345678_90123456_78901234 推广位PID └ adzone_name String 名称名称 └ date_time String 2026-02-01 时间 └ update_time String 2026-02-27 13:29:52 cpa数据更新时间 traffic_driving_data TrafficDrivingData 引流数据 └ click_pv String 1 点击次数 └ click_uv String 1 点击人数 payment_data PaymentData 付款数据 └ pay_ord_uv String 1 付款人数 └ pay_ord_amt String 1 付款金额(元) └ pay_ord_num String 1 付款笔数 └ union_cvr String 1 付款转化率 └ pay_ord_unit_price String 1 平均客单价(元) └ pay2nd_tk_disp_tfee String 1 付款预估收入(元) └ pay2nd_tk_disp_tfee_rate String 1 付款预估提成率 └ pay2nd_tk_tfee String 1 付款预估实际收入(元) └ hl_pay_ord_uv String 1 非低佣付款人数 └ hl_pay_ord_amt String 1 非低佣付款金额(元) └ hl_pay_ord_num String 1 非低佣付款笔数 └ hl_pay_tk_disp_tfee String 1 非低佣付款预估收入(元) └ st_pay_ord_uv String 1 单品付款人数 └ st_pay_ord_num String 1 单品付款笔数 └ st_pay_ord_amt String 1 单品付款金额(元) └ st_pay2nd_tk_disp_tfee String 1 单品付款预估收入(元) effect_payment_data EffectPaymentData 有效付款数据 └ eff_ord_num String 1 有效付款笔数 └ eff_ord_amt String 1 有效付款金额(元) └ eff2nd_tk_tfee String 1 有效付款预估实际收入(元) └ eff2nd_tk_disp_tfee String 1 有效付款预估收入(元) red_envelope_data RedEnvelopeData 红包数据 └ red_envelope_eff_ord_num String 1 红包订单笔数 └ red_envelope_eff_ord_amt String 1 红包订单金额(元) └ red_envelope_eff2nd_tk_disp_tfee String 1 红包订单付款预估收入(元) └ red_envelope_pay2nd_tk_disp_tfee_per_vegas String 1 单红包收入(元) └ red_envelope_send_vegas_num String 1 红包发放量 └ red_envelope_use_vegas_num String 1 红包使用量 settle_data SettleData 结算数据 └ sett_ord_uv String 1 结算人数 └ sett_ord_amt String 1 结算金额(元) └ sett_ord_num String 1 结算笔数 └ sett2nd_tk_tfee String 1 结算预估实际收入(元) └ sett2nd_tk_disp_tfee String 1 结算预估收入(元) cpa_data CpaData cpa数据 └ pay_tk_icpa_tfee String 1 预估实际总收入(元) └ pay_tk_icpa_tfee_per_uclk_uv String 1 单引流UV实际收入(元) └ pay_cpa_fee String 1 预估cpa收入(元) └ pre_cpa_uv String 1 预估cpa奖励UV └ pre_cpa_uv_per_uclk_uv String 1 cpa命中率 └ pre_cpa_vegas_uv_per_uclk_uv String 1 cpa开奖率 └ activity_id String 1 活动id

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkDgBusinessAdvisorActivityRequest req = new TbkDgBusinessAdvisorActivityRequest();
req.setPageSize(10L);
req.setPid("mm_1_2_3");
req.setType(1L);
req.setPageNo(1L);
req.setQTime("2022-05-22");
req.setActivityId("123131");
TbkDgBusinessAdvisorActivityResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TbkDgBusinessAdvisorActivityRequest req = new TbkDgBusinessAdvisorActivityRequest();
req.PageSize = 10L;
req.Pid = "mm_1_2_3";
req.Type = 1L;
req.PageNo = 1L;
req.QTime = "2022-05-22";
req.ActivityId = "123131";
TbkDgBusinessAdvisorActivityResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TbkDgBusinessAdvisorActivityRequest;
$req->setPageSize("10");
$req->setPid("mm_1_2_3");
$req->setType("1");
$req->setPageNo("1");
$req->setQTime("2022-05-22");
$req->setActivityId("123131");
$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.activity' \
-d 'partner_id=apidoc' \
-d 'sign=EBE10AFDD6665EF32FCC8F76E8B24330' \
-d 'sign_method=hmac' \
-d 'timestamp=2026-04-01+15%3A08%3A41' \
-d 'v=2.0' \
-d 'activity_id=123131' \
-d 'page_no=1' \
-d 'page_size=10' \
-d 'pid=mm_1_2_3' \
-d 'q_time=2022-05-22' \
-d 'type=1'

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

req=top.api.TbkDgBusinessAdvisorActivityRequest(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="2022-05-22"
req.activity_id="123131"
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.activity");
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","2022-05-22");
add_param(pRequest,"activity_id","123131");
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.activity', {
	'page_size':'10',
	'pid':'mm_1_2_3',
	'type':'1',
	'page_no':'1',
	'q_time':'2022-05-22',
	'activity_id':'123131'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<tbk_dg_business_advisor_activity_response>
    <data>
        <page_no>1</page_no>
        <page_size>10</page_size>
        <total_count>123</total_count>
        <result>
            <business_advisor_page_res>
                <pid>mm_12345678_90123456_78901234</pid>
                <adzone_name>名称</adzone_name>
                <date_time>2026-02-01</date_time>
                <update_time>2026-02-27 13:29:52</update_time>
                <traffic_driving_data>
                    <click_pv>1</click_pv>
                    <click_uv>1</click_uv>
                </traffic_driving_data>
                <payment_data>
                    <pay_ord_uv>1</pay_ord_uv>
                    <pay_ord_amt>1</pay_ord_amt>
                    <pay_ord_num>1</pay_ord_num>
                    <union_cvr>1</union_cvr>
                    <pay_ord_unit_price>1</pay_ord_unit_price>
                    <pay2nd_tk_disp_tfee>1</pay2nd_tk_disp_tfee>
                    <pay2nd_tk_disp_tfee_rate>1</pay2nd_tk_disp_tfee_rate>
                    <pay2nd_tk_tfee>1</pay2nd_tk_tfee>
                    <hl_pay_ord_uv>1</hl_pay_ord_uv>
                    <hl_pay_ord_amt>1</hl_pay_ord_amt>
                    <hl_pay_ord_num>1</hl_pay_ord_num>
                    <hl_pay_tk_disp_tfee>1</hl_pay_tk_disp_tfee>
                    <st_pay_ord_uv>1</st_pay_ord_uv>
                    <st_pay_ord_num>1</st_pay_ord_num>
                    <st_pay_ord_amt>1</st_pay_ord_amt>
                    <st_pay2nd_tk_disp_tfee>1</st_pay2nd_tk_disp_tfee>
                </payment_data>
                <effect_payment_data>
                    <eff_ord_num>1</eff_ord_num>
                    <eff_ord_amt>1</eff_ord_amt>
                    <eff2nd_tk_tfee>1</eff2nd_tk_tfee>
                    <eff2nd_tk_disp_tfee>1</eff2nd_tk_disp_tfee>
                </effect_payment_data>
                <red_envelope_data>
                    <red_envelope_eff_ord_num>1</red_envelope_eff_ord_num>
                    <red_envelope_eff_ord_amt>1</red_envelope_eff_ord_amt>
                    <red_envelope_eff2nd_tk_disp_tfee>1</red_envelope_eff2nd_tk_disp_tfee>
                    <red_envelope_pay2nd_tk_disp_tfee_per_vegas>1</red_envelope_pay2nd_tk_disp_tfee_per_vegas>
                    <red_envelope_send_vegas_num>1</red_envelope_send_vegas_num>
                    <red_envelope_use_vegas_num>1</red_envelope_use_vegas_num>
                </red_envelope_data>
                <settle_data>
                    <sett_ord_uv>1</sett_ord_uv>
                    <sett_ord_amt>1</sett_ord_amt>
                    <sett_ord_num>1</sett_ord_num>
                    <sett2nd_tk_tfee>1</sett2nd_tk_tfee>
                    <sett2nd_tk_disp_tfee>1</sett2nd_tk_disp_tfee>
                </settle_data>
                <cpa_data>
                    <pay_tk_icpa_tfee>1</pay_tk_icpa_tfee>
                    <pay_tk_icpa_tfee_per_uclk_uv>1</pay_tk_icpa_tfee_per_uclk_uv>
                    <pay_cpa_fee>1</pay_cpa_fee>
                    <pre_cpa_uv>1</pre_cpa_uv>
                    <pre_cpa_uv_per_uclk_uv>1</pre_cpa_uv_per_uclk_uv>
                    <pre_cpa_vegas_uv_per_uclk_uv>1</pre_cpa_vegas_uv_per_uclk_uv>
                </cpa_data>
                <activity_id>1</activity_id>
            </business_advisor_page_res>
        </result>
    </data>
</tbk_dg_business_advisor_activity_response>

{
    "tbk_dg_business_advisor_activity_response":{
        "data":{
            "page_no":1,
            "page_size":10,
            "total_count":123,
            "result":{
                "business_advisor_page_res":[
                    {
                        "pid":"mm_12345678_90123456_78901234",
                        "adzone_name":"名称",
                        "date_time":"2026-02-01",
                        "update_time":"2026-02-27 13:29:52",
                        "traffic_driving_data":{
                            "click_pv":"1",
                            "click_uv":"1"
                        },
                        "payment_data":{
                            "pay_ord_uv":"1",
                            "pay_ord_amt":"1",
                            "pay_ord_num":"1",
                            "union_cvr":"1",
                            "pay_ord_unit_price":"1",
                            "pay2nd_tk_disp_tfee":"1",
                            "pay2nd_tk_disp_tfee_rate":"1",
                            "pay2nd_tk_tfee":"1",
                            "hl_pay_ord_uv":"1",
                            "hl_pay_ord_amt":"1",
                            "hl_pay_ord_num":"1",
                            "hl_pay_tk_disp_tfee":"1",
                            "st_pay_ord_uv":"1",
                            "st_pay_ord_num":"1",
                            "st_pay_ord_amt":"1",
                            "st_pay2nd_tk_disp_tfee":"1"
                        },
                        "effect_payment_data":{
                            "eff_ord_num":"1",
                            "eff_ord_amt":"1",
                            "eff2nd_tk_tfee":"1",
                            "eff2nd_tk_disp_tfee":"1"
                        },
                        "red_envelope_data":{
                            "red_envelope_eff_ord_num":"1",
                            "red_envelope_eff_ord_amt":"1",
                            "red_envelope_eff2nd_tk_disp_tfee":"1",
                            "red_envelope_pay2nd_tk_disp_tfee_per_vegas":"1",
                            "red_envelope_send_vegas_num":"1",
                            "red_envelope_use_vegas_num":"1"
                        },
                        "settle_data":{
                            "sett_ord_uv":"1",
                            "sett_ord_amt":"1",
                            "sett_ord_num":"1",
                            "sett2nd_tk_tfee":"1",
                            "sett2nd_tk_disp_tfee":"1"
                        },
                        "cpa_data":{
                            "pay_tk_icpa_tfee":"1",
                            "pay_tk_icpa_tfee_per_uclk_uv":"1",
                            "pay_cpa_fee":"1",
                            "pre_cpa_uv":"1",
                            "pre_cpa_uv_per_uclk_uv":"1",
                            "pre_cpa_vegas_uv_per_uclk_uv":"1"
                        },
                        "activity_id":"1"
                    }
                ]
            }
        }
    }
}

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.activity (淘宝客-推广者-采量经营活动数据)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ