Skip to main content
GET
/
v1
/
discovery
/
browse
/
charts
BrowseCharts
curl --request GET \
  --url https://sdk.anghami.com/v1/discovery/browse/charts
{
  "charts": [
    {
      "chart": {
        "id": {
          "value": "<string>"
        },
        "name": "<string>",
        "description": "<string>",
        "contentType": "CONTENT_TYPE_UNSPECIFIED",
        "region": "<string>",
        "artwork": {
          "url": "<string>",
          "width": 123,
          "height": 123
        },
        "lastUpdated": "<string>"
      },
      "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>"
}

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"

Query Parameters

​
page_size
integer<int32>

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

BrowseChartsResponse is the response message containing available charts with their top entries.

​
charts
object[]
​
nextPageToken
string

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