Artist Releases

Returns an artist's Spotify catalog: albums, singles, and tracks. This is the usual first step in a release-automation workflow — fetch the catalog, pick the newest release, then hand its URL to Create Link.

Request

For an artist you manage:

query GetArtistReleases($artist_id: String!) {
  get_artist_releases(artist_id: $artist_id) {
    success
    releases {
      id
      name
      album_name
      type
      url
      cover_image
      release_date
    }
  }
}

For any Spotify artist, whether or not you manage them:

query GetReleasesBySpotifyId($spotify_id: String!) {
  get_releases_by_spotify_id(spotify_id: $spotify_id) {
    success
    releases {
      id
      name
      album_name
      type
      url
      cover_image
      release_date
    }
  }
}

Arguments

Field	Argument	Type	Description
get_artist_releases	artist_id	String!	ArtistHub artist UUID.
get_releases_by_spotify_id	spotify_id	String!	Spotify artist ID.

Response

{
  "data": {
    "get_artist_releases": {
      "success": true,
      "releases": [
        {
          "id": "4uLU6hMCjMI75M1A2tKUQC",
          "name": "Example Single",
          "album_name": "Example Single",
          "type": "single",
          "url": "https://open.spotify.com/album/4uLU6hMCjMI75M1A2tKUQC",
          "cover_image": "https://i.scdn.co/image/....jpg",
          "release_date": "2026-07-18"
        }
      ]
    }
  }
}

Release fields

Field	Type	Description
id	String	Spotify ID of the release.
name	String	Release title.
album_name	String	Parent album title. Matches name for singles.
type	String	album, single, or track.
url	String	Full open.spotify.com URL. This is what create_link wants for spotify_link.
cover_image	String	Cover art URL.
release_date	String	YYYY-MM-DD. May be less precise for older catalog entries.

Building a link from the newest release

query Latest($artist_id: String!) {
  get_artist_releases(artist_id: $artist_id) {
    releases { name url release_date type }
  }
}

Sort client-side by release_date descending, take the first entry, then:

mutation CreateFromRelease(
  $artist_id: String!
  $domain: String!
  $path: String!
  $spotify_link: String!
) {
  create_link(
    artist_id: $artist_id
    domain: $domain
    path: $path
    type: "release"
    spotify_link: $spotify_link
    fill_dsps: true
  ) {
    success
    link { id domain path title }
  }
}

With type: "release" and fill_dsps: true, ArtistHub resolves the release across Apple Music, Amazon Music, iTunes, Deezer, and TikTok and attaches those destinations for you. See Create Link.

INFO

Releases come from Spotify, so a title that has not propagated through Spotify's catalog yet will not appear here. For an unreleased album, create the link with the pre-release Spotify URL and use fill_missing_deeplinks after release day to backfill the DSPs that were not live at creation time.