Skip to main content
GET
/
v1
/
discovery
/
browse
/
charts
/
{chart_id}
/
entries
GetChartEntries
curl --request GET \
  --url https://sdk.anghami.com/v1/discovery/browse/charts/{chart_id}/entries
{
  "entries": [
    {
      "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
        }
      },
      "rank": 123,
      "rankChange": 123
    }
  ],
  "nextPageToken": "<string>",
  "totalCount": 123
}

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

chart_id
string
required

Unique identifier of the chart whose entries to retrieve.

Query Parameters

page_size
integer<int32>

Maximum number of entries 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

GetChartEntriesResponse is the response message containing the chart entries.

entries
object[]
nextPageToken
string

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

totalCount
integer<int32>

Total number of entries in this chart.