Douyin Fetch Douplus Video Ranking
## Purpose Retrieve the Douyin DOU+ video ranking board to discover popular videos and compare ranking dimensions within a content category and time-range code. ## Inputs Provide a required `request_body` object. All fields inside it are optional and nullable; `{}` uses the documented defaults. - `time_range`: Time-range code, documented as 1, 2, or 3; default 2. The corresponding calendar durations are not specified. - `tag_id`: Content category ID; default 634 (Entertainment). Categories: 601 Drama; 602 Celebrities; 606 Music; 607 Anime/comics/games; 608 Gaming; 609 Current affairs; 612 Dance; 614 Agriculture and rural life; 615 Science and technology; 616 Finance; 617 Parenting; 619 Lifestyle; 621 Health; 623 Relationships; 624 Culture; 625 Workplace; 626 Education; 627 Photography; 628 Food; 629 Travel; 631 Fashion; 633 Sports; 634 Entertainment; 635 Automotive. - `dim_type`: Ranking dimension; default 5. Values: 1 = breakout videos from low-follower accounts; 2 = high completion rate; 3 = high like rate; 4 = high follower-growth rate; 5 = popularity index. - `adv_id`: Optional advertiser ID string; defaults to an empty string and may be left empty. ## Result Returns ranking data with video, author, and metric information when available. The response's `data` payload has no fixed documented field structure and may be null. The tool retrieves rankings; it does not launch promotions or modify campaigns.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
Each call has a fixed charge of 2.07 credits. Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | 获取 DOU+ 视频排行榜的请求体对象,包含时间范围(time_range)、内容垂类(tag_id)、榜单维度(dim_type)及可留空的广告主 ID(adv_id),用于指定榜单查询条件。 | — |
request_body.adv_id | string | null | No | 广告主ID,可留空/Advertiser id (optional) | "" |
request_body.tag_id | integer | null | No | 垂类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汽车 | 634 |
request_body.dim_type | integer | null | No | 榜单维度/Ranking dimension: 1=低粉爆款, 2=高完播率, 3=高点赞率, 4=高涨粉率, 5=热度指数 | 5 |
request_body.time_range | integer | null | No | 时间范围/Time range: 1 / 2 / 3 | 2 |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_douyin_fetch_douplus_video_ranking' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"dim_type": 3,
"tag_id": 617,
"time_range": 2
}
}
}'{
"code": 200,
"data": {
"code": 0,
"data": [
{
"author": {
"followerCount": 603,
"nickname": "感叹号!(求关注版)"
},
"cover": "https://p11-sign.douyinpic.com/tos-cn-p-0015/oAf7MQAfI6VC9BBIQCk6AEXnfy8YhB8QipAckB~noop.jpeg?x-expires=1794387600&x-signature=NB%2F8UMz1Y2bPrbFvEMLDCieNJVg%3D&from=3751895876",
"createTime": "1793361032",
"isPhoto": false,
"itemId": "7702426984328795081",
"title": "女性安全,这件事真的需要被看见! #真实生活分享计划 #女性安全 #女孩保护自己 #提高警惕 #安全科普"
}
],
"msg": "success"
},
"docs": "https://api.tikhub.io/#/Douyin-DouPlus-API/fetch_video_ranking_api_v1_douyin_douplus_fetch_video_ranking_post",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"request_id": "531080ef-f86f-4b90-b0db-40b12f2de5c2"
}This example shows part of the response. Copied content is valid JSON.

