📡API

An API for developers!

The API request limit is set to 5 requests per second.

flazeinfo

GET https://api.flazebot.com/flazeinfo

Allows you to retrieve the status of flazebot. (Updated every minute)

Headers

Name	Type	Description
accept	application/json

200: OK OK

{
  "flazeinfo": {
    "members": 17501,
    "guilds": 75,
    "ping": 132 (ms),
    "shard_count": 1,
    "cpu_usage": 11 (%),
    "memory_usage": 124 (MB),
    "storage_usage": 60 (MB),
    "listeners": 2,
    "voice_connections": 9,
    "data_refresh": "2021-11-28T14:27:21.275691+01:00"
  },
  "status": 200
}

shards

GET https://api.flazebot.com/shards

Allows you to retrieve the status of all FlazeBot shards. (Updated every 5 minutes)

Headers

Name	Type	Description
accept	application/json

200: OK OK

{
    "shards_info": {
        "shards": {
            "0": {
                "shard_id": "0",
                "ping": 113
            }
        },
        "shard_count": 1,
        "data_refresh": "2021-11-28T14:27:21.276272+01:00"
    },
    "status": 200
}

radioinfo

GET https://api.flazebot.com/radioinfo

Allows you to retrieve the status of all FlazeBot Radio. (updated every 30 seconds)

Headers

Name	Type	Description
accept	application/json

200: OK OK

{
    "radio_info": {
        "radio": {
            "phonk": {
                "name": "Phonk",
                "id": 1,
                "title": "Ignored",
                "artist": "JOINTMANE",
                "art": "https://radio.flazebot.com/api/station/1/art/572de828ad68c80fa2a90ff4-1653828725.jpg",
                "duration": 210 (seconds),
                "played_at": 1655221111 (timestamp),
                "listeners": 1,
                "listeners_peak": 2
            },
            "future_bass": {
                "name": "Future Bass",
                "id": 3,
                "title": "Dasvin - Cycle",
                "artist": "Dasvin Music",
                "art": "https://radio.flazebot.com/static/uploads/album_art.1653581680.jpg",
                "duration": 161 (seconds),
                "played_at": 1655221210 (timestamp),
                "listeners": 0,
                "listeners_peak": 0
            }
        },
        "radio_count": 2,
        "all_listeners": 1,
        "data_refresh": "2022-06-14T17:41:28.710076+02:00"
    }
}

status

GET https://api.flazebot.com/status

Allows to retrieve the status of FlazeBot servers. (Ping Update every 1 minute)

Headers

Name	Type	Description
accept	application/json

200: OK OK

{
    "Website": {
        "name": "Website",
        "status": 1 (0 = Offline, 1 = Online),
        "ping": 136 (ms),
        "url": "https://flazebot.com",
        "hostname": null
    },
    "data_refresh": "2022-04-25 18:14:21.132008+02:00",
    "Zircon": {
        "name": "Zircon",
        "status": 1 (0 = Offline, 1 = Online),
        "ping": 16 (ms),
        "url": "https://",
        "hostname": "zircon.flazebot.com"
    },
    "Quartz": {
        "name": "Quartz",
        "status": 1 (0 = Offline, 1 = Online),
        "ping": 0 (ms),
        "url": "https://",
        "hostname": "quartz.flazebot.com"
    },
    "Opale": {
        "name": "Opale",
        "status": 1 (0 = Offline, 1 = Online),
        "ping": 0 (ms),
        "url": "https://",
        "hostname": "opale.flazebot.com"
    },
    "Cobalt": {
        "name": "Cobalt",
        "status": 1 (0 = Offline, 1 = Online),
        "ping": 14 (ms),
        "url": "https://",
        "hostname": "cobalt.flazebot.com"
    },
    "status": 200
}

radionews

GET https://api.flazebot.com/radionews

Allows you to get news from Flazebot radio (updated every Monday)

Headers

Name	Type	Description
accept	application/json

200: OK OK

