查询视频任务相关实时汇总数据
收藏接口说明
该接口用于提供给撮合中介查询归属于撮合中介的小程序推广计划投稿视频的任务关联的累计交易金额
使用限制
- 撮合中介仅能查询到撮合中介自己名下团长有绑定关系的达人的视频数据
- 撮合中介仅能查到达人和团长处于绑定期间内产生的达人投稿视频数据
- 移动/网站应用路径：抖音开放平台 > 控制台 > 移动应用/网站应用 > 能力管理 > 特殊权限
- 不需要用户授权
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/api/match/v2/taskbox/agency_query_video_sum_data/ |
| HTTP Method | POST |
| Scope | taskbox.agent.admin |
| 权限要求 | 移动/网站应用路径：抖音开放平台 > 控制台 > 移动应用/网站应用 > 能力管理 > 特殊权限 不需要用户授权 |
请求参数
请求头
access-token必填String
示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
示例：application/json
固定值"application/json"
Body
video_ids必填Array<Int64>
示例：[8531760050956799274]
视频ID，单次查询数量不可超过20个，可以通过查询视频状态-v2接口获得。
请求示例
curl --location --request POST 'https://open.douyin.com/api/match/v2/taskbox/agency_query_video_sum_data/' \ --header 'access-token: 0801121846735352506a356a6' \ --header 'content-type: application/json' \ --data '{"video_ids":[8531760050956799274]}'
响应参数
Body展开全部子属性
data必填Struct
展开子属性
err_msg必填String
示例："access_token无效"
错误描述
err_no必填Int32
示例：28001003
错误码
log_id必填String
示例："202405291440576E078D8757B9"
日志id
响应示例
正常响应示例异常响应示例
{ "log_id": "202008121419360101980821035705926A", "err_no": 0, "err_msg": "", "data": { "data": [ { "billing_gmv_td": 4085486602577675300, "biling_refund_gmv_td": 6271644340633502000, "video_id": 3386494927132716000, "task_id": 6671517479483389000, "agent_id": "TPRZpIPavK", "publish_time": 1685664000 } ] } }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 0 | success | 无 |
| 200 | 28003018 | 请求频率过高 | 接口调用qps不能超过5 |
| 200 | 28001007 | 1. 参数不合法
2. 以下视频未授权、暂不支持查询\n702345xxxxxx | 1. 视频ID数量是否大于0小或等于20
2. 是否具有视频查询权限 |
| 200 | 28001005 | 系统内部错误，请重试 | 无 |
