# Kworb API: Get YouTube music chart

> Gets Kworb's latest YouTube music chart, worldwide or for one country, ordered by daily views. The worldwide chart covers the past 24 hours. Country charts report daily track streams.

Unofficial. Not affiliated with or endorsed by Kworb.

- Page: https://fous.com/methods/kworb.net/get-youtube-music-chart
- Method: `kworb.net/get_youtube_music_chart`, version 1
- Website: kworb.net
- Returns: chart date, country, entries with position, artist, song, daily views, total views, video link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `country` | string | no | `"global"` | Country name or two-letter code, or global for the worldwide chart. Example: United States. Default "global". |
| `max_results` | integer | no | `10` | Most chart entries to return (up to 200). Example: 25. Default 100. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "country": "global",
  "max_results": 10
}
```

Its output:

```json
{
  "country": "Worldwide",
  "entries": [
    {
      "artist": "Shakira, Burna Boy",
      "page_url": "https://kworb.net/youtube/video/fcnDmrtj6Sk.html",
      "position": 1,
      "song_title": "Dai Dai",
      "video_link": "https://www.youtube.com/watch?v=fcnDmrtj6Sk",
      "daily_views": 4286608,
      "total_views": 1279268144
    },
    {
      "artist": null,
      "page_url": "https://kworb.net/youtube/video/p1potl1sbjA.html",
      "position": 2,
      "song_title": "Ramayana: Ravana Tandav (Song) | Namit M, Nitesh T | Ranbir, Yash | AR Rahman, Vishal D, Kumar V",
      "video_link": "https://www.youtube.com/watch?v=p1potl1sbjA",
      "daily_views": 4049206,
      "total_views": 17913901
    },
    {
      "artist": null,
      "page_url": "https://kworb.net/youtube/video/roHWN9fL2SM.html",
      "position": 3,
      "song_title": "NMIXX(엔믹스) “긴 소원 (Birthday Wish)” M/V",
      "video_link": "https://www.youtube.com/watch?v=roHWN9fL2SM",
      "daily_views": 3884203,
      "total_views": 18275378
    }
  ],
  "chart_date": "2026-10-23",
  "chart_page_url": "https://kworb.net/youtube/"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"kworb.net/get_youtube_music_chart","input":{"country":"global","max_results":10}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What are the top 25 songs on YouTube worldwide right now by daily views?
- Show me the current YouTube music chart for Japan with the top 50 tracks.
- I need the latest global YouTube chart ordered by views from the last 24 hours, just the top 10.
- On kworb, what's trending on the YouTube music chart in Brazil today?
- Pull the YouTube daily music chart for the United States, up to 100 entries, including video links.

## Input schema

```json
{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "default": "global",
      "description": "Country name or two-letter code, or global for the worldwide chart. Example: United States."
    },
    "max_results": {
      "type": "integer",
      "default": 100,
      "maximum": 200,
      "minimum": 1,
      "description": "Most chart entries to return (up to 200). Example: 25."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "chart_date",
    "country",
    "chart_page_url",
    "entries"
  ],
  "properties": {
    "country": {
      "type": "string"
    },
    "entries": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "artist": {
            "type": [
              "string",
              "null"
            ]
          },
          "page_url": {
            "type": "string"
          },
          "position": {
            "type": "integer"
          },
          "song_title": {
            "type": [
              "string",
              "null"
            ]
          },
          "video_link": {
            "type": [
              "string",
              "null"
            ]
          },
          "daily_views": {
            "type": "integer"
          },
          "total_views": {
            "type": [
              "integer",
              "null"
            ]
          }
        }
      }
    },
    "chart_date": {
      "type": "string"
    },
    "chart_page_url": {
      "type": "string"
    }
  }
}
```

## See more

- [Kworb API: Get Spotify daily chart](https://fous.com/methods/kworb.net/get-spotify-daily-chart.md): Returns the latest published Spotify daily Top 200 chart from Kworb for a country or worldwide, with rankings and stream counts.
- [Kworb API: Get artist stream counts](https://fous.com/methods/kworb.net/get-artist-stream-counts.md): Gets an artist's tracked Spotify streaming totals, most-streamed songs and albums from Kworb.
- [YouTube API: List top songs chart](https://fous.com/methods/youtube.com/list-top-songs.md): Lists the latest weekly YouTube Music Top Songs chart for a country or globally, with ranks, weekly views and video links.
- [Apple API: List top charts](https://fous.com/methods/music.apple.com/list-top-charts.md): Lists the current top songs, albums, or music videos on Apple Music for a country, in chart order. Countries without an Apple Music chart return no results.
- [Deezer API: List top charts](https://fous.com/methods/deezer.com/list-top-charts.md): Lists current worldwide top tracks, albums or artists on Deezer in chart order, or tracks from Deezer's official Top <country> playlist.
- [JustWatch API: List streaming chart titles](https://fous.com/methods/justwatch.com/list-streaming-charts.md): Lists titles on JustWatch's daily streaming chart for a country, optionally limited to one streaming service.
- [Billboard API: Get chart](https://fous.com/methods/billboard.com/get-chart.md): Gets the ranked entries and chart history for a Billboard chart. It returns the latest published week, or the week that contains a given date. A date between published weeks selects the next published week.
- [Google API: List Google Play top charts](https://fous.com/methods/play.google.com/list-top-charts.md): Lists ranked Android apps or games from the Google Play top free, top paid or top grossing chart for a country and category.
- [All Kworb methods](https://fous.com/methods/kworb.net.md)
