Documentación

API de RadarFutebol

La API de RadarFutebol entrega en JSON los partidos de fútbol en vivo que aparecen en el panel: resultado, minuto de juego, estadísticas de ambos equipos y, en el plan Completa, cuotas, probabilidades, xG, el índice de presión Score de Lances, previsión del tiempo añadido e historial. Es la misma fuente del sitio, recalculada cada 5 segundos.

Dirección base y formato

Todas las rutas están bajo la dirección de abajo, responden solo a GET y devuelven JSON en UTF-8.

https://www.radarfutebol.com/api

OpenAPI 3.1: https://www.radarfutebol.com/openapi.json

Autenticación

Cada suscripción de API genera un token, visible en la página Pagos de tu cuenta (allí también puedes generar un token nuevo, que invalida el anterior). Envía el token en la cabecera Authorization en cada llamada:

Authorization: Bearer <token>
Accept: application/json

El token vale durante el período contratado. Cada endpoint exige el plan indicado en la tabla; un token de otro plan recibe 403.

Endpoints

Endpoint	Plan	Qué devuelve
GET /eventos-live-basico	Básica	Partidos en vivo: id del partido, país, competición, equipos, resultado final y del descanso, minuto actual y estadísticas de cada equipo (posesión, tiros, córners, ataques peligrosos, penaltis y tarjetas).
GET /eventos-live	Completa	Todo lo de la versión básica, más cuotas previas y en vivo, probabilidades, xG, Score de Lances de 5 y 10 minutos y previsión del tiempo añadido.
GET /eventos-passados/{data}	Completa	Partidos terminados en la fecha indicada en formato AAAA-MM-DD, con competición, equipos y resultado final.
GET /dados-evento/{id}	Completa	Línea de tiempo de un partido. El {id} es el campo id que devuelven los endpoints de partidos en vivo.

Límites, caché y errores

Básica: 60 solicitudes por minuto. Completa: 180 por minuto. Por encima del límite la respuesta es 429 con la cabecera Retry-After en segundos.
Los datos en vivo cambian cada 5 segundos. Consultar más rápido devuelve el mismo contenido.
Cada respuesta trae ETag. Devuélvelo en If-None-Match y, si nada cambió, la respuesta es 304 sin cuerpo.
Cada respuesta trae las cabeceras RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset y RateLimit-Policy (estándar IETF), además de las X-RateLimit-* antiguas.
Versión: el contrato actual es la versión 1, indicada en la cabecera API-Version. Un campo nuevo no cambia la versión. Un cambio incompatible sale como versión nueva, elegida con la cabecera API-Version en la solicitud y avisada por e-mail a los suscriptores; lo que vaya a retirarse responde antes con las cabeceras Deprecation y Sunset.
401 significa token ausente, inválido o vencido: detén el bucle y renueva la suscripción. Tras 60 respuestas 401 en 10 minutos, la IP recibe 429 hasta que cierre la ventana.

Ejemplo

curl -H "Authorization: Bearer $RADARFUTEBOL_TOKEN" \
     -H "Accept: application/json" \
     https://www.radarfutebol.com/api/eventos-live-basico

Planes y contratación

Los planes Básica y Completa, con precio mensual y anual, están en la página de la API. Se contrata en el propio sitio y el token sale al instante.

Ver planes de la API

¿Duda técnica? Escribe a [email protected].