RadioAPI Dokumentation

Echtzeit-Daten für alle Stationen der RadioGruppe – aktuell gespielte Titel, Hörerzahlen, Stationsinfos und Song-Chroniken.

v1 JSON & XML GET only CORS: * UTF-8

API v1 · JSON /v1/json/ · aktuelle stabile Schnittstelle

GET /v1/json/stationData Stationsdaten mit Filtern ▾

Flexibler Endpunkt für Stationsdaten. Kann nach Netzwerk, Station und Genre gefiltert werden. Gibt Echtzeit-Daten (artist, title, listeners…) zurück.

URL-Varianten (Netzwerk)

Format	Beispiel
Query-Parameter	`/v1/json/stationData?network=1`
Pfad · ID	`/v1/json/1/stationData`
Pfad · Name	`/v1/json/lionfm/stationData`

Parameter

Name	Typ	Pflicht	Beschreibung
`network`	integer	optional	Netzwerk-ID (Query oder im Pfad, siehe oben)
`stationID`	integer	optional	Stations-ID im Netzwerk (ext_id). Benötigt `network`
`genre`	integer	optional	Genre-ID
`topStations`	integer	optional	`1` = alle, Top zuerst · `2` = nur Top-Stationen
`array`	integer	optional	`1` = Array · sonst Objekt mit ID als Key
`textFormat`	integer	optional	`1` = Großbuchstaben · `2` = normal · `3` = Kleinbuchstaben

⚡ Try it out

network

URL-Format

stationID

textFormat

http://www.radioapi.de/v1/json/stationData

GET /v1/json/songHistory Song-Chronik nach Zeitraum ▾

Song-Chronik einer Station gefiltert nach Datum und Uhrzeit. Mit from=latest&till=latest die aktuellen Titel der letzten Stunde abrufen.

URL-Varianten (Netzwerk)

Format	Beispiel
Query-Parameter	`/v1/json/songHistory?network=1`
Pfad · ID	`/v1/json/1/songHistory`
Pfad · Name	`/v1/json/lionfm/songHistory`

Parameter

Name	Typ	Pflicht	Beschreibung
`station`	integer	optional	Interne Stations-ID (oder ext_id wenn network gesetzt)
`network`	integer	optional	Netzwerk-ID (Query oder im Pfad) – station wird als ext_id interpretiert
`from`	string	optional	Startzeit `HH:MM` oder `latest`
`till`	string	optional	Endzeit `HH:MM` oder `latest`
`date`	string	optional	Datum `Y-m-d`
`textFormat`	integer	optional	`1` Groß · `2` Normal · `3` Klein

⚡ Try it out

network

URL-Format

station

from / till

http://www.radioapi.de/v1/json/songHistory

GET /v1/json/allListeners Hörersumme (netzwerkübergreifend) ▾

Summiert die Hörer aller oder ausgewählter Netzwerke. Gibt eine einzelne Ganzzahl zurück.

Parameter

Name	Typ	Pflicht	Beschreibung
`network`	string	optional	Kommagetrennte Netzwerk-IDs, z.B. `1,2,3`. Ohne Parameter: alle Netzwerke

⚡ Try it out

network

URL-Format

http://www.radioapi.de/v1/json/allListeners

GET /v1/json/showSchedule Showplan ▾

Gibt alle geplanten Shows zurück (Name, Streamer, Zeiten, Wiederholungsregeln), optional gefiltert nach Station. Jede Show enthält ein cancellations-Array mit abgesagten Einzelterminen.

Parameter

Name	Typ	Pflicht	Beschreibung
`stationID`	integer	optional	Interne Stations-ID – ohne Parameter: alle Shows

Antwort-Felder

Feld	Typ	Beschreibung
`id`	integer	Show-ID
`show_name`	string	Name der Show
`streamer_name`	string	Name des Streamers
`start_time` / `end_time`	string	Uhrzeit (HH:MM:SS)
`start_date` / `end_date`	string	Gültigkeitszeitraum (YYYY-MM-DD)
`repeat_type`	string	`none` · `daily` · `weekly` · `biweekly` · `monthly` u.a.
`weekday`	integer	Wochentag (0 = Sonntag … 6 = Samstag)
`cancellations`	array	Liste abgesagter Termine – leer wenn keine Absagen vorliegen
`cancellations[].date`	string	Datum des abgesagten Termins (YYYY-MM-DD)
`cancellations[].reason`	string\|null	Optionaler Absagegrund

⚡ Try it out

stationID

http://www.radioapi.de/v1/json/showSchedule

GET /v1/json/listenerCounter.json Hörerzähler (statische JSON-Datei) ▾

Statische JSON-Datei mit den aktuellen Hörerzahlen aller Stationen. Wird regelmäßig serverseitig aktualisiert. Keine Query-Parameter.

Parameter

Keine Parameter erforderlich.

⚡ Try it out

/v1/json/listenerCounter.json

API v1 · XML /v1/xml/ · aktuelle stabile Schnittstelle · Content-Type: application/xml

GET /v1/xml/stationData Stationsdaten mit Filtern ▾

Identische Parameter wie /v1/json/stationData, Antwort als XML.

Parameter

Name	Typ	Pflicht	Beschreibung
`network`	integer	optional	Netzwerk-ID
`stationID`	integer	optional	Stations-ID im Netzwerk (ext_id). Benötigt `network`
`genre`	integer	optional	Genre-ID
`topStations`	integer	optional	`1` = alle, Top zuerst · `2` = nur Top-Stationen
`textFormat`	integer	optional	`1` = Großbuchstaben · `2` = normal · `3` = Kleinbuchstaben

⚡ Try it out

network

URL-Format

