Skip to main content
POST
/
v1
/
streaming
/
video
AcquireVideoStream
curl --request POST \
  --url https://sdk.anghami.com/v1/streaming/video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "maxQuality": "VIDEO_QUALITY_UNSPECIFIED"
}
'
{
  "stream": {
    "manifestUrl": "<string>",
    "drmScheme": "DRM_SCHEME_UNSPECIFIED",
    "licenseUrl": "<string>",
    "drmParams": {},
    "expiresInSeconds": 123,
    "availableQualities": [
      {
        "label": "<string>",
        "bitrateKbps": 123,
        "codec": "<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 'stream' scope. Required for all streaming operations. Format: Bearer <access_token>.

Example:

"Bearer eyJhbGciOiJSUzI1NiIs..."

​
Accept-Language
string

Preferred locale for error messages and metadata (BCP 47).

Example:

"ar"

Body

application/json

AcquireVideoStreamRequest is the request message for acquiring a video stream. This is the billable event for video playback.

​
movieId
object

MovieID is a typed identifier for a movie.

​
episodeId
object

EpisodeID is a typed identifier for an episode.

​
maxQuality
enum<string>

VideoQuality enumerates the available video stream quality tiers.

Available options:
VIDEO_QUALITY_UNSPECIFIED,
VIDEO_QUALITY_SD,
VIDEO_QUALITY_HD,
VIDEO_QUALITY_FULL_HD,
VIDEO_QUALITY_UHD

Response

Successful response

AcquireVideoStreamResponse is the response message containing the video stream details.

​
stream
object

StreamInfo contains the information required to play a stream. Returned by all stream acquisition RPCs.