GET /nowplaying · SYNK Radio API

GET/nowplaying

What SYNK Radio is playing right now. Returns the current track, listener count, playlist and streamer, plus what is coming up next and the recent song history.

Rate limit

30 req/min

Caching

Not cached on our end. Every call goes straight to the station.

Notes

Poll no more than once every couple of seconds. The stream metadata does not update faster than that.
song_history is the last few plays with timestamps, most recent first.
listeners.current is the live count. Do not treat it as unique users; a single tab counts.

Authentication

Send a User-Agent header containing a contact email. See authentication.

Parameters

Name	Type	Required	Description
station	string	optional	Station shortcode. Defaults to synk_radio.

Request

curl 'https://api.synkradio.co.uk/nowplaying' \
  -H 'User-Agent: [email protected]'

Try it

GETTry it

Sends a real request

station · stringUser-Agent · header

https://api.synkradio.co.uk/nowplaying

Response

200 application/json

{
  "station": {
    "id": 1,
    "name": "SYNK Radio",
    "shortcode": "synk_radio",
    "description": "",
    "frontend": "icecast",
    "backend": "liquidsoap",
    "timezone": "Europe/London",
    "listen_url": "",
    "url": "https://synkradio.co.uk",
    "public_player_url": "",
    "playlist_pls_url": "",
    "playlist_m3u_url": "",
    "is_public": true,
    "requests_enabled": false,
    "mounts": [
      {
        "id": 1,
        "name": "/radio.mp3 (192kbps MP3)",
        "url": "",
        "bitrate": 192,
        "format": "mp3",
        "listeners": {
          "total": 4,
          "unique": 1,
          "current": 4
        },
        "path": "/radio.mp3",
        "is_default": true
      }
    ],
    "remotes": [],
    "hls_enabled": false,
    "hls_is_default": false,
    "hls_url": null,
    "hls_listeners": 0
  },
  "listeners": {
    "total": 4,
    "unique": 1,
    "current": 4
  },
  "live": {
    "is_live": false,
    "streamer_name": "",
    "broadcast_start": null,
    "art": null
  },
  "now_playing": {
    "sh_id": 133177,
    "played_at": 1789425835,
    "duration": 173,
    "playlist": "New",
    "streamer": "",
    "is_request": false,
    "song": {
      "id": "0513e6f92dce44b07df5dcd299722fdd",
      "art": "",
      "custom_fields": [],
      "text": "benny blanco - Eastside - Eastside",
      "artist": "benny blanco",
      "title": "Eastside",
      "album": "Eastside",
      "genre": "",
      "isrc": "USUM71809132",
      "lyrics": ""
    },
    "elapsed": 56,
    "remaining": 117
  },
  "playing_next": {
    "cued_at": 1789425823,
    "played_at": 1789426004,
    "duration": 212.6105,
    "playlist": "Underground",
    "is_request": false,
    "song": {
      "id": "159b468c54a20ab9af148f3873e26112",
      "art": "",
      "custom_fields": [],
      "text": "Unglued, Duskee - Minimalizm",
      "artist": "Unglued, Duskee",
      "title": "Minimalizm",
      "album": "",
      "genre": "",
      "isrc": "",
      "lyrics": ""
    }
  },
  "song_history": [
    {
      "sh_id": 133175,
      "played_at": 1789425615,
      "duration": 218,
      "playlist": "New",
      "streamer": "",
      "is_request": false,
      "song": {
        "id": "04ed09f7447b42aaaab4a3d9374a2c13",
        "art": "",
        "custom_fields": [],
        "text": "James Arthur - The Greatest Showman: Reimagined - Rewrite The Stars",
        "artist": "James Arthur",
        "title": "Rewrite The Stars",
        "album": "The Greatest Showman: Reimagined",
        "genre": "",
        "isrc": "USAT21811541",
        "lyrics": ""
      }
    },
    "..."
  ],
  "is_online": true,
  "cache": null
}

Response schema

Field	Type	Example
station	object	20 fields
listeners	object	3 fields
live	object	4 fields
now_playing	object	9 fields
playing_next	object	6 fields
song_history	array<object>	2 items
is_online	boolean	true
cache	null	null

Previous/live Next/search