Radioguide Data API
Radiodaten für Apps, Autos, TVs und Websites
Über 100.000 Radiosender mit Stream-URLs, die wir täglich prüfen, Logos, Genres und Ländern. Dazu was gerade läuft, die meistgespielten Songs im Radio und ein Änderungsfeed, um deine Kopie aktuell zu halten.
# Jazzsender in den Niederlanden curl -H "X-Api-Key: rg_live_..." \ "https://www.radioguide.fm/api/v2/stations?country=NL&genre=jazz" { "data": [{ "id": "64f1c2a9e4b0a1b2c3d4e5f6", "name": "Jazz Radio Amsterdam", "country": "NL", "genres": ["jazz"], "stream_url": "https://...", "stream_ok": true, "now_playing": {"artist": "Chet Baker", ...} }] }
Was du bekommst
Eine API für alles, was wir über Radio wissen.
Sender und Streams
Suche nach Name, Land, Genre und Sprache. Jede Stream-URL mit Format, und Sender, die einander ähneln.
Stream-Zustand
Wir prüfen die Streams selbst: online oder nicht, Codec, Bitrate und Uptime über 30 Tage. Keine toten Sender mehr in deiner App.
Läuft gerade
Der Titel, der gerade läuft, und die Titel davor, ausgelesen aus den Streams tausender Sender.
Radio-Charts
Die meistgespielten Songs und Künstler im Radio, pro Land und Genre, mit Einsätzen pro Tag.
Radioguide Channels
Unsere eigenen Kanäle mit neuer Musik unabhängiger Künstler: was gerade läuft und der Plan der nächsten Titel.
Synchron bleiben
Ein Änderungsfeed, ein vollständiger täglicher Export und Webhooks, wenn sich ein Sender ändert, ein Stream ausfällt oder ein neuer Titel beginnt.
Wer sie nutzt
Radio-Apps
Baue eine Radio-App, ohne selbst eine Senderliste zu pflegen: Suche, Logos, funktionierende Streams und was gerade läuft.
Developer oder ProAuto-, TV- und Hardwarehersteller
Internetradio in Armaturenbrettern, Smart-TVs, Set-Top-Boxen und WLAN-Radios, mit Logos in jeder Größe und täglich geprüften Streams.
Business oder DatenlizenzMusikindustrie und Analyse
Sieh, welche Songs und Künstler das Radio spielt, wo und wie oft. Für Labels, Promoter und Marktforschung.
Pro oder BusinessWebsites und Widgets
Zeig lokale Sender, eine Topliste oder was gerade läuft auf deiner eigenen Website.
Free oder DeveloperTarife
Starte kostenlos. Upgrade, wenn du live gehst; monatlich kündbar.
Free
- 1.000 Aufrufe pro Tag
- 30 Aufrufe pro Minute
- Nicht kommerzielle Nutzung
- "Powered by Radioguide.fm" mit Link erforderlich
- Logos und Streamstatus
- Läuft gerade
- Radio-Charts
- Uptime, Codec und Bitrate
- Änderungsfeed und Webhooks
- Vollständiger täglicher Export
Developer
- 50.000 Aufrufe pro Tag
- 300 Aufrufe pro Minute
- Kommerzielle Nutzung in einer App oder Website
- Logos und Streamstatus
- Läuft gerade
- Radio-Charts
- Uptime, Codec und Bitrate
- Änderungsfeed und Webhooks
- Vollständiger täglicher Export
Pro
- 500.000 Aufrufe pro Tag
- 1.500 Aufrufe pro Minute
- Kommerzielle Nutzung in einer App oder Website
- Logos und Streamstatus
- Läuft gerade
- Radio-Charts
- Uptime, Codec und Bitrate
- Änderungsfeed und Webhooks
- Vollständiger täglicher Export
Business
- 5.000.000 Aufrufe pro Tag
- 6.000 Aufrufe pro Minute
- Kommerzielle Nutzung in mehreren Apps
- Logos und Streamstatus
- Läuft gerade
- Radio-Charts
- Uptime, Codec und Bitrate
- Änderungsfeed und Webhooks
- Vollständiger täglicher Export
- 99,9% Uptime-SLA
Enterprise
- Eigene Limits und Datenlizenz
- Kommerzielle Nutzung in mehreren Apps
- Logos und Streamstatus
- Läuft gerade
- Radio-Charts
- Uptime, Codec und Bitrate
- Änderungsfeed und Webhooks
- Vollständiger täglicher Export
- 99,95% Uptime-SLA
Preise verstehen sich zzgl. MwSt. Die MwSt. wird an der Kasse hinzugefügt.
Schnellstart
Kostenlosen Schlüssel erstellen
Melde dich an, benenne dein Projekt und kopiere den Schlüssel. Er wird nur einmal angezeigt.
Mach deinen ersten Aufruf
curl -H "X-Api-Key: $RADIOGUIDE_KEY" "https://www.radioguide.fm/api/v2/search?q=jazz&country=US" curl -H "X-Api-Key: $RADIOGUIDE_KEY" "https://www.radioguide.fm/api/v2/stations/64f1c2a9e4b0a1b2c3d4e5f6" curl -H "X-Api-Key: $RADIOGUIDE_KEY" "https://www.radioguide.fm/api/v2/charts?country=NL&days=7"
Im Browser nutzen
Schlüssel funktionieren von deinem Server aus. Für Aufrufe aus einer Webseite trage deine Domain beim Schlüssel im Portal ein; andere Websites können ihn dann nicht nutzen.
const r = await fetch("https://www.radioguide.fm/api/v2/channels", { headers: { "X-Api-Key": "rg_live_..." } });
const { data } = await r.json();Radioguide in KI-Assistenten
Mit unserem MCP-Server suchen Claude, ChatGPT und andere Assistenten Sender, sehen, was läuft, finden Songs im Radio und lesen die Radiocharts, mit Links zu den Senderseiten.
Claude
In Claude (Web oder Desktop): Einstellungen, Connectors, Benutzerdefinierten Connector hinzufügen. Name: Radioguide. URL:
https://www.radioguide.fm/mcp
Claude Code:
claude mcp add --transport http radioguide https://www.radioguide.fm/mcp --header "Authorization: Bearer rg_live_..."
Konfigurationsdatei von Claude Desktop (claude_desktop_config.json) mit deinem API-Schlüssel:
{
"mcpServers": {
"radioguide": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://www.radioguide.fm/mcp",
"--header",
"Authorization:${RADIOGUIDE_AUTH}"
],
"env": {
"RADIOGUIDE_AUTH": "Bearer rg_live_..."
}
}
}
}
ChatGPT
In ChatGPT: Einstellungen, Apps und Connectors, Erweiterte Einstellungen: Entwicklermodus einschalten. Dann einen Connector mit dieser URL und ohne Authentifizierung anlegen:
https://www.radioguide.fm/mcp
In ChatGPT erscheinen Senderkarten mit Play-Button (Beta).
Eigenes GPT mit Actions: Schema von dieser URL importieren und als Authentifizierung API key, Bearer wählen:
https://www.radioguide.fm/api/openapi.json?profile=gpt
Andere MCP-Clients
Jeder Client mit dem Streamable-HTTP-Transport funktioniert: Sende JSON-RPC-Nachrichten per POST an die URL. Beispiel:
curl -s https://www.radioguide.fm/mcp -H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-app","version":"1.0"}}}'
curl -s https://www.radioguide.fm/mcp -H "Content-Type: application/json" \
-H "Authorization: Bearer rg_live_..." \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_stations","arguments":{"genre":"jazz","country":"FR"}}}'
Clients, die keine Header senden können, hängen den Schlüssel an die URL: https://www.radioguide.fm/mcp?api_key=YOUR_KEY. Verwende dafür einen eigenen Schlüssel.
Ohne Schlüssel: 20 Tool-Aufrufe pro Minute und 300 pro Tag pro Netzwerk, mit bis zu 5 Ergebnissen pro Antwort. Mit API-Schlüssel zählt jeder Tool-Aufruf als ein API-Call deines Pakets.
Assistenten müssen Radioguide.fm als Quelle nennen und auf die genannten Senderseiten verlinken. Jedes Tool-Ergebnis enthält den Link und den Quellenhinweis.
Du baust einen Assistenten, eine Suchmaschine oder einen Musikdienst? Lizenziere unsere strukturierten Sender-, Now-Playing- und Chartdaten mit täglichen Exporten, Änderungsfeed, hohen Limits und einer Vereinbarung zur Quellenangabe.
- Senderdaten mit täglich geprüften Streams
- Aktuelle Titel und Radiocharts von Tausenden Sendern
- Quellenangabe: Radioguide.fm als Quelle mit einem Link zur Senderseite, überall wo die Daten erscheinen
Im Free-Tarif darfst du die Daten für nicht kommerzielle Projekte nutzen, wenn du überall, wo die Daten erscheinen, "Powered by Radioguide.fm" mit einem Link zu unserer Website zeigst. Jede Antwort enthält den Text in meta.attribution.
<a href="https://www.radioguide.fm">Powered by Radioguide.fm</a>
API-Referenz OpenAPI 3.1 MCP Changelog Streamstatus Nutzungsbedingungen Datenlizenz