Kworb API: Get Spotify daily chart
Returns the latest published Spotify daily Top 200 chart from Kworb for a country or worldwide, with rankings and stream counts.
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 country code, or global for the worldwide chart. Example: United States.
global
Default
global.- Max Results optional
max_results How many top-ranked songs to include, from 1 to 200. Example: 20.
20
Whole number from 1 to 200. Default
200.
Input as JSON
{ "country": "global", "max_results": 20}Output
{ "country": "Global", "entries": [ { "artist": "Tate McRae", "position": 1, "song_url": "https://kworb.net/spotify/track/2sFepQNyl1WjpROruP8bJ0.html" , "song_title": "Housewife", "daily_streams": 7122640, "days_on_chart": 6, "peak_position": 1, "featured_artists": null, "seven_day_streams": 31916943, "change_since_yesterday": "0", "total_streams_on_chart": 31916943, "change_in_daily_streams": 774292 }, { "artist": "KAROL G", "position": 2, "song_url": "https://kworb.net/spotify/track/3h5T5JypYU7huFiVYhv1dr.html" , "song_title": "BbY WOW", "daily_streams": 5095930, "days_on_chart": 71, "peak_position": 1, "featured_artists": "Judeline, rusowsky", "seven_day_streams": 36006626, "change_since_yesterday": "0", "total_streams_on_chart": 337422480, "change_in_daily_streams": 147171 }, { "artist": "ADÉLA", "position": 3, "song_url": "https://kworb.net/spotify/track/70cHKK8bHAfJrOGVnfRG9J.html" , "song_title": "Nicole Kidman", "daily_streams": 5023994, "days_on_chart": 48, "peak_position": 2, "featured_artists": "ADÉLA", "seven_day_streams": 32384931, "change_since_yesterday": "0", "total_streams_on_chart": 167484589, "change_in_daily_streams": 335798 } ], "chart_url": "https://kworb.net/spotify/country/global_daily.html" , "chart_date": "2026-10-21"}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"kworb.net/get_spotify_daily_chart","input":{"country":"global","max_results":20}}' # 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_spotify_daily_chart" , "input": { "country": "global", "max_results": 20 }})# 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_spotify_daily_chart" , "input": { "country": "global", "max_results": 20 } }), 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_spotify_daily_chart# with {"country":"global","max_results":20}"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 country code, or global for the worldwide chart. Example: United States." }, "max_results": { "type": "integer", "default": 200, "maximum": 200, "minimum": 1, "description": "How many top-ranked songs to include, from 1 to 200. Example: 20." } }}Output schema
{ "type": "object", "required": [ "country", "chart_date", "chart_url", "entries" ], "properties": { "country": { "type": "string" }, "entries": { "type": "array", "items": { "type": "object", "properties": { "artist": { "type": "string" }, "position": { "type": "integer" }, "song_url": { "type": "string" }, "song_title": { "type": "string" }, "daily_streams": { "type": [ "integer", "null" ] }, "days_on_chart": { "type": [ "integer", "null" ] }, "peak_position": { "type": [ "integer", "null" ] }, "featured_artists": { "type": [ "string", "null" ] }, "seven_day_streams": { "type": [ "integer", "null" ] }, "change_since_yesterday": { "type": [ "string", "null" ] }, "total_streams_on_chart": { "type": [ "integer", "null" ] }, "change_in_daily_streams": { "type": [ "integer", "null" ] } } } }, "chart_url": { "type": "string" }, "chart_date": { "type": "string" } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
kworb.net/get_spotify_daily_chart- Returns
- country, chart date, chart URL, entries with position, artist, song, streams
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_spotify_daily_chart with the inputs above.
Ask your agent
- What are the top 20 songs on Spotify's daily chart in the United States today?
- Show me the global Spotify Top 200 daily chart with stream counts.
- Get the latest Spotify daily chart for Japan, top 10 songs with their streams.
- I need today's Spotify Top 50 for Brazil including artists and daily streams, from kworb.net.
- Which songs ranked highest on the Spotify daily chart for Germany, and how many streams did each get?
See more
All Kworb methodsGets 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.
kworb.net/get_youtube_music_chartGets an artist's tracked Spotify streaming totals, most-streamed songs and albums from Kworb.
kworb.net/get_artist_stream_countsLists 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 Spotify's top or trending podcasts for a country in chart order, with rank, movement, publisher, artwork and Spotify link. Category charts exist only for some countries.
open.spotify.com/list_top_podcastsLists titles on JustWatch's daily streaming chart for a country, optionally limited to one streaming service.
justwatch.com/list_streaming_chartsLists the latest weekly YouTube Music Top Songs chart for a country or globally, with ranks, weekly views and video links.
youtube.com/list_top_songsGets 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 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_charts