Elite Football Cloud · API

Datos de fútbol listos para integrar

REST JSON con ligas, equipos, jugadores, partidos en vivo, clasificaciones, fichajes, valor de mercado y scouting. Base URL estable y esquema OpenAPI interactivo.

Abrir Swagger openapi.json Ver planes

Base URL

https://api.elitefootball.cloud

Formato

JSON · UTF-8

Versión estable

/api/v1/*

Planes

Free con 3 ligas menores para probar. Starter, Growth y Pro incluyen 7 días de prueba: introduces la tarjeta y el primer cobro es automático al acabar el trial (cancela antes si no quieres continuar). Anual −20%. Al superar la cuota → HTTP 429, sin cargos extra.

Free

0 €/ mes

Sandbox para probar la API

Ligas: 3 ligas menores
Requests: 1500 / día
Rate: 30 / min

3 ligas menores fijas (sandbox)
Hoy: LaLiga Hypermotion + 2 slots en camino
Equipos, jugadores, partidos, standings
1.500 requests / día · 30 / min
Sin live hub, scouting ni predicciones

Crear cuenta gratis

Popular

Starter

20 €/ mes

o 192 € / año (−20%)

Prototipos en producción

Ligas: 5 ligas a elegir
Requests: 10.000 / día
Rate: 60 / min

7 días de prueba gratis (luego cobro automático)
5 ligas a elegir (pueden ser top)
Catálogo REST estándar
10.000 requests / día · 60 / min
Soporte por email

Puedes cambiar a anual arriba para el −20%. Introduces tarjeta ahora; hoy pagas 0 €. El primer cobro es a los 7 días.

Growth

79 €/ mes

o 758.40 € / año (−20%)

Live y tráfico medio

Ligas: 15 ligas a elegir
Requests: 75.000 / día
Rate: 120 / min

7 días de prueba gratis (luego cobro automático)
15 ligas a elegir
Live matches + hub
Feed de fichajes
75.000 requests / día · 120 / min

Puedes cambiar a anual arriba para el −20%. Introduces tarjeta ahora; hoy pagas 0 €. El primer cobro es a los 7 días.

Pro

199 €/ mes

o 1910.40 € / año (−20%)

Scouting y predicciones

Ligas: Todas las ligas
Requests: 250.000 / día
Rate: 300 / min

7 días de prueba gratis (luego cobro automático)
Acceso a todas las ligas
Scouting avanzado
Predicciones 1X2
250.000 requests / día · 300 / min

Puedes cambiar a anual arriba para el −20%. Introduces tarjeta ahora; hoy pagas 0 €. El primer cobro es a los 7 días.

Enterprise

A medida

Volumen, SLA y a medida

Ligas: Todas + roadmap
Requests: Custom
Rate: Custom

1M+ requests / día o ilimitado
Rate limit y SLA custom
Soporte prioritario
Webhooks e histórico profundo

Plan	Precio	Ligas	Req/día	Rate/min
Free	0 €/mes	3 ligas menores	1500 / día	30
Starter	20 €/mes	5 ligas a elegir	10.000 / día	60
Growth	79 €/mes	15 ligas a elegir	75.000 / día	120
Pro	199 €/mes	Todas las ligas	250.000 / día	300
Enterprise	A medida	Todas + roadmap	Custom	—

Autenticación

Crea una cuenta (plan Free automático), ve a Mi cuenta API y genera tu clave. Obligatoria en todas las peticiones a la API:

HTTP header

X-API-Key: ef_tu_clave_aqui

Inicio rápido

Tres llamadas típicas para validar la integración en menos de un minuto.

Listar ligas

curl -sS "https://api.elitefootball.cloud/api/v1/leagues" \
  -H "Accept: application/json"

Jugadores paginados

curl -sS "https://api.elitefootball.cloud/api/v1/players?page=1&page_size=20&position=Delantero" \
  -H "Accept: application/json"

Partidos en vivo / hoy

curl -sS "https://api.elitefootball.cloud/api/matches/live" \
  -H "Accept: application/json"

Formato de respuesta

Los listados simples (p. ej. ligas) devuelven un array JSON. Los listados paginados de jugadores usan envelope:

application/json

{
  "items": [ { "id": "…", "display_name": "…", "position": "Delantero", … } ],
  "total": 6232,
  "page": 1,
  "page_size": 20,
  "pages": 312
}

Los identificadores son UUID. Las imágenes relativas (p. ej. /images/…) se sirven desde el sitio https://elitefootball.cloud.

Catálogo estable · /api/v1

Superficie recomendada para integraciones comerciales a largo plazo.

Método	Endpoint	Descripción	Query
GET	/api/v1/leagues	Catálogo de ligas con país y slug	—
GET	/api/v1/countries	Países	—
GET	/api/v1/continents	Continentes	—
GET	/api/v1/teams	Equipos	club_id, league_id
GET	/api/v1/clubs	Clubes	—
GET	/api/v1/clubs/teams	Relación club → equipos	club_id
GET	/api/v1/clubs/{club_id}/teams	Equipos de un club	—
GET	/api/v1/coaches	Entrenadores	active, nationality
GET	/api/v1/stadiums	Estadios	country_name
GET	/api/v1/matches	Partidos	league_id, season_id
GET	/api/v1/matches/{match_id}/statistics	Estadísticas del partido	—
GET	/api/v1/matches/{match_id}/lineups	Alineaciones	—
GET	/api/v1/players	Jugadores paginados	page, page_size, position
GET	/api/v1/players/stats	Ranking de estadísticas	season_id, season_name, league_id, team_id, limit, offset
GET	/api/v1/players/{player_id}/history	Historial / trayectoria	—
GET	/api/v1/players/{player_id}/snapshots	Snapshots de valor de mercado	—
GET	/api/v1/players/{player_id}/injuries	Lesiones	—

Producto · live, standings, fichajes, scouting

Endpoints que alimentan la web (tiempo real, clasificaciones, mercado y explorador de scouting). Incluidos en el mismo host API.

Método	Endpoint	Descripción	Query
GET	/api/matches/live	Partidos en directo y calendario del día	date (YYYY-MM-DD), league_id, include_secondary
GET	/api/matches/{match_id}	Detalle de partido	—
GET	/api/matches/{match_id}/events	Eventos (goles, tarjetas, cambios)	—
GET	/api/matches/{match_id}/hub	Payload completo para hub en vivo	—
GET	/api/matches/{match_id}/prediction	Predicción 1X2	—
GET	/api/standings/{season_id}	Clasificación de temporada	league_id
GET	/api/standings/{season_id}/player-stats	Estadísticas de jugadores en la temporada	—
GET	/api/transfers	Feed de fichajes	window (recent\|summer\|winter\|all), league_id, page, page_size
GET	/api/players/{player_id}	Ficha completa de jugador	—
GET	/api/players/{player_id}/value-history	Histórico de valor de mercado	—
GET	/api/players/{player_id}/season-stats	Agregados por temporada	—
GET	/api/players/{player_id}/match-stats	Estadísticas partido a partido	—
GET	/api/players/{player_id}/similar	Jugadores similares	—
GET	/api/teams/{team_id}	Detalle de equipo	—
GET	/api/teams/{team_id}/players	Plantilla por posición	—
GET	/api/scout/players	Motor de scouting con filtros avanzados	position_group, age_min/max, market_value_, goals_min, form_, sort, limit…
GET	/api/academies	Canteras y filiales	—
GET	/api/seasons/current	Temporada actual	—
GET	/health	Health check	—

Scouting avanzado

GET /api/scout/players admite filtros de posición (GK|DF|MF|FW), edad, valor, goles, asistencias, pie, nacionalidad, ventana de forma (5/10) y ordenación.

Ejemplo scouting

curl -sS "https://api.elitefootball.cloud/api/scout/players?position_group=FW&age_max=23&goals_min=5&limit=25" \
  -H "Accept: application/json"

Errores y códigos

Código	Significado
200	OK
404	Recurso no encontrado (UUID inválido o inexistente)
422	Parámetros de query inválidos
429	Límite de tasa (planes comerciales)
500	Error interno — reintenta o contacta soporte

¿Listo para empezar?

Indica el plan (Free, Starter, Growth, Pro o Enterprise), ligas que necesitas y volumen estimado. Respondemos en supportelitefootballcloud@gmail.com.

Volver a planes

Referencia interactiva completa: https://api.elitefootball.cloud/docs. Esquema: https://api.elitefootball.cloud/openapi.json.