Skip to main content
GET
/
v1
/
music
/
songs
/
{song_id}
/
lyrics
GetLyrics
curl --request GET \
  --url https://sdk.anghami.com/v1/music/songs/{song_id}/lyrics
{
  "lyrics": {
    "lines": [
      "<string>"
    ]
  },
  "syncedLyrics": {
    "lines": [
      {
        "text": "<string>",
        "startTimeMs": "<string>"
      }
    ]
  }
}

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 whose lyrics to retrieve.

Response

Successful response

GetLyricsResponse is the response message containing the song's lyrics. Returns either plain-text or time-synchronized lyrics depending on availability.

​
lyrics
object

Lyrics represents plain-text lyrics for a song without timing information.

​
syncedLyrics
object

SyncedLyrics represents time-synchronized lyrics for a song (karaoke-style).