接口说明

该接口用于提供给开发者查询中介下视频的明细数据（按视频维度统计），截止查询发生时刻，视频的收益每日明细数据，注意不同类型任务平台结算数据产出时间不确定，注意T+1查询昨日数据
开发者在小程序推广计划中创建推广任务后，可查询相应任务的投稿视频数据

使用限制

只能查询到和投稿自己任务的达人视频数据。

基本信息

名称	描述
HTTP URL	https://open.douyin.com/api/match/v2/taskbox/query_task_video_daily_data/
HTTP Method	POST
Scope	match_taskbox.default.data_permission
权限要求	服务商代调用场景下，需商家授予数据分析权限。任务台

请求参数

请求头

access-token必填String

当非服务商时，调用https://open.douyin.com/oauth/client_token/生成的token
当服务商时，调用https://open.douyin.com/api/tpapp/v2/auth/get_auth_token/生成的token

content-type必填String

示例：application/json

固定值"application/json"

Body

billing_date必填String

示例：2023-10-01

计费日期"2023-10-01"

page_num必填Int32

示例：1

页号

page_size必填Int32

示例：10

页大小，不能超过10000

video_publish_end_time必填Int64

示例：1684080001

视频发布的结束时间，秒级时间戳
视频发布的起始时间与视频发布的结束时间相差不能超过30天

video_publish_start_time必填Int64

示例：1684080000

视频发布的起始时间，秒级时间戳
距离当前日期不能超过90天

agency_client_keyString

示例：awck97rsdsd****wd14

合作的撮合中介的网站应用key

douyin_idString

示例：A7932234

视频作者抖音号

请求示例
curl --location --request POST 'https://open.douyin.com/api/match/v2/taskbox/query_task_video_daily_data/' \
--header 'content-type: application/json' \
--header 'access-token: 0801121846735352506a356a6' \
--data '
  {
    "video_publish_start_time":1683689418,
    "video_publish_end_time": 1684380619,
    "page_num": 1,
    "page_size": 10,
    "douyin_id":"A221321",
    "billing_date": "2023-10-01",
    "agency_client_key":"awck97******wwd14"    
  }
'

响应参数

Body展开全部子属性

err_msg必填String

示例：success

错误信息

err_no必填Int32

示例：0

错误码，0 是成功，其它为异常

log_id必填String

示例：202008121419360101980821035705926A

标识请求的唯一id，在接口异常时用于问题排查

dataStruct

展开子属性

响应示例
正常响应示例异常响应示例
{
  "err_no": 0,
  "err_msg": "success",
  "log_id": "202008121419360101980821035705926A",
  "data": {
    "video_daily_data_list": [
      {
        "ActiveCnt1d": 0,
        "AdShareCost1d": 0,
        "Author": "nice1",
        "BillingGMV1d": 0,
        "BillingRefundGMV1d": 0,
        "ClientName": "撮合网站应用015",
        "FeedAdShareCost1d": 0,
        "DouyinID": "31626424566",
        "ExpectedProfit": 0,
        "GMV1d": 0,
        "MicroAppTitle": "行业ITC",
        "PublishTime": 1692878009,
        "RefundGMV1d": 0,
        "TaskId": 7270785143852253000,
        "TaskName": "小程序B的支付分成绑定任务R4",
        "VideoId": 7270855478333246000,
        "VideoLink": "https://www.iesdouyin.com/share/video/7270855478333246754/?region=CN&mid=7270855692553079609",
        "VideoTitle": "hello",
        "date": "2023-08-25"
      }
    ]
  }
}

切换单列布局

错误码

HTTP 状态码	错误码	错误码描述	排查建议
200	0	success	接口请求成功，无需排查
200	28001005	系统内部错误，请重试	请求重试，若依然无解请向平台提交反馈
200	28001007	参数不合法	按err_msg进行自查
200	28013009	开始时间不能早于3个月
200	28013010	单页数量不能超过10000
200	28003018	请求频率过高	接口调用QPS不能超过10
200	28001018	应用未获得该能力	请服务商前往「服务商平台-设置-权限设置」申请该小程序的「数据分析」权限

开发者文档

查询任务台任务投稿视频数据（明细）-v2

建议接入账单接口：查询推广视频数据下载链接

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

查询任务台任务投稿视频数据（明细）-v2在线调试

建议接入账单接口：查询推广视频数据下载链接

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

查询任务台任务投稿视频数据（明细）-v2