API de datos de fútbol

API de fútbol para marcadores en vivo, calendario y clasificación

Una API REST JSON de datos de fútbol que cubre 117 ligas y copas en 41 países y regiones. Marcadores en vivo cada minuto, alineaciones, eventos del partido y estadísticas, con un plan gratuito de 2.000 peticiones por día.

117
Ligas y copas
41
Países y regiones
32,000+
Partidos
4,800+
Equipos
100,000+
Eventos del partido
200,000+
Registros de jugadores por partido

Qué devuelve la API de fútbol

Cada tipo de datos está detrás de su propio endpoint, para que solicites solo lo que necesita una pantalla

Marcadores en vivo

Marcadores, estado y minuto actual, actualizados cada minuto mientras se juegan los partidos. Un feed WebSocket envía actualizaciones sin polling.

Calendario y horarios

Cada partido en una fecha con hora de inicio, estado, marcadores y fase de la competición, desde partidos de grupo hasta rondas de eliminación.

Clasificación de ligas

Tablas completas con partidos jugados, ganados, empatados, perdidos, goles a favor y en contra, diferencia de goles, puntos y forma reciente para cada equipo.

Eventos del partido

Goles, asistencias, tarjetas amarillas y rojas y sustituciones, cada uno con el jugador, el lado del equipo y el minuto.

Alineaciones y estadísticas de jugadores

Titulares, suplentes, números de camiseta, capitanes y minutos jugados, más tiros, pases y entradas por jugador donde existan datos detallados.

Estadísticas de partido del equipo

Tiros, tiros a puerta, faltas, pases, precisión de pases, entradas, paradas y tarjetas amarillas para ambos equipos en un partido.

Máximos goleadores, asistencias y tarjetas

Listas clasificadas para cada liga: máximos goleadores, más asistencias y más tarjetas amarillas y rojas.

Enfrentamientos directos

Encuentros anteriores entre dos equipos cualesquiera, con marcadores y fechas, para vistas previas de partidos.

Equipos, plantillas y trofeos

Perfiles de equipo con estadio y ciudad, listas de plantilla actual e historia de trofeos.

Endpoints de la API de fútbol

Todos los endpoints usan GET y devuelven JSON. URL base: https://sportapi.ai/api

EndpointDevuelve
GET /fixtures/date/{YYYY-MM-DD}Todos los partidos en una fecha con estado, marcadores, equipos y competición
GET /fixtures/{id}Un partido: marcador, estado, fase, penaltis y estadio
GET /fixtures/{id}/eventsGoles, asistencias, tarjetas y sustituciones con minutos
GET /fixtures/{id}/lineupsTitulares y suplentes con posiciones y minutos jugados
GET /fixtures/{id}/statsEstadísticas del equipo: tiros, pases, entradas, faltas, paradas
GET /fixtures/h2h/{team1}/{team2}Historial de enfrentamientos directos de dos equipos
GET /standings/{league_id}Tabla de liga con puntos, diferencia de goles y forma
GET /leaguesTodas las competiciones, agrupadas por país
GET /leagues/{id}/topscorersMáximos goleadores (también /topassists y /topcards)
GET /teams/{id}Perfil de equipo (también /squad y /trophies)
GET /players/{slug}Perfil de jugador con estadísticas de temporada y carrera

Referencia completa con parámetros y ejemplos →

Haz tu primera petición en minutos

Crea una cuenta, genera una clave en tu panel y envíala en la cabecera X-Api-Key. La estructura de la respuesta es la misma para cada liga, por lo que un único analizador cubre todas las competiciones.

  • Respuestas JSON para cada endpoint
  • Clave API en el encabezado X-Api-Key
  • Estado en vivo con el minuto actual
  • La misma estructura para cada liga
Documentación completa de la API →
PeticiónRespuesta
GET https://sportapi.ai/api/fixtures/date/2026-10-07
GET https://sportapi.ai/api/fixtures/5664768/lineups
GET https://sportapi.ai/api/fixtures/5664768/stats

X-Api-Key: YOUR_API_KEY

Compatible con cualquier lenguaje

HTTP y JSON puros, para que cualquier lenguaje, framework o herramienta pueda llamarlo

⌨️cURL
🐘PHP
🟢Node.js
🐍Python
☕Java
💎Ruby
🦀Rust
🔷Go
Plan gratuito de API de fútbol

Empieza gratis, mejora tu plan cuando crezca el tráfico

Cada plan incluye todos los endpoints y todas las ligas. El plan gratuito te da 2.000 peticiones por día (hasta 14.000 al mes) y una clave API, suficiente para construir un widget de marcadores en vivo, una página de clasificación o una tabla de máximos goleadores.