{
  "new_radio_stats": {
    "total_songs": 169,
    "total_seconds": 25991
  },
  "deleted_radio_stats": {
    "total_songs": 97,
    "total_seconds": 19510
  },
  "new_songs_stats": {
    "total_songs": 1,
    "total_seconds": 213
  },
  "deleted_songs_stats": {
    "total_songs": 1,
    "total_seconds": 187
  },
  "deleted_radio": {
    "test": {
      "radio_name": "Test",
      "songs_number": 97
    }
  },
  "new_radio": {
    "phonk": {
      "radio_name": "Phonk",
      "songs_number": 169
    }
  },
  "radio": {
    "phonk": {
      "deleted_songs": null,
      "new_songs": null,
      "radio_name": "Phonk"
    },
    "future_bass": {
      "deleted_songs": [
        {
          "unique_id": "550aa7aa8f1d78c0aee80e03",
          "album": "Control",
          "genre": null,
          "lyrics": null,
          "isrc": null,
          "length": 187,
          "length_text": "3:07",
          "path": "Bishu_Anjulie_-_Control_Monstercat_Release.mp3",
          "mtime": 1653835124,
          "amplify": null,
          "fade_overlap": null,
          "fade_in": null,
          "fade_out": null,
          "cue_in": null,
          "cue_out": null,
          "art_updated_at": 1653835129,
          "id": 909,
          "song_id": "d996dc16e203f24c11adc8574e450090",
          "text": "Bishu & Anjulie - Control",
          "artist": "Bishu & Anjulie",
          "title": "Control",
          "custom_fields": [],
          "links": {
            "self": "https://radio.flazebot.com/api/station/3/file/909"
          }
        }
      ],
      "new_songs": [
        {
          "unique_id": "bf589eed50dd428fbfc5775c",
          "album": "Eternal",
          "genre": null,
          "lyrics": null,
          "isrc": null,
          "length": 213,
          "length_text": "3:33",
          "path": "Athena_smle_-_Eternal_Monstercat_Release.mp3",
          "mtime": 1653835121,
          "amplify": null,
          "fade_overlap": null,
          "fade_in": null,
          "fade_out": null,
          "cue_in": null,
          "cue_out": null,
          "art_updated_at": 0,
          "id": 907,
          "song_id": "eb5bbaf19aa50db4c61ebe90c7639567",
          "text": "Athena, smle - Eternal",
          "artist": "Athena, smle",
          "title": "Eternal",
          "custom_fields": [],
          "links": {
            "self": "https://radio.flazebot.com/api/station/3/file/907"
          }
        }
      ],
      "radio_name": "Future Bass"
    }
  },
  "datatime_radio_last": "2022-06-24",
  "datatime_radio_next": "2022-06-27",
  "data_refresh_date": "2022-06-24",
  "data_refresh": "2022-06-24 00:48:30.513064+02:00",
  "status": 200
}

playlists

GET https://api.flazebot.com/playlists

Allows you to retrieve the FlazeBot playlist (updated every Monday)

Path Parameters

Name	Type	Description
radio_name*	String

200: OK phonk

