Skip to content

Get a Space

GET

http
https://api.atomic.radio/spaces/:spaceId
https://api.atomic.radio/spaces/:spaceId

Returns a space object for a given space ID.

Space Structure

FieldTypeDescription
idStringThe id of the space
nameStringThe name of the space
listenersNumberCurrent number of listeners
categoriesString[]The categories of the space
includesString[]Dependence on other Spaces
uploadBooleanIf something can be uploaded
current_show?ShowThe live show of the space
current_track?SpaceTrackThe 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
updatedAtDateLast update of the space
createdAtDateFirst update of the space

Space Track Structure

FieldTypeDescription
idStringThe id of the track
artistStringThe artist of the track
titleStringThe title of the track
durationNumberThe duration of the track in seconds
artworkStringThe artwork of the track as a url
preview?StringThe audio preview of the track as a url
preview_video?StringThe video preview of the track as a url
startingAtDateWhen the track is played
endingAtDateWhen 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"
}