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

PHP SDK: Nutzen Sie PHP? Installieren Sie die offizielle Client-Bibliothek mit Composer:

composer require forcescripts/live-football-api-php

Paket auf Packagist ansehen →

Node.js SDK: Nutzen Sie Node.js? Installieren Sie die offizielle Client-Bibliothek mit npm:

npm install live-football-api

Paket auf npm ansehen →

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 500 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 /referee	1 Credit pro Aufruf
GET /leagues	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	Ungültiger Parameter (z.B. falsches Datumsformat)
401	Fehlender oder ungültiger `api_key`
403	Zugriff verweigert — unzureichendes Guthaben, Tageslimit überschritten oder inaktives Konto
429	Rate-Limit überschritten — kein Guthaben-Problem. Sie senden Anfragen schneller als das Requests/Sekunde-Limit Ihres Plans erlaubt (Ihr Limit finden Sie auf der Preise-Seite). Warten Sie die im `Retry-After`-Header angegebene Anzahl Sekunden und versuchen Sie es erneut.
500	Datenbankfehler
503	Upstream-Datenquelle nicht verfügbar

{
  "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"
        },
        "week": "3",
        "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. week — Name des Spieltags/der Runde (z. B. "3" oder "Viertelfinale"); null, wenn unbekannt.

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",
    "match_date": "2026-07-03T14:00:00Z",
    "last_updated": "2026-07-03 14:22:01 UTC",
    "stale": false,
    "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", "extra_time": null }
    },
    "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",
          "assist": { "name": "De Bruyne", "id": "lfa-de-bruyne", "image": "https://live-football-api.com/people/lfa-de-bruyne.png" }
        }
      },
      {
        "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"
}

events[].type ist immer lowercase snake_case — einer von goal, own_goal, yellow_card, red_card, substitution. Das detail-Objekt eines Tors enthält ein assist-Objekt, wenn eine Vorlage erfasst wurde (sonst fehlt es).

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. Der Hauptschiedsrichter enthält zusätzlich avg_yellow_cards und avg_red_cards (durchschnittliche Karten pro Spiel); bei Assistenten, dem vierten Offiziellen und VAR ist dies null.

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", "avg_yellow_cards": 5.05, "avg_red_cards": 0.26 },
      { "id": "6c998fdc-ca49-69c3-2488-347671830e3a", "name": "Stuart Burt",    "role": "Lineman 1", "avg_yellow_cards": null, "avg_red_cards": null },
      { "id": "6a528c78-5157-c275-9d86-ca7ed7ff21ac", "name": "Simon Long",     "role": "Lineman 2", "avg_yellow_cards": null, "avg_red_cards": null },
      { "id": "e6e57850-918d-c5ef-9bc0-e8b43c2b8e88", "name": "Anthony Taylor","role": "Fourth official", "avg_yellow_cards": null, "avg_red_cards": null },
      { "id": "4748a374-2d55-ae66-642e-8e9e05fb566c", "name": "Graham Scott",  "role": "VAR", "avg_yellow_cards": null, "avg_red_cards": null }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

GET /referee

Gibt das Profil und die Karriere-Kartenstatistik eines Schiedsrichters zurück — Gesamt- und Durchschnittswerte pro Spiel für gelbe/rote Karten, Fouls und verhängte Elfmeter, sowie eine Spiel-für-Spiel-Historie mit den je Mannschaft gezeigten Karten.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Ihr API-Schlüssel
referee_id	string	Ja	Schiedsrichter-ID — aus dem `id`-Feld einer /officials-Antwort
lang	string	Nein	Antwortsprache: `en` `tr` `de` `ru`

Beispielanfrage

GET https://live-football-api.com/api/v1/referee?api_key=YOUR_KEY&referee_id=318b2878-3b27-6877-7197-955dbe48cbd5

Antwort

