Skip to main content
GET
/
v1
/
playlists
/
{id}
GetPlaylist
curl --request GET \
  --url https://sdk.anghami.com/v1/playlists/{id}
{
  "playlist": {
    "id": {
      "value": "<string>"
    },
    "name": {
      "value": "<string>",
      "originalValue": "<string>"
    },
    "description": {
      "value": "<string>",
      "originalValue": "<string>"
    },
    "visibility": "PLAYLIST_VISIBILITY_UNSPECIFIED",
    "ownerId": {
      "value": "<string>"
    },
    "ownerName": "<string>",
    "coverArtwork": {
      "url": "<string>",
      "width": 123,
      "height": 123
    },
    "itemCount": 123,
    "totalDurationMs": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>"
  },
  "items": [
    {
      "content": {
        "songId": {
          "value": "<string>"
        },
        "albumId": {
          "value": "<string>"
        },
        "artistId": {
          "value": "<string>"
        },
        "playlistId": {
          "value": "<string>"
        },
        "showId": {
          "value": "<string>"
        },
        "seasonId": {
          "value": "<string>"
        },
        "episodeId": {
          "value": "<string>"
        },
        "movieId": {
          "value": "<string>"
        },
        "title": "<string>",
        "subtitle": "<string>",
        "artwork": {
          "url": "<string>",
          "width": 123,
          "height": 123
        }
      },
      "position": 123,
      "addedAt": "<string>"
    }
  ],
  "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>. Required for GetUserPlaylists; optional for GetPlaylist if x-api-key is provided.

Example:

"Bearer eyJhbGciOiJSUzI1NiIs..."

x-api-key
string

API key for server-to-server access. Only valid for GetPlaylist on public playlists.

Example:

"ang_live_..."

Accept-Language
string

Preferred locale for localized content in playlist items (BCP 47).

Example:

"ar"

Path Parameters

id
string
required

Unique identifier of the playlist 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.

Response

Successful response

GetPlaylistResponse is the response message containing the playlist and its items.

playlist
object

Playlist represents a user-created or editorial playlist.

items
object[]
nextPageToken
string

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