football API Dokumentation

Einfache REST API. API-Schlüssel als Query-Parameter übergeben — keine Header erforderlich.

Basis-URL: https://live-football-api.com/api/v1

Authentifizierung

Fügen Sie api_key jeder Anfrage-URL hinzu. Erstellen Sie ein kostenloses Konto, um einen Schlüssel zu erhalten.

https://live-football-api.com/api/v1/matches?api_key=YOUR_KEY&date=2026-07-03

Geben Sie Ihren API-Schlüssel nicht in öffentlichem Client-Code oder öffentlichen Repos preis.

Guthaben

Jeder API-Aufruf verbraucht Guthaben. Guthaben verfällt nie. Neue Konten erhalten 100 kostenlose Credits.

Endpunkt	Kosten
GET /matches	1 Credit pro Aufruf
GET /live_match_details	1 Credit pro Aufruf
GET /lineups	1 Credit pro Aufruf
GET /h2h	1 Credit pro Aufruf
GET /injuries	1 Credit pro Aufruf
GET /officials	1 Credit pro Aufruf
GET /leagues	1 Credit pro Aufruf
GET /league	1 Credit pro Aufruf
GET /league_standings	1 Credit pro Aufruf
GET /league_fixtures	1 Credit pro Aufruf
GET /team_matches	1 Credit pro Aufruf
GET /team_squad	1 Credit pro Aufruf
GET /team_standings	1 Credit pro Aufruf
GET /player	1 Credit pro Aufruf
GET /player_matches	1 Credit pro Aufruf
GET /team_search	1 Credit pro Aufruf
GET /player_search	1 Credit pro Aufruf
POST /webhook/register	Kostenlos
GET /webhook/register	Kostenlos
DELETE /webhook/register	Kostenlos

Fehler

Alle Fehler geben JSON mit code und message zurück:

Code	Bedeutung
400	Bad request — missing or invalid parameter
401	API key missing or invalid
403	Access denied — insufficient credits, daily limit exceeded, or inactive account
429	Insufficient credits
500	Database error
503	Upstream data source unavailable — retry after a few seconds

{
  "success": false,
  "message": "Access denied. Possible reasons: Invalid key, insufficient credits, daily limit exceeded, or inactive account.",
  "timestamp": "2026-07-03 14:22:01"
}

GET /matches

Gibt footballspiele für ein bestimmtes Datum zurück. Team- und Liganamen können optional übersetzt werden.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Ihr API-Schlüssel
date	string	Nein	Spieldatum im Format `YYYY-MM-DD`
lang	string	Nein	Antwortsprache: `en` `tr` `de` `ru`

Beispielanfrage

GET https://live-football-api.com/api/v1/matches?api_key=YOUR_KEY&date=2026-07-03&lang=en

Antwort

{
  "success": true,
  "credits_remaining": 4999,
  "data": {
    "date": "2026-07-03",
    "language": "en",
    "timezone": "UTC",
    "matches": [
      {
        "id": "lfa4phmwb3bhclg7aqht1ajcwk",
        "league": {
          "id": "lfa-premier-league",
          "name": "Premier League",
          "country": "England"
        },
        "kickoff": "14:00",
        "status": {
          "status": "live",
          "display": "73'",
          "is_live": true,
          "state": "inPlay"
        },
        "home": {
          "id": "lfa-man-city",
          "name": "Manchester City",
          "logo": "https://live-football-api.com/teams/lfa-man-city.png",
          "score": 2
        },
        "away": {
          "id": "lfa-arsenal",
          "name": "Arsenal",
          "logo": "https://live-football-api.com/teams/lfa-arsenal.png",
          "score": 1
        },
        "halftime": { "home": 1, "away": 0 },
        "tv_broadcast": true,
        "penalty": { "home": null, "away": null }
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

tv_broadcast — true, wenn das Spiel im TV übertragen wird (noch keine Sendernamen). penalty — Elfmeterschießen-Ergebnis, null, außer das Spiel ging ins Elfmeterschießen.

GET /live_match_details

Gibt Echtzeit-Spieldaten zurück: Ereigniszeitlinie (Tore, Karten, Wechsel) und Matchstatistiken.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Ihr API-Schlüssel
match_id	string	Ja	Spiel-ID aus der `/matches`-Antwort
lang	string	Nein	Antwortsprache: `en` `tr` `de` `ru`

Beispielanfrage

GET https://live-football-api.com/api/v1/live_match_details?api_key=YOUR_KEY&match_id=lfa4phmwb3bhclg7aqht1ajcwk&lang=en

Antwort

{
  "success": true,
  "credits_remaining": 4998,
  "data": {
    "match_id": "lfa4phmwb3bhclg7aqht1ajcwk",
    "last_updated": "2026-07-03 14:22:01 UTC",
    "header": {
      "home": {
        "name": "Manchester City",
        "id": "lfa-man-city",
        "logo": "https://live-football-api.com/teams/lfa-man-city.png",
        "score": "2"
      },
      "away": {
        "name": "Arsenal",
        "id": "lfa-arsenal",
        "logo": "https://live-football-api.com/teams/lfa-arsenal.png",
        "score": "1"
      },
      "status": { "display": "", "is_live": true, "is_postponed": 0, "minute": "73", "state": "inPlay" }
    },
    "events": [
      {
        "time": "23",
        "type": "Goal",
        "side": "home",
        "detail": {
          "player": { "name": "Haaland", "id": "lfa-haaland", "image": "https://live-football-api.com/people/lfa-haaland.png" },
          "score": "1-0"
        }
      },
      {
        "time": "65",
        "type": "Yellow Card",
        "side": "away",
        "detail": {
          "player": { "name": "Rice", "id": "lfa-rice", "image": "https://live-football-api.com/people/lfa-rice.png" }
        }
      }
    ],
    "stats": [
      { "label": "Possession", "home": "62%", "away": "38%" },
      { "label": "Shots",      "home": "14",  "away": "6"   },
      { "label": "Corners",    "home": "7",   "away": "3"   }
    ],
    "csb_url": "https://live-football-api.com/api/v1/csb?token=eyJhbGci...&matchid=lfa4phmwb3bhclg7aqht1ajcwk&lang=en",
    "venue": { "name": "Etihad Stadium", "capacity": 53400 },
    "referee": "M. Oliver",
    "tv_channels": ["beIN SPORTS 1"],
    "player_of_the_match": { "name": "Haaland", "id": "lfa-haaland", "image": "https://live-football-api.com/people/lfa-haaland.png", "rating": 8.7 }
  },
  "timestamp": "2026-07-03 14:22:01"
}

venue, referee, tv_channels (tatsächliche Sendernamen) und player_of_the_match sind neu. Ereignisse können außerdem is_penalty / is_second_yellow in detail enthalten, wenn zutreffend.

csb_url — Sofort einsatzbereite iframe-URL für die Live-Spiel-CSB-Visualisierung. Direkt einbetten: <iframe src="csb_url" width="636" height="400" frameborder="0"></iframe>
Gibt null zurück, wenn das Spiel keinen aktiven CSB-Feed hat (z. B. vor dem Spiel oder nicht unterstützter Wettbewerb).

GET /csb

Gibt die Centre Stage Board (CSB) Visualisierung eines Live-Spiels als HTML-Seite zurück — zum Einbetten in einem <iframe> konzipiert. Das Feld csb_url in der /live_match_details-Antwort enthält bereits eine fertige URL mit vorausgehobenem Token; in den meisten Fällen müssen Sie diesen Endpunkt nicht manuell aufrufen.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
token	string	Ja	JWT-Visualisierungstoken (wird fertig in `csb_url` aus der live_match_details-Antwort geliefert).
matchid	string	Ja	Spiel-ID im `lfa`-Format (identisch mit dem Feld `id` aus /matches).
lang	string	Nein	Antwortsprache: `en` `tr` `de` `ru`

Beispielanfrage

<iframe
  src="https://live-football-api.com/api/v1/csb?token=TOKEN&matchid=lfa4phmwb3bhclg7aqht1ajcwk&lang=en"
  width="636"
  height="400"
  frameborder="0"
  allowtransparency="true"
></iframe>

Der CSB-Token ist zeitlich begrenzt (in der Regel 4 Stunden gültig). Verwenden Sie immer die csb_url aus einem frischen /live_match_details-Aufruf, um einen gültigen Token zu erhalten. Tokens nicht zwischenspeichern oder fest kodieren.

GET /lineups

Gibt die Startelf, Ersatzspieler und Trainer beider Teams zurück. Ca. 1 Stunde vor Anstoß verfügbar.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Ihr API-Schlüssel
match_id	string	Ja	Spiel-ID aus der `/matches`-Antwort
lang	string	Nein	Antwortsprache: `en` `tr` `de` `ru`

Beispielanfrage

GET https://live-football-api.com/api/v1/lineups?api_key=YOUR_KEY&match_id=lfa4phmwb3bhclg7aqht1ajcwk&lang=en

Antwort

{
  "success": true,
  "credits_remaining": 4997,
  "data": {
    "match_id": "lfa4phmwb3bhclg7aqht1ajcwk",
    "home": {
      "starting": [
        { "id": "lfa-ederson", "name": "Ederson", "image": "https://live-football-api.com/people/lfa-ederson.png", "number": "31", "position": "Goalkeeper", "rating": 6.8 },
        { "id": "lfa-haaland", "name": "Haaland", "image": "https://live-football-api.com/people/lfa-haaland.png", "number": "9",  "position": "Forward",   "rating": 8.7 }
      ],
      "subs": [
        { "id": "lfa-bernardo", "name": "Bernardo Silva", "image": "https://live-football-api.com/people/lfa-bernardo.png", "number": "20", "position": "Midfielder", "rating": null }
      ],
      "coach": { "id": "lfa-guardiola", "name": "Pep Guardiola", "image": "https://live-football-api.com/people/lfa-guardiola.png" }
    },
    "away": {
      "starting": [
        { "id": "lfa-raya", "name": "Raya", "image": "https://live-football-api.com/people/lfa-raya.png", "number": "1", "position": "Goalkeeper", "rating": 6.5 }
      ],
      "subs": [],
      "coach": { "id": "lfa-arteta", "name": "Mikel Arteta", "image": "https://live-football-api.com/people/lfa-arteta.png" }
    },
    "formation": { "home": 433, "away": 442 },
    "is_projected": false
  },
  "timestamp": "2026-07-03 14:22:01"
}

Jeder Spieler enthält jetzt auch number, position und rating. formation und is_projected (true = voraussichtliche Aufstellung vor Anpfiff) sind neu auf oberster Ebene.

GET /h2h

Gibt die bisherige Bilanz zwischen den beiden Teams zurück.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Ihr API-Schlüssel
match_id	string	Ja	Spiel-ID aus der `/matches`-Antwort
lang	string	Nein	Antwortsprache: `en` `tr` `de` `ru`

Beispielanfrage

GET https://live-football-api.com/api/v1/h2h?api_key=YOUR_KEY&match_id=lfa4phmwb3bhclg7aqht1ajcwk&lang=en

Antwort

{
  "success": true,
  "credits_remaining": 4996,
  "data": {
    "match_id": "lfa4phmwb3bhclg7aqht1ajcwk",
    "home_form": [
      {
        "date": "2026-06-14",
        "home": { "id": "lfa-man-city", "name": "Manchester City", "logo": "https://live-football-api.com/teams/lfa-man-city.png" },
        "away": { "id": "lfa-chelsea",  "name": "Chelsea",         "logo": "https://live-football-api.com/teams/lfa-chelsea.png" },
        "score": "3-1"
      }
    ],
    "away_form": [ ],
    "h2h": [
      {
        "date": "2025-09-22",
        "home": { "id": "lfa-man-city", "name": "Manchester City", "logo": "https://live-football-api.com/teams/lfa-man-city.png" },
        "away": { "id": "lfa-arsenal",  "name": "Arsenal",         "logo": "https://live-football-api.com/teams/lfa-arsenal.png" },
        "score": "2-1"
      }
    ],
    "h2h_summary": { "home_wins": 8, "away_wins": 6, "draws": 4 }
  },
  "timestamp": "2026-07-03 14:22:01"
}

h2h_summary ist neu — zusammengefasste Sieg-/Unentschieden-Zahlen der beiden Teams, zusätzlich zu den Spiel-für-Spiel-Listen.

GET /injuries

Gibt bestätigte Verletzungen und Sperren beider Teams vor dem Spiel zurück.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Ihr API-Schlüssel
match_id	string	Ja	Spiel-ID aus der `/matches`-Antwort
lang	string	Nein	Antwortsprache: `en` `tr` `de` `ru`

Beispielanfrage

GET https://live-football-api.com/api/v1/injuries?api_key=YOUR_KEY&match_id=lfa4phmwb3bhclg7aqht1ajcwk&lang=en

Antwort

{
  "success": true,
  "credits_remaining": 4995,
  "data": {
    "match_id": "lfa4phmwb3bhclg7aqht1ajcwk",
    "injuries": {
      "home": [
        {
          "id": "lfa-de-bruyne",
          "name": "Kevin De Bruyne",
          "image": "https://live-football-api.com/people/lfa-de-bruyne.png",
          "position": "Midfielder",
          "status": "Hamstring Injury",
          "stats": { "appearence": 12, "assists": 6, "goals": 2, "redCards": 0, "yellowCards": 1 }
        }
      ],
      "away": [
        { "id": "lfa-zinchenko", "name": "Oleksandr Zinchenko", "image": "https://live-football-api.com/people/lfa-zinchenko.png", "position": "Defender", "status": "Suspended", "stats": null }
      ]
    }
  },
  "timestamp": "2026-07-03 14:22:01"
}

Jeder Spieler enthält jetzt, sofern verfügbar, stats (Einsätze/Tore/Vorlagen/Karten dieser Saison), sonst null.

GET /officials

Gibt die Schiedsrichter eines Spiels zurück.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Ihr API-Schlüssel
match_id	string	Ja	Spiel-ID aus der `/matches`-Antwort
lang	string	Nein	Antwortsprache: `en` `tr` `de` `ru`

Beispielanfrage

GET https://live-football-api.com/api/v1/officials?api_key=YOUR_KEY&match_id=lfa4phmwb3bhclg7aqht1ajcwk

Antwort

{
  "success": true,
  "credits_remaining": 4994,
  "data": {
    "match_id": "lfa4phmwb3bhclg7aqht1ajcwk",
    "officials": [
      { "id": "8d319822-2432-4da3-7bcb-ca5c11421394", "name": "Michael Oliver", "role": "Main" },
      { "id": "6c998fdc-ca49-69c3-2488-347671830e3a", "name": "Stuart Burt",    "role": "Lineman 1" },
      { "id": "6a528c78-5157-c275-9d86-ca7ed7ff21ac", "name": "Simon Long",     "role": "Lineman 2" },
      { "id": "e6e57850-918d-c5ef-9bc0-e8b43c2b8e88", "name": "Anthony Taylor","role": "Fourth official" },
      { "id": "4748a374-2d55-ae66-642e-8e9e05fb566c", "name": "Graham Scott",  "role": "VAR" }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

GET /leagues

Gibt alle verfügbaren Ligen nach Land gruppiert zurück.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Ihr API-Schlüssel
lang	string	Nein	Antwortsprache: `en` `tr` `de` `ru`

Beispielanfrage

GET https://live-football-api.com/api/v1/leagues?api_key=YOUR_KEY&lang=en

Antwort

{
  "success": true,
  "credits_remaining": 4993,
  "data": {
    "language": "en",
    "total_countries": 45,
    "data": [
      {
        "country": "England",
        "leagues": [
          { "id": "lfa-premier-league",    "name": "Premier League" },
          { "id": "lfa-championship",      "name": "Championship" },
          { "id": "lfa-league-one",        "name": "League One" }
        ]
      },
      {
        "country": "Spain",
        "leagues": [
          { "id": "lfa-la-liga",   "name": "La Liga" },
          { "id": "lfa-segunda",   "name": "Segunda División" }
        ]
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

GET /league

Gibt Detailinformationen zu einer Liga zurück.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Ihr API-Schlüssel
league_id	string	Ja	Liga-ID aus `/leagues`
lang	string	Nein	Antwortsprache: `en` `tr` `de` `ru`

Beispielanfrage

GET https://live-football-api.com/api/v1/league?api_key=YOUR_KEY&league_id=lfa-premier-league&lang=en

GET /league_standings

Gibt die aktuelle Tabelle einer Liga zurück.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Ihr API-Schlüssel
league_id	string	Ja	Liga-ID aus `/leagues`
season	string	Nein	Saison-ID z.B. `2025` oder `2025-2026`. Leer lassen für aktuelle Saison.
lang	string	Nein	Antwortsprache: `en` `tr` `de` `ru`

Beispielanfrage

GET https://live-football-api.com/api/v1/league_standings?api_key=YOUR_KEY&league_id=lfa-premier-league&season=2024/2025&lang=en

Antwort

{
  "success": true,
  "credits_remaining": 4992,
  "data": {
    "league_id": "lfa-premier-league",
    "season": "2024/2025",
    "available_seasons": ["2024/2025", "2023/2024", "2022/2023"],
    "timezone": "UTC",
    "standings": [
      {
        "title": "Premier League",
        "table": [
          {
            "rank": 1,
            "team": {
              "id": "lfa-liverpool",
              "name": "Liverpool",
              "logo": "https://live-football-api.com/teams/lfa-liverpool.png"
            },
            "played": 38, "won": 28, "drawn": 6, "lost": 4,
            "goals_for": 86, "goals_against": 41,
            "goal_diff": 45, "points": 90,
            "form": "WWDWL",
            "zone": { "name": "Champions League", "color": "#02206B" }
          },
          {
            "rank": 2,
            "team": {
              "id": "lfa-man-city",
              "name": "Manchester City",
              "logo": "https://live-football-api.com/teams/lfa-man-city.png"
            },
            "played": 38, "won": 24, "drawn": 7, "lost": 7,
            "goals_for": 78, "goals_against": 52,
            "goal_diff": 26, "points": 79,
            "form": "WDWWW",
            "zone": { "name": "Champions League", "color": "#02206B" }
          }
        ]
      }
    ],
    "home_standings": [ { "title": "Premier League", "table": [ ] } ],
    "away_standings": [ { "title": "Premier League", "table": [ ] } ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

Jede Zeile enthält jetzt auch form (letzte 5 Ergebnisse, z. B. "WWDWL") und zone (Qualifikations-/Abstiegszone, falls vorhanden). Neu auf oberster Ebene: home_standings / away_standings — dieselbe Tabelle, aufgeteilt nach Heim- und Auswärtsergebnissen. Hinweis: numerische Felder (rank, played, points usw.) sind jetzt JSON-Zahlen statt Strings.

GET /league_fixtures

Gibt den vollständigen Spielplan einer Liga zurück, wochenweise gruppiert, mit Ergebnissen für gespielte und Anstoßzeiten für kommende Spiele.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Ihr API-Schlüssel
league_id	string	Ja	Liga-ID aus `/leagues`
season	string	Nein	Saison-ID z.B. `2025` oder `2025-2026`. Leer lassen für aktuelle Saison.
week	string	Nein	Filtert auf einen einzelnen Spieltag/eine Runde, z. B. `1`. Weglassen für alle Wochen.
lang	string	Nein	Antwortsprache: `en` `tr` `de` `ru`

Beispielanfrage

GET https://live-football-api.com/api/v1/league_fixtures?api_key=YOUR_KEY&league_id=lfa-super-lig&season=2025/2026&week=1&lang=tr

Antwort

{
  "success": true,
  "credits_remaining": 4991,
  "data": {
    "league_id": "lfa-super-lig",
    "league_name": "Trendyol Süper Lig",
    "season": "2025/2026",
    "available_seasons": ["2025/2026", "2024/2025", "2023/2024"],
    "timezone": "UTC",
    "weeks": [
      {
        "week": "1",
        "matches": [
          {
            "id": "lfa-c5b95lue06z36lha2ueniwsgk",
            "league": { "id": "lfa-super-lig", "name": "Trendyol Süper Lig" },
            "round": "Adnan Süvari Sezonu",
            "date": "2026-08-14",
            "kickoff": "18:30",
            "status": { "status": "finished", "display": "MS", "is_live": false, "state": "postGame" },
            "home": {
              "id": "lfa-esa748l653sss1wurz5ps3228",
              "name": "Galatasaray",
              "logo": "https://live-football-api.com/teams/lfa-esa748l653sss1wurz5ps3228.png",
              "score": "2"
            },
            "away": {
              "id": "lfa-eg0cqg1u8zz85ma9nzk0cijv",
              "name": "Çorum FK",
              "logo": "https://live-football-api.com/teams/lfa-eg0cqg1u8zz85ma9nzk0cijv.png",
              "score": "2"
            },
            "halftime": { "home": 0, "away": 0 },
            "penalty": { "home": null, "away": null }
          }
        ]
      }
    ],
    "stale": false
  },
  "timestamp": "2026-08-31 12:00:00"
}

GET /team_matches

Gibt Spielplan und Ergebnisse einer Mannschaft für eine Saison zurück.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Ihr API-Schlüssel
team_id	string	Ja	Team-ID aus den Spieldaten
season	string	Nein	Saison-ID z.B. `2025` oder `2025-2026`. Leer lassen für aktuelle Saison.
lang	string	Nein	Antwortsprache: `en` `tr` `de` `ru`

Beispielanfrage

GET https://live-football-api.com/api/v1/team_matches?api_key=YOUR_KEY&team_id=lfa-man-city&season=2024/2025&lang=en

Antwort

{
  "success": true,
  "credits_remaining": 4991,
  "data": {
    "team_id": "lfa-man-city",
    "team_logo": "https://live-football-api.com/teams/lfa-man-city.png",
    "season": "2024/2025",
    "available_seasons": ["2024/2025", "2023/2024", "2022/2023"],
    "timezone": "UTC",
    "matches": [
      {
        "id": "lfa4phmwb3bhclg7aqht1ajcwk",
        "date": "2025-08-17 14:00:00",
        "timestamp": 1755439200,
        "league": { "id": "lfa-premier-league", "name": "Premier League", "country": "England" },
        "status": "FT",
        "home": { "id": "lfa-man-city", "name": "Manchester City", "logo": "https://live-football-api.com/teams/lfa-man-city.png", "score": 2 },
        "away": { "id": "lfa-chelsea",  "name": "Chelsea",          "logo": "https://live-football-api.com/teams/lfa-chelsea.png",  "score": 0 }
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

GET /team_squad

Gibt den vollständigen Kader mit Positionen und Trikotnummern zurück.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Ihr API-Schlüssel
team_id	string	Ja	Team-ID aus den Spieldaten
season	string	Nein	Saison-ID z.B. `2025` oder `2025-2026`. Leer lassen für aktuelle Saison.
lang	string	Nein	Antwortsprache: `en` `tr` `de` `ru`

Beispielanfrage

GET https://live-football-api.com/api/v1/team_squad?api_key=YOUR_KEY&team_id=lfa-man-city&season=2024/2025

Antwort

{
  "success": true,
  "credits_remaining": 4990,
  "data": {
    "team_id": "lfa-man-city",
    "team_logo": "https://live-football-api.com/teams/lfa-man-city.png",
    "season": "2024/2025",
    "available_seasons": ["2024/2025", "2023/2024", "2022/2023"],
    "timezone": "UTC",
    "squad": [
      {
        "id": "lfa-haaland",
        "name": "Erling Haaland",
        "image": "https://live-football-api.com/people/lfa-haaland.png",
        "number": "9",
        "position": "Forward",
        "age": 25,
        "country": "Norway",
        "stats": { "matches": 34, "goals": 27, "assists": 5 },
        "yellow_cards": 2,
        "red_cards": 0
      }
    ],
    "coaches": [
      { "id": "lfa-guardiola", "name": "Pep Guardiola", "image": "https://live-football-api.com/people/lfa-guardiola.png" }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

Jeder Spieler enthält jetzt auch yellow_cards / red_cards für die Saison. Neu auf oberster Ebene: coaches listet den Trainerstab des Teams auf.

GET /team_standings

Gibt die aktuelle Tabellenposition einer Mannschaft zurück.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Ihr API-Schlüssel
team_id	string	Ja	Team-ID aus den Spieldaten
lang	string	Nein	Antwortsprache: `en` `tr` `de` `ru`

Beispielanfrage

GET https://live-football-api.com/api/v1/team_standings?api_key=YOUR_KEY&team_id=lfa-man-city&lang=en

Antwort

{
  "success": true,
  "credits_remaining": 4989,
  "data": {
    "team_id": "lfa-man-city",
    "season": "2024/2025",
    "available_seasons": ["2024/2025", "2023/2024"],
    "timezone": "UTC",
    "standings": [
      {
        "league": "Premier League",
        "table": [
          {
            "rank": 2,
            "team": { "id": "lfa-man-city", "name": "Manchester City", "logo": "https://live-football-api.com/teams/lfa-man-city.png" },
            "played": 38, "won": 24, "drawn": 7, "lost": 7,
            "goals_for": 78, "goals_against": 52, "goal_diff": 26, "points": 79,
            "form": "WDWWW",
            "zone": { "name": "Champions League", "color": "#02206B" }
          }
        ]
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

GET /team_search

Sucht Teams nach Namen. Gibt passende Teams mit ihren IDs und Logos zurück.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Ihr API-Schlüssel
q	string	Ja	Suchbegriff (Team- oder Spielername)
lang	string	Nein	Antwortsprache: `en` `tr` `de` `ru`

Beispielanfrage

GET https://live-football-api.com/api/v1/team_search?api_key=YOUR_KEY&q=galatasaray

Antwort

{
  "success": true,
  "credits_remaining": 4990,
  "data": {
    "keywords": "galatasaray",
    "total": 3,
    "teams": [
      {
        "id": "lfa-galatasaray",
        "name": "Galatasaray",
        "logo": "https://live-football-api.com/teams/lfa-galatasaray.png",
        "country": "Turkey"
      },
      {
        "id": "lfa-galatasaray-u19",
        "name": "Galatasaray U19",
        "logo": "https://live-football-api.com/teams/lfa-galatasaray-u19.png",
        "country": "Turkey"
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

Jedes Ergebnis enthält jetzt auch country (Nationalität des Teams/Spielers). Diese Suche gibt bei berühmten einwortigen Nachnamen ("messi", "ronaldo", "kane") auch keinen 500-Fehler mehr zurück wie beim vorherigen Anbieter.

GET /player

Gibt das Profil eines Spielers (Biografie, Position, Marktwert) sowie die vollständige Vereins- und Nationalmannschaftskarriere zurück.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Ihr API-Schlüssel
player_id	string	Ja	Spieler-ID, wie von `/player_search` zurückgegeben
lang	string	Nein	Antwortsprache: `en` `tr` `de` `ru`

Beispielanfrage

GET https://live-football-api.com/api/v1/player?api_key=YOUR_KEY&player_id=lfa-haaland&lang=en

Antwort

{
  "success": true,
  "credits_remaining": 4988,
  "data": {
    "player_id": "lfa-haaland",
    "name": "E. Haaland",
    "first_name": "Erling",
    "last_name": "Haaland",
    "photo": "https://live-football-api.com/people/lfa-haaland.png",
    "position": "Forward",
    "nationality": "Norway",
    "birthdate": "2000-07-21",
    "height": "195 cm",
    "weight": "88 kg",
    "foot": "Left",
    "shirt_number": 9,
    "market_value": "180.000.000€",
    "current_team": { "id": "lfa-man-city", "name": "Manchester City", "logo": "https://live-football-api.com/teams/lfa-man-city.png" },
    "clubs_career": [
      {
        "team": { "id": "lfa-man-city", "name": "Manchester City", "logo": "https://live-football-api.com/teams/lfa-man-city.png" },
        "date_start": "2022-07-01",
        "is_loaned": false,
        "seasons": [
          {
            "name": "2024/2025",
            "competitions": [
              { "league": { "id": "lfa-premier-league", "name": "Premier League" }, "appearances": 34, "goals": 27, "assists": 5, "yellow_cards": 2, "red_cards": 0 }
            ]
          }
        ]
      }
    ],
    "internationals_career": [
      {
        "team": { "id": "lfa-norway", "name": "Norway", "logo": "https://live-football-api.com/teams/lfa-norway.png" },
        "date_start": "2019-09-05",
        "is_loaned": false,
        "seasons": []
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

GET /player_matches

Gibt das Spiel-für-Spiel-Protokoll eines Spielers (Tore, Vorlagen, Karten, Einsätze) für ein Team und eine Saison zurück.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Ihr API-Schlüssel
player_id	string	Ja	Spieler-ID, wie von `/player_search` zurückgegeben
team_id	string	Nein	Team-ID, für das der Spieler spielte, wie in `current_team.id` / `clubs_career[].team.id` von `/player`. Standard: aktuelles Team.
season	string	Nein	Saisonbezeichnung (z. B. "2024/2025"), wie in `clubs_career[].seasons[].name` von `/player`. Standard: aktuellste Saison mit tatsächlichen Einsätzen für dieses Team.
lang	string	Nein	Antwortsprache: `en` `tr` `de` `ru`

Beispielanfrage

GET https://live-football-api.com/api/v1/player_matches?api_key=YOUR_KEY&player_id=lfa-haaland&lang=en

Antwort

{
  "success": true,
  "credits_remaining": 4987,
  "data": {
    "player_id": "lfa-haaland",
    "team_id": "lfa-man-city",
    "team_name": "Manchester City",
    "season": "2024/2025",
    "competitions": [
      {
        "league": { "id": "lfa-premier-league", "name": "Premier League" },
        "matches": [
          {
            "id": "lfa4phmwb3bhclg7aqht1ajcwk",
            "date": "2025-08-17 14:00:00",
            "is_home": true,
            "opponent": { "id": "lfa-chelsea", "name": "Chelsea", "logo": "https://live-football-api.com/teams/lfa-chelsea.png" },
            "score": "2-0",
            "goals": 1,
            "assists": 0,
            "yellow_card": false,
            "second_yellow_card": false,
            "red_card": false,
            "started": true
          }
        ]
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

Wenn team_id/season weggelassen werden, wählt der Endpunkt automatisch das aktuellste Team+Saison, in dem der Spieler tatsächlich zum Einsatz kam (überspringt Saisons mit null Einsätzen, z. B. direkt nach einem Transfer).

GET /player_search

Sucht Spieler nach Namen. Gibt passende Spieler mit ihren IDs und Fotos zurück.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Ihr API-Schlüssel
q	string	Ja	Suchbegriff (Team- oder Spielername)
lang	string	Nein	Antwortsprache: `en` `tr` `de` `ru`

Beispielanfrage

GET https://live-football-api.com/api/v1/player_search?api_key=YOUR_KEY&q=mbappe

Antwort

{
  "success": true,
  "credits_remaining": 4989,
  "data": {
    "keywords": "mbappe",
    "total": 2,
    "players": [
      {
        "id": "lfa-k-mbappe",
        "name": "K. Mbappe",
        "photo": "https://live-football-api.com/people/lfa-k-mbappe.png",
        "country": "France"
      },
      {
        "id": "lfa-e-mbappe",
        "name": "E. Mbappe",
        "photo": "https://live-football-api.com/people/lfa-e-mbappe.png",
        "country": "France"
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

POST /webhook/register

Registrieren Sie eine URL für Echtzeit-Benachrichtigungen, wenn in einem Live-Spiel ein Tor fällt. Registrierung ist kostenlos. Jede zugestellte Tor-Benachrichtigung kostet 1 Credit.

Webhooks werden per HTTP POST zugestellt. Ihr Endpunkt muss innerhalb von 10 Sekunden mit 2xx antworten, sonst wird bis zu 3-mal wiederholt.

⚠️ Wichtiger Sicherheitshinweis Webhook-Benachrichtigungen werden von unserem System über die IP-Adresse 45.94.4.69 gesendet. Für zusätzliche Sicherheit können Sie eingehende Anfragen an Ihren Webhook-Endpunkt auf Ihrem Server (auf Firewall-Ebene) so einschränken, dass nur diese IP-Adresse zugelassen wird.

Parameter (POST-Body)

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Ihr API-Schlüssel
webhook_url	string	Ja	Ihre Callback-URL (HTTPS erforderlich)
label	string	Nein	Optionale Bezeichnung für diesen Webhook

Beispielanfrage

POST https://live-football-api.com/api/v1/webhook/register?api_key=YOUR_KEY
Content-Type: application/json

{
  "webhook_url": "https://yourapp.com/webhooks/football",
  "label": "my server"
}

Antwort

{
  "success": true,
  "data": {
    "id": 1,
    "webhook_url": "https://yourapp.com/webhooks/football",
    "label": "my server",
    "is_active": true,
    "message": "Webhook registered. You will be charged 1 credit per goal notification."
  }
}

GET /webhook/register

Gibt alle registrierten Webhook-Abonnements zurück. Kostenlos.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Ihr API-Schlüssel

Beispielanfrage

GET https://live-football-api.com/api/v1/webhook/register?api_key=YOUR_KEY

Antwort

{
  "success": true,
  "data": {
    "webhooks": [
      {
        "id": 1,
        "webhook_url": "https://yourapp.com/webhooks/football",
        "label": "my server",
        "is_active": true,
        "created_at": "2026-07-04 12:00:00"
      }
    ],
    "total": 1
  }
}

DELETE /webhook/register

Löscht ein Webhook-Abonnement dauerhaft. Kostenlos.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Ihr API-Schlüssel
id	integer	Ja	Webhook-ID zum Löschen (aus der Liste)

Beispielanfrage

DELETE https://live-football-api.com/api/v1/webhook/register?api_key=YOUR_KEY&id=1

Antwort

{
  "success": true,
  "data": {
    "message": "Webhook deleted successfully."
  }
}

Payload-Beispiele

Ihre URL erhält bei jedem Tor eine POST-Anfrage mit JSON-Body — das ist der einzige gesendete Ereignistyp.

Goal Event

{
  "event": "goal",
  "match_id": "lfa4phmwb3bhclg7aqht1ajcwk",
  "timestamp": "2026-07-03T14:46:00Z",
  "data": {
    "minute": 46,
    "team": "home",
    "player": "Erling Haaland",
    "assist": "Kevin De Bruyne",
    "score": { "home": 3, "away": 1 }
  }
}

Tore sind derzeit der einzige Ereignistyp, den diese API sendet — es gibt kein card-, kickoff- oder fulltime-Ereignis und keinen konfigurierbaren event_types-Parameter (die Registrierung nimmt nur webhook_url und optional label entgegen).