Kworb API: Get artist stream counts
Gets an artist's tracked Spotify streaming totals, most-streamed songs and albums from Kworb.
Unofficial. Not affiliated with or endorsed by Kworb.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Artist, required
artist Artist name as shown on Kworb, for example Bad Bunny.
Taylor Swift
- Max Results optional
max_results Maximum most-streamed songs to return, for example 50.
3
Whole number from 1 to 500. Default
50.
Input as JSON
{ "artist": "Taylor Swift", "max_results": 3}Output
{ "songs": [ { "title": "Cruel Summer", "page_link": "https://open.spotify.com/track/1BxfuPKGuaTgP7aM0Bbdwr" , "artist_role": "lead", "daily_streams": 906873, "total_streams": 3517678103 }, { "title": "Blank Space", "page_link": "https://open.spotify.com/track/1p80LdxRV74UKvL8gnD7ky" , "artist_role": "lead", "daily_streams": 1316621, "total_streams": 2643309554 }, { "title": "I Don’t Wanna Live Forever (Fifty Shades Darker)", "page_link": "https://open.spotify.com/track/55n9yjI6qqXh5F2mYvUc2y" , "artist_role": "featured", "daily_streams": 608655, "total_streams": 2225189935 } ], "albums": [ { "title": "Lover", "page_link": "https://open.spotify.com/album/1NAmidJlEaVgA3MpcPFYGq" , "daily_streams": 3512217, "total_streams": 15091463285 }, { "title": "Midnights (The Til Dawn Edition)", "page_link": "https://open.spotify.com/album/1fnJ7k0bllNfL1kVdNVW1A" , "daily_streams": 3292502, "total_streams": 12547301750 }, { "title": "folklore: the long pond studio sessions (from the Disney+ special) [deluxe edition]", "page_link": "https://open.spotify.com/album/0PZ7lAru5FDFHuirTkWe9Z" , "daily_streams": 4148218, "total_streams": 12422853324 } ], "artist": "Taylor Swift", "kworb_link": "https://kworb.net/spotify/artist/06HL4z0CvFAxyc27GXpf02_songs.html" , "daily_streams": 47844699, "songs_tracked": 670, "total_streams": 132454451338, "spotify_artist_id": "06HL4z0CvFAxyc27GXpf02"}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"kworb.net/get_artist_stream_counts","input":{"artist":"Taylor Swift","max_results":3}}' # 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_artist_stream_counts" , "input": { "artist": "Taylor Swift", "max_results": 3 }})# 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_artist_stream_counts" , "input": { "artist": "Taylor Swift", "max_results": 3 } }), 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_artist_stream_counts# with {"artist":"Taylor Swift","max_results":3}"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", "required": [ "artist" ], "properties": { "artist": { "type": "string", "minLength": 1, "description": "Artist name as shown on Kworb, for example Bad Bunny." }, "max_results": { "type": "integer", "default": 50, "maximum": 500, "minimum": 1, "description": "Maximum most-streamed songs to return, for example 50." } }}Output schema
{ "type": "object", "required": [ "artist", "total_streams", "daily_streams", "songs_tracked", "kworb_link", "spotify_artist_id", "songs", "albums" ], "properties": { "songs": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "page_link": { "type": "string" }, "artist_role": { "enum": [ "lead", "featured" ], "type": "string" }, "daily_streams": { "type": [ "integer", "null" ] }, "total_streams": { "type": "integer" } } } }, "albums": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "page_link": { "type": "string" }, "daily_streams": { "type": [ "integer", "null" ] }, "total_streams": { "type": "integer" } } } }, "artist": { "type": "string" }, "kworb_link": { "type": "string" }, "daily_streams": { "type": "integer" }, "songs_tracked": { "type": "integer" }, "total_streams": { "type": "integer" }, "spotify_artist_id": { "type": "string" } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
kworb.net/get_artist_stream_counts- Returns
- total streams, daily streams, songs tracked, songs, albums
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_artist_stream_counts with the inputs above.
Ask your agent
- How many total Spotify streams does Bad Bunny have according to Kworb, and what are his top 50 most-streamed songs?
- Show me the tracked daily streams and number of songs tracked for Taylor Swift on kworb.net.
- Pull up Drake's most-streamed Spotify songs and albums, limited to the top 20.
- What are Dua Lipa's total streams, daily streams, and top albums by Spotify count?
- Get the streaming totals and the 100 most-streamed tracks for Olivia Rodrigo.
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 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 a Spotify artist's public profile from their name, artist link or ID: listeners, followers, world rank, top cities, popular tracks, latest release and release counts.
open.spotify.com/get_artistLooks up a Last.fm artist by name and returns listening statistics, profile, top tracks and albums, similar artists, and upcoming events.
last.fm/get_artistFinds a Spotify song by title (optionally narrowed by artist), track link, URI or track ID and returns its public play count and details. Without an artist, the most-played exact title match wins. Previews and ISRC may be unavailable for some tracks.
open.spotify.com/get_songLists a SoundCloud artist's public tracks in latest or SoundCloud popular order, with profile and track details. SoundCloud's popular list may contain fewer than 100 tracks (currently at most 30).
soundcloud.com/list_artist_tracksReturns an artist's Billboard Hot 100 song history or Billboard 200 album history: chart totals (entries, No. 1 hits, top 10 hits) and each title's debut, peak and weeks on chart, most recent debut first.
billboard.com/get_artist_chart_historyLists an artist's songs on Genius by popularity or newest release date, with featured artists, release dates, page views and song art. The artist can be given by name or by Genius artist link; dates or views may be unavailable.
genius.com/list_artist_songs