Douyin Fetch Douplus Video Ranking

2.07 credits/call
ae_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.

VideoSocial
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYes获取 DOU+ 视频排行榜的请求体对象,包含时间范围(time_range)、内容垂类(tag_id)、榜单维度(dim_type)及可留空的广告主 ID(adv_id),用于指定榜单查询条件。—
request_body.adv_idstring | nullNo广告主ID,可留空/Advertiser id (optional)""
request_body.tag_idinteger | nullNo垂类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_typeinteger | nullNo榜单维度/Ranking dimension: 1=低粉爆款, 2=高完播率, 3=高点赞率, 4=高涨粉率, 5=热度指数5
request_body.time_rangeinteger | nullNo时间范围/Time range: 1 / 2 / 32

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.