{
    "name": "Phonk",
    "id": 1,
    "songs": [
        {
            "unique_id": "0bc6a828e28a53794becd5e7",
            "song_id": "a268bd128a1166f4af5feb014b6f372a",
            "id": 732,
            "title": "3-6 Destruction",
            "artist": "Pharmacist",
            "length": 122,
            "length_text": "2:02",
            "art": "https://radio.flazebot.com/api/station/1/art/732"
        },
        {
            "unique_id": "a3733bc35de7a7a51cf1cc73",
            "song_id": "daca95271e3c3f083bb0ee56f43b2f64",
            "id": 733,
            "title": "KERAUNOS KILLER (Speed Up)",
            "artist": "4WHEEL",
            "length": 76,
            "length_text": "1:16",
            "art": "https://radio.flazebot.com/api/station/1/art/733"
        },
        {
            "unique_id": "b673a0f50e1d238bd48165a2",
            "song_id": "9ac2ac480f778740f9749fd823e815cc",
            "id": 734,
            "title": "ETERNITY",
            "artist": "509 $icario x CRXSADER x Chillify x PLUTO!",
            "length": 133,
            "length_text": "2:13",
            "art": "https://radio.flazebot.com/api/station/1/art/734"
        },
        {
            "unique_id": "872964ff95113d6f3c5a0990",
            "song_id": "354ee76b301d783f6511fce792e0f403",
            "id": 735,
            "title": "7VNSPEED",
            "artist": "7oh2",
            "length": 210,
            "length_text": "3:30",
            "art": "https://radio.flazebot.com/api/station/1/art/735"
        },
        {
            "unique_id": "6a239ed0511974af140e5758",
            "song_id": "a3fb6b9b7f2d67ad03251b0f22faf191",
            "id": 736,
            "title": "In the Sky",
            "artist": "7vvch",
            "length": 156,
            "length_text": "2:36",
            "art": "https://radio.flazebot.com/api/station/1/art/736"
        },
        {
            "unique_id": "1412c8493503770c82162be4",
            "song_id": "8d857d379e47888fe37b571ba3a1eb55",
            "id": 737,
            "title": "AFTERLIFE",
            "artist": "CYREX",
            "length": 196,
            "length_text": "3:16",
            "art": "https://radio.flazebot.com/api/station/1/art/737"
        },
        {
            "unique_id": "99d0ea55dbefb960cb6feb4f",
            "song_id": "e8ddadd94c117617fe5e7ce23c11a139",
            "id": 738,
            "title": "Angel & Demon",
            "artist": "Valisbeats",
            "length": 201,
            "length_text": "3:21",
            "art": "https://radio.flazebot.com/api/station/1/art/738"
        }
    ]
}

search

GET https://api.flazebot.com/search

Allows you to search for songs in FlazeBot playlists.

Query Parameters

Name	Type	Description
search_string*	String
search_radio*	String
search_max	Integer

200: OK

{
  "songs_found": [
    {
      "unique_id": "65af14858b77fc4ce340ac6f",
      "song_id": "555d5548f4e0baa43098b088b75f8589",
      "id": 754,
      "title": "COLLAB",
      "artist": "PHONK WALKER",
      "length": 172,
      "length_text": "2:52",
      "art": "https://radio.flazebot.com/api/station/1/art/754"
    },
    {
      "unique_id": "d7cc4739767c9a4f6680a297",
      "song_id": "b39f3eb5a7cc0141e6cea38222a14463",
      "id": 810,
      "title": "Keraunos",
      "artist": "PlayaPhonk",
      "length": 145,
      "length_text": "2:25",
      "art": "https://radio.flazebot.com/api/station/1/art/810"
    },
    {
      "unique_id": "d540189b9aa098e030977c20",
      "song_id": "7c4dd4003d26d265f642624764180d34",
      "id": 812,
      "title": "KILLASTORE II",
      "artist": "PHOROMANE, Phonk Killer",
      "length": 105,
      "length_text": "1:45",
      "art": "https://radio.flazebot.com/api/station/1/art/812"
    },
    {
      "unique_id": "25b10eb66cb5e67b41bc9a84",
      "song_id": "82831e7a8e3c40b8552bbea2360c65d1",
      "id": 763,
      "title": "DISCOPHONKO",
      "artist": "$uLTANR$",
      "length": 160,
      "length_text": "2:40",
      "art": "https://radio.flazebot.com/api/station/1/art/763"
    },
    {
      "unique_id": "4994249001f9bbdeb97ac44e",
      "song_id": "166eaa3a619afeaefbb07271ae0160c7",
      "id": 793,
      "title": "Graveyard Phonk",
      "artist": "DeadJxhn, Yavomag, Georgios Mouzenidis, Alexandros Papantoniou",
      "length": 145,
      "length_text": "2:25",
      "art": "https://radio.flazebot.com/api/station/1/art/793"
    }
  ]
}