Recurso do painel xCAST

Sua rádio conversa com
qualquer sistema.

A API JSON do xCAST expõe tudo da sua rádio — música atual, histórico, audiência, mapa — e ainda aceita comandos: ligar, desligar, pular música. Para o seu site, seu app, sua automação. Com documentação pública e respostas em menos de 1 segundo.

Ver planos xCAST Ver documentação da API
Respostas em <1s Chaves com escopo e IP Incluso nos planos xCAST
Documentação pública da API v2 do xCAST

Documentação real e pública: endpoints de leitura com cache e exemplos prontos.

Now playingMúsica, artista e capa em JSON
HistóricoÚltimas 50 músicas tocadas
Mapa e audiênciaPor cidade/UF, sem expor IP
Controle remotoLigar, desligar, pular música
WebhooksSeu sistema avisado a cada troca
Como funciona

Integrado em 3 passos

1

Gere sua chave no painel

Em Streaming → API & Integrações, crie até 10 chaves com escopo de leitura ou controle — e restrinja por IP se quiser. Revogável a qualquer momento.

2

Copie o endpoint pronto

A documentação pública mostra cada endpoint com a URL montada: status, now-playing, histórico, resumo de 7/30 dias, top músicas, uptime e mais.

3

Integre onde quiser

Site, app, planilha, automação, monitor externo — qualquer coisa que fale HTTP consome sua rádio em JSON.

Tudo da sua rádio, em JSON
Leitura em tempo real

Tudo da sua rádio, em JSON

Status completo, música atual com capa, histórico de até 50 faixas, resumo de audiência de 7/30 dias, top músicas, ouvintes por hora, mapa por cidade/UF (sem expor IP de ouvinte), playlists e agendamentos — tudo com cache inteligente e respostas em menos de 1 segundo.

  • Endpoint de uptime para monitores externos (UptimeRobot)
  • Rate limit generoso: 120 requisições/minuto na leitura
  • ETag/304 e CORS: eficiente até em página pública
Comande a rádio de fora do painel
Controle remoto

Comande a rádio de fora do painel

Os endpoints de controle aceitam POST autenticado para ligar e desligar o streaming ou o AutoDJ, pular a música atual, trocar de playlist e disparar conteúdo — cada ação registrada no log da rádio.

  • Chaves com escopo: leitura e controle separados
  • Restrição por IP em cada chave
  • Toda ação auditada no log da rádio
Na prática

O que dá para construir com a API

Casos reais de quem integra a rádio aos próprios sistemas.

Site sob medida

Mostre "tocando agora" com capa no seu site com o widget de 1 linha de script — ou monte o layout que quiser consumindo o JSON.

Avisos automáticos

Webhooks assinados avisam seu sistema quando a música troca ou a rádio muda de status — sem ficar consultando de minuto em minuto.

Monitoramento 24/7

O endpoint de uptime responde no padrão dos monitores externos: caiu, seu UptimeRobot te acorda antes do ouvinte reclamar.

Automações

Ligue o AutoDJ por script no fim do expediente, pule música por comando, integre com o sistema interno da emissora.

<0s
Tempo de resposta
0/min
Requisições de leitura
0
Chaves por rádio
0
Músicas no histórico
Dúvidas

Perguntas frequentes sobre a API

Em todos os planos de streaming xCAST. A chave de leitura pública já vem pronta no painel; as chaves avançadas (escopo de leitura de negócio e controle) você cria em Streaming → API & Integrações, sem custo extra.
Para o básico, não: o widget "tocando agora" é uma linha de script que você cola no site, e a documentação mostra as URLs prontas. Para integrações maiores (app próprio, automações), aí sim um desenvolvedor aproveita a API completa.
Status da transmissão, música atual (com artista e capa), próxima música, histórico de até 50 faixas, resumo de audiência de 7/30 dias, top músicas, ouvintes por hora, mapa de ouvintes por cidade/UF, playlists, agendamentos e modo atual (ao vivo/AutoDJ/relay).
Ligar e desligar o streaming e o AutoDJ, pular a música atual, recarregar ou trocar a playlist e disparar um conteúdo do acervo — com autenticação própria, limite de 10 ações/minuto e registro no log da rádio.
Em vez de o seu sistema perguntar de tempos em tempos, o xCAST avisa: quando a música muda ou o status da rádio muda, ele chama a URL que você cadastrar (até 3 por rádio), com assinatura HMAC para você validar a origem.
Sim. Quem já integrou com a API antiga não precisa mudar nada — a v2 convive com ela, com os mesmos nomes de campos no endpoint de status e muito mais velocidade.
Explore mais

Outros recursos do xCAST

Ao Vivo e AutoDJ

O revezamento que mantém a rádio 24h no ar — com demonstração interativa.

App para Rádio

O aplicativo da sua rádio na Play Store, com a sua marca e cores.

Hora Certa e Vinhetas

A identidade sonora que dá cara de rádio grande, no automático.

Mapa de Ouvintes

Audiência em tempo real, cidade por cidade, com Media Kit para anunciantes.

Pedidos de Música

O ouvinte pede pelo site ou app e o pedido cai na fila do seu painel.

Players e Widgets

Player com SSL, tocando agora e grade — para embedar em qualquer site.

Retransmissão

Programação de rede em horários agendados, com retorno automático ao AutoDJ.

Estatísticas e Relatórios

18 análises, heatmap de audiência e Media Kit — telas reais do painel.

WebDJ

Estúdio de DJ no navegador: 2 decks, mic com talkover, sampler e a biblioteca da rádio.

Integre sua rádio a tudo

API JSON, webhooks e widget prontos, inclusos nos planos xCAST. Ativação imediata e 30 dias de garantia.