Skip to content
Melody Radio

Melody Radio

Melody Stream


Now Playing

Get the current song that is playing on Melody.

Endpoint: /api/nowplaying

Method: GET

Example Request:

GET /api/nowplaying

Example Response:

{
    "nowplaying": {
        "sh_id": 3868,
        "played_at": 1739393660,
        "duration": 258,
        "playlist": "default",
        "streamer": "",
        "is_request": false,
        "song": {
            "id": "08b95ecb428c56d7cc1d2ce36910bf2e",
            "art": "https:\/\/azura.itsmelody.net\/api\/station\/melody_reborn\/art\/2d2c0827f85089595247bb5c-1738686985.jpg",
            "custom_fields": [],
            "text": "Roxy Music - More Than This",
            "artist": "Roxy Music",
            "title": "More Than This",
            "album": "The Best Of Roxy Music",
            "genre": "Rock",
            "isrc": "GBAAA9900092",
            "lyrics": ""
        },
        "elapsed": 194,
        "remaining": 64
    },
    "live": {
        "is_live": false,
        "streamer_name": "Melody Stream",
        "streamer": {
            "id": "-1",
            "avatar": "https:\/\/itsmelody.net\/storage\/images\/logo.png",
            "header": "https:\/\/itsmelody.net\/storage\/images\/melody.png",
            "name": "Melody Stream",
            "discord_tag": "Melody#6073",
            "discord_id": "940319865238077460",
            "twitch": "https:\/\/www.twitch.tv\/itsmelodyNET",
            "tiktok": null,
            "youtube": null,
            "twitter": "https:\/\/twitter.com\/itsmelodynet"
        }
    },
    "listeners": {
        "total": 0,
        "unique": 0,
        "current": 0
    },
    "song_art": {
        "big": "https:\/\/i.scdn.co\/image\/ab67616d0000b273c7972702cff224328b39f8a6",
        "medium": "https:\/\/i.scdn.co\/image\/ab67616d00001e02c7972702cff224328b39f8a6",
        "small": "https:\/\/i.scdn.co\/image\/ab67616d00004851c7972702cff224328b39f8a6"
    },
    "uri": "spotify:track:6N7gPTru90HYLRUIVDQ185"
}

Song Request

Submit a song request to Melody's playlist.

Endpoint: /api/request

Method: POST

Example Request:

POST /api/request
{
    "song": "Requested Song Title",
    "artist": "Requested Artist Name"
}

Example Response:

{
    "message": "Your request has been submitted."
}