stationID

http://www.radioapi.de/v1/xml/stationData

GET /v1/xml/songHistory Song-Chronik nach Zeitraum ▾

Identische Parameter wie /v1/json/songHistory, Antwort als XML.

Parameter

Name	Typ	Pflicht	Beschreibung
`station`	integer	optional	Interne Stations-ID (oder ext_id wenn network gesetzt)
`network`	integer	optional	Netzwerk-ID
`from`	string	optional	Startzeit `HH:MM` oder `latest`
`till`	string	optional	Endzeit `HH:MM` oder `latest`
`date`	string	optional	Datum `Y-m-d`

⚡ Try it out

network

URL-Format

station

from / till

http://www.radioapi.de/v1/xml/songHistory

GET /v1/xml/showSchedule Showplan ▾

Identische Parameter und Daten wie /v1/json/showSchedule, Antwort als XML. Abgesagte Termine erscheinen als <cancellations>-Node mit <cancellation><date> und <reason>.

Parameter

Name	Typ	Pflicht	Beschreibung
`stationID`	integer	optional	Interne Stations-ID – ohne Parameter: alle Shows

⚡ Try it out

stationID

http://www.radioapi.de/v1/xml/showSchedule

GET /v1/xml/listenerCounter.xml Hörerzähler aller Stationen ▾

Statische XML-Datei mit den aktuellen Hörerzahlen aller Stationen. Wird regelmäßig serverseitig aktualisiert. Keine Parameter erforderlich.

Parameter

Keine Parameter erforderlich.

⚡ Try it out

/v1/xml/listenerCounter.xml

Vereinfacht /api/ · einfache Standardschnittstelle · kein Versprechen auf Stabilität

GET /api/station_list Alle Stationen, nach Netzwerk gruppiert ▾

Gibt alle aktiven Stationen zurück, gruppiert nach network_id. Enthält Name, Genre, Hörerzahl, Stream-URLs, Farben und Logo.

Parameter

Keine Parameter erforderlich.

Response-Felder

Feld	Typ	Beschreibung
`count`	integer	Gesamtanzahl aller Stationen
`groups[].network_id`	integer	Netzwerk-ID
`groups[].stations[]`	array	Stationen des Netzwerks
`…station.name`	string	Interner Name (laut.fm)
`…station.display_name`	string	Anzeigename
`…station.listeners`	integer	Aktuelle Hörerzahl
`…station.stream.mp3`	string	MP3-Stream-URL
`…station.image`	string	Logo-URL

⚡ Try it out

http://www.radioapi.de/api/station_list

GET /api/{station}/listener Aktuelle Hörerzahl ▾

Gibt die aktuelle Hörerzahl der gewählten Station zurück.

Parameter

Name	Typ	In	Pflicht	Beschreibung
`station`	string	path	required	Stationsname, z.B. `lionfm`

Response-Felder

Feld	Typ	Beschreibung
`station`	string	Stationsname
`listeners`	integer	Anzahl aktiver Hörer

⚡ Try it out

{station}

http://www.radioapi.de/api/{station}/listener

GET /api/{station}/now_playing Aktuell gespielter Titel ▾

Gibt Interpret, Titel, Genre, Start-/Endzeit und Live-Status zurück. Bei LionFM (network_id 1) wird zusätzlich die Cover-URL geliefert.

Parameter

Name	Typ	In	Pflicht	Beschreibung
`station`	string	path	required	Stationsname

Response-Felder

Feld	Typ	Beschreibung
`artist`	string	Interpret (Großbuchstaben)
`title`	string	Titel (Großbuchstaben)
`genre`	string	Genre
`start`	string	Startzeit `Y-m-d H:i:s`
`end`	string	Voraussichtliches Ende
`is_live`	boolean	Läuft gerade ein Live-Streamer?
`cover`	string	Cover-URL – nur bei LionFM

⚡ Try it out

{station}

http://www.radioapi.de/api/{station}/now_playing

GET /api/{station}/info Vollständige Stationsinfos ▾

Beschreibung, Genre, Farben, Stream-URLs, Logo und Live-Status einer Station.

Parameter

Name	Typ	In	Pflicht	Beschreibung
`station`	string	path	required	Stationsname

Response-Felder

Feld	Typ	Beschreibung
`id`	integer	Interne Stations-ID
`network_id`	integer	Zugehöriges Netzwerk
`display_name`	string	Anzeigename
`description`	string	Beschreibungstext
`main_genre`	string	Hauptgenre
`color`	string	Primärfarbe (HEX)
`image`	string	Logo-URL
`stream.mp3 / .m3u / .pls`	string	Stream-URLs
`listeners`	integer	Aktuelle Hörerzahl
`is_live`	boolean	Live-Status

⚡ Try it out

{station}

http://www.radioapi.de/api/{station}/info

GET /api/{station}/last_songs Zuletzt gespielte Titel ▾

Gibt die zuletzt gespielten Titel zurück (Standard: 10, Maximum: 20). Bei LionFM wird das Cover-Bild geliefert.

Parameter

Name	Typ	In	Pflicht	Beschreibung
`station`	string	path	required	Stationsname
`limit`	integer	query	optional	Anzahl Songs, 1–20 (Standard: 10)

Response-Felder

Feld	Typ	Beschreibung
`station`	string	Stationsname
`count`	integer	Anzahl zurückgegebener Einträge
`songs[].time`	string	Ausstrahlungszeit `H:i`
`songs[].artist`	string	Interpret
`songs[].title`	string	Titel
`songs[].cover`	string	Cover-URL – nur bei LionFM

⚡ Try it out

{station}

limit

http://www.radioapi.de/api/{station}/last_songs