# 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.

- Page: https://fous.com/methods/shazam.com/list-top-charts
- Method: `shazam.com/list_top_charts`, version 1
- Website: shazam.com
- Returns: chart name, location, ranked songs with title, artist, cover image, Shazam link and track id
- 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 |
|---|---|---|---|---|
| `genre` | string | no |  | An available chart genre, such as Pop or Hip-Hop/Rap. Leave blank for the overall chart. Default "". |
| `location` | string | no | `"world"` | World, a country, or a city. For example: Chicago. Default "world". |
| `max_results` | integer | no |  | Number of ranked songs to return, up to 200. For example: 25. Default 50. |

## Output

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

```json
{
  "location": "world"
}
```

Its output:

```json
{
  "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"
}
```

## 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":"shazam.com/list_top_charts","input":{"location":"world"}}'
```

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 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.

## Input schema

```json
{
  "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

```json
{
  "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
}
```

## See more

- [Shazam API: List breakout songs](https://fous.com/methods/shazam.com/list-breakout-songs.md): Get 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.
- [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.
- [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.
- [Apple API: List top App Store charts](https://fous.com/methods/apps.apple.com/list-top-charts.md): Lists 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.
- [Spotify API: List top podcasts](https://fous.com/methods/open.spotify.com/list-top-podcasts.md): Lists 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.
- [Roblox API: List top games](https://fous.com/methods/roblox.com/list-top-games.md): Lists ranked Roblox experiences from a current Charts list. Each game includes players online, approval percentage, creator, icon and game link.
- [Apple API: List top podcasts](https://fous.com/methods/podcasts.apple.com/list-top-podcasts.md): Lists Apple Podcasts chart entries in rank order for a country and category, as top shows or top episodes.
- [All Shazam methods](https://fous.com/methods/shazam.com.md)