文档中心 > API类目 > 淘宝客API

taobao.tbk.content.reports.query.stat (淘宝客-内容三方-媒体数据报表交换-汇总数据)

汇总达人pid维度报表查询API

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_size Number 必须 100 每页大小,最大值为100
page_no Number 必须 1 页码
dimensions String 可选 ds,hh 聚合条件;ds-获取当天各小时信息,hh-获取指定小时信息
filters String 必须 ds=20250331;hh=20;hasCount=true 查询条件;ds为日期(最早可追溯至20250101),hh为小时【如hh=09,代表当日早上8-9时数据】,hasCount表示是否获取数量,建议第一次获取,后续传入false以提高整个接口响应性能
return_fields String 可选 ds,hh,sett_ord_num,sett_ord_amt,cm_3rd_pub_share_fee,cm_pub_share_fee,pre_3rd_pub_share_fee,pre_pub_share_fee,pay_ord_num,pay_ord_amt,3rd_pub_id,pub_id,site_id,adzone_id,item_id,cate_level1_name,tk_pv,tk_uv,tb_pv,tb_uv 查询结果返回的字段
report_type_id String 必须 union_content_platform_item_cate_basic_v1 报表名称

响应参数

名称 类型 示例值 描述
data_list MapData [] map数组 结果列表
  • └ cate_level1_name
  • String
  • 服装
  • 商品一级类目名称
  • └ item_id
  • String
  • 123ucbewri-123ucbewri
  • 新商品ID
  • └ tk_uv
  • String
  • 10
  • 淘客点击uv
  • └ tk_pv
  • String
  • 10
  • 淘客点击pv
  • └ ds
  • String
  • 20190525
  • 日期
  • └ cm_3rd_pub_share_fee
  • String
  • 20
  • 结算平台佣金收益
  • └ cm_pub_share_fee
  • String
  • 1.5
  • 结算达人佣金收益
  • └ pre_3rd_pub_share_fee
  • String
  • 1.5
  • 达人预估收入
  • └ pre_pub_share_fee
  • String
  • 1.5
  • 平台预估收入
  • └ adzone_id
  • Number
  • 1234
  • 达人adzoneid
  • └ site_id
  • Number
  • 1234
  • 达人siteid
  • └ pub_id
  • Number
  • 1234
  • 达人pubid
  • └ sub_pub_id
  • Number
  • 1234
  • 平台pud_id
  • └ pay_ord_amt
  • BigDecimal
  • 22.5
  • 付款金额
  • └ pay_ord_num
  • String
  • 10
  • 付款笔数
  • └ sett_ord_amt
  • BigDecimal
  • 22.5
  • 结算笔数
  • └ sett_ord_num
  • String
  • 10
  • 结算金额
  • └ hh
  • String
  • 20
  • 小时
report_type_id String union_content_platform_item_cate_basic_v1 报表名称
page_info RptPageinfo map 分页信息
  • └ total_cnt
  • Number
  • 1234
  • 总数
  • └ page_no
  • Number
  • 1
  • 页数
  • └ page_size
  • Number
  • 100
  • 每页大小

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkContentReportsQueryStatRequest req = new TbkContentReportsQueryStatRequest();
req.setPageSize(100L);
req.setPageNo(1L);
req.setDimensions("ds,hh");
req.setFilters("ds=20250331;hh=20;hasCount=true");
req.setReturnFields("ds,hh,sett_ord_num,sett_ord_amt,cm_3rd_pub_share_fee,cm_pub_share_fee,pre_3rd_pub_share_fee,pre_pub_share_fee,pay_ord_num,pay_ord_amt,3rd_pub_id,pub_id,site_id,adzone_id,item_id,cate_level1_name,tk_pv,tk_uv,tb_pv,tb_uv");
req.setReportTypeId("union_content_platform_item_cate_basic_v1");
TbkContentReportsQueryStatResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tbk_content_reports_query_stat_response>
    <data_list>
        <map_data>
            <cate_level1_name>服装</cate_level1_name>
            <item_id>123ucbewri-123ucbewri</item_id>
            <tk_uv>10</tk_uv>
            <tk_pv>10</tk_pv>
            <ds>20190525</ds>
            <cm_3rd_pub_share_fee>20</cm_3rd_pub_share_fee>
            <cm_pub_share_fee>1.5</cm_pub_share_fee>
            <pre_3rd_pub_share_fee>1.5</pre_3rd_pub_share_fee>
            <pre_pub_share_fee>1.5</pre_pub_share_fee>
            <adzone_id>1234</adzone_id>
            <site_id>1234</site_id>
            <pub_id>1234</pub_id>
            <sub_pub_id>1234</sub_pub_id>
            <pay_ord_amt>22.5</pay_ord_amt>
            <pay_ord_num>10</pay_ord_num>
            <sett_ord_amt>22.5</sett_ord_amt>
            <sett_ord_num>10</sett_ord_num>
            <hh>20</hh>
        </map_data>
    </data_list>
    <report_type_id>union_content_platform_item_cate_basic_v1</report_type_id>
    <page_info>
        <total_cnt>1234</total_cnt>
        <page_no>1</page_no>
        <page_size>100</page_size>
    </page_info>
</tbk_content_reports_query_stat_response>

异常示例

  • 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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部