O que está tocando nas rádios online, agora.
O Tuneping mantém um índice ao vivo de dezenas de milhares de estações de rádio online e o oferece como uma API JSON, com histórico de execuções e alertas de lista de desejos. Lemos a linha de título que todo player exibe, e nunca o áudio.
Experimente ao vivo, no índice real · 2 req/s sem chave
Leia a documentação da APIStatus ao vivoGET https://api.tuneping.com/v1/now-playing/search
01 · O que você recebe
Seis recursos, uma API
Busca ao vivo
sem chavePergunte “quem está tocando Blue Monday agora?” e receba as estações, com busca aproximada e sem distinção de acentos, e um nível de confiança por resultado.
GET /v1/now-playing/search
Tocando agora nas favoritas
sem chaveUma requisição com um lote de ids de estações retorna o título atual, quando ele foi visto pela primeira vez e quando foi confirmado pela última vez.
GET /v1/now-playing?station_ids=…
Histórico de execuções
developer +O que uma estação tocou, com horários estimados de início e fim: 7 dias no Developer, 12 meses no Pro e acima.
GET /v1/stations/{id}/history
Alertas de lista de desejos
developer +Indique uma música ou um artista e saiba no momento em que uma estação começar a tocá-lo. Consulte por polling ou receba em stream via SSE; no Pro e acima, receba um webhook.
SSE · webhook
Faixas e artistas
sem chaveOs títulos são normalizados e, quando possível, vinculados a identificadores do MusicBrainz, para que você possa contar execuções por faixa ou artista.
trk_… · art_… · MusicBrainz ids
Diretório de estações
sem chaveDezenas de milhares de estações com país, codec e o método que usamos para ler seus títulos, com busca e filtros.
GET /v1/stations
02 · Como funciona
Lemos uma linha
Todo stream carrega um pequeno canal paralelo com o título atual, o texto que seu player exibe. O Tuneping lê isso e nada mais.
Diretório
Partimos do diretório público Radio Browser, mantido pela comunidade, e sondamos cada estação uma vez para descobrir o lugar mais barato onde seu título é publicado: o endpoint de status público do servidor de streaming ou o bloco de metadados dentro do stream.
Consultar, com educação
A cada 20 a 60 segundos lemos de algumas centenas de bytes até cerca de 16 KB por estação e fechamos a conexão. No máximo duas conexões por servidor ao mesmo tempo, respeitando o robots.txt e o Retry-After. Detalhes para operadores.
Normalizar
Os títulos são divididos em artista e faixa, classificados como música, vinheta, programa ou anúncio, comparados com o MusicBrainz quando o texto permite e recebem um horário de início com uma incerteza explícita.
Servir
Uma API JSON simples com ETags, cabeçalhos de rate limit e cache na borda, descrita em um arquivo OpenAPI e na referência da API.
Só metadados · tudo o que guardamos de uma consulta
StreamTitle='Madonna - Holiday';
O áudio ao redor é descartado à medida que chega. Nenhuma gravação, nenhuma prévia, nenhum fingerprinting, nada retransmitido. O que o coletor faz.
03 · Limites honestos
O que ele não faz
Muitas estações não enviam títulos, só o próprio nome ou slogans. Marcamos essas estações e não inventamos dados; a página de status mostra quantas entregam metadados ao vivo.
Uma mudança vista em uma consulta aconteceu em algum momento do intervalo anterior. Toda execução traz start_uncertainty_seconds; espere ±10 a 30 s, dependendo do método.
A detecção por metadados da estação é menos completa que o reconhecimento de áudio e nunca uma contagem certificada de execuções. Como evidência, diga “detectado a partir dos metadados da estação”.
Streams mudam de endereço, saem do ar e trocam de dono todos os dias. Uma estação pode fazer opt-out a qualquer momento e sai da API em até 24 horas.
Os nomes das estações são retornados como texto; logos e artes não fazem parte do serviço.
04 · Planos
Planos
Autoatendimento, cancele quando quiser. O plano anual custa dez vezes o mensal. Os preços incluem impostos (IVA) onde se aplicam; o Stripe cobra em CHF, EUR, USD, GBP ou JPY. Business e cobrança anual: [email protected].
Free
€ 0
para sempre
- 1.000 requisições por dia
- 2 req/s, rajada de 5
- Busca ao vivo, tocando agora em lote (20 estações), diretório de estações
- Consultas de faixas e artistas
- 1 chave de API após verificação do e-mail
- Exibe “Data by Tuneping”
Developer
€ 29 / mês
ou € 290 / ano
- 100.000 requisições por mês
- 10 req/s, rajada de 20
- Tocando agora em lote para até 100 estações
- 7 dias de histórico de execuções
- 10 listas de desejos, por polling ou via SSE
- Suporte por e-mail em até 2 dias úteis
- Sem atribuição obrigatória
Pro
€ 99 / mês
ou € 990 / ano
- 1.000.000 de requisições por mês
- 50 req/s, rajada de 100
- 12 meses de histórico de execuções
- 5 endpoints de webhook com filtros por estação, faixa e artista
- 100 listas de desejos, também entregues por webhook
- Relatórios de execuções por faixa e artista
- 5 chaves de API, suporte por e-mail em até 1 dia útil
Business
a partir de € 349 / mês
fatura anual, volume sob medida
- Volume e taxa de requisições sob medida
- 12 meses de histórico, mais dados agregados além disso
- 20 endpoints de webhook, firehose sem filtro permitido
- 1.000 listas de desejos, 20 conexões SSE
- Exportações CSV / JSONL
- SLA mensal de 99,5% nas leituras, contato dedicado
05 · Operadores
Opera uma estação?
Você pode ver TunepingBot/0.1 (+https://tuneping.com/bot) nos seus logs. Ele lê o endpoint de status público ou o primeiro bloco de metadados do seu stream a cada 20 a 60 segundos, e nada mais. Seus endereços, e três formas de opt-out que entram em vigor em até 24 horas, estão em uma única página. Dúvidas: [email protected].