Skip to main content
POST
/
v1
/
music
/
songs:batchGet
BatchGetSongs
curl --request POST \
  --url https://sdk.anghami.com/v1/music/songs:batchGet \
  --header 'Content-Type: application/json' \
  --data '
{
  "songIdList": [
    {
      "value": "<string>"
    }
  ]
}
'
{
  "results": {}
}

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"

Body

application/json

BatchGetSongsRequest is the request message for retrieving multiple songs by ID.

​
songIdList
object[]
Required array length: 1 - 100 elements

Response

Successful response

BatchGetSongsResponse is the response message containing the requested songs.

​
results
object

Map of song ID to result. Every requested ID appears in this map. Value is either the song or an error explaining why it could not be retrieved.