Skip to main content
GET
/
v1
/
video
/
seasons
/
{id}
GetSeason
curl --request GET \
  --url https://sdk.anghami.com/v1/video/seasons/{id}
{
  "season": {
    "id": {
      "value": "<string>"
    },
    "showId": {
      "value": "<string>"
    },
    "seasonNumber": 123,
    "title": {
      "value": "<string>",
      "originalValue": "<string>"
    },
    "description": {
      "value": "<string>",
      "originalValue": "<string>"
    },
    "episodeCount": 123,
    "airDate": "<string>",
    "artwork": [
      {
        "url": "<string>",
        "width": 123,
        "height": 123
      }
    ]
  },
  "episodes": [
    {
      "id": {
        "value": "<string>"
      },
      "showId": {
        "value": "<string>"
      },
      "seasonId": {
        "value": "<string>"
      },
      "seasonNumber": 123,
      "episodeNumber": 123,
      "title": {
        "value": "<string>",
        "originalValue": "<string>"
      },
      "description": {
        "value": "<string>",
        "originalValue": "<string>"
      },
      "durationMs": 123,
      "airDate": "<string>",
      "guestCast": [
        {
          "id": {
            "value": "<string>"
          },
          "name": {
            "value": "<string>",
            "originalValue": "<string>"
          },
          "role": "<string>",
          "profileImageUrl": "<string>",
          "isLead": true
        }
      ],
      "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

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

id
string
required

Unique identifier of the season to retrieve.

Query Parameters

page_size
integer<int32>

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

GetSeasonResponse is the response message containing the requested season and its episodes.

season
object

Season represents a full season within a show. Contains complete metadata but not the episode list - use GetSeason for paginated episodes.

episodes
object[]
nextPageToken
string

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