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

taobao.tbk.dg.media.kol.realtime.summary (淘宝客-推广者-达人实时销量汇总数据)

媒体平台获取平台下达人实时销量榜

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
sub_adzone_id Number 必须 109503250186 达人三段式第一段,如:mm_1_2_3中的3
sub_site_id Number 必须 636300240 达人三段式第一段,如:mm_1_2_3中的2
sub_pub_id Number 必须 128315573 达人三段式第一段,如:mm_1_2_3中的1

响应参数

名称 类型 示例值 描述
realtime_summary KolRealTimeSummary 达人实时汇总数据
  • category_ranks
  • CategoryRank []
  • 分类目销量排名列表
  • └ item_category_name
  • String
  • 防辐射裙/马甲
  • 商品所属的根类目,即一级类目的名称,注若不区分类目汇总时该值为ALL_CATEGORY
  • └ alipay_amt
  • String
  • 10001.21
  • alipay金额
  • └ alipay_num
  • Number
  • 10001
  • alipay笔数
  • └ rank_num
  • Number
  • 1
  • 排名,注若不区分类目汇总时该值为空
  • └ update_time
  • Number
  • 1570257153
  • 统计更新时间戳
  • └ sub_adzone_id
  • Number
  • 3
  • 达人pid三段式中的第三段,如mm_1_2_3中的3
  • └ sub_site_id
  • Number
  • 2
  • 达人pid三段式中的第二段,如mm_1_2_3中的2
  • └ sub_pub_id
  • Number
  • 1
  • 达人pid三段式中的第一段,如mm_1_2_3中的1
  • └ pub_id
  • Number
  • 1238123124
  • 媒体平台memberid

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkDgMediaKolRealtimeSummaryRequest req = new TbkDgMediaKolRealtimeSummaryRequest();
req.setSubAdzoneId(109503250186L);
req.setSubSiteId(636300240L);
req.setSubPubId(128315573L);
TbkDgMediaKolRealtimeSummaryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tbk_dg_media_kol_realtime_summary_response>
    <realtime_summary>
        <category_ranks>
            <category_rank>
                <item_category_name>防辐射裙/马甲</item_category_name>
                <alipay_amt>10001.21</alipay_amt>
                <alipay_num>10001</alipay_num>
                <rank_num>1</rank_num>
                <update_time>1570257153</update_time>
            </category_rank>
        </category_ranks>
        <sub_adzone_id>3</sub_adzone_id>
        <sub_site_id>2</sub_site_id>
        <sub_pub_id>1</sub_pub_id>
        <pub_id>1238123124</pub_id>
    </realtime_summary>
</tbk_dg_media_kol_realtime_summary_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

返回
顶部