TikTok Viral 50 Music Chart

omnial/tiktok-app-v3-fetch-music-chart-list

Returns TikTok's Viral 50 music chart in chart order (50 songs in the captured call), with the time the chart was last updated. For each song: its music ID, title, artist name, album, clip length, vocal language label, release date, theme tags, how many videos use the sound, and the linked artist accounts (user ID, sec_uid, handle, display name and verified flag). Only the Viral 50 chart is offered, as one page of 50 with no paging.

activeper callv1

Price

Up to $0.00205 per call; you pay what the call used

The price shown is the price you pay. No monthly minimum. Top-ups start at $5.

Data source

TikTok

Data from TikTok.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/tiktok-app-v3-fetch-music-chart-list" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/tiktok-app-v3-fetch-music-chart-list" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/tiktok-app-v3-fetch-music-chart-list", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/tiktok-app-v3-fetch-music-chart-list", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.00205

Updated: Oct 14, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "scene"
  ],
  "properties": {
    "count": {
      "enum": [
        50
      ],
      "type": "integer",
      "default": 50,
      "description": "Songs per page. Only 50, the whole chart, is offered, and it is the default."
    },
    "scene": {
      "enum": [
        1
      ],
      "type": "integer",
      "description": "Which chart to return. Only 1, the Viral 50 chart, is offered."
    },
    "cursor": {
      "enum": [
        0
      ],
      "type": "integer",
      "default": 0,
      "description": "Start position in the chart. Only 0, the top of the chart, is offered."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "chart_info": {
      "type": "object",
      "properties": {
        "update_time": {
          "type": "number",
          "description": "When the chart was last updated, as a Unix timestamp in seconds."
        }
      }
    },
    "music_list": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "music_info": {
            "type": "object",
            "properties": {
              "album": {
                "type": "string",
                "description": "The album the song is on."
              },
              "title": {
                "type": "string",
                "description": "The song title."
              },
              "author": {
                "type": "string",
                "description": "The artist name as credited on the sound."
              },
              "id_str": {
                "type": "string",
                "description": "The sound's TikTok music ID."
              },
              "artists": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "uid": {
                      "type": "string",
                      "description": "The account's user ID."
                    },
                    "handle": {
                      "type": "string",
                      "description": "The account's handle."
                    },
                    "sec_uid": {
                      "type": "string",
                      "description": "The account's sec_uid."
                    },
                    "nick_name": {
                      "type": "string",
                      "description": "The account's display name."
                    },
                    "is_verified": {
                      "type": "boolean",
                      "description": "Whether TikTok shows the account as verified."
                    }
                  }
                },
                "description": "The TikTok accounts linked to the song's artists; empty or absent when none is linked."
              },
              "duration": {
                "type": "number",
                "description": "Length of the usable sound clip, in seconds."
              },
              "language": {
                "type": "string",
                "description": "The language TikTok labels the vocals with, such as 'English', or 'non_vocal' for an instrumental."
              },
              "theme_tags": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": "string"
                },
                "description": "Mood and occasion tags TikTok gives the song, such as 'Party'; null when it has none."
              },
              "user_count": {
                "type": "number",
                "description": "How many videos use the sound, as TikTok counts them."
              },
              "music_release_info": {
                "type": "object",
                "properties": {
                  "group_release_date": {
                    "type": "number",
                    "description": "The song's release date, as a Unix timestamp in seconds; 0 when TikTok has none."
                  }
                }
              }
            }
          }
        }
      },
      "description": "The chart's songs, in chart order (50 in the capture)."
    },
    "status_code": {
      "type": "number",
      "description": "0 when the lookup succeeded."
    }
  },
  "description": "The Viral 50 chart, as returned after shaping."
}