TItikhub
Douyin-DouPlus-API

获取 DOU+ 视频排行榜/Get DOU+ video ranking

Changed on

[中文]

用途:

  • 获取 DOU+ 视频排行榜（热门榜），可按时间范围、垂类、榜单维度筛选

参数:

  • time_range: 时间范围，1 / 2 / 3，默认 2
  • tag_id: 垂类ID，默认 634（娱乐）。完整对照：601剧情, 602明星, 606音乐, 607二次元, 608游戏, 609时事, 612舞蹈, 614三农, 615科技, 616财经, 617亲子, 619生活, 621健康, 623情感, 624文化, 625职场, 626教育, 627摄影, 628美食, 629旅行, 631时尚, 633体育, 634娱乐, 635汽车
  • dim_type: 榜单维度，默认 5。1=低粉爆款, 2=高完播率, 3=高点赞率, 4=高涨粉率, 5=热度指数
  • adv_id: 广告主ID，可留空

返回:

  • 视频排行榜数据（含作品、作者、各项指标等）

[English]

Purpose:

  • Get the DOU+ video ranking board, filterable by time range, category and dimension

Parameters:

  • time_range: Time range, 1 / 2 / 3, default 2
  • tag_id: Category id, default 634 (Entertainment). Full map: 601 Plot, 602 Star, 606 Music, 607 ACGN, 608 Game, 609 CurrentAffairs, 612 Dance, 614 Agriculture, 615 Sci-Tech, 616 Finance, 617 ParentChild, 619 Life, 621 Health, 623 Emotion, 624 Culture, 625 Office, 626 Education, 627 Photography, 628 Food, 629 Travel, 631 Fashion, 633 Sport, 634 Entertainment, 635 Car
  • dim_type: Ranking dimension, default 5. 1=low-fan hits, 2=high completion, 3=high like-rate, 4=high follower-growth, 5=hotness index
  • adv_id: Advertiser id, optional

Return:

  • Video ranking data (items, authors, metrics, etc.)
post/api/v1/douyin/douplus/fetch_video_ranking

Request

  • Base URL
    https://api.tikhub.io (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Request body

time_rangeinteger nullable

时间范围/Time range: 1 / 2 / 3

tag_idinteger nullable

垂类ID/Category id. 601剧情,602明星,606音乐,607二次元,608游戏,609时事,612舞蹈,614三农,615科技,616财经,617亲子,619生活,621健康,623情感,624文化,625职场,626教育,627摄影,628美食,629旅行,631时尚,633体育,634娱乐,635汽车

dim_typeinteger nullable

榜单维度/Ranking dimension: 1=低粉爆款, 2=高完播率, 3=高点赞率, 4=高涨粉率, 5=热度指数

adv_idstring nullable

广告主ID,可留空/Advertiser id (optional)

Example request

{
  "time_range": 2,
  "tag_id": 634,
  "dim_type": 5
}

Response

Successful Response

codeinteger

HTTP status code | HTTP状态码

request_idstring nullable

Unique request identifier | 唯一请求标识符

messagestring

Response message (EN-US) | 响应消息 (English)

message_zhstring

Response message (ZH-CN) | 响应消息 (中文)

supportstring

Support message | 支持消息

timestring

The time the response was generated | 生成响应的时间

time_stampinteger

The timestamp the response was generated | 生成响应的时间戳

time_zonestring

The timezone of the response time | 响应时间的时区

docsstring nullable

Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接

cache_messagestring nullable

Cache message (EN-US) | 缓存消息 (English)

cache_message_zhstring nullable

Cache message (ZH-CN) | 缓存消息 (中文)

cache_urlstring nullable

The URL to access the cached result | 访问缓存结果的 URL

routerstring

The endpoint that generated this response | 生成此响应的端点

paramsunknown
dataunknown

Changes