Área do cliente Chamar no WhatsApp
Recurso do painel xCAST

Sua rádio conversa com qualquer sistema.

Cole uma linha no site e mostre a música que está tocando, com capa. Ou leve status, histórico e uptime da rádio, em JSON, para o seu app, sistema ou monitor.

Ver planos xCASTVer documentação da API
  • Em todos os planos xCAST
  • A partir de R$29,20/mês
  • 30 dias de garantia
beta.xcast.com.br/api-v2/docs
Documentação pública da API v2 do xCAST, com a tabela de endpoints de leitura
Tocando agoraMúsica, artista e capa
HistóricoAté 50 músicas tocadas
UptimeSeu monitor sabe se a rádio caiu
Widget de 1 linhaSem programar nada
Na prática

O que dá para construir com a API

Do widget que qualquer pessoa cola no site à integração feita por um desenvolvedor.

No seu site
Widget tocando agora do xCAST nos temas claro e escuro, com capa, música e artista da rádio de demonstração Beats FM
Sem programar

Tocando agora no seu site, com 1 linha

Cole uma linha de script no site da rádio e ele passa a mostrar a música que está tocando, com capa e artista. Funciona com a KEY que já vem no painel, em qualquer plano xCAST.

  • Tema claro ou escuro, para combinar com o seu site
  • Atualiza sozinho a cada 15 segundos
  • Avisa “Fora do ar” quando a rádio está desligada
Ver players e widgets
beta.xcast.com.br · resposta real, resumida
GET /api-v2/now-playing/SUA_KEY

{
  "sucesso": true,
  "status": "Ligado",
  "artista": "The Pussycat Dolls",
  "musica": "Buttons (Final Edit Version)",
  "capa_musica": "https://player.xcast.com.br/img/…",
  "proxima_musica": "",
  "titulo": "Beats - HITS"
}
Com um desenvolvedor

Tudo da sua rádio, em JSON

Com a KEY da rádio saem status, música atual com capa, próxima música e histórico de até 50 faixas. Exclusivo do xCAST BETA (a troca de painel é sem custo): uma chave privada libera também audiência de 7 e 30 dias, músicas mais tocadas, ouvintes por hora, mapa por cidade/UF, playlists e agendamentos.

  • Endpoint de uptime para monitor externo (UptimeRobot): se a rádio cair, você fica sabendo antes de o ouvinte reclamar
  • Até 120 consultas por minuto, com cache e resposta em menos de 1 segundo
  • ETag/304 e CORS liberado: dá para consultar direto de uma página pública
Abrir a documentação
Como funciona

Integrado em 3 passos

1

Pegue a KEY da rádio

Ela já vem pronta na página de API do seu painel xCAST. No xCAST BETA (a troca de painel é sem custo), você também cria chaves privadas, com escopo e restrição por IP.

2

Copie o endpoint pronto

A documentação pública mostra cada endpoint com a URL montada: status, tocando agora, histórico, uptime e mais.

3

Cole no site ou no sistema

Use o widget de 1 linha no site ou consuma o JSON no app, na planilha, na automação ou no monitor externo.

AGORA, AO VIVO…pessoas ouvindo rádios xCAST neste momento
7.500+rádios criadas na POP
164 milhões+registros de audiência medidos
24/7suporte humano de verdade
Dúvidas

Perguntas frequentes sobre a API

Em todos os planos de streaming xCAST, a partir de R$29,20/mês, sem custo extra. A KEY da rádio já vem pronta na página de API do painel, e é com ela que funcionam a leitura pública e o widget.
A leitura pública (status, tocando agora, histórico e uptime) e o widget funcionam com a KEY nos dois painéis. Criar chaves privadas, com escopo e restrição por IP, e ler os dados de audiência é exclusivo do xCAST BETA, e você troca de painel sem custo.
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, como um app próprio ou uma automação, um desenvolvedor aproveita a API completa.
Com a KEY: status da transmissão, música atual com artista e capa, próxima música, histórico de até 50 faixas e uptime. Com chave privada (xCAST BETA): resumo de audiência de 7 e 30 dias, músicas mais tocadas, ouvintes por hora, mapa de ouvintes por cidade/UF (sem o IP do ouvinte), playlists, agendamentos e o modo atual (ao vivo, AutoDJ ou relay).
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.

Não achou sua dúvida? Chamar no WhatsApp ou veja a base de conhecimento.

Explore mais

Outros recursos do xCAST

Fábrica de Spots Novo

O spot do anunciante feito no painel: texto, voz realista com sotaque e música de fundo, pronto para o ar.

xCAST Sync Novo

Programas e programetes baixados sozinhos na pasta da automação do estúdio, a partir do plano SPEAKER.

Ao Vivo e AutoDJ

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

App para Rádio

O app da sua rádio para Android e iPhone (Web App), com o seu nome, logo e cores, a partir do plano BEATS.

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

Pelo seu site, pela página da rádio ou pelo app: o pedido chega ao painel ou toca sozinho no AutoDJ.

Players e Widgets

Player com SSL, tocando agora e widgets de pedidos e chat, para colar 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.

Rádio na Alexa

"Alexa, toca a minha rádio": a skill oficial da sua emissora, inclusa no plano CROWN.

Portal XCAST Rádios

Sua rádio listada automaticamente num portal nacional de descoberta — divulgação desde o dia 1.

Página da Rádio (Player)

A página pronta da sua rádio com o player, em 5 modelos — pedidos, chat e mais, incluso no painel.

Integre sua rádio a tudo

API JSON e widget de 1 linha inclusos em todos os planos xCAST, a partir de R$29,20/mês. Ativação imediata e 30 dias de garantia.

Ver planos xCAST Falar com especialista