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

Base URL

https://api.elitefootball.cloud

Formato

JSON · UTF-8

Versión estable

/api/v1/*

Autenticación

La API pública está disponible en lectura para evaluación. Para uso en producción (apps, productos, alto volumen o redistribución), solicita una clave comercial a .

Cuando tengas clave, envíala en cada petición:

HTTP header

X-API-Key: TU_CLAVE_AQUI
# o, según acuerdo:
X-Internal-Token: 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

Uso comercial

Planes para medios, apps, scouting clubs y data products. Incluyen cuota de requests, soporte y acceso a endpoints premium (live hub, predicciones, scouting). Escribe a soporte indicando caso de uso y volumen estimado.

Probar en Swagger

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