# Deezer API: Get song details

> Gets a Deezer song's tempo, ISRC, loudness gain and recording details from its title, track link or track ID. An artist name helps pick the right recording.

Unofficial. Not affiliated with or endorsed by Deezer.

- Page: https://fous.com/methods/deezer.com/get-song-details
- Method: `deezer.com/get_song_details`, version 1
- Website: deezer.com
- Returns: title, artist, album, release_date, length, tempo_bpm, isrc, loudness_gain_db, explicit, preview_link, deezer_link, track_id, length_seconds
- 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 |
|---|---|---|---|---|
| `song` | string | yes | `"Uptown Funk"` | Song title, Deezer track link, or track ID, e.g. Uptown Funk or https://www.deezer.com/track/92734438. |
| `artist` | string | no | `"Mark Ronson"` | Artist name to distinguish recordings, e.g. Mark Ronson. Leave blank for the most popular match. Default "". |

## Output

From a run on Oct 23, 2026. Its input:

```json
{
  "song": "Uptown Funk",
  "artist": "Mark Ronson"
}
```

Its output:

```json
{
  "isrc": "GBARL1401524",
  "album": "Uptown Special",
  "title": "Uptown Funk (feat. Bruno Mars)",
  "artist": "Mark Ronson",
  "length": "4:30",
  "explicit": "no",
  "track_id": 92734438,
  "tempo_bpm": 114.8,
  "deezer_link": "https://www.deezer.com/track/92734438",
  "preview_link": "https://cdnt-preview.dzcdn.net/api/1/1/b/0/a/0/b0a30d99fddf73c172e0d3f308899dd5.mp3?hdnea=exp=1792748614~acl=/api/1/1/b/0/a/0/b0a30d99fddf73c172e0d3f308899dd5.mp3*~data=user_id=0,application_id=42~hmac=da98c5cea05acd66f3f99f37b01592e46fe5ff00ac632b48f6ba01af3a2ee0c2",
  "release_date": "2015-01-12",
  "length_seconds": 270,
  "loudness_gain_db": -11.9
}
```

## 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":"deezer.com/get_song_details","input":{"song":"Uptown Funk","artist":"Mark Ronson"}}'
```

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 is the tempo in BPM and ISRC code for the song Uptown Funk by Mark Ronson?
- Can you look up the loudness gain in dB and explicit flag for track 92734438 on Deezer?
- I need the album name, release date and length of the Deezer track Blinding Lights by The Weeknd.
- Find the tempo, ISRC and preview link for the song Levitating by Dua Lipa.
- Get the recording details for https://www.deezer.com/track/3135556, including its duration in seconds and Deezer link.

## Input schema

```json
{
  "type": "object",
  "required": [
    "song"
  ],
  "properties": {
    "song": {
      "type": "string",
      "description": "Song title, Deezer track link, or track ID, e.g. Uptown Funk or https://www.deezer.com/track/92734438."
    },
    "artist": {
      "type": "string",
      "default": "",
      "description": "Artist name to distinguish recordings, e.g. Mark Ronson. Leave blank for the most popular match."
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "title",
    "artist",
    "album",
    "release_date",
    "length",
    "tempo_bpm",
    "isrc",
    "loudness_gain_db",
    "explicit",
    "preview_link",
    "deezer_link",
    "track_id",
    "length_seconds"
  ],
  "properties": {
    "isrc": {
      "type": [
        "string",
        "null"
      ]
    },
    "album": {
      "type": [
        "string",
        "null"
      ]
    },
    "title": {
      "type": "string"
    },
    "artist": {
      "type": "string"
    },
    "length": {
      "type": "string",
      "description": "Length in m:ss."
    },
    "explicit": {
      "enum": [
        "yes",
        "no"
      ],
      "type": "string"
    },
    "track_id": {
      "type": "integer"
    },
    "tempo_bpm": {
      "type": [
        "number",
        "null"
      ]
    },
    "deezer_link": {
      "type": "string"
    },
    "preview_link": {
      "type": [
        "string",
        "null"
      ]
    },
    "release_date": {
      "type": [
        "string",
        "null"
      ],
      "format": "date"
    },
    "length_seconds": {
      "type": "integer"
    },
    "loudness_gain_db": {
      "type": [
        "number",
        "null"
      ]
    }
  },
  "additionalProperties": false
}
```

## See more

- [Deezer API: Get album](https://fous.com/methods/deezer.com/get-album.md): Looks up a Deezer album by name, album link, or ID, optionally matching an artist, and returns its details and ordered tracklist.
- [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.
- [SongBPM API: Get song tempo and key](https://fous.com/methods/songbpm.com/get-song-tempo-and-key.md): Finds the best SongBPM match for a song title and artist and returns its tempo, musical key, Camelot key, length and time signature.
- [Spotify API: Get song](https://fous.com/methods/open.spotify.com/get-song.md): Finds 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.
- [MusicBrainz API: Get song identifiers](https://fous.com/methods/musicbrainz.org/get-song-identifiers.md): Finds the best-matching studio recording on MusicBrainz for a song title and artist. Returns its ISRCs, first release date and up to 25 of its earliest releases.
- [SoundCloud API: Get track](https://fous.com/methods/soundcloud.com/get-track.md): Gets a public SoundCloud track and its stats from a title and optional artist, or from a track link. Search picks the artist's matching upload with the most plays; unavailable fields are null.
- [Spotify API: Get album](https://fous.com/methods/open.spotify.com/get-album.md): Gets a Spotify album by name (optionally with the artist), album link or album ID, with its details and ordered track list including play counts.
- [Discogs API: Get release](https://fous.com/methods/discogs.com/get-release.md): Finds a Discogs release by title, artist or release link and returns its edition details, tracks, community counts, current price and sold price statistics.
- [All Deezer methods](https://fous.com/methods/deezer.com.md)