Skip to the content
Get an API key
  1. API reference
  2. Read and write a user's library

Get user's liked albums

GET/api/{integrationUserUUID}/albums
CoreAuthBasicDevTokenDocsSessionToken

This endpoint fetches liked albums from Music Service.

Path parameters

integrationUserUUID
uuidrequired

The connected user: the integrationUserUUID from the sign-in callback.

Query parameters

nextParam
string

Parameter returned in the response responsible for pagination.

limitParam
number

Specifies the maximum number of results per request, adjusted based on the limitations of the respective music service. Ignored if the service doesn't support such a limit.

Response

200application/json · AlbumsResponseok
results
Album[]
required
results[].id
string
required
results[].name
string
required
results[].totalItems
number | null
required
results[].imageUrl
string | null
required
results[].artists
ArtistSimplified[] | null
required
results[].artists.id
string | null
required
results[].artists.entryId
string | null
requiredIdentifier associated with an artist within a user's library. Artist entry id can be obtained during fetching artists from user's library.
results[].artists.name
string
required
results[].artists.imageUrl
string | null
required
results[].artists.followers
number | null
required
nextParam
string | null
required
totalItems
number | null
required
Example answer
{
  "results": [
    {
      "id": "4Gfnly5CzMJQqkUFfoHaP3",
      "name": "Meteora",
      "totalItems": 13,
      "imageUrl": "https://www.example-image.com/978263478234",
      "artists": [
        null
      ]
    }
  ],
  "nextParam": "eyJvZmZzZXQiOjEwfQ==",
  "totalItems": 25
}

Errors

404

Your account has no connected user with this uuid, or the item does not exist.

412

The user must sign in again (IntegrationUserNotAuthenticated).

429

Too many requests. Wait for the seconds in Retry-After.