Skip to main content
GET
/
v1
/
music
/
artists
/
{artist_id}
/
discography
GetArtistDiscography
curl --request GET \
  --url https://sdk.anghami.com/v1/music/artists/{artist_id}/discography
{
  "albums": [
    {
      "id": {
        "value": "<string>"
      },
      "title": {
        "value": "<string>",
        "originalValue": "<string>"
      },
      "artists": [
        {
          "id": {
            "value": "<string>"
          },
          "name": {
            "value": "<string>",
            "originalValue": "<string>"
          }
        }
      ],
      "albumType": "ALBUM_TYPE_UNSPECIFIED",
      "releaseDate": "<string>",
      "genres": [
        "<string>"
      ],
      "trackCount": 123,
      "artwork": [
        {
          "url": "<string>",
          "width": 123,
          "height": 123
        }
      ],
      "label": "<string>",
      "upc": "<string>",
      "popularity": 123
    }
  ],
  "nextPageToken": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.sdk.anghami.com/llms.txt

Use this file to discover all available pages before exploring further.

Headers

Authorization
string

OAuth 2.0 Bearer token for user-authenticated requests. Format: Bearer <access_token>. Optional if x-api-key is provided.

Example:

"Bearer eyJhbGciOiJSUzI1NiIs..."

x-api-key
string

API key for server-to-server access without user context. Optional if Authorization is provided.

Example:

"ang_live_..."

Accept-Language
string

Preferred locale for localized content (BCP 47). Determines which language variant is returned for LocalizedString fields.

Example:

"ar"

Path Parameters

artist_id
string
required

Unique identifier of the artist whose discography to retrieve.

Query Parameters

page_size
integer<int32>

Maximum number of items to return per page (1-100, default 20).

page_token
string

Opaque page token from a previous response. Omit for the first page.

album_types
string[]

Filter by album types. Empty list returns all types.

min_release_year
integer<int32>

Minimum release year filter. Zero means no minimum.

max_release_year
integer<int32>

Maximum release year filter. Zero means no maximum.

Response

Successful response

GetArtistDiscographyResponse is the response message containing the artist's albums.

albums
object[]
nextPageToken
string

Token for the next page of results. Empty if no more pages.