Radioguide Data API
Rádiová data pro aplikace, auta, televize a weby
Přes 100 000 rádiových stanic s adresami streamů, které denně kontrolujeme, logy, žánry a zeměmi. K tomu co právě hraje, nejhranější skladby v rádiu a kanál změn, aby vaše kopie byla aktuální.
# Jazzové stanice v Nizozemsku 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", ...} }] }
Co získáte
Jedno API pro vše, co víme o rádiu.
Stanice a streamy
Hledejte podle názvu, země, žánru a jazyka. Každá adresa streamu s formátem a stanice, které jsou si podobné.
Stav streamů
Streamy kontrolujeme sami: online nebo ne, kodek, datový tok a dostupnost za 30 dní. Žádné mrtvé stanice v tvé aplikaci.
Právě hraje
Skladba ve vysílání a ty před ní, načtené ze streamů tisíců stanic.
Rádiové žebříčky
Nejhranější skladby a umělci v rádiu podle země a žánru, s počtem přehrání za den.
Radioguide Channels
Naše vlastní kanály s novou hudbou nezávislých umělců: co právě hraje a program dalších skladeb.
Zůstaňte synchronizovaní
Kanál změn, úplný denní export a webhooky, když se stanice změní, stream vypadne nebo začne nová skladba.
Kdo to používá
Rádiové aplikace
Vytvořte rádiovou aplikaci bez udržování seznamu stanic: vyhledávání, loga, fungující streamy a co právě hraje.
Developer nebo ProVýrobci aut, televizí a hardwaru
Internetové rádio v palubních deskách, chytrých televizích, set-top boxech a Wi-Fi rádiích, s logy v každé velikosti a denně kontrolovanými streamy.
Business nebo datová licenceHudební průmysl a analytika
Zjistěte, jaké skladby a umělce rádio hraje, kde a jak často. Pro vydavatelství, promotéry a průzkum trhu.
Pro nebo BusinessWeby a widgety
Ukažte na vlastním webu místní stanice, žebříček nebo co právě hraje.
Free nebo DeveloperTarify
Začněte zdarma. Na vyšší tarif přejděte při spuštění; zrušit lze kterýkoli měsíc.
Free
- 1 000 volání denně
- 30 volání za minutu
- Nekomerční použití
- "Powered by Radioguide.fm" s odkazem je povinné
- Loga a stav streamů
- Právě hraje
- Rádiové žebříčky
- Dostupnost, kodek a datový tok
- Kanál změn a webhooky
- Úplný denní export
Developer
- 50 000 volání denně
- 300 volání za minutu
- Komerční použití v jedné aplikaci nebo webu
- Loga a stav streamů
- Právě hraje
- Rádiové žebříčky
- Dostupnost, kodek a datový tok
- Kanál změn a webhooky
- Úplný denní export
Pro
- 500 000 volání denně
- 1 500 volání za minutu
- Komerční použití v jedné aplikaci nebo webu
- Loga a stav streamů
- Právě hraje
- Rádiové žebříčky
- Dostupnost, kodek a datový tok
- Kanál změn a webhooky
- Úplný denní export
Business
- 5 000 000 volání denně
- 6 000 volání za minutu
- Komerční použití ve více aplikacích
- Loga a stav streamů
- Právě hraje
- Rádiové žebříčky
- Dostupnost, kodek a datový tok
- Kanál změn a webhooky
- Úplný denní export
- SLA dostupnosti 99,9 %
Enterprise
- Vlastní limity a datová licence
- Komerční použití ve více aplikacích
- Loga a stav streamů
- Právě hraje
- Rádiové žebříčky
- Dostupnost, kodek a datový tok
- Kanál změn a webhooky
- Úplný denní export
- SLA dostupnosti 99,95 %
Ceny jsou bez DPH. DPH se připočítá při placení.
Rychlý start
Vytvořte klíč zdarma
Přihlaste se, pojmenujte projekt a zkopírujte klíč. Zobrazí se jen jednou.
Udělej první volání
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"
Použití v prohlížeči
Klíče fungují z vašeho serveru. Pro volání z webové stránky přidejte v portálu ke klíči svou doménu; jiné weby ho pak nemohou použít.
const r = await fetch("https://www.radioguide.fm/api/v2/channels", { headers: { "X-Api-Key": "rg_live_..." } });
const { data } = await r.json();Radioguide v AI asistentech
Náš server MCP umožňuje Claude, ChatGPT a dalším asistentům hledat stanice, vidět, co hraje, najít skladby ve vysílání a číst hitparády, s odkazy na stránky stanic.
Claude
V Claude (web nebo desktop): Nastavení, Konektory, Přidat vlastní konektor. Název: Radioguide. Adresa:
https://www.radioguide.fm/mcp
Claude Code:
claude mcp add --transport http radioguide https://www.radioguide.fm/mcp --header "Authorization: Bearer rg_live_..."
Konfigurační soubor Claude Desktop (claude_desktop_config.json) s vaším klíčem API:
{
"mcpServers": {
"radioguide": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://www.radioguide.fm/mcp",
"--header",
"Authorization:${RADIOGUIDE_AUTH}"
],
"env": {
"RADIOGUIDE_AUTH": "Bearer rg_live_..."
}
}
}
}
ChatGPT
V ChatGPT: Nastavení, Aplikace a konektory, Pokročilá nastavení: zapněte vývojářský režim. Pak vytvořte konektor s touto adresou bez ověření:
https://www.radioguide.fm/mcp
V ChatGPT se zobrazují karty stanic s tlačítkem přehrávání (beta).
Vlastní GPT s Actions: importujte schéma z této adresy a jako ověření zvolte API key, Bearer:
https://www.radioguide.fm/api/openapi.json?profile=gpt
Další klienti MCP
Funguje každý klient s transportem Streamable HTTP: posílejte zprávy JSON-RPC metodou POST na tuto adresu. Příklad:
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"}}}'
Klienti, kteří neumí posílat hlavičky, přidají klíč do adresy: https://www.radioguide.fm/mcp?api_key=YOUR_KEY. Použijte na to samostatný klíč.
Bez klíče: 20 volání nástrojů za minutu a 300 denně na síť, až 5 výsledků na odpověď. S klíčem API se každé volání počítá jako jedno volání API vašeho balíčku.
Asistenti musí uvádět Radioguide.fm jako zdroj a odkazovat na stránky stanic, které zmiňují. Každý výsledek obsahuje odkaz a uvedení zdroje.
Vyvíjíte asistenta, vyhledávač nebo hudební službu? Licencujte naše strukturovaná data o stanicích, právě hraných skladbách a hitparádách: denní exporty, kanál změn, vysoké limity a dohoda o uvádění zdroje.
- Data stanic se streamy, které denně kontrolujeme
- Právě hrané skladby a hitparády z tisíců stanic
- Uvedení zdroje: všude, kde se data zobrazují, uveďte Radioguide.fm jako zdroj s odkazem na stránku stanice
V tarifu Free můžete data používat pro nekomerční projekty, pokud všude, kde se data zobrazují, uvedete "Powered by Radioguide.fm" s odkazem na náš web. Každá odpověď obsahuje tento text v meta.attribution.
<a href="https://www.radioguide.fm">Powered by Radioguide.fm</a>
Reference API OpenAPI 3.1 MCP Seznam změn Stav streamů Podmínky použití Datová licence