Los planes de pago aumentan el límite diario y el número de claves y no tienen tope mensual. El límite diario se aplica por clave y se reinicia cada día a las 00:00 UTC.

Crea una cuenta gratuita →
Peticiones por día, por clave
Free2.000
Starter10.000
Pro50.000
Business200.000

Precios de la API de fútbol

Todos los planes incluyen cada endpoint y cada liga

Free
Gratis
2.000 peticiones/día
  • Todos los endpoints
  • Todas las ligas y copas
  • Marcadores en vivo y calendario
  • Eventos del partido y alineaciones
  • 1 clave API
Empezar gratis
Starter
$10/mes
10.000 peticiones/día
  • Todos los endpoints
  • Todas las ligas y copas
  • Marcadores en vivo y calendario
  • Eventos del partido y alineaciones
  • 1 clave API
Suscríbete
Business
$50/mes
200.000 peticiones/día
  • Todos los endpoints
  • Todas las ligas y copas
  • Marcadores en vivo y calendario
  • Eventos del partido y alineaciones
  • 10 claves API
Suscríbete

Acerca de la API de fútbol SportAPI

SportAPI es una API de fútbol para desarrolladores que necesitan datos estructurados de partidos sin tener que unir varias fuentes. Es un servicio REST JSON que cubre solo el fútbol (soccer): calendario, marcadores en vivo, clasificación, equipos, jugadores, eventos del partido, alineaciones y estadísticas del partido. Es adecuado para aplicaciones de marcadores en vivo, juegos de fantasía, sitios web de clubes, bots y paneles de análisis.

Qué datos devuelve la API de fútbol

La API de datos de fútbol está organizada en calendario, ligas, equipos, jugadores y clasificación. Cada endpoint es una petición GET simple que devuelve JSON, por lo que se puede analizar en cualquier lenguaje. Un objeto de calendario contiene el id del partido, fecha y hora, estado (Scheduled, LIVE, HT, FT, AET, PENS), minuto actual, equipos local y visitante, marcadores y la fase de la competición. Como cada estado de partido usa los mismos campos, tu interfaz no necesita casos especiales. La referencia de endpoints enumera cada parámetro.

Marcadores en vivo y eventos del partido

Una API de marcadores en vivo solo es útil si es fresca. SportAPI actualiza los marcadores en vivo cada minuto mientras se disputan los partidos. Los goles, asistencias, tarjetas amarillas y rojas y sustituciones se almacenan como eventos del partido con el jugador, el lado del equipo y el minuto. Las alineaciones, asistencias, tarjetas y estadísticas de los jugadores se añaden aproximadamente una hora después del pitido final.

Si no quieres consultar la API constantemente (polling), conéctate al endpoint WebSocket en wss://sportapi.ai/ws?key=YOUR_API_KEY. Envía actualizaciones de marcador a tu cliente, típicamente 30 a 60 segundos después de un gol. También puedes ver los mismos datos en la página de marcadores en vivo.

Calendario, clasificación y API de estadísticas de fútbol

La API de calendario de fútbol devuelve cada partido en una fecha dada, y los endpoints de partido único te dan eventos, alineaciones y estadísticas. La API de clasificación de fútbol devuelve la tabla completa: posición, jugados, ganados, empatados, perdidos, goles a favor y en contra, diferencia de goles, puntos y forma reciente. Cada tabla de liga en este sitio está construida con los mismos datos.

La API de estadísticas de fútbol ofrece estadísticas de equipos por partido: tiros, tiros a puerta, tiros fuera de portería, faltas, pases, precisión de pases, entradas, éxito en entradas, paradas y tarjetas amarillas. Los registros de partidos de jugadores añaden minutos jugados, goles, asistencias, tiros, ocasiones creadas y entradas. Los máximos goleadores, máximos asistentes y más tarjetas están disponibles para cada liga, y el historial de enfrentamientos directos para cualquier par de equipos.

Cobertura de la API de fútbol

La API abarca 117 ligas y copas en 41 países y regiones, con más de 4.800 equipos, 32.000 partidos, 25.000 jugadores y 100.000 eventos de partido. La cobertura incluye la Premier League, La Liga, Serie A, Bundesliga, Ligue 1, Eredivisie, la Champions League, Europa League y Conference League, las Nations League de UEFA y Concacaf, la MLS, la Liga MX, la Serie A de Brasil, la Saudi Pro League y la J1 League. También se incluyen divisiones inferiores inglesas, copas nacionales, competiciones femeninas y partidos de selecciones. Consulta la página de cobertura para la lista completa.

Los datos detallados dependen de la fuente. Las alineaciones, asistencias, tarjetas y estadísticas de jugadores existen para competiciones que nuestra fuente de datos cubre en detalle. Para algunas competiciones más pequeñas, solo obtienes el marcador, el estado y los goles.

Empieza en tres pasos

Primero, crea una cuenta gratuita en la página de registro con tu correo o Google y genera una clave en My Access. Las claves comienzan con sk_live_. Segundo, envía la clave en el encabezado X-Api-Key. Tercero, llama a un endpoint:

curl "https://sportapi.ai/api/fixtures/date/2026-10-08" \
  -H "X-Api-Key: YOUR_API_KEY"

La demo en vivo te permite probar los endpoints con tu clave antes de escribir código. Mantén la clave en tu servidor, no en el código del navegador.

Plan gratuito de API de fútbol y planes de pago

El plan gratuito de API de fútbol no tiene costo y permite 2.000 peticiones diarias (14.000 al mes) con una clave. Starter es $10 al mes para 10.000 peticiones diarias, Pro es $25 por 50.000 peticiones y tres claves, y Business es $50 por 200.000 peticiones y diez claves. Todos los planes incluyen todos los endpoints y ligas. El límite se aplica por clave y se reinicia a las 00:00 UTC. Cada llamada cuenta como una petición, incluidas las que devuelven un error, y la API responde con HTTP 429 una vez alcanzado el límite. Compara las opciones en la página de precios.

En los últimos 30 días, el tiempo de respuesta mediano fue de aproximadamente 22 ms, y la mayoría de las peticiones se respondieron en menos de 100 ms.

Lo que no hace la API de fútbol

SportAPI no proporciona cuotas de apuestas, expected goals (xG), porcentajes de posesión ni fotos de jugadores, y solo cubre fútbol. Aún no hay SDK oficiales ni webhooks, ni garantía de disponibilidad. Si tu producto necesita esas funciones, planea añadir otra fuente. Para marcadores, calendario, clasificación, eventos y estadísticas básicas de partido, es una base completa y sencilla.

API de fútbol: preguntas frecuentes

¿Hay un plan gratuito de API de fútbol y cuáles son sus límites? −

Sí. El plan gratuito cuesta $0 y permite 2.000 peticiones diarias, hasta 14.000 al mes, con una clave API. Incluye todos los endpoints y todas las ligas. El límite se reinicia todos los días a las 00:00 UTC, y la API responde con HTTP 429 una vez alcanzado. Cada llamada cuenta como una petición, incluidas las que devuelven un error.

¿Cómo me autentico con la API de fútbol? +

Crea una cuenta, genera una clave en My Access en tu panel y envíala en el encabezado HTTP X-Api-Key con cada petición. Las claves comienzan con sk_live_. La URL base es https://sportapi.ai/api. Mantén la clave en tu servidor en lugar de en el código del navegador.

¿Qué formato devuelve la API de fútbol? +

Cada endpoint devuelve JSON sobre REST mediante peticiones GET. La estructura es idéntica para cada liga y competición, por lo que un solo parser funciona en todas partes.

¿Con qué frecuencia se actualizan los marcadores en vivo? +

Los marcadores en vivo se actualizan cada minuto mientras se disputan los partidos. Las alineaciones, asistencias, tarjetas y estadísticas de jugadores se añaden aproximadamente una hora después del pitido final. Las actualizaciones por WebSocket llegan unos 30 a 60 segundos después de un gol.

¿Qué ligas cubre la API de fútbol? +

Cubre 117 ligas y copas en 41 países y regiones, incluyendo la Premier League, La Liga, Serie A, Bundesliga, Ligue 1, la Champions League, la MLS, las divisiones inferiores de Inglaterra, copas nacionales, competiciones femeninas y partidos de selecciones nacionales. La página de cobertura lista cada competición.

¿La API de fútbol incluye cuotas de apuestas? +

No. SportAPI no proporciona cuotas, goles esperados ni porcentajes de posesión. Ofrece resultados, calendario, clasificación, eventos del partido, alineaciones y estadísticas de los partidos.

¿Están disponibles las alineaciones y estadísticas de jugadores para cada partido? +

No. Están disponibles para partidos en competiciones que nuestra fuente de datos cubre en detalle. Para algunas competiciones más pequeñas, como varias copas nacionales y ligas inferiores, solo están disponibles el marcador, el estado y los goles.

¿Puedo obtener actualizaciones en vivo sin hacer polling? +

Sí. Conéctate al endpoint WebSocket wss://sportapi.ai/ws?key=YOUR_API_KEY. Envía actualizaciones de marcadores en vivo a tu cliente, típicamente 30 a 60 segundos después de un gol, lo que reduce el número de peticiones que necesitas hacer.

Empieza a construir con la API de fútbol hoy

Plan gratuito con 2.000 peticiones diarias y 14.000 al mes. Incluye todos los endpoints y ligas.

Obtén tu clave API →