Radioguide Data API
Dati radio per app, auto, TV e siti web
Oltre 100.000 stazioni radio con URL degli stream controllati ogni giorno, loghi, generi e paesi. In più cosa va in onda ora, i brani più trasmessi in radio e un feed delle modifiche per tenere aggiornata la tua copia.
# Stazioni jazz nei Paesi Bassi 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", ...} }] }
Cosa ottieni
Un'unica API per tutto ciò che sappiamo sulla radio.
Stazioni e stream
Cerca per nome, paese, genere e lingua. Ogni URL di stream con il formato, e stazioni simili tra loro.
Salute degli stream
Controlliamo gli stream noi stessi: online o no, codec, bitrate e uptime su 30 giorni. Niente più stazioni morte nella tua app.
In onda ora
Il brano in onda e quelli precedenti, letti dagli stream di migliaia di stazioni.
Classifiche radio
I brani e gli artisti più trasmessi in radio, per paese e genere, con i passaggi al giorno.
Radioguide Channels
I nostri canali con nuova musica di artisti indipendenti: cosa va in onda ora e il palinsesto dei prossimi brani.
Resta sincronizzato
Un feed delle modifiche, un'esportazione completa giornaliera e webhook quando una stazione cambia, uno stream cade o inizia un nuovo brano.
Chi la usa
App radio
Crea un'app radio senza gestire un elenco di stazioni: ricerca, loghi, stream funzionanti e cosa va in onda ora.
Developer o ProCase automobilistiche, produttori di TV e hardware
Radio via internet in cruscotti, Smart TV, set-top box e radio Wi-Fi, con loghi in ogni formato e stream controllati ogni giorno.
Business o licenza datiIndustria musicale e analisi
Scopri quali brani e artisti passa la radio, dove e quanto spesso. Per etichette, promoter e ricerche di mercato.
Pro o BusinessSiti web e widget
Mostra stazioni locali, una top list o cosa va in onda ora sul tuo sito.
Free o DeveloperPiani
Inizia gratis. Passa a un piano a pagamento quando vai online; disdici quando vuoi, ogni mese.
Free
- 1.000 chiamate al giorno
- 30 chiamate al minuto
- Uso non commerciale
- "Powered by Radioguide.fm" con link obbligatorio
- Loghi e stato degli stream
- In onda ora
- Classifiche radio
- Uptime, codec e bitrate
- Feed delle modifiche e webhook
- Esportazione completa giornaliera
Developer
- 50.000 chiamate al giorno
- 300 chiamate al minuto
- Uso commerciale in un'app o un sito
- Loghi e stato degli stream
- In onda ora
- Classifiche radio
- Uptime, codec e bitrate
- Feed delle modifiche e webhook
- Esportazione completa giornaliera
Pro
- 500.000 chiamate al giorno
- 1.500 chiamate al minuto
- Uso commerciale in un'app o un sito
- Loghi e stato degli stream
- In onda ora
- Classifiche radio
- Uptime, codec e bitrate
- Feed delle modifiche e webhook
- Esportazione completa giornaliera
Business
- 5.000.000 chiamate al giorno
- 6.000 chiamate al minuto
- Uso commerciale in più app
- Loghi e stato degli stream
- In onda ora
- Classifiche radio
- Uptime, codec e bitrate
- Feed delle modifiche e webhook
- Esportazione completa giornaliera
- SLA di uptime del 99,9%
Enterprise
- Limiti personalizzati e licenza dati
- Uso commerciale in più app
- Loghi e stato degli stream
- In onda ora
- Classifiche radio
- Uptime, codec e bitrate
- Feed delle modifiche e webhook
- Esportazione completa giornaliera
- SLA di uptime del 99,95%
Prezzi IVA esclusa. L'IVA viene aggiunta al momento del pagamento.
Avvio rapido
Crea una chiave gratuita
Accedi, dai un nome al progetto e copia la chiave. Viene mostrata una sola volta.
Fai la tua prima chiamata
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"
Usala nel browser
Le chiavi funzionano dal tuo server. Per chiamate da una pagina web, aggiungi il tuo dominio alla chiave nel portale; altri siti non potranno usarla.
const r = await fetch("https://www.radioguide.fm/api/v2/channels", { headers: { "X-Api-Key": "rg_live_..." } });
const { data } = await r.json();Radioguide negli assistenti IA
Il nostro server MCP permette a Claude, ChatGPT e altri assistenti di cercare stazioni, vedere cosa va in onda, trovare brani in radio e leggere le classifiche, con link alle pagine delle stazioni.
Claude
In Claude (web o desktop): Impostazioni, Connettori, Aggiungi connettore personalizzato. Nome: 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_..."
File di configurazione di Claude Desktop (claude_desktop_config.json), con la tua chiave 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
In ChatGPT: Impostazioni, App e connettori, Impostazioni avanzate: attiva la modalità sviluppatore. Poi crea un connettore con questo URL e senza autenticazione:
https://www.radioguide.fm/mcp
In ChatGPT compaiono schede delle stazioni con pulsante di riproduzione (beta).
GPT personalizzato con Actions: importa lo schema da questo URL e scegli API key, Bearer, come autenticazione:
https://www.radioguide.fm/api/openapi.json?profile=gpt
Altri client MCP
Funziona qualsiasi client con il trasporto Streamable HTTP: invia messaggi JSON-RPC in POST all’URL. Esempio:
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"}}}'
I client che non possono inviare intestazioni aggiungono la chiave all’URL: https://www.radioguide.fm/mcp?api_key=YOUR_KEY. Usa una chiave separata per questo.
Senza chiave: 20 chiamate agli strumenti al minuto e 300 al giorno per rete, con al massimo 5 risultati per risposta. Con una chiave API ogni chiamata conta come una chiamata API del tuo piano.
Gli assistenti devono citare Radioguide.fm come fonte e collegarsi alle pagine delle stazioni menzionate. Ogni risultato contiene il link e la citazione.
Sviluppi un assistente, un motore di ricerca o un servizio musicale? Ottieni la licenza dei nostri dati strutturati su stazioni, brani in onda e classifiche, con export giornalieri, feed delle modifiche, limiti elevati e un accordo sull’attribuzione.
- Dati delle stazioni con stream controllati ogni giorno
- Brani in onda e classifiche radio da migliaia di stazioni
- Attribuzione: indica Radioguide.fm come fonte con un link alla pagina della stazione ovunque compaiano i dati
Con il piano Free puoi usare i dati per progetti non commerciali se mostri "Powered by Radioguide.fm" con un link al nostro sito ovunque compaiano i dati. Ogni risposta contiene il testo in meta.attribution.
<a href="https://www.radioguide.fm">Powered by Radioguide.fm</a>
Riferimento API OpenAPI 3.1 MCP Changelog Stato degli stream Condizioni d'uso Licenza dati