--- title: "获取 DOU+ 视频排行榜/Get DOU+ video ranking" method: POST path: "/api/v1/douyin/douplus/fetch_video_ranking" tags: ["Douyin-DouPlus-API"] --- # 获取 DOU+ 视频排行榜/Get DOU+ video ranking `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) - URL: `https://api.tikhub.io/api/v1/douyin/douplus/fetch_video_ranking` - Auth: HTTP bearer # [中文] ### 用途: - 获取 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.) ## Request body - VideoRankingRequest: DOU+ 视频排行榜请求模型 DOU+ Video Ranking Request Model - `time_range` integer, nullable: 时间范围/Time range: 1 / 2 / 3 - `tag_id` integer, 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_type` integer, nullable: 榜单维度/Ranking dimension: 1=低粉爆款, 2=高完播率, 3=高点赞率, 4=高涨粉率, 5=热度指数 - `adv_id` string, nullable: 广告主ID,可留空/Advertiser id (optional) ## Response `200` Successful Response - ResponseModel - `code` integer: HTTP status code | HTTP状态码 - `request_id` string, nullable: Unique request identifier | 唯一请求标识符 - `message` string: Response message (EN-US) | 响应消息 (English) - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文) - `support` string: Support message | 支持消息 - `time` string: The time the response was generated | 生成响应的时间 - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳 - `time_zone` string: The timezone of the response time | 响应时间的时区 - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接 - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English) - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文) - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL - `router` string: The endpoint that generated this response | 生成此响应的端点 - `params` unknown - `data` unknown ## Other responses - `422`: Validation Error ## Changes - **2026-10-08** `96a122a5f220`: 2 info - added the optional property `detail/items/ctx` to the response with the `422` status - added the optional property `detail/items/input` to the response with the `422` status - **2026-09-01** `50f9ec6e1cd3`: 1 info - endpoint added [Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/douyin/douplus/fetch_video_ranking/post.md) --- [API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)