AzuraCast API Reference

AzuraCast API Reference

This page is for people building their own widgets. It documents which AzuraCast public endpoints this project reads and the shape of the now-playing response. Verified live on 2026-06-28.

To see how these endpoints map onto the named widget fields this service produces, see Field Catalog.

Public endpoints (no auth)

Endpoint	Returns
/api/nowplaying/{station}	Full now-playing state (see shape below)
/api/station/{station}	Station meta: stream/listen URLs, mounts (bitrate/format), requests_enabled
/api/station/{station}/schedule	Upcoming shows/events (array, can be empty)
/api/station/{station}/requests	Requestable songs (request_id, request_url, song{})
/api/stations	All stations on the instance
/api/nowplaying/{station}/art	Redirect to current album art

Auth-gated endpoints (do not use for public widgets)

These return 403 to anonymous callers, so they are intentionally not used. Keeping the widget on public endpoints keeps it purely read-only.

• /api/station/{station}/streamers
• /api/station/{station}/podcasts

Now-playing response shape

station{ name, description, listen_url, public_player_url, mounts[]{ bitrate, format, name, is_default }, requests_enabled }
listeners{ current, total, unique }
live{ is_live, streamer_name, broadcast_start, art }
now_playing{ elapsed, duration, remaining, playlist, is_request, song{ id, art, text, artist, title, album, genre, isrc, lyrics } }
playing_next{ duration, playlist, song{ ... } }
song_history[]{ song{ ... } }
is_online

Gotchas

• Plain HTTP requests 307-redirect to HTTPS. Use the https:// base or follow redirects.
• The now-playing payload already contains a lot beyond the obvious track fields: playing_next (up-next track), now_playing.remaining, song.genre/isrc/lyrics/text, listeners.total/unique, live.broadcast_start/art, and station.mounts[].bitrate/format. Read it before adding extra fetches.

See Field Catalog for how each of these paths maps to a widget field.