Skip to main content
GET
/
v1
/
soundtrack
/
songs
/
{song_id}
/
associated-content
GetAssociatedContent
curl --request GET \
  --url https://sdk.anghami.com/v1/soundtrack/songs/{song_id}/associated-content
{
  "entries": [
    {
      "showId": {
        "value": "<string>"
      },
      "movieId": {
        "value": "<string>"
      },
      "title": {
        "value": "<string>",
        "originalValue": "<string>"
      },
      "description": {
        "value": "<string>",
        "originalValue": "<string>"
      },
      "artwork": [
        {
          "url": "<string>",
          "width": 123,
          "height": 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

song_id
string
required

Unique identifier of the song to look up.

Query Parameters

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.

content_types
string[]

Optional filter for content types. If empty, returns all associated content (shows and movies). If specified, filters to only the specified types.

Response

Successful response

GetAssociatedContentResponse is the response message containing shows and movies that feature the requested song.

entries
object[]
nextPageToken
string

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

totalCount
integer<int32>

Total number of associated content items. Useful for display, e.g., "Featured in 5 shows and movies".