Version 1
Public API
Free JSON endpoints for building your own widgets, bots and overlays.
Base URL
https://respawnradio.net/api/v1All endpoints use GET, need no API key and allow cross-origin requests. Please don't poll more than once every 15 seconds.
GET /stats
The current song, who is on air and how many people are listening.
song | id, title, artist, art, preview, likes, dislikes, played |
onair | name, type (auto|show|booking), id, avatar, profile_url, likes, day, hour, show, socials |
listeners | current listener count |
listen_url | stream URL |
last_updated | epoch timestamp |
Fields that don't apply (for example presenter likes while the AutoDJ is on air) return -1.
Try itGET /recentlyPlayed
The last 50 songs played, newest first.
[ ] | array of: id, title, artist, art, preview, likes, dislikes, played, presenter, time (epoch) |
GET /booked
Every booked timetable slot for the current week (Monday to Sunday).
[ ] | array of: name, title, user_id, avatar, day (1 = Monday), hour (station time), week (ISO week number), date, time (epoch), profile_url |
GET /shows
All recurring weekly shows.
[ ] | array of: id, name, host, description, day, hour, url |