短视频详细数据

在线调试

//查询"xxx"，"xxx"这两个抖音号在 2023年3月20日 到 2023年3月21日 在抖音端发布的自挂载,达人挂载短视频详细数据
{
  "start_time": 1679241600,
  "end_time": 1679328000,
  "host_name": "douyin",
  "query_bind_type": 0,
  "aweme_short_id_list": ["xxx","xxx"],
  "query_data_type":4,
  "page_no":1,
  "page_size":100
}

/**查询"7169582939932"，"716958217457932"这两个短视频ID中发布时间在 2023年3月20日 到 2023年3月21日
之间的短视频的详细数据**/
{
  "start_time": 1679241600,
  "end_time": 1679328000,
  "query_bind_type": 1,
  "item_id_list": ["7169582939932","716958217457932"],
  "open_item_id_list": ["@+mBxX3X5nqAF2xpmBxlSuRAyt+dfQfc7UnuQdDXzWUB9BtjSmH12d3fcFVF++2xOEzYKH+kboOjsmFRO+ahTAQ==", "@+mBxX3X5nqAF2xpmBxlSuRAyt+dfQfc7U32ReT7+UkJ8C4jV3H2wk1C8FVF++2xOkETGWYts5haD9aCpAKVqEQ=="]
  "query_data_type":4,
  "page_no":1,
  "page_size":100
}

{
  "err_no":0,
  "err_msg":"success",
  "data":{
    // 短视频/直播间详细数据列表,每一个元素表示一个短视频/直播间数据，列表按短视频发布时间/直播间开播时间倒序排列
    "data_list":[
      {
        //如果是短视频，则会返回如下指标
        "item_id": "7169582199207939932", //短视频ID
        "open_item_id_list": "@+mBxX3X5nqAF2xpmBxlSuRAyt+dfQfc7UnuQdDXzWUB9BtjSmH12d3fcFVF++2xOEzYKH+kboOjsmFRO+ahTAQ==", // 加密视频ID
        "item_title": "无敌战神",          //短视频标题
        "item_cover": "xxx",              //短视频封面（目前只有抖音端发布的短视频才有封面地址）
        "item_addr": "xxx",               //短视频播放地址（目前只有抖音端发布的短视频才有播放地址）
        "item_aweme_shortid":"今天又明天",  //短视频作者对应的抖音号
        "item_aweme_type":"1",            //短视频作者对应的类型，1:企业号 0:个人号
        "item_aweme_name":"xxx",          //短视频作者的昵称
        "item_aweme_avatar":"xxx",        //短视频作者头像地址
        "item_duration":"449",            //短视频时长，单位秒
        "item_create_time":"1679241689",  //短视频创建时间，时间戳形式
        "item_last_frame_watch_cnt":2,    //短视频最后一帧观看完成次数
        "item_completion_rate":"10%",     //短视频完播率(短视频最后一帧观看完成次数/短视频播放次数)
        "item_comment_count":"1",         //短视频评论次数
        "item_like_count":"1",            //短视频点赞次数
        "item_share_count":"1",           //短视频分享次数
        "item_vv":"20",                   //短视频播放次数
        "mp_show_pv":"2",                 //小程序曝光次数
        "mp_click_pv":"2",                //小程序点击次数（该指标后续不再提供，可以参考 mp_drainage_pv 指标）
        "mp_drainage_pv":"2",             //进入小程序次数
        "item_uv":"20",                   //短视频播放人数
        "mp_show_uv":"2",                 //小程序曝光人数
        "mp_click_uv":"2",                //小程序点击人数（该指标后续不再提供，可以参考 mp_drainage_uv 指标）
        "mp_drainage_uv":"2",             //进入小程序人数
        "pay_order_cnt":"1",              //支付订单数
        "pay_customer_cnt":"1",           //支付订单人数
        "pay_order_amount":"1",           //支付订单金额(单位：分)
        "customer_once_price":"1",        //客单价(支付订单金额/支付订单人数 单位：分)
        "order_once_price":"1",           //单均价(支付订单金额/支付订单数 单位：分)
        "refund_customer_cnt":"0",        //发起退款用户数
        "refund_order_cnt":"0",           //发起退款订单数
        "refund_amount":"0"               //发起退款金额(单位：分)
        "bc_relation_bind_type":"0"       //BC账号绑定关系，0-普通号，100-品牌号，200-员工号，300-合作号
      },
      {
        ...
      },
      {
        ...
      }
      ,
      ...
    ],
    "sum":20, //在查询条件范围内发布视频/直播间的总数

    // 此字段只有在查询单个直播间时才有数据返回，用于展示跨天直播的直播间在每一天所产生的详细数据，key:每天整点时间戳，value:直播间数据
    "detail_data":{
      1679241600:{
        //与data_list列表中的元素的字段相同
        ...
      },
      1679328000:{
        ...
      }
    }
  },
  "log_id":xxx
}

{
  "err_no":11009,
  "err_msg":参数不合法或缺少参数,
  "log_id":xxx,
  "data":{
  }
}