获取用户视频情况

Scope: data.external.user 需要申请权限需要用户授权该接口用于获取用户视频情况。

注：用户首次授权应用后，需要第二天才会产生全部的数据；

数据都会在不晚于 12:00 刷新，如果没获取到可以多次尝试；若仍然异常，请提交工单处理。

每日新增作品数计算公式：今日累计 - 截止昨日累计 = 今日新增，需考虑删除视频造成的数量影响。例如：如果 26 号的视频总量为 10，27 号发布一条视频再删除一条以前的视频，那么 27 号的视频新增数量统计为 0。

返回的数据以用户使用抖音 app 发送且通过审核为准。例如：某用户发布 10 条视频（截至今天）只有 7 条视频是通过抖音 APP 发送，剩余视频通过抖音极速版 APP 发送，则这部分视频不计入视频统计范围。

状态码排查

进入【状态码排查工具】

请求地址

GET /data/external/user/item/

请求头

Content-Type: application/json
access-token: 调用/oauth/access_token/生成的 token，此 token 需要用户授权。示例: act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka27L56lr

请求参数

URL 请求

参数名称	参数类型	参数描述	参数示例	是否必填

暂无数据

响应参数

参数名称	参数类型	参数描述	参数示例	是否必填

暂无数据

响应样例

{
  "data": {
    "description": "",
    "error_code": "0",
    "result_list": [
      {
        "date": "yyyy-MM-dd",
        "new_issue": "200",
        "new_play": "200",
        "total_issue": "200"
      }
    ]
  },
  "extra": {
    "description": "",
    "error_code": "0",
    "logid": "202008121419360101980821035705926A",
    "now": "1597213176393",
    "sub_description": "",
    "sub_error_code": "0"
  }
}

响应错误样例

{
  "data": {
    "description": "Parameter error",
    "error_code": 2100005
  },
  "extra": {
    "logid": "2020070614111601022506808001045D59",
    "now": 1594015876138
  }
}

诚邀您对本文档易读易用性进行评价

好用

不好用