Radioguide Data API
Dados de rádio para apps, automóveis, TV e sites
Mais de 100.000 rádios com URL de streams que verificamos todos os dias, logotipos, gêneros e países. E ainda o que está tocando, as músicas mais tocadas na rádio e um registro de alterações para manter a sua cópia atualizada.
# Rádios de jazz nos Países Baixos 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", ...} }] }
O que recebe
Uma API para tudo o que sabemos sobre rádio.
Rádios e streams
Pesquise por nome, país, gênero e idioma. Cada URL de stream com o formato, e rádios parecidas entre si.
Saúde dos streams
Verificamos os streams nós próprios: online ou não, codec, bitrate e disponibilidade em 30 dias. Acabaram-se as rádios mortas na sua app.
Tocando agora
A música no ar e as anteriores, lidas dos streams de milhares de rádios.
Rankings de rádio
As músicas e artistas mais tocados na rádio, por país e gênero, com reproduções por dia.
Radioguide Channels
Os nossos próprios canais com música nova de artistas independentes: o que está tocando e a programação das próximas músicas.
Mantenha-se sincronizado
Um registro de alterações, uma exportação completa diária e webhooks quando uma rádio muda, um stream falha ou começa uma nova música.
Quem a usa
Apps de rádio
Crie uma app de rádio sem manter uma lista de rádios: pesquisa, logotipos, streams que funcionam e o que está tocando.
Developer ou ProFabricantes de automóveis, TV e hardware
Rádio na internet em painéis de automóveis, Smart TV, boxes e rádios Wi-Fi, com logotipos em todos os tamanhos e streams verificados diariamente.
Business ou licença de dadosIndústria musical e análise
Veja que músicas e artistas a rádio toca, onde e com que frequência. Para editoras, promotores e estudos de mercado.
Pro ou BusinessSites e widgets
Mostre rádios locais, um ranking ou o que está tocando no seu próprio site.
Free ou DeveloperPlanos
Comece grátis. Mude de plano quando lançar; cancele em qualquer mês.
Free
- 1.000 chamadas por dia
- 30 chamadas por minuto
- Uso não comercial
- "Powered by Radioguide.fm" com link obrigatório
- Logotipos e estado dos streams
- Tocando agora
- Rankings de rádio
- Disponibilidade, codec e bitrate
- Registro de alterações e webhooks
- Exportação completa diária
Developer
- 50.000 chamadas por dia
- 300 chamadas por minuto
- Uso comercial numa app ou site
- Logotipos e estado dos streams
- Tocando agora
- Rankings de rádio
- Disponibilidade, codec e bitrate
- Registro de alterações e webhooks
- Exportação completa diária
Pro
- 500.000 chamadas por dia
- 1.500 chamadas por minuto
- Uso comercial numa app ou site
- Logotipos e estado dos streams
- Tocando agora
- Rankings de rádio
- Disponibilidade, codec e bitrate
- Registro de alterações e webhooks
- Exportação completa diária
Business
- 5.000.000 chamadas por dia
- 6.000 chamadas por minuto
- Uso comercial em várias apps
- Logotipos e estado dos streams
- Tocando agora
- Rankings de rádio
- Disponibilidade, codec e bitrate
- Registro de alterações e webhooks
- Exportação completa diária
- SLA de disponibilidade de 99,9%
Enterprise
- Limites à medida e licença de dados
- Uso comercial em várias apps
- Logotipos e estado dos streams
- Tocando agora
- Rankings de rádio
- Disponibilidade, codec e bitrate
- Registro de alterações e webhooks
- Exportação completa diária
- SLA de disponibilidade de 99,95%
Os preços não incluem IVA. O IVA é acrescentado no pagamento.
Início rápido
Crie uma chave grátis
Inicie sessão, dê um nome ao projeto e copie a chave. Só é mostrada uma vez.
Faça a sua primeira chamada
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"
Use no navegador
As chaves funcionam a partir do seu servidor. Para chamadas a partir de uma página web, adicione o seu domínio à chave no portal; outros sites não a poderão usar.
const r = await fetch("https://www.radioguide.fm/api/v2/channels", { headers: { "X-Api-Key": "rg_live_..." } });
const { data } = await r.json();Radioguide em assistentes de IA
O nosso servidor MCP permite ao Claude, ao ChatGPT e a outros assistentes pesquisar rádios, ver o que está tocando, encontrar músicas no ar e ler os rankings de rádio, com links para as páginas das rádios.
Claude
No Claude (web ou desktop): Configurações, Conectores, Adicionar conector personalizado. 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_..."
Arquivo de configuração do Claude Desktop (claude_desktop_config.json), com a sua chave 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
No ChatGPT: Configurações, Apps e conectores, Configurações avançadas: ative o modo de programador. Depois crie um conector com este URL e sem autenticação:
https://www.radioguide.fm/mcp
No ChatGPT aparecem cartões de rádios com botão de reprodução (beta).
GPT personalizado com Actions: importe o esquema deste URL e escolha API key, Bearer, como autenticação:
https://www.radioguide.fm/api/openapi.json?profile=gpt
Outros clientes MCP
Funciona qualquer cliente com o transporte Streamable HTTP: envie mensagens JSON-RPC por POST para o URL. Exemplo:
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"}}}'
Os clientes que não conseguem enviar cabeçalhos juntam a chave ao URL: https://www.radioguide.fm/mcp?api_key=YOUR_KEY. Use uma chave separada para isso.
Sem chave: 20 chamadas de ferramentas por minuto e 300 por dia por rede, com até 5 resultados por resposta. Com uma chave API, cada chamada conta como uma chamada API do seu plano.
Os assistentes devem indicar o Radioguide.fm como fonte e incluir links para as páginas das rádios que mencionam. Cada resultado de ferramenta contém o link e a menção da fonte.
Está a criar um assistente, um motor de pesquisa ou um serviço de música? Licencie os nossos dados estruturados de rádios, músicas no ar e rankings, com exportações diárias, um feed de alterações, limites elevados e um acordo de atribuição.
- Dados de rádios com streams verificados todos os dias
- O que está tocando e rankings de rádio de milhares de rádios
- Atribuição: mostre o Radioguide.fm como fonte, com uma ligação para a página da rádio, onde quer que os dados apareçam
No plano Free pode usar os dados em projetos não comerciais se mostrar "Powered by Radioguide.fm" com um link para o nosso site onde quer que os dados apareçam. Cada resposta contém o texto em meta.attribution.
<a href="https://www.radioguide.fm">Powered by Radioguide.fm</a>
Referência da API OpenAPI 3.1 MCP Alterações Estado dos streams Termos de utilização Licença de dados
