Cómo crear un panel de fútbol personal usando APIs gratuitas y Google Sheets
Cómo crear un dashboard de fútbol personal con APIs gratuitas y Google Sheets
Crea tu propio rastreador de resultados en vivo hoy
La mayoría de apps de resultados llenan tu feed con ligas que nunca ves, esconden los equipos que te importan bajo pestañas y disparan notificaciones por cada gol en un torneo que ignoraste. No puedes filtrar el ruido sin pagar por un nivel premium que sigue mostrando anuncios. Una hoja de Google Sheets alimentada por una API gratuita invierte ese modelo. Tú decides exactamente qué clubes aparecen (por ejemplo, Arsenal, Bayern Munich y Boca Juniors) y nada más. Los datos se actualizan cuando abres la hoja o según un temporizador que configuras, no cuando lo decide un servidor push. Sin banners, sin píxeles de seguimiento, sin cuenta requerida más allá de la clave de API. Los planes gratuitos de API-Football y Football-Data.org permiten cientos de llamadas al día, más que suficiente para una lista personal de partidos. La hoja vive en Drive, así que se abre en tu móvil, portátil o un enlace familiar compartido sin problemas de sincronización. Controlas el diseño, los colores y la lógica; nada queda obsoleto porque un equipo de producto cambió de rumbo.
Necesitas una cuenta de Google, unos quince minutos y cero experiencia en programación. El tutorial cubre tres opciones de API gratuitas: API-Football a través de RapidAPI, Football-Data.org y API-Football directa. Cada una ofrece un nivel gratuito de unas 100 peticiones al día, suficiente para seguir un puñado de clubes. Solo aparecen fórmulas básicas de Google Sheets: IMPORTJSON para obtener los datos, QUERY y FILTER para darles forma, así que nunca abres el editor de Apps Script. Si sabes escribir =SUMA(A1:A10), puedes crear este panel. La hoja permanece en tu Drive, se actualiza según tu horario y viaja a cualquier dispositivo donde inicies sesión. Sin tarjeta de crédito, sin servidor, sin ventana de mantenimiento.
Elige tu API y obtén tus credenciales
Image: 4.2 - Trace the sleeve, by LaMenta3, CC BY-SA 2.0
API-Football en RapidAPI ofrece el inicio más rápido: una cuenta en el marketplace, 100 peticiones al día y cobertura de más de 800 ligas. Football-Data.org omite el paso de la tarjeta de crédito, impone un ritmo suave de 10 peticiones por minuto y devuelve un JSON más plano que se analiza limpiamente en una hoja de Google Sheets. API-Football directa replica el catálogo de RapidAPI pero reside en su propio panel, así que gestionas las claves por separado. Una jornada típica de la Premier League consume unas 20 peticiones si obtienes partidos, marcadores en vivo y estadísticas básicas de cada encuentro. Para una primera versión, Football-Data.org elimina la capa adicional de RapidAPI y mantiene simple el cálculo de la cuota. Cambia a API-Football cuando necesites alineaciones, mapas de calor de jugadores o feeds de xG que Football-Data.org no expone.
Regístrate en football-data.org, confirma el correo y abre el panel para copiar tu X-Auth-Token.
Pega en el navegador: https://api.football-data.org/v4/competitions/PL/matches?dateFrom=2024-01-15&dateTo=2024-01-15.
Añade el encabezado X-Auth-Token: TU_TOKEN con ModHeader o el inspector de red.
Una respuesta correcta devuelve JSON con un objeto competition y un array matches; cada entrada trae utcDate, homeTeam.name, awayTeam.name y un objeto score con fullTime.home y fullTime.away.
Comprueba los encabezados X-RateLimit-Limit y X-RateLimit-Remaining para confirmar el techo de 10 peticiones por minuto.
Un 403 indica token ausente o mal formado; un 429, que has agotado el cupo del minuto.
Importar datos de fútbol en directo a Google Sheets
Google Sheets no incluye un parser JSON nativo, así que hay que instalar Apps Script una sola vez. Abre Extensiones > Apps Script, borra el código inicial y pega la función IMPORTJSON del gist de GitHub de Brad Jasper. Guarda el proyecto, vuelve a la hoja y autoriza el script cuando te lo pida — es una concesión de permisos estándar, no un riesgo de seguridad. La firma de la función es =IMPORTJSON(url, query, parseOptions). Usa noHeaders en parseOptions para evitar la fila de encabezado automática. Ejemplo: =IMPORTJSON("https://api.football-data.org/v4/competitions/PL/matches?dateFrom=2024-01-15&dateTo=2024-01-15", "/matches", "noHeaders"). Las funciones personalizadas solo se recalculan cuando cambian sus argumentos o se edita la hoja; no se autoactualizan con un temporizador. Ten en cuenta esa limitación al diseñar la siguiente sección.
=IMPORTJSON(
"https://api.football-data.org/v4/competitions/PL/matches?dateFrom="&TEXT(TODAY(),"yyyy-mm-dd")&"&dateTo="&TEXT(TODAY(),"yyyy-mm-dd"), // URL with dynamic today's date
"matches[*].[utcDate,homeTeam.name,awayTeam.name,score.fullTime.home,score.fullTime.away]", // JSONPath query: extract date, home, away, home score, away score
"noHeaders" // parseOption: suppress header row
)
Envuelve la llamada a IMPORTJSON en QUERY para conservar solo los partidos finalizados, ordenar por hora de inicio y mostrar columnas limpias: =QUERY(IMPORTJSON(...), "SELECT Col1, Col2, Col3, Col4, Col5 WHERE Col4 IS NOT NULL ORDER BY Col1", 0). Col1 es la cadena de fecha UTC, Col2 el equipo local, Col3 el visitante, Col4 el marcador local, Col5 el marcador visitante. Convierte UTC a hora local con un ARRAYFORMULA junto a los datos: =ARRAYFORMULA(IF(LEN(A2:A), TEXT(A2:A+TIME(1,0,0), "ddd dd/mm HH:mm"), )); ajusta el desplazamiento de TIME según tu zona. Muestra solo los clubes que sigues filtrando el rango resultante: =FILTER(B2:F, REGEXMATCH(B2:B, "Arsenal|Liverpool|Chelsea") + REGEXMATCH(C2:C, "Arsenal|Liverpool|Chelsea")). El signo más actúa como lógica OR entre las columnas de local y visitante. Estas tres fórmulas (QUERY, ARRAYFORMULA, FILTER) transforman un volcado JSON en bruto en una lista personal de partidos que se actualiza cada vez que la hoja se recalcula, sin necesidad de disparadores de Apps Script.
Automatizar la actualización y pulir el panel
Las funciones personalizadas como IMPORTJSON solo se recalculan al abrir la hoja o cuando cambian sus entradas, así que la lista de partidos se queda obsoleta hasta que intervienes. La solución más ligera es un script de Apps Script de cinco líneas que escribe una marca de tiempo en una celda apartada (Z1 va bien), forzando a todas las fórmulas dependentes a reevaluarse. Pégalo en Extensiones → Apps Script:
Guarda, luego haz clic en el icono del reloj (Activadores) → Añadir activador → elige triggerRefresh, basado en tiempo, temporizador por horas, cada hora. Eso genera 24 llamadas a la API al día, cómodamente por debajo del nivel gratuito de 100 llamadas en RapidAPI y del límite de 10 por minuto en Football-Data.org. Si prefieres cero mantenimiento de script, una actualización manual con Ctrl+R (Cmd+R en Mac) refresca la hoja bajo demanda. Cualquiera de los dos enfoques cierra la brecha del «en vivo» sin ningún complemento de pago ni automatización compleja.
Crea un selector de liga en la celda A1 con Datos → Validación de datos → Lista a partir de un rango e introduce los seis códigos de competición: PL, UCL, PD, BL1, SA, FL1. Reescribe la URL de IMPORTJSON para que lea esa celda y el panel cambie de liga al instante:
Aplica formato condicional a las columnas de goles (supongamos goles local en D, goles visitante en E). Selecciona las filas de partidos, ve a Formato → Formato condicional → La fórmula personalizada es y añade tres reglas:
=$D2>$E2→ relleno verde (victoria local)=$D2<$E2→ relleno rojo (victoria visitante)=$D2=$E2→ relleno amarillo (empate)
Los colores se actualizan solos a medida que llegan los resultados. Por último, comparte la hoja: Archivo → Compartir → Cualquier persona con el enlace → Visualizador. Para incrustarla públicamente, usa Archivo → Compartir → Publicar en la web → Documento completo → Enlace y pega el iframe donde lo necesites.
Mantén tu panel de fútbol funcionando a largo plazo
Image: DIY Suitcase Table, by Stacie Stacie Stacie, CC BY-SA 2.0
Los niveles gratuitos cambian sin previo aviso; Football-Data.org redujo su límite diario en 2023, así que trata la cuota como un objetivo móvil. Cada respuesta incluye cabeceras que revelan el estado en tiempo real: X-RequestCounter-Reset indica cuándo se reinicia la ventana y X-Requests-Available muestra el saldo restante. Captura esos valores en una pestaña oculta llamada _quota con una llamada ligera a IMPORTJSON apuntando a la ruta de las cabeceras, por ejemplo:
=IMPORTJSON("https://api.football-data.org/v4/competitions/PL/matches", "headers[X-Requests-Available],headers[X-RequestCounter-Reset]")
Programa un activador diario que añada el resultado junto a TODAY(); un formato condicional sencillo marca cualquier fila donde las llamadas disponibles bajen de veinte. Si el techo vuelve a bajar, cambia la URL base a API-Football; los endpoints replican la misma estructura, solo cambia la cabecera de autenticación de X-Auth-Token a X-RapidAPI-Key. Mantén una columna de reserva en tu selector de liga con códigos alternativos (PL, UCL, PD, BL1, SA, FL1) para que el panel sobreviva a un cambio de proveedor con una sola edición de celda.
- Verifica las cabeceras de cuota, prueba un endpoint, confirma que el formato condicional se aplica, comprueba la actualización de la marca de tiempo, revisa la lista de equipos favoritos.
- Vigila los errores 429, si necesitas actualizaciones minuto a minuto en directo, quieres estadísticas de jugadores o requieres más de 50 ligas — entonces evalúa los planes de pago.
El mismo patrón de IMPORTJSON que alimenta tu lista de partidos abre la puerta a un contexto más rico sin necesidad de nuevas herramientas. Cambia el endpoint a /competitions/PL/standings y la ruta de consulta a standings[0].table[].[position,team.name,played,won,draw,lost,points] para obtener una tabla en vivo; usa /competitions/PL/scorers con scorers[].[player.name,team.name,goals] para seguir la carrera por la Bota de Oro; o recupera la forma reciente de un club mediante /teams/57/matches?limit=5&status=FINISHED (sustituye 57 por cualquier ID de equipo de la referencia de Football-Data.org). Cada llamada devuelve un JSON plano que QUERY puede transformar en columnas limpias, de modo que puedes colocar clasificaciones, goleadores y forma uno al lado del otro en una sola hoja. La documentación interactiva del proveedor en docs.football-data.org te permite probar cada parámetro antes de pegar la URL. Tu panel ahora supera a cualquier app porque muestra exactamente lo que te interesa: ni más ni menos.