Channels

An endpoint which gives you all information about the current, next and last played songs. You can also find the number of current listeners, who is currently on air and some more info. 📡

A rate limiter takes care of this endpoint, find out more about all the security mechanisms we use here.

get
Get all channels

https://api.atomicradio.eu/channels
This endpoint returns you a list of our channels
Request
Response
Request
Response
200: OK
The response is too big to show here

get
Get live information

https://api.atomicradio.eu/channels/live
This endpoint returns you informations about our livestream.
Request
Response
Request
Response
200: OK
{
"is_live": Boolean,
"streamer": String
}

get
Get channel

https://api.atomicradio.eu/channels/:id
This endpoint returns you informations about a single channel.
Request
Response
Request
Path Parameters
:id
required
string
Here you can use one, dance or trap as parameter value.
Response
200: OK
{
"name": String,
"description": {
"de": String,
"en": String
},
"listeners": Number,
"live":{
"is_live": Boolean,
"streamer": String
},
"song":{
"artist": String,
"title": String,
"playlist": String,
"start_at": Number,
"end_at": Number,
"duration": Number,
"artworks":{
"100": String,
"250": String,
"500": String,
"1000": String
}
},
"schedule":[
{
"artist": String,
"title": String,
"playlist": String,
"start_at": Number,
"end_at": Number,
"duration": Number,
"artworks":{
"100": String,
"250": String,
"500": String,
"1000": String
}
},
],
"history":[
{
"artist": String,
"title": String,
"playlist": String,
"start_at": Number,
"end_at": Number,
"duration": Number,
"artworks":{
"100": String,
"250": String,
"500": String,
"1000": String
}
},
],
"stream_urls":{
"highquality": String,
"middlequality":String,
"lowquality": String
}
}
404: Not Found
{
"code": 404,
"message": "This channel does not exist."
}

get
Get live information

https://api.atomicradio.eu/channels/:id/live
This endpoint returns you informations about our livestream.
Request
Response
Request
Path Parameters
:id
required
string
Here you can use one, dance or trap as parameter value.
Response
200: OK
{
"is_live": Boolean,
"streamer": String
}
404: Not Found
{
"code": 404,
"message": "This channel does not exist."
}
500: Internal Server Error
{
"code": 500,
"message": "Only our channel 'atr.one' has live metadata."
}

get
Get song information

https://api.atomicradio.eu/channels/:id/song
This endpoint returns you informations about the current playing song on this channel.
Request
Response
Request
Path Parameters
:id
required
string
Here you can use one, dance or trap as parameter value.
Response
200: OK
{
"artist": String,
"title": String,
"playlist": String,
"start_at": Number,
"end_at": Number,
"duration": Number,
"artworks":{
"100": String,
"250": String,
"500": String,
"1000": String
}
}
404: Not Found
{
"code": 404,
"message": "This channel does not exist."
}

get
Get listener informations

https://api.atomicradio.eu/channels/:id/listeners
This endpoint returns you the information how many are listening to this channel.
Request
Response
Request
Path Parameters
:id
required
string
Here you can use one, dance or trap as parameter value.
Response
200: OK
{
"listeners": Number
}
404: Not Found
{
"code": 404,
"message": "This channel does not exist."
}

get
Get history list

https://api.atomicradio.eu/channels/:id/history
This endpoint returns you a list of songs that have already been played on this channel.
Request
Response
Request
Path Parameters
:id
required
string
Here you can use one, dance or trap as parameter value.
Response
200: OK
[
{
"artist": String,
"title": String,
"playlist": String,
"start_at": Number,
"end_at": Number,
"duration": Number,
"artworks":{
"100": String,
"250": String,
"500": String,
"1000": String
}
}
]
404: Not Found
{
"code": 404,
"message": "This channel does not exist."
}

get
Get schedule list

https://api.atomicradio.eu/channels/:id/schedule
This endpoint returns you a list of songs that will be played soon on this channel.
Request
Response
Request
Path Parameters
:id
required
string
Here you can use one, dance or trap as parameter value.
Response
200: OK
[
{
"artist": String,
"title": String,
"playlist": String,
"start_at": Number,
"end_at": Number,
"duration": Number,
"artworks":{
"100": String,
"250": String,
"500": String,
"1000": String
}
}
]
404: Not Found
{
"code": 404,
"message": "This channel does not exist."
}