Douyin Fetch Music Hot Search List

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

SocialEntertainmentAudio
2.07 credits/call

Pricing

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

ParameterTypeRequiredDescriptionDefault
cursorstringNo游标/Cursor0
chart_typestringNo榜单类型/Chart typehot

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_music_hot_search_list' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "chart_type": "hot",
    "cursor": "0"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.