Douyin tools

Douyindouyin_music_hot_search_list

Douyin music rankings

Get Douyin music rankings by board type, including tracks and pagination.

Start with your agent

Claude CodeCodexCursor

Download and install the dedicated Mouter Skill for “Douyin music rankings”: https://mouter.ai/skills/douyin_music_hot_search_list.zip

Pricing

How credits work

0.01 credits per call

Each additional page is billed as a separate call.

Usage example

Agent

Example input

Use douyin_music_hot_search_list. Look up Douyin music rankings and summarize popular music charts and ranks. Confirm inputs and estimated cost before running.

Example output

Example only: Douyin music rankings has not been run. Once a task succeeds, its result contains these fields:

  1. platformtext
  2. charttext
  3. itemslist: music, heat, trend_code
  4. paginationobject: has_more, next_cursor, total
  5. updated_atnumber
  6. retrieved_atnumber

Values depend on your input. The matching JSON example structure is in the API tab.

Continue this example

For the first batch, omit cursor. When pagination.has_more indicates more results and pagination.next_cursor is present, pass the returned pagination.next_cursor as cursor in the next call. Keep the original identifiers, filters and ordering unchanged. Each request retrieves one batch. Illustrative requests and response fragment; no calls are executed.

1. Initial request

{
  "name": "douyin_music_hot_search_list",
  "arguments": {}
}

2. Returned continuation

{
  "pagination": {
    "next_cursor": "<NEXT_CURSOR>",
    "has_more": true
  }
}

3. Follow-up request

{
  "name": "douyin_music_hot_search_list",
  "arguments": {
    "cursor": "<NEXT_CURSOR>"
  }
}
  • Getting started: start with the current defaults and adjust the query scope for the task. Adjust continuation cursor, ranking type as needed.

FAQ

How do I look up a result with Douyin music rankings?

Douyin music rankings: Getting started: start with the current defaults and adjust the query scope for the task. Adjust continuation cursor, ranking type as needed.

Which result details can I use from Douyin music rankings?

Get Douyin music rankings by board type, including tracks and pagination. The result includes chart, items, pagination, updated_at. Read result.items[]: heat, trend_code. result.retrieved_at records retrieval time; content publication times are separate source fields. Optional fields depend on what the source returns; retain null or missing values when combining results.

Which result types or modes does Douyin music rankings support?

Douyin music rankings: chart: values hot / trending / original; default "hot".

How do I retrieve more results from Douyin music rankings?

Douyin music rankings: For the first batch, omit cursor. When pagination.has_more indicates more results and pagination.next_cursor is present, pass the returned pagination.next_cursor as cursor in the next call. Keep the original identifiers, filters and ordering unchanged. Each request retrieves one batch.

How is Douyin music rankings billed for each request?

Published reference rates: Standard rate: 0.01 credits · Per call. Each additional page is billed as a separate call. Final charges use your account’s rates and actual usage.