Get all Spaces

GET

http

https://api.atomic.radio/spaces

https://api.atomic.radio/spaces

Returns a list with all space objects.

Space Structure

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
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

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"
        },
        // ...
    ],
    "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"
        },
        // ...
    ],
    "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"
}

Get all Spaces ​

Space Structure ​

Space Track Structure ​

Example Space Structure ​

Get all Spaces

Space Structure

Space Track Structure

Example Space Structure