Get a Douyin Live Room Gift Leaderboard

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

Douyin

Get a Douyin Live Room Gift Leaderboard

Enter a known Douyin live-room ID to get that room’s gift-user ranking — who sent gifts there. Optional rank_type defaults to 30. Not TikTok creator daily ranking, a Streamlabs overlay, a gift price list, or a watch/record player. Pay-per-use, no subscription.

You receive

TikHub returns the gift-user leaderboard Douyin provides for that room_id. Output fields are unpublished, so inspect the payload. It does not send gifts, list gift prices, rank streamers globally, enable viewer ranking, or search rooms. Pay-per-use, no subscription; maximum $0.0015 per call.

Start with your task

Get a Douyin Live Room Gift Leaderboard

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
queryParams`queryParams`	`object`	Required	Required fields `room_id`
room_id`queryParams.room_id`	`string`	Required	Live room room_id. Examples `7356585666190461731`
rank_type`queryParams.rank_type`	`integer`	Optional	Leaderboard type. Default `30`

View raw JSON

{
  "type": "object",
  "required": [
    "queryParams"
  ],
  "properties": {
    "queryParams": {
      "type": "object",
      "required": [
        "room_id"
      ],
      "properties": {
        "room_id": {
          "type": "string",
          "title": "Room Id",
          "examples": [
            "7356585666190461731"
          ],
          "description": "Live room room_id."
        },
        "rank_type": {
          "type": "integer",
          "title": "Rank Type",
          "default": 30,
          "description": "Leaderboard type."
        }
      },
      "additionalProperties": true
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Bring your agent along.
Copy the note below into your agent’s chat. It reuses an existing connection or helps set one up.
Get connected
Start with your task
Tell your agent what you want to accomplish, including any constraints that matter.
Check before you call
I will inspect this tool, confirm the inputs and current cost, and check your authorization before running it. Then I will explain the result and its limits.

You receive

Start with your task

Inputs & outputs

Input schema

Result schema

Bring your agent along.

Start with your task

Check before you call