# Spotify API: Get album

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

Unofficial. Not affiliated with or endorsed by Spotify.

- Page: https://fous.com/methods/open.spotify.com/get-album
- Method: `open.spotify.com/get_album`, version 1
- Website: open.spotify.com
- Returns: album name, artists, release date, type, label, copyright, cover, total length, tracks with featured artists, lengths, play counts, explicit flags
- 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 |
|---|---|---|---|---|
| `album` | string | yes | `"https://open.spotify.com/album/0ETFjACtuP2ADo6LFhL6HN"` | Album name, Spotify album link or album ID, for example Abbey Road. |
| `artist` | string | no |  | Artist to identify the right album, for example The Beatles. Default "". |

## Output

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

```json
{
  "album": "https://open.spotify.com/album/0ETFjACtuP2ADo6LFhL6HN"
}
```

Its output:

```json
{
  "tracks": [
    {
      "title": "Come Together - Remastered 2009",
      "length": "4:19",
      "explicit": false,
      "length_ms": 259946,
      "play_count": 1006109837,
      "disc_number": 1,
      "spotify_link": "https://open.spotify.com/track/2EqlS6tkEnglzr7tkKAAYD",
      "track_number": 1,
      "featured_artists": [],
      "spotify_track_id": "2EqlS6tkEnglzr7tkKAAYD"
    },
    {
      "title": "Something - Remastered 2009",
      "length": "3:02",
      "explicit": false,
      "length_ms": 182293,
      "play_count": 546612992,
      "disc_number": 1,
      "spotify_link": "https://open.spotify.com/track/0pNeVovbiZHkulpGeOx1Gj",
      "track_number": 2,
      "featured_artists": [],
      "spotify_track_id": "0pNeVovbiZHkulpGeOx1Gj"
    },
    {
      "title": "Maxwell's Silver Hammer - Remastered 2009",
      "length": "3:27",
      "explicit": false,
      "length_ms": 207920,
      "play_count": 69306398,
      "disc_number": 1,
      "spotify_link": "https://open.spotify.com/track/2S8xyNRJX1XQdo3qnTuovI",
      "track_number": 3,
      "featured_artists": [],
      "spotify_track_id": "2S8xyNRJX1XQdo3qnTuovI"
    }
  ],
  "artists": [
    "The Beatles"
  ],
  "copyright": "© 2015 Apple Corps Ltd | ℗ 2015 Calderstone Productions Limited (a division of Universal Music Group)",
  "album_name": "Abbey Road (Remastered 2009)",
  "album_type": "album",
  "record_label": "EMI Catalogue",
  "release_date": "1969-09-26",
  "spotify_link": "https://open.spotify.com/album/0ETFjACtuP2ADo6LFhL6HN",
  "total_length": "47 min 29 s",
  "cover_image_link": "https://i.scdn.co/image/ab67616d0000b273dc30583ba717007b00cceb25",
  "number_of_tracks": 17,
  "spotify_album_id": "0ETFjACtuP2ADo6LFhL6HN"
}
```

## 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":"open.spotify.com/get_album","input":{"album":"https://open.spotify.com/album/0ETFjACtuP2ADo6LFhL6HN"}}'
```

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

- Show me the full tracklist for Rumours by Fleetwood Mac with stream counts for each song
- Which song on Kendrick Lamar's GNX has the most plays on Spotify?
- Pull up the details for this album: https://open.spotify.com/album/4LH4d3cOWNNsVw41Gqt2kv — label, release date, and total runtime
- What record label put out SOS by SZA, and which tracks on it are marked explicit?
- Get the Spotify album 1NAmidJlEaVgA3MpcPFYGq with all its songs, featured artists and track lengths

## Input schema

```json
{
  "type": "object",
  "required": [
    "album"
  ],
  "properties": {
    "album": {
      "type": "string",
      "description": "Album name, Spotify album link or album ID, for example Abbey Road."
    },
    "artist": {
      "type": "string",
      "default": "",
      "description": "Artist to identify the right album, for example The Beatles."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "album_name",
    "artists",
    "release_date",
    "album_type",
    "number_of_tracks",
    "total_length",
    "record_label",
    "copyright",
    "cover_image_link",
    "spotify_link",
    "tracks",
    "spotify_album_id"
  ],
  "properties": {
    "tracks": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "track_number",
          "disc_number",
          "title",
          "featured_artists",
          "length",
          "play_count",
          "explicit",
          "spotify_link",
          "spotify_track_id",
          "length_ms"
        ],
        "properties": {
          "title": {
            "type": "string",
            "description": "Track title."
          },
          "length": {
            "type": "string",
            "description": "Track length in m:ss."
          },
          "explicit": {
            "type": "boolean",
            "description": "Whether Spotify marks the track explicit."
          },
          "length_ms": {
            "type": "integer",
            "description": "Track length in milliseconds.",
            "x-fous-developer": true
          },
          "play_count": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Public Spotify play count, or null if unavailable."
          },
          "disc_number": {
            "type": "integer",
            "description": "Disc number."
          },
          "spotify_link": {
            "type": "string",
            "description": "Spotify track page link."
          },
          "track_number": {
            "type": "integer",
            "description": "Track number within its disc."
          },
          "featured_artists": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Track artists who are not credited as album artists."
          },
          "spotify_track_id": {
            "type": "string",
            "description": "Spotify track ID.",
            "x-fous-developer": true
          }
        },
        "additionalProperties": false
      },
      "description": "All album tracks in disc and track order."
    },
    "artists": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Album artists."
    },
    "copyright": {
      "type": [
        "string",
        "null"
      ],
      "description": "Copyright credits, or null if not listed."
    },
    "album_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Album title."
    },
    "album_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "Album, single or compilation."
    },
    "record_label": {
      "type": [
        "string",
        "null"
      ],
      "description": "Record label, or null if not provided."
    },
    "release_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Release date in YYYY-MM-DD, or null if not listed."
    },
    "spotify_link": {
      "type": [
        "string",
        "null"
      ],
      "description": "Spotify album page link."
    },
    "total_length": {
      "type": [
        "string",
        "null"
      ],
      "description": "Total running time as text."
    },
    "cover_image_link": {
      "type": [
        "string",
        "null"
      ],
      "description": "Spotify cover image link."
    },
    "number_of_tracks": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Total tracks across all discs."
    },
    "spotify_album_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "Spotify album ID.",
      "x-fous-developer": true
    }
  },
  "additionalProperties": false
}
```

## See more

- [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.
- [Spotify API: Get artist](https://fous.com/methods/open.spotify.com/get-artist.md): Gets 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.
- [Spotify API: Search music](https://fous.com/methods/spotify.com/search-music.md): Searches Spotify for songs, artists, albums, playlists or podcasts by keywords and returns them in Spotify's result order. Songs and albums include a release date when Spotify gives a full date.
- [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.
- [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.
- [Apple API: Get album](https://fous.com/methods/music.apple.com/get-album.md): Finds an Apple Music album by title and optional artist, or by album link, and returns its matched release, purchase details and tracks in order.
- [Bandcamp API: Get album](https://fous.com/methods/bandcamp.com/get-album.md): Gets a Bandcamp album by title and optional artist, or by album link, with prices, physical formats, tracks and album details. Supporter count covers only profiles shown on the page; copies left is given only when displayed.
- [Pitchfork API: Get album review](https://fous.com/methods/pitchfork.com/get-album-review.md): Finds Pitchfork's newest review that matches an album title and artist, and returns the review's rating and details.
- [All Spotify methods](https://fous.com/methods/spotify.com.md)