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.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Country optional
country Country name or two-letter code, or global for the worldwide chart. Example: United States.
global
Default
global.- Max Results optional
max_results Most chart entries to return (up to 200). Example: 25.
10
Whole number from 1 to 200. Default
100.
Input as JSON
{ "country": "global", "max_results": 10}Output
{ "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/" }Code
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}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "kworb.net/get_youtube_music_chart" , "input": { "country": "global", "max_results": 10 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "kworb.net/get_youtube_music_chart" , "input": { "country": "global", "max_results": 10 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run kworb.net/get_youtube_music_chart# with {"country":"global","max_results":10}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "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
{ "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" } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
kworb.net/get_youtube_music_chart- Returns
- chart date, country, entries with position, artist, song, daily views, total views, video link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method kworb.net/get_youtube_music_chart with the inputs above.
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.
See more
All Kworb methodsReturns the latest published Spotify daily Top 200 chart from Kworb for a country or worldwide, with rankings and stream counts.
kworb.net/get_spotify_daily_chartGets an artist's tracked Spotify streaming totals, most-streamed songs and albums from Kworb.
kworb.net/get_artist_stream_countsLists the latest weekly YouTube Music Top Songs chart for a country or globally, with ranks, weekly views and video links.
youtube.com/list_top_songsLists 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.
music.apple.com/list_top_chartsLists current worldwide top tracks, albums or artists on Deezer in chart order, or tracks from Deezer's official Top <country> playlist.
deezer.com/list_top_chartsLists titles on JustWatch's daily streaming chart for a country, optionally limited to one streaming service.
justwatch.com/list_streaming_chartsGets 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.
billboard.com/get_chartLists ranked Android apps or games from the Google Play top free, top paid or top grossing chart for a country and category.
play.google.com/list_top_charts