Shazam API: List top charts
Gets Shazam's current ranked top songs for the world, a country, or a city, optionally by genre. City charts have up to 50 songs; genres are available only in some places.
Unofficial. Not affiliated with or endorsed by Shazam.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Genre optional
genre An available chart genre, such as Pop or Hip-Hop/Rap. Leave blank for the overall chart.
(default)
- Location optional
location World, a country, or a city. For example: Chicago.
world
Default
world.- Max Results optional
max_results Number of ranked songs to return, up to 200. For example: 25.
50 (default)
Whole number from 1 to 200.
Input as JSON
{ "location": "world"}Output
{ "songs": [ { "rank": 1, "artist": "HUGEL, Imael Angel & Ultra Naté", "song_title": "Movin' To The Sun", "shazam_link": "https://www.shazam.com/song/6778877440/movin-to-the-sun" , "shazam_track_id": "6778877440", "cover_image_link": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/86/10/b4/8610b422-9eaf-dccc-bb90-68751386deeb/1134279.jpg/300x300bb.webp" }, { "rank": 2, "artist": "Imael Angel", "song_title": "Bad Times (Extended Version)", "shazam_link": "https://www.shazam.com/song/1890913669/bad-times-extended-version" , "shazam_track_id": "1890913669", "cover_image_link": "https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/08/03/7f/08037f7d-6173-9348-991d-5966f0686539/artwork.jpg/300x300bb.webp" }, { "rank": 3, "artist": "Quavo & Takeoff", "song_title": "HOTEL LOBBY (Unc & Phew) [A COLORS SHOW]", "shazam_link": "https://www.shazam.com/song/1630436384/hotel-lobby-unc-and-phew-a-colors-show" , "shazam_track_id": "1630436384", "cover_image_link": "https://is1-ssl.mzstatic.com/image/thumb/Music122/v4/18/96/60/189660c7-3ad1-b892-9559-468e4ca651d1/22UMGIM67509.rgb.jpg/300x300bb.webp" } ], "location": "World", "chart_name": "Top 200 Global"}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"shazam.com/list_top_charts","input":{"location":"world"}}' # 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": "shazam.com/list_top_charts" , "input": { "location": "world" }})# 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": "shazam.com/list_top_charts" , "input": { "location": "world" } }), 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 shazam.com/list_top_charts# with {"location":"world"}"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": { "genre": { "type": "string", "default": "", "description": "An available chart genre, such as Pop or Hip-Hop/Rap. Leave blank for the overall chart." }, "location": { "type": "string", "default": "world", "description": "World, a country, or a city. For example: Chicago." }, "max_results": { "type": "integer", "default": 50, "maximum": 200, "minimum": 1, "description": "Number of ranked songs to return, up to 200. For example: 25." } }}Output schema
{ "type": "object", "required": [ "chart_name", "location", "songs" ], "properties": { "songs": { "type": "array", "items": { "type": "object", "required": [ "rank", "song_title", "artist", "cover_image_link", "shazam_link", "shazam_track_id" ], "properties": { "rank": { "type": "integer" }, "artist": { "type": [ "string", "null" ] }, "song_title": { "type": "string" }, "shazam_link": { "type": "string" }, "shazam_track_id": { "type": [ "string", "null" ] }, "cover_image_link": { "type": [ "string", "null" ] } }, "additionalProperties": false } }, "location": { "type": "string" }, "chart_name": { "type": "string" } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
shazam.com/list_top_charts- Returns
- chart name, location, ranked songs with title, artist, cover image, Shazam link and track id
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 shazam.com/list_top_charts with the inputs above.
Ask your agent
- What are the top 25 most Shazamed songs in Chicago right now?
- Show me the current global Shazam chart, top 100 tracks with artist names and links.
- I need the top hip-hop/rap songs people are identifying in Brazil this week — give me the top 20.
- Which pop tracks are trending in the UK right now? Just the top 10 with cover art.
- Pull the ranked list of the hottest songs being looked up in Tokyo at the moment, up to 50.
See more
All Shazam methodsGet the ranked Discovery songs rising quickly in Shazam searches for a country. Some countries have no Discovery chart; public charts currently show up to 10 songs.
shazam.com/list_breakout_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 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_chartsLists ranked iPhone or iPad apps from the public App Store charts for a chart, category, and country. App bundles and apps that are no longer available are left out.
apps.apple.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 ranked Roblox experiences from a current Charts list. Each game includes players online, approval percentage, creator, icon and game link.
roblox.com/list_top_gamesLists Apple Podcasts chart entries in rank order for a country and category, as top shows or top episodes.
podcasts.apple.com/list_top_podcasts