# TikTok music charts — Top 50, Viral 50

TikHub

TikTok music charts — Top 50, Viral 50.

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use TikTok music charts — Top 50, Viral 50 (tool ID: tikhub.tiktok-app-v3-fetch-music-chart-list). Ask me for the details you need, then show me the result.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

**Job:** [Search TikTok](https://scrollport.com/tools/tiktok-api)

**Current price:** $0.0025/request

**Availability:** Ready to run

## Tool details

**About this tool**

TikTok music charts — Top 50, Viral 50. Retrieve one bounded result or page. Pagination is explicit; each follow-up page is another call. The catalog price is the maximum per request. Quotes use the selected limits. Completed requests cost their quote, including valid empty pages and no-match answers. Failed requests are uncharged. Read public social data without a connected social account. Results include reviewed business data and available pagination. The worked example shows selected fields from a recorded response, with at most one selected item from each list.

**Inputs and outputs**

### Input

`count` integer · optional

Number per page (max 50)

minimum: 1 · maximum: 20

`cursor` integer · optional

Pagination cursor

minimum: 0 · maximum: 1000000

`scene` integer · optional

Chart type (0: Top 50, 1: Viral 50)

minimum: 0 · maximum: 1000000

### Output

`data` object

Returned data value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "tikhub.tiktok-app-v3-fetch-music-chart-list",
  "input": {
    "count": 5,
    "scene": 0,
    "cursor": 0
  }
}
```

### Output

```
{
  "data": {
    "chart_info": {
      "id": "7245341979050396417"
    },
    "music_list": [
      {
        "id": "7245341979050396417",
        "music_info": {
          "id": "7675366858590144513",
          "album": "Summer Bummer (Lights On)",
          "title": "Summer Bummer (Lights On)",
          "author": "RhyRhy",
          "status": 1,
          "artists": [
            {
              "handle": "rhy0n",
              "status": 1,
              "sec_uid": "MS4wLjABAAAAoT6ylsx_iEoJ2lAB-9SZhZYJN4F81liR9jWTL7KkZeZC2XaBtWwL50LmBl-I_5Gx"
            }
          ],
          "user_count": 566,
          "matched_song": {
            "id": "7675369571927263248",
            "title": "Summer Bummer (Lights On)",
            "author": "RhyRhy"
          }
        }
      }
    ]
  }
}
```

**Errors and limitations**

- `invalid_input`: The lookup fields or limits are invalid.example: {"scene":0,"cursor":0,"count":5}
- `upstream_error`: The provider could not complete a verified result; the wallet was not charged.Check the documented fields and contact Scrollport support with the run ID if needed.

---

Canonical page: https://scrollport.com/tools/providers/tikhub/tiktok-app-v3-fetch-music-chart-list