获取抖音电影榜、抖音电视剧榜、抖音综艺榜_

接口说明

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/item/
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

名称	字段类型	是否必填	示例	描述
type	Int64	否	1	榜单类型： * 1 - 电影 * 2 - 电视剧 * 3 - 综艺
version	Int64	否	4212256867759156475	榜单版本：空值默认为本周榜单

请求示例

curl --location --request GET 'https://open.douyin.com/discovery/ent/rank/item/?type=4212256867759156475&version=7419484119538132598&access_token=it8j3M15Fi' \
--header 'content-type: application/json' \
--header 'access-token: 0801121846735352506a356a6'

响应参数

Body

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

响应示例

正常响应示例

{
  "data": {
    "active_time": "2020-03-31 12:00:00",
    "description": "",
    "error_code": "0",
    "list": [
      {
        "actors": [
          "[徐峥 袁泉 沈腾 吴云芳 陈奇 黄梅莹 欧丽娅 贾冰 郭京飞]"
        ],
        "areas": [
          "[中国]"
        ],
        "directors": [
          "[徐峥]"
        ],
        "discussion_hot": "789200",
        "hot": "1.361e+06",
        "id": "6399487713065566465",
        "influence_hot": "789200",
        "maoyan_id": "1250696",
        "name": "囧妈",
        "name_en": "Lost in Russia",
        "poster": "https://p3-dy.bytecdn.cn/obj/compass/9ac412ae054b57f69c0967a8eb5e25c9",
        "release_date": "2020-01-25",
        "search_hot": "684900",
        "tags": [
          "[喜剧]"
        ],
        "topic_hot": "684900",
        "type": "1"
      }
    ]
  },
  "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	参数不合法	根据错误信息检查请求参数是否填写正常

获取抖音电影榜、抖音电视剧榜、抖音综艺榜在线调试