RecoupGet a Free AuditFree Audit

API REFERENCE

Get Artist Albums

On this page
GET/api/spotify/artist/albums

Get Spotify catalog information about an artist's albums.

Authentication

See the authentication guide for API key and account access requirements.

Request

cURL
curl --request GET \
  --url 'https://api.recoupable.dev/api/spotify/artist/albums?id=YOUR_ID' \
  --header 'x-api-key: YOUR_API_KEY'

Replace the YOUR_ placeholders with your values. Required query parameters are included; optional parameters are listed below.

Parameters

Query parameters

idstringrequired

The Spotify ID of the artist

include_groupsstring

A comma-separated list of keywords to filter the response. Valid values are: album, single, appears_on, compilation

marketstring

An ISO 3166-1 alpha-2 country code. If specified, only content available in that market will be returned

limitinteger

The maximum number of items to return (default: 20, min: 1, max: 50)

Default: 20

offsetinteger

The index of the first item to return (default: 0)

Default: 0

Responses

200Artist albums retrieved successfully

application/json

hrefstring

A link to the Web API endpoint returning the full result

limitinteger

The maximum number of items in the response

nextstringnullable

URL to the next page of items

offsetinteger

The offset of the items returned

previousstringnullable

URL to the previous page of items

totalinteger

The total number of items available

itemsarray<SpotifySimplifiedAlbum>

Array of simplified album objects

Item properties for items
album_typestring · enum

The type of the album

Values: "album", "single", "compilation"

total_tracksinteger

The number of tracks in the album

available_marketsarray<string>

Markets in which the album is available

Item properties for available_markets

string

external_urlsobject
Properties for external_urls
spotifystring

The Spotify URL for the object

hrefstring

A link to the Web API endpoint providing full details

idstring

The Spotify ID for the album

imagesarray<SpotifyImage>

The cover art for the album in various sizes

Item properties for images
urlstring

The source URL of the image

heightintegernullable

The image height in pixels

widthintegernullable

The image width in pixels

namestring

The name of the album

release_datestring

The date the album was first released

release_date_precisionstring · enum

The precision with which release_date value is known

Values: "year", "month", "day"

restrictionsobject

Included when a content restriction is applied

Properties for restrictions
reasonstring

The reason for the restriction

typestring · enum

The object type, always 'album'

Values: "album"

uristring

The Spotify URI for the album

artistsarray<SpotifySimplifiedArtist>

The artists of the album

Item properties for artists
external_urlsobject
Properties for external_urls
spotifystring

The Spotify URL for the object

hrefstring

A link to the Web API endpoint providing full details

idstring

The Spotify ID for the artist

namestring

The name of the artist

typestring · enum

The object type, always 'artist'

Values: "artist"

uristring

The Spotify URI for the artist

album_groupstring · enum

The field to distinguish albums by various groups

Values: "album", "single", "compilation", "appears_on"

400Bad request - missing required parameters

application/json

errorobject

Error details

Properties for error
statusinteger

HTTP status code

messagestring

Error message

Full specification

Download the OpenAPI file for complete schemas, constraints, and examples.

Download social.json
View operation source
json
{
  "description": "Get Spotify catalog information about an artist's albums.",
  "parameters": [
    {
      "name": "id",
      "in": "query",
      "description": "The Spotify ID of the artist",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "include_groups",
      "in": "query",
      "description": "A comma-separated list of keywords to filter the response. Valid values are: album, single, appears_on, compilation",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "market",
      "in": "query",
      "description": "An ISO 3166-1 alpha-2 country code. If specified, only content available in that market will be returned",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "limit",
      "in": "query",
      "description": "The maximum number of items to return (default: 20, min: 1, max: 50)",
      "required": false,
      "schema": {
        "type": "integer",
        "default": 20,
        "minimum": 1,
        "maximum": 50
      }
    },
    {
      "name": "offset",
      "in": "query",
      "description": "The index of the first item to return (default: 0)",
      "required": false,
      "schema": {
        "type": "integer",
        "default": 0
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Artist albums retrieved successfully",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/SpotifyArtistAlbumsResponse"
          }
        }
      }
    },
    "400": {
      "description": "Bad request - missing required parameters",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/SpotifyErrorResponse"
          }
        }
      }
    }
  }
}