Douyin Fetch Music Hot Search List
Retrieve Douyin music chart data by chart type, with cursor-based pagination. Inputs (both optional strings): - chart_type: "hot" for the hot chart (default), "trending" for the rising chart, or "original" for the original music chart. - cursor: Pagination cursor; defaults to "0" for the initial page. For subsequent pages, pass the cursor returned by the previous response and keep the same chart_type. Returns: Music chart data for the requested page. The documented pagination information includes a next cursor and has_more, which indicates whether more data is available. The detailed structure of individual music entries is not specified. Example: {"chart_type":"hot","cursor":"0"}. This tool retrieves charts; it does not accept music search keywords.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.
Each call has a fixed charge and retrieves one page of music chart data for the selected chart type. Each call to retrieve a subsequent page using a cursor is charged separately.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
cursor | string | No | 游标/Cursor | 0 |
chart_type | string | No | 榜单类型/Chart type | hot |
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_music_hot_search_list' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"chart_type": "hot",
"cursor": "0"
}
}'{
"code": 200,
"data": {
"cursor": 0,
"extra": {
"fatal_item_ids": [],
"logid": "20261109235913EFDD45D75B03017D82BF",
"now": 1794239953000
},
"has_more": 0,
"log_pb": {
"impr_id": "20261109235913EFDD45D75B03017D82BF"
},
"music_list": [
{
"can_background_play": true,
"has_copyright": true,
"heat": 19951092,
"music_info": {
"album": "你的不经意",
"author": "Fozik佛子克",
"cover_hd": {
"height": 720,
"uri": "tos-cn-v-2774c002/o4DihNWrrtAiP9ZAmWAcWYDTBaE4EzIQgAaiT",
"url_list": [],
"width": 720
},
"cover_large": {
"height": 720,
"uri": "tos-cn-v-2774c002/o4DihNWrrtAiP9ZAmWAcWYDTBaE4EzIQgAaiT",
"url_list": [],
"width": 720
},
"id": 7699717253151558410,
"title": "你的不经意"
}
}
],
"status_code": 0
},
"docs": "https://api.tikhub.io/#/Douyin-App-V3-API/fetch_music_hot_search_list_api_v1_douyin_app_v3_fetch_music_hot_search_list_get",
"message": "Request successful. This request will incur a charge."
}This example shows part of the response. Copied content is valid JSON.

