# Shazam API

> Shazam returns ranked song charts and breakout songs, available as a workflow and API.

Shazam returns ranked top songs for the world, a country, or a city; choose a location and optionally a genre with List top charts. Shazam returns ranked Discovery songs rising quickly in searches for a country; provide a country with List breakout songs.

- Page: https://fous.com/workflows/shazam
- Handle: `@shazam`
- Category: [Entertainment](https://fous.com/workflows/category/entertainment)
- Source website: https://shazam.com
- Last verified: Sep 29, 2026
- Fous is not affiliated with Shazam.

## Methods

### List breakout songs

Operation `list_breakout_songs`, version 1. 1 credit per call.

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.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `country` | string | yes | `"CA"` | Country name or two-letter code, such as United States or US. |
| `max_results` | integer | no | `3` | Most songs to return, for example 50. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "country"
  ],
  "properties": {
    "country": {
      "type": "string",
      "minLength": 2,
      "description": "Country name or two-letter code, such as United States or US.",
      "examples": [
        "CA",
        "United States"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1,
      "description": "Most songs to return, for example 50.",
      "x-fous-developer": true,
      "examples": [
        3
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "country": "CA",
      "max_results": 3
    },
    {
      "country": "United States"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `songs` | array |  |  |
| `songs[].rank` | integer | `1` |  |
| `songs[].artist` | string or null | `"Wxoda"` |  |
| `songs[].track_id` | string | `"6812803286"` |  |
| `songs[].song_title` | string | `"Vibin"` |  |
| `songs[].shazam_link` | string | `"https://www.shazam.com/song/6812803286/vibin"` |  |
| `songs[].cover_image_link` | string or null | `"https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/e9/0f/4e/e90f4e4d-0fb0-57a9-461d-533e85417bb4/885288590388.jpg/75x` |  |
| `country` | string | `"Canada"` |  |
| `chart_name` | string | `"Discovery"` |  |

**Example input**

```json
{
  "country": "CA",
  "max_results": 3
}
```

**Example output**

```json
{
  "songs": [
    {
      "rank": 1,
      "artist": "Wxoda",
      "track_id": "6812803286",
      "song_title": "Vibin",
      "shazam_link": "https://www.shazam.com/song/6812803286/vibin",
      "cover_image_link": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/e9/0f/4e/e90f4e4d-0fb0-57a9-461d-533e85417bb4/885288590388.jpg/75x75bb.webp"
    },
    {
      "rank": 2,
      "artist": "Falling In Reverse, Corey Taylor & Serj Tankian",
      "track_id": "6797421554",
      "song_title": "Joseph",
      "shazam_link": "https://www.shazam.com/song/6797421554/joseph",
      "cover_image_link": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/47/d0/2f/47d02f1d-6066-a073-2580-6d9765f5222b/0045778810185.png/75x75bb.webp"
    },
    {
      "rank": 3,
      "artist": "KAROL G, Judeline & rusowsky",
      "track_id": "6796864754",
      "song_title": "BbY WOW",
      "shazam_link": "https://www.shazam.com/song/6796864754/bby-wow",
      "cover_image_link": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/2b/66/b2/2b66b26c-ab23-faa1-c4ee-06fa2cce8f76/26UM1IM00558.rgb.jpg/75x75bb.webp"
    }
  ],
  "country": "Canada",
  "chart_name": "Discovery"
}
```

### List top charts

Operation `list_top_charts`, version 1. 1 credit per call.

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

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `genre` | string | no | `"Pop"` | An available chart genre, such as Pop or Hip-Hop/Rap. Leave blank for the overall chart. |
| `location` | string | no | `"Chicago"` | World, a country, or a city. For example: Chicago. |
| `max_results` | integer | no | `3` | Number of ranked songs to return, up to 200. For example: 25. |

**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.",
      "examples": [
        "Pop",
        "Hip-Hop/Rap"
      ]
    },
    "location": {
      "type": "string",
      "default": "world",
      "description": "World, a country, or a city. For example: Chicago.",
      "examples": [
        "Chicago",
        "world",
        "Brazil"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "description": "Number of ranked songs to return, up to 200. For example: 25.",
      "x-fous-developer": true,
      "examples": [
        3
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "location": "Chicago",
      "max_results": 3
    },
    {
      "location": "world"
    },
    {
      "genre": "Pop",
      "location": "Brazil",
      "max_results": 3
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `songs` | array |  |  |
| `songs[].rank` | integer | `1` |  |
| `songs[].artist` | string or null | `"Quavo & Takeoff"` |  |
| `songs[].song_title` | string | `"HOTEL LOBBY (Unc & Phew) [A COLORS SHOW]"` |  |
| `songs[].shazam_link` | string | `"https://www.shazam.com/song/1630436384/hotel-lobby-unc-and-phew-a-colors-show"` |  |
| `songs[].shazam_track_id` | string or null | `"1630436384"` |  |
| `songs[].cover_image_link` | string or null | `"https://is1-ssl.mzstatic.com/image/thumb/Music122/v4/18/96/60/189660c7-3ad1-b892-9559-468e4ca651d1/22UMGIM67509.rgb.jpg` |  |
| `location` | string | `"Chicago, United States"` |  |
| `chart_name` | string | `"Top 50 Chicago, United States"` |  |

**Example input**

```json
{
  "location": "Chicago",
  "max_results": 3
}
```

**Example output**

```json
{
  "songs": [
    {
      "rank": 1,
      "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"
    },
    {
      "rank": 2,
      "artist": "KAROL G, Judeline & rusowsky",
      "song_title": "BbY WOW",
      "shazam_link": "https://www.shazam.com/song/6796864754/bby-wow",
      "shazam_track_id": "6796864754",
      "cover_image_link": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/2b/66/b2/2b66b26c-ab23-faa1-c4ee-06fa2cce8f76/26UM1IM00558.rgb.jpg/300x300bb.webp"
    },
    {
      "rank": 3,
      "artist": "Bronski Beat",
      "song_title": "Smalltown Boy",
      "shazam_link": "https://www.shazam.com/song/1320069110/smalltown-boy",
      "shazam_track_id": "1320069110",
      "cover_image_link": "https://is1-ssl.mzstatic.com/image/thumb/Music125/v4/76/df/ee/76dfee41-aca3-76c6-e695-c46ec360e090/639842819527.jpg/300x300bb.webp"
    }
  ],
  "location": "Chicago, United States",
  "chart_name": "Top 50 Chicago, United States"
}
```

## Quick start

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@shazam",
  "visibility": "public",
  "operation": "list_breakout_songs",
  "version": 1,
  "input": {
    "country": "CA",
    "max_results": 3
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

body = json.loads("{\n  \"api\": \"@shazam\",\n  \"visibility\": \"public\",\n  \"operation\": \"list_breakout_songs\",\n  \"version\": 1,\n  \"input\": {\n    \"country\": \"CA\",\n    \"max_results\": 3\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=120) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_000),
  body: JSON.stringify({
  "api": "@shazam",
  "visibility": "public",
  "operation": "list_breakout_songs",
  "version": 1,
  "input": {
    "country": "CA",
    "max_results": 3
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

Or describe the data in plain language: send `{"api":"@shazam","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## Use cases

- Track ranked songs across countries and cities
- Compare chart rankings by genre
- Spot songs rising quickly in Shazam searches
- Monitor breakout songs in a country

## FAQ

### Is Fous affiliated with Shazam?

No. Fous is not affiliated with Shazam. This workflow reads the public shazam.com website and returns its data.

### How much does it cost?

Each run costs 1 credit. With pay-as-you-go, a credit costs 1¢; monthly plans cost less per credit.

### Do I need a Shazam account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from shazam.com when you run it; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 29, 2026.

### What songs top the chart for a location?

List top charts returns ranked songs for a world, country, or city location, optionally filtered by genre.

### Which songs are rising quickly in a country?

List breakout songs returns ranked Discovery songs rising quickly in Shazam searches for the specified country.

## Related

- [Apple Music API](https://fous.com/workflows/apple-music.md): Apple Music returns albums, tracks, artist profiles, latest releases, top music, matching songs, and current charts; prices, previews, and older albums may be unavailable.
- [Deezer API](https://fous.com/workflows/deezer.md): Deezer provides albums with ordered tracklists, song recording details, and current worldwide charts or official country-playlist tracks; previews and some tempo data may be unavailable or expire.
- [Spotify API](https://fous.com/workflows/spotify.md): Spotify returns public artist profiles, album credits and ordered tracks, song details and play counts, up to 500 playlist songs, keyword results, and country-based podcast charts; dates and regional options vary.
- [YouTube API](https://fous.com/workflows/youtube.md): YouTube returns public video, caption, comment, channel and upload details, plus the latest weekly Top Songs chart; inferred dates and some counts may be approximate.
- [Apple Podcasts API](https://fous.com/workflows/apple-podcasts.md): Apple Podcasts returns chart listings, relevant show search results, show details with newest available episodes, and country-specific ratings and reviews; results are capped, and older or subscription episodes may be unavailable.
- [Apple App Store API](https://fous.com/workflows/apple-app-store.md): Apple App Store returns public app listings, keyword search, ratings, prices, listed purchases, country-specific reviews and visible replies, and up to 200 ranked chart apps.
- [Billboard API](https://fous.com/workflows/billboard.md): Billboard provides chart rankings and histories for published chart weeks, including artists’ Hot 100 song and Billboard 200 album totals and title-by-title performance.
- [Microsoft Store API](https://fous.com/workflows/microsoft-store.md): Microsoft Store returns app and game listings, country-specific searches, and ranked charts; update notes, purchase prices, and exact rating counts may be unavailable.
- [All Entertainment workflows](https://fous.com/workflows/category/entertainment)