Skip to main content
GET
/
v1
/
library
/
likes
GetLikedItems
curl --request GET \
  --url https://sdk.anghami.com/v1/library/likes \
  --header 'Authorization: <authorization>'
{
  "items": [
    {
      "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
      }
    }
  ],
  "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
required

OAuth 2.0 Bearer token with the 'read' scope. Required for all library operations. Format: Bearer <access_token>.

Example:

"Bearer eyJhbGciOiJSUzI1NiIs..."

​
Accept-Language
string

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

Example:

"ar"

Query Parameters

​
content_type
string

Filter by content type. If UNSPECIFIED, returns all liked content types (songs and albums).

​
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

GetLikedItemsResponse is the response message containing the user's liked items.

​
items
object[]
​
nextPageToken
string

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