Lo que suena en la radio por internet, ahora mismo.
Tuneping mantiene un índice en vivo de decenas de miles de emisoras de radio por internet y lo sirve como API JSON, con historial de reproducciones y alertas de listas de deseos. Leemos la línea de título que muestra cualquier reproductor, y nunca el audio.
Prueba en vivo, contra el índice real · 2 req/s sin clave
Lee la documentación de la APIEstado en vivoGET https://api.tuneping.com/v1/now-playing/search
01 · Qué obtienes
Seis cosas, una API
Búsqueda en vivo
sin clavePregunta “¿quién está poniendo Blue Monday ahora mismo?” y obtén las emisoras, con búsqueda aproximada que ignora los acentos y un nivel de confianza por resultado.
GET /v1/now-playing/search
Lo que suena en tus favoritas
sin claveUna sola solicitud con un lote de ids de emisoras devuelve el título actual, cuándo se vio por primera vez y cuándo se confirmó por última vez.
GET /v1/now-playing?station_ids=…
Historial de reproducciones
developer +Lo que puso una emisora, con horas estimadas de inicio y fin: 7 días en Developer, 12 meses en Pro y superiores.
GET /v1/stations/{id}/history
Alertas de listas de deseos
developer +Indica una canción o un artista y entérate en cuanto una emisora empiece a ponerlo. Consúltalo periódicamente o recíbelo en streaming por SSE; en Pro y superiores, también mediante un webhook.
SSE · webhook
Pistas y artistas
sin claveLos títulos se normalizan y, cuando es posible, se vinculan a identificadores de MusicBrainz para que puedas contar reproducciones por pista o por artista.
trk_… · art_… · MusicBrainz ids
Directorio de emisoras
sin claveDecenas de miles de emisoras con país, códec y el método que usamos para leer sus títulos, con búsqueda y filtros.
GET /v1/stations
02 · Cómo funciona
Leemos una línea
Cada stream lleva un pequeño canal lateral con el título actual, el texto que muestra tu reproductor. Tuneping lee eso y nada más.
Directorio
Partimos del directorio público Radio Browser, mantenido por la comunidad, y sondeamos cada emisora una vez para encontrar el lugar más barato donde publica su título: el endpoint de estado público del servidor de streaming o el bloque de metadatos dentro del stream.
Sondear, con cortesía
Cada 20 a 60 segundos leemos desde unos cientos de bytes hasta unos 16 KB por emisora y cerramos la conexión. Como máximo dos conexiones por servidor a la vez, respetando robots.txt y Retry-After. Detalles para operadores.
Normalizar
Los títulos se separan en artista y pista, se clasifican como canción, identificativo, programa o anuncio, se cotejan con MusicBrainz cuando el texto lo permite y reciben una hora de inicio con una incertidumbre explícita.
Servir
Una API JSON sencilla con ETags, cabeceras de límite de frecuencia y caché en el edge, descrita en un archivo OpenAPI y en la referencia de la API.
Solo metadatos · todo lo que guardamos de un sondeo
StreamTitle='Madonna - Holiday';
El audio que lo rodea se descarta a medida que llega. Sin grabación, sin vista previa, sin huella acústica, sin retransmisión. Qué hace el sondeador.
03 · Límites, con honestidad
Lo que no puede hacer
Muchas emisoras no envían títulos, solo su propio nombre o eslóganes. Las marcamos y no inventamos datos; la página de estado muestra cuántas entregan metadatos en vivo.
Un cambio visto en un sondeo ocurrió en algún momento del intervalo anterior. Cada reproducción lleva start_uncertainty_seconds; cuenta con ±10 a 30 s según el método.
La detección a partir de los metadatos de la emisora es menos completa que el reconocimiento de audio y nunca es un recuento certificado de reproducciones. Como prueba, indica “detectado a partir de los metadatos de la emisora”.
Los streams se mudan, desaparecen y cambian de dueño a diario. Una emisora puede excluirse en cualquier momento y sale de la API en menos de 24 horas.
Los nombres de las emisoras se devuelven como texto; los logotipos y las imágenes no forman parte del servicio.
04 · Planes
Planes
Autoservicio, cancela cuando quieras. La facturación anual equivale a diez mensualidades. Los precios incluyen el IVA cuando corresponde; Stripe factura en CHF, EUR, USD, GBP o JPY. Business y facturación anual: [email protected].
Free
0 €
para siempre
- 1.000 solicitudes al día
- 2 req/s, ráfaga de 5
- Búsqueda en vivo, now-playing por lotes (20 emisoras), directorio de emisoras
- Consultas de pistas y artistas
- 1 clave de API tras verificar el correo
- Muestra “Data by Tuneping”
Developer
29 € / mes
o 290 € / año
- 100.000 solicitudes al mes
- 10 req/s, ráfaga de 20
- Now-playing por lotes de hasta 100 emisoras
- 7 días de historial de reproducciones
- 10 listas de deseos, por consulta o vía SSE
- Soporte por correo en 2 días hábiles
- Sin atribución obligatoria
Pro
99 € / mes
o 990 € / año
- 1.000.000 de solicitudes al mes
- 50 req/s, ráfaga de 100
- 12 meses de historial de reproducciones
- 5 endpoints de webhook con filtros por emisora, pista y artista
- 100 listas de deseos, también entregadas por webhook
- Informes de reproducciones por pista y artista
- 5 claves de API, soporte por correo en 1 día hábil
Business
desde 349 € / mes
factura anual, volumen a medida
- Volumen y frecuencia de solicitudes a medida
- 12 meses de historial y agregados más allá
- 20 endpoints de webhook, firehose sin filtrar permitido
- 1.000 listas de deseos, 20 conexiones SSE
- Exportaciones CSV / JSONL
- SLA mensual del 99,5 % en lecturas, contacto asignado
05 · Operadores
¿Tienes una emisora?
Puede que veas TunepingBot/0.1 (+https://tuneping.com/bot) en tus registros. Lee tu endpoint de estado público o el primer bloque de metadatos de tu stream cada 20 a 60 segundos, y nada más. Sus direcciones, y tres formas de excluirte que surten efecto en menos de 24 horas, están en una sola página. Preguntas: [email protected].