DocumentationGet all Spaces
GET
http
https://api.atomic.radio/spaceshttps://api.atomic.radio/spacesReturns a list with all space objects.
Space Structure
Deprecation Warning for stream_urls
stream_urls will be removed early next year. Existing systems should switch to streams.
Further information: Transitioning to HLS.
| Field | Type | Description |
|---|---|---|
| id | String | The id of the space |
| name | String | The name of the space |
| listeners | Number | Current number of listeners |
| categories | String[] | The categories of the space |
| includes | String[] | Dependence on other Spaces |
| upload | Boolean | If something can be uploaded |
| current_show? | Show | The live show of the space |
| current_track? | SpaceTrack | The current track of the space |
| next_tracks? | SpaceTrack[] | The next 10 tracks of the space |
| last_tracks? | SpaceTrack[] | The last 10 track of the space |
| streams | { progressive: String, hls: String } | All stream mountpoints that are available |
| stream_urls | { type: String, url: String }[] | All stream mountpoints that are available |
| updatedAt | Date | Last update of the space |
| createdAt | Date | First update of the space |
Space Track Structure
| Field | Type | Description |
|---|---|---|
| id | String | The id of the track |
| artist | String | The artist of the track |
| title | String | The title of the track |
| duration | Number | The duration of the track in seconds |
| artwork | String | The artwork of the track as a url |
| preview? | String | The audio preview of the track as a url |
| preview_video? | String | The video preview of the track as a url |
| startingAt | Date | When the track is played |
| endingAt | Date | When the track ends |
Example Space Structure
Deprecation Warning for stream_urls
stream_urls will be removed early next year. Existing systems should switch to streams.
Further information: Transitioning to HLS.
json
{
"id": "one",
"name": "ONE",
"listeners": 0,
"categories": [
"Hits",
"Electronic"
],
"includes": [
"hits>2013",
"remix",
"clubsounds"
],
"upload": true,
"current_show": null,
"current_track": {
"id": "6878098175098359808",
"artist": "Gokhan Kosar",
"title": "Hey",
"duration": 245,
"artwork": "https://assets.atomic.radio/tracks/artworks/6878098175098359808.jpg",
"preview": null,
"preview_video": null,
"startingAt": "2022-12-31T13:02:03.000Z",
"endingAt": "2022-12-31T13:06:08.000Z"
},
"next_tracks": [
{
"id": "6854942149205561344",
"artist": "Imanbek & Martin Jensen",
"title": "I'm Just Feelin'",
"duration": 162,
"artwork": "https://assets.atomic.radio/tracks/artworks/6854942149205561344.jpg",
"preview": null,
"preview_video": null,
"startingAt": "2022-12-31T13:06:16.000Z",
"endingAt": "2022-12-31T13:08:58.000Z"
},
// ....
],
"last_tracks": [
{
"id": "6855093871357988864",
"artist": "Kygo feat. Will Heard",
"title": "Nothing Left",
"duration": 237,
"artwork": "https://assets.atomic.radio/tracks/artworks/6855093871357988864.jpg",
"preview": null,
"preview_video": null,
"startingAt": "2022-12-31T12:58:11.000Z",
"endingAt": "2022-12-31T13:02:08.000Z"
},
// ...
],
"streams": {
"progressive": "https://listen.atomic.radio/one",
"hls": "https://listen.atomic.radio/one.m3u8"
},
"stream_urls": [
{
"type": "lossless",
"url": "https://listen.atomic.radio/one/lossless"
},
{
"type": "highquality",
"url": "https://listen.atomic.radio/one/highquality"
},
{
"type": "middlequality",
"url": "https://listen.atomic.radio/one/middlequality"
},
{
"type": "lowquality",
"url": "https://listen.atomic.radio/one/lowquality"
}
],
"updatedAt": "2022-12-31T13:02:04.122Z",
"createdAt": "2022-12-30T23:00:19.376Z"
}{
"id": "one",
"name": "ONE",
"listeners": 0,
"categories": [
"Hits",
"Electronic"
],
"includes": [
"hits>2013",
"remix",
"clubsounds"
],
"upload": true,
"current_show": null,
"current_track": {
"id": "6878098175098359808",
"artist": "Gokhan Kosar",
"title": "Hey",
"duration": 245,
"artwork": "https://assets.atomic.radio/tracks/artworks/6878098175098359808.jpg",
"preview": null,
"preview_video": null,
"startingAt": "2022-12-31T13:02:03.000Z",
"endingAt": "2022-12-31T13:06:08.000Z"
},
"next_tracks": [
{
"id": "6854942149205561344",
"artist": "Imanbek & Martin Jensen",
"title": "I'm Just Feelin'",
"duration": 162,
"artwork": "https://assets.atomic.radio/tracks/artworks/6854942149205561344.jpg",
"preview": null,
"preview_video": null,
"startingAt": "2022-12-31T13:06:16.000Z",
"endingAt": "2022-12-31T13:08:58.000Z"
},
// ....
],
"last_tracks": [
{
"id": "6855093871357988864",
"artist": "Kygo feat. Will Heard",
"title": "Nothing Left",
"duration": 237,
"artwork": "https://assets.atomic.radio/tracks/artworks/6855093871357988864.jpg",
"preview": null,
"preview_video": null,
"startingAt": "2022-12-31T12:58:11.000Z",
"endingAt": "2022-12-31T13:02:08.000Z"
},
// ...
],
"streams": {
"progressive": "https://listen.atomic.radio/one",
"hls": "https://listen.atomic.radio/one.m3u8"
},
"stream_urls": [
{
"type": "lossless",
"url": "https://listen.atomic.radio/one/lossless"
},
{
"type": "highquality",
"url": "https://listen.atomic.radio/one/highquality"
},
{
"type": "middlequality",
"url": "https://listen.atomic.radio/one/middlequality"
},
{
"type": "lowquality",
"url": "https://listen.atomic.radio/one/lowquality"
}
],
"updatedAt": "2022-12-31T13:02:04.122Z",
"createdAt": "2022-12-30T23:00:19.376Z"
}