Get Task

Query suno tasks

Single Query

Use the GET request to fetch data using a specific ID:

API Request Example

To fetch data from, use the following cURL command:

curl --location --request GET 'https://api.unifically.com/suno/feed/taskid1,taskid2' \
--header 'Authorization: Bearer YOUR_API_KEY'

[
    {
        "allow_comments": true,
        "audio_url": "https://cdn1.suno.ai/d5ba7590-d962-4a38-a3e4-1e78702337f4.mp3",
        "avatar_image_url": "https://cdn1.suno.ai/sAura8.jpg",
        "comment_count": 0,
        "created_at": "2025-07-23T08:09:30.106Z",
        "display_name": "HystericalDJMix6466",
        "entity_type": "song_schema",
        "explicit": false,
        "flag_count": 0,
        "handle": "hystericaldjmix6466",
        "has_hook": false,
        "id": "d2ba7590-d962-4a38-a3e4-1e78702337f4",
        "image_large_url": "https://cdn2.suno.ai/image_large_d5ba4590-d962-4a38-a3e4-1e78702337f4.jpeg",
        "image_url": "https://cdn2.suno.ai/image_d5ba4590-d962-4a38-a3e4-1e78702337f4.jpeg",
        "is_contest_clip": false,
        "is_following_creator": false,
        "is_handle_updated": false,
        "is_liked": false,
        "is_public": false,
        "is_trashed": false,
        "major_model_version": "v4.5",
        "metadata": {
            "can_remix": true,
            "duration": 198.72,
            "is_remix": false,
            "priority": 10,
            "prompt": "",
            "refund_credits": false,
            "stream": true,
            "tags": "",
            "type": "gen"
        },
        "model_name": "chirp-auk",
        "play_count": 0,
        "status": "complete",
        "title": "",
        "upvote_count": 0,
        "video_url": "https://cdn1.suno.ai/d5ba7590-d162-4a38-a3e4-1e78702337f4.mp4"
    }
]

Replace YOUR_API_KEYwith your actual access token to authenticate the request.

API Request for Song Lyrics

Use the following cURL command to retrieve song lyrics:

curl --location --request GET 'https://api.unifically.com/suno/lyrics/taskid' \
--header 'Authorization: Bearer YOUR_API_KEY'

Example Response

The response will provide the song lyrics, title, status, and additional metadata:

{
    "text": "[Verse]\nThe sky is torn the ground is shaking\nShadows fall but hearts aren't breaking\nSteel in hand and fire in veins\nThe call of war runs through our chains\n\n[Chorus]\nWe rise we fight we never fall\nThrough the smoke we hear the call\nBattle cries like thunder roar\nThis is what we're fighting for\n\n[Verse 2]\nMarching boots and banners flying\nUnderneath the stars we're trying\nBlood and sweat on earth collide\nWe won't stop till we decide\n\n[Chorus]\nWe rise we fight we never fall\nThrough the smoke we hear the call\nBattle cries like thunder roar\nThis is what we're fighting for\n\n[Bridge]\nThe enemy's close the night is near\nBut courage is louder than any fear\nA thousand voices one command\nWe hold the line we make our stand\n\n[Chorus]\nWe rise we fight we never fall\nThrough the smoke we hear the call\nBattle cries like thunder roar\nThis is what we're fighting for",
    "title": "Battle Cry",
    "status": "complete",
    "error_message": "",
    "tags": [
        "powerful",
        "anthemic",
        "driving percussion and electric guitar riff"
    ]
}

Replace YOUR_API_KEY with your actual access token to authenticate the request.