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

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

榜单介绍

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

上榜规则

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

榜单规则

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

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

状态码排查

进入【状态码排查工具】

请求地址

GET /discovery/ent/rank/item/

请求头

  • Content-Type: application/json
  • access-token: 调用/oauth/client_token/生成的token，此token不需要用户授权。示例: clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ

请求参数

URL 请求

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

响应参数

参数名称参数类型参数描述参数示例
暂无数据

响应样例

{
  "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
  }
}
诚邀您对本文档易读易用性进行评价
好用
不好用