获取抖音影视综榜单版本_

接口说明

Scope: discovery.ent

需要申请权限。路径：抖音开放平台控制台 > 应用详情 > 能力管理 > 数据权限。

不需要用户授权该接口用于查询抖音影视综榜单数据，可以根据版本返回往期榜单。返回的内容按热度降序排列，电影榜最多返回top30、电视剧榜和综艺榜最多返回top10。

榜单介绍

榜单影响力值根据影片在抖音中的相关数据，通过多维度的算法计算，综合反映影片在抖音平台上的热度。

上榜规则

电影上映时间在当前时间的前60后45天。
电视剧上映时间在当前时间的前60天后30天。
综艺上映时间在当前时间的前90天后30天。（除部分全年持续播出综艺）

榜单规则

电影榜/电视剧榜/综艺榜分为“本周榜单”和“往期榜单”两部分。

本周榜单：展示本周上榜影片的动态变化，热度值在每天的12:00~24:00间，每日更新一次。
往期榜单：每周日最后一张榜单（次日周一12:00发布），即当周最终上榜的影片排名及数据详情，进入往期榜单。
榜单统计周期：周一00:00-周日24:00。

基本信息

名称	描述
HTTP URL	https://open.douyin.com/discovery/ent/rank/version/
HTTP Method	GET
Scope	discovery.ent

请求头

名称	字段类型	是否必填	示例	描述
access-token	String	是	clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ	调用https://open.douyin.com/oauth/client_token/生成的token
content-type	String	是	application/json	固定值"application/json"

请求参数

Query

名称	字段类型	是否必填	示例	描述
count	Int64	否	10	每页数量
cursor	Int64	否	1	分页游标, 第一页请求cursor是0, response中会返回下一页请求用到的cursor, 同时response还会返回has_more来表明是否有更多的数据。
type	Int64	否	1	榜单类型： * 1 - 电影 * 2 - 电视剧 * 3 - 综艺

请求示例

curl --location --request GET 'https://open.douyin.com/discovery/ent/rank/version/?cursor=4500000590208066065&count=7261018853479395646&type=5485147713039669839&access_token=oQs5zWtVDN' \
--header 'content-type: application/json' \
--header 'access-token: 0801121846735352506a356a6' \

响应参数

Body

名称	字段类型	是否必填
extra	Struct	是
data	Struct	否
extra_body	Struct	否

响应示例

正常响应示例

{
  "data": {
    "cursor": "<nil>",
    "description": "",
    "error_code": "0",
    "has_more": "<nil>",
    "list": [
      {
        "active_time": "2020-03-30 12:00:00",
        "end_time": "2020-03-30 00:00:00",
        "start_time": "2020-03-23 00:00:00",
        "type": "1",
        "version": "18"
      }
    ]
  },
  "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
  }
}

错误码

http状态码	错误码	错误码描述	排查建议
200	28001005	系统内部错误，请重试	请求重试，若依然无解请向平台提交反馈
200	28001003	access_token无效	重新请求生成access_token
200	28001008	access_token过期,请刷新或重新授权	重新请求生成access_token
200	28001016	当前应用已被封禁或下线	clientKey被封禁或者下线
200	28001006	网络调用错误，请重试	重试即可
200	28001014	应用未授权任何能力	确认应用是否授权能力
200	28001018	应用未获得该能力	开通相关能力
200	28003017	quota已用完	联系平台处理
200	28001019	应用该能力已被封禁	该能力被封禁，联系平台处理
200	28001007	参数不合法	根据错误信息检查请求参数是否填写正常

获取抖音影视综榜单版本在线调试