{
  "success": true,
  "credits_remaining": 4993,
  "data": {
    "referee_id": "318b2878-3b27-6877-7197-955dbe48cbd5",
    "name": "Fernando Alexis Portillo Botello",
    "nationality": "Mexico",
    "birthdate": "1997-08-07",
    "career": {
      "matches_in_history": 5,
      "total_yellow_cards": 22,
      "total_red_cards": 4,
      "total_fouls": 19,
      "total_penalties_awarded": 1,
      "avg_yellow_cards_per_match": 4.4,
      "avg_red_cards_per_match": 0.8
    },
    "recent_matches": [
      {
        "match_id": "cnkinja3gq8ukagjx5vuxj4es",
        "date": "2026-09-22 00:00:00",
        "area": "Mexico",
        "competition": "Liga MX Femenil",
        "season": "2026/2027",
        "round": "Apertura",
        "score": { "home": 2, "away": 7 },
        "home_team": { "yellow_cards": 1, "red_cards": 1, "fouls": 0, "penalties": 0 },
        "away_team": { "yellow_cards": 2, "red_cards": 1, "fouls": 0, "penalties": 0 }
      }
    ]
  },
  "timestamp": "2026-09-22 15:36:47"
}

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",   "logo": "https://live-football-api.com/leagues/lfa-premier-league.png" },
          { "id": "lfa-championship",      "name": "Championship",     "logo": "https://live-football-api.com/leagues/lfa-championship.png" },
          { "id": "lfa-league-one",        "name": "League One",       "logo": "https://live-football-api.com/leagues/lfa-league-one.png" }
        ]
      },
      {
        "country": "Spain",
        "leagues": [
          { "id": "lfa-la-liga",   "name": "La Liga",           "logo": "https://live-football-api.com/leagues/lfa-la-liga.png" },
          { "id": "lfa-segunda",   "name": "Segunda División",  "logo": "https://live-football-api.com/leagues/lfa-segunda.png" }
        ]
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

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",
    "stale": false,
    "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" }
          }
        ]
      }
    ],
    "live_standings": [
      {
        "title": "Premier League",
        "table": [
          {
            "rank": "1",
            "team": {
              "id": "lfa-liverpool",
              "name": "Liverpool",
              "logo": "https://live-football-api.com/teams/lfa-liverpool.png"
            },
            "played": "29", "won": "21", "drawn": "6", "lost": "2",
            "goals_for": "68", "goals_against": "28",
            "goal_diff": "40", "points": "69",
            "form": "WWWDW",
            "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. live_standings steht direkt unter standings und hat dieselbe Form. Während ein Spiel läuft, sind Tor, Punkte und Platz bereits in der Live-Tabelle enthalten. Ohne laufendes Spiel ist live_standings eine leere Liste. Vergangene Saisons enthalten es nicht. 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",
  "timestamp": "2026-09-19T20:29:33+00:00",
  "match": {
    "id": "ni54yus2t3t1kjf1vu2efjf8",
    "minute": "66",
    "home": {
      "id": "1q0ukadexm6xinnytfac9eglg",
      "name": "Atletico Rafaela",
      "score": "3",
      "logo": "https://live-football-api.com/teams/1q0ukadexm6xinnytfac9eglg.png"
    },
    "away": {
      "id": "39yl9nw2nhhulyjssa497c758",
      "name": "Tucuman",
      "score": "2",
      "logo": "https://live-football-api.com/teams/39yl9nw2nhhulyjssa497c758.png"
    }
  },
  "goal": {
    "minute": "66",
    "side": "home",
    "score": "3-2",
    "player": {
      "id": "7qdipko1ne61sibspp3qc4kid",
      "name": "L. Albertengo",
      "image": "https://live-football-api.com/people/7qdipko1ne61sibspp3qc4kid.png"
    },
    "assist": {
      "id": "aud0up6cwbrlwpnzibxvxy31l",
      "name": "A. Obando",
      "image": "https://live-football-api.com/people/aud0up6cwbrlwpnzibxvxy31l.png"
    }
  }
}

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).

Zeige eine Liste der Live-Spiele, ein Spielergebnis, eine Ligatabelle, einen Mannschaftskader oder ein Spielerprofil auf deiner Seite mit einer Codezeile — Credits und Limits laufen über deinen eigenen API-Schlüssel, keine Programmierung nötig. Widgets erstellst du im Dashboard.

<script src="https://live-football-api.com/widget/widget.js"
        data-token="SESSION_TOKEN" async></script>

Der Wert von data-token ist NICHT das permanente Widget-Token — es ist ein stündlich ablaufendes Session-Token, das über den unten stehenden /widget/session-Endpunkt bezogen wird.

Um ein Widget zu erstellen, welche Funktionen (Ereignisse, Aufstellung, H2H, Tabelle usw.) aktiviert sind und erlaubte Domain(s) festzulegen: Dashboard → Widgets →

Dasselbe Widget kann über die Attribute data-type/data-id am Script-Tag in verschiedenen Formen eingebettet werden:

Parameter	Beschreibung
(keins)	Heutige Spieleliste — mit Live/Bevorstehend/Beendet-Filter und Datumsauswahl.
data-type="match" data-id="MATCH_ID"	Ein einzelnes Spielergebnis + Ereignisse/Aufstellung/H2H/Spielfeld-Tabs.
data-type="league" data-id="LEAGUE_ID"	Liga-Tabelle und Spielplan.
data-type="team" data-id="TEAM_ID"	Mannschaftskader, Spielhistorie, Tabelle.
data-type="player" data-id="PLAYER_ID"	Spielerprofil.

Optionale Attribute im selben <script>-Tag:

Parameter	Beschreibung
data-lang="tr\|en\|de\|ru"	Erzwingt eine bestimmte Anzeigesprache, unabhängig von der Browsersprache des Besuchers.
data-max-width="480px\|100%\|900px"	Das Widget ist standardmäßig 480px breit. Setze "100%" (oder einen beliebigen CSS-Breitenwert), um einen breiteren Container zu füllen.
data-height="480px\|80vh\|none"	Begrenzt die scrollbare Spielliste standardmäßig auf 480px. Setze "none" oder einen größeren Wert (z. B. "90vh") für eine höhere oder Vollbild-Einbindung.

Die Größe wird ausschließlich über diese beiden Attribute und die Größe des Containers gesteuert, in den du das Widget einfügst — kein eigenes CSS nötig.

<script src="https://live-football-api.com/widget/widget.js"
        data-token="SESSION_TOKEN"
        data-max-width="100%"
        data-height="90vh" async></script>

Bevor ein Widget Daten abrufen kann, benötigst du ein signiertes, 1 Stunde gültiges Session-Token, das mit deinem echten API-Schlüssel eingetauscht wird. Das permanente Widget-Token (im Dashboard angezeigt) kann selbst keine Daten abrufen — es dient nur dem Umtausch über diesen Endpunkt.

Rufe diesen Endpunkt NUR von deinem eigenen Server aus auf — api_key ist dein echter, geheimer Schlüssel und darf niemals an einen Browser oder Client-Code gesendet werden.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	Ja	Der API-Schlüssel, zu dem dieses Widget gehört (geheim — nur serverseitig)
token	string	Ja	Das im Dashboard angezeigte permanente Widget-Token

Beispielanfrage

curl "https://live-football-api.com/widget/session.php?api_key=YOUR_KEY&token=YOUR_WIDGET_TOKEN"

Antwort

{
  "success": true,
  "data": {
    "session_token": "eyJ3aWQiOjExLCJleHAiOjE3ODkxNjM4MTR9.0lRDtD...",
    "expires_at": "2026-09-12T21:56:54+00:00",
    "expires_in": 3600
  }
}

Automatische Aktualisierung

Das Token läuft nach 1 Stunde ab. Führe bei einer statischen Seite auf deinem Server etwa alle 30 Minuten einen Cron-/geplanten Job aus, der ein neues Session-Token abruft und den data-token-Wert auf deiner Seite aktualisiert. Bei einer dynamischen Seite (bei jeder Anfrage serverseitig gerendert) holst du das Token stattdessen frisch beim Rendern.

#!/bin/bash
# Cron entry — every 30 minutes, well inside the 1-hour expiry:
# */30 * * * * /path/to/refresh_widget_session.sh

SESSION=$(curl -s "https://live-football-api.com/widget/session.php?api_key=YOUR_KEY&token=YOUR_WIDGET_TOKEN" | jq -r '.data.session_token')
sed -i "s/data-token=\"[^\"]*\"/data-token=\"$SESSION\"/" /var/www/yoursite/page-with-widget.html

Warum wir das so machen: data-token ist immer im Seitenquelltext / Netzwerk-Tab sichtbar — das liegt in der Natur jeder clientseitigen Anmeldeinformation. Ein ablaufendes Token, einmal kopiert und anderswo wiederverwendet, funktioniert innerhalb einer Stunde von selbst nicht mehr — niemand muss es bemerken oder handeln, damit sich das Risiko schließt.