interface Album {
    album_type: "album" | "single" | "compilation";
    artists: Artist[];
    available_markets: string[];
    copyrights: Copyright[];
    external_ids?: ExternalIds;
    external_urls: ExternalUrls;
    genres: string[];
    href: string;
    id: string;
    images: Image[];
    label: string;
    name?: string;
    popularity: number;
    release_date: string;
    release_date_precision: "year" | "month" | "day";
    restrictions?: {
        reason: "market" | "product" | "explicit";
    };
    total_tracks: number;
    tracks: PagingObject<TrackSimplified>;
    type: "album";
    uri: string;
}

Hierarchy (view full)

Properties

album_type: "album" | "single" | "compilation"

The type of the album.

artists: Artist[]

The artists of the album.

available_markets: string[]

The markets in which the album is available: ISO 3166-1 alpha-2 country codes. Note that an album is considered available in a market when at least 1 of its tracks is available in that market.

copyrights: Copyright[]

The copyright statements of the album.

external_ids?: ExternalIds

Known external IDs for the track.

external_urls: ExternalUrls

Known external URLs for this album.

genres: string[]

The genres of the album.

href: string

A link to the Web API endpoint providing full details of the album.

id: string

The Spotify ID for the album.

images: Image[]

The cover art for the album in various sizes, widest first.

label: string

The label for the album.

name?: string

The name of the album. In case of an album takedown, the value may be an empty string.

popularity: number

The popularity of the artist. The value will be between 0 and 100, with 100 being the most popular. The artist's popularity is calculated from the popularity of all the artist's tracks.

release_date: string

The date the album was first released.

release_date_precision: "year" | "month" | "day"

The precision with which release_date value is known.

restrictions?: {
    reason: "market" | "product" | "explicit";
}

Included in the response when a content restriction is applied.

Type declaration

  • reason: "market" | "product" | "explicit"

    The reason for the restriction. Albums may be restricted if the content is not available in a given market, to the user's subscription type, or when the user's account is set to not play explicit content.

total_tracks: number

The number of tracks in the album.

The tracks of the album.

type: "album"

The object type.

uri: string

The Spotify URI for the album.