futbol API Belgeleri

Basit REST API. API anahtarınızı sorgu parametresi olarak gönderin — başlık gerekmez.

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

Kimlik Doğrulama

Her istek URL'ine api_key ekleyin. Ücretsiz hesap oluşturarak anahtar alabilirsiniz.

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

API anahtarınızı herkese açık istemci kodunda veya açık repolarda paylaşmayın.

Krediler

Her API çağrısı kredinizden düşer. Krediler hiç sona ermez. Yeni hesaplara 100 ücretsiz kredi verilir.

Endpoint	Maliyet
GET /matches	çağrı başına 1 kredi
GET /live_match_details	çağrı başına 1 kredi
GET /lineups	çağrı başına 1 kredi
GET /h2h	çağrı başına 1 kredi
GET /injuries	çağrı başına 1 kredi
GET /officials	çağrı başına 1 kredi
GET /leagues	çağrı başına 1 kredi
GET /league	çağrı başına 1 kredi
GET /league_standings	çağrı başına 1 kredi
GET /league_fixtures	çağrı başına 1 kredi
GET /team_matches	çağrı başına 1 kredi
GET /team_squad	çağrı başına 1 kredi
GET /team_standings	çağrı başına 1 kredi
GET /player	çağrı başına 1 kredi
GET /player_matches	çağrı başına 1 kredi
GET /team_search	çağrı başına 1 kredi
GET /player_search	çağrı başına 1 kredi
POST /webhook/register	Ücretsiz
GET /webhook/register	Ücretsiz
DELETE /webhook/register	Ücretsiz

Hatalar

Tüm hatalar code ve message içeren JSON döner:

Kod	Anlam
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

Belirtilen tarihteki futbol maçlarını döner. Takım ve lig adlarını isteğe bağlı çevirebilirsiniz.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
date	string	Hayır	`YYYY-MM-DD` formatında maç tarihi
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

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

Yanıt

{
  "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 — Maç TV yayınına açıksa true döner (henüz kanal ismi yok). penalty — Penaltı atışları skoru; maç penaltılara gitmediyse null döner.

GET /live_match_details

Gerçek zamanlı maç verisi döner: olay zaman çizelgesi (goller, kartlar, değişiklikler) ve maç istatistikleri (topla oynama, şutlar, kornerler vb.).

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
match_id	string	Evet	`/matches` yanıtındaki maç kimliği
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

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

Yanıt

{
  "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 (gerçek kanal isimleri) ve player_of_the_match yeni eklendi. Uygun olduğunda olaylarda (events) detail içinde is_penalty / is_second_yellow bayrakları da bulunabilir.

csb_url — Canlı maç CSB görselleştirmesi için kullanıma hazır iframe URL'si. Doğrudan yerleştirin: <iframe src="csb_url" width="636" height="400" frameborder="0"></iframe>
Maçın aktif CSB beslemesi yoksa (örn. maç öncesi veya desteklenmeyen lig) null döner.

GET /csb

Canlı maç Centre Stage Board (CSB) görselleştirmesini HTML sayfa olarak döner — <iframe> içine yerleştirmek için tasarlanmıştır. /live_match_details yanıtındaki csb_url alanı zaten hazır token içeren URL'yi sağlar; çoğu durumda bu endpoint'i manuel çağırmanıza gerek yoktur.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
token	string	Evet	JWT görselleştirme tokenı (live_match_details yanıtındaki `csb_url` içinde hazır olarak gelir).
matchid	string	Evet	`lfa` formatında maç ID'si (`/matches` yanıtındaki `id` alanıyla aynı).
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

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

CSB tokenı süreli geçerliliğe sahiptir (genellikle 4 saat). Geçerli token almak için her zaman taze bir /live_match_details çağrısından gelen csb_url'yi kullanın. Token'ları önbelleğe almayın veya sabit kodlamayın.

GET /lineups

Her iki takımın ilk 11'i, yedekleri ve teknik direktörünü döner. Maçtan yaklaşık 1 saat önce yayınlanır.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
match_id	string	Evet	`/matches` yanıtındaki maç kimliği
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

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

Yanıt

{
  "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"
}

Her oyuncuda artık number, position ve rating alanları da var. Üst seviyede formation ve is_projected (true = maç başlamadan önceki tahmini kadro) yeni eklendi.

GET /h2h

Belirtilen maçtaki iki takım arasındaki karşılıklı maç geçmişini döner.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
match_id	string	Evet	`/matches` yanıtındaki maç kimliği
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

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

Yanıt

{
  "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 yeni eklendi — maç maç listelerin yanında iki takımın toplam galibiyet/beraberlik sayıları.

GET /injuries

Maç öncesinde her iki takımın sakatları ve cezalılarını döner.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
match_id	string	Evet	`/matches` yanıtındaki maç kimliği
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

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

Yanıt

{
  "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"
}

Her oyuncuda artık mevcutsa bu sezonki maç/gol/asist/kart istatistiklerini içeren stats alanı da var, yoksa null döner.

GET /officials

Bir maça atanan hakem ve yardımcı hakemleri döner.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
match_id	string	Evet	`/matches` yanıtındaki maç kimliği
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

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

Yanıt

{
  "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

Ülkeye göre gruplandırılmış, alfabetik sıralanmış tüm ligleri döner.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

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

Yanıt

{
  "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

Bir ligin sezon, takımlar ve logo dahil detaylı bilgisini döner.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
league_id	string	Evet	`/leagues` yanıtındaki lig kimliği
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

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

GET /league_standings

Bir ligin güncel puan tablosunu döner. Çok gruplu müsabakaları destekler.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
league_id	string	Evet	`/leagues` yanıtındaki lig kimliği
season	string	Hayır	Sezon kimliği, örn. `2025` veya `2025-2026`. Mevcut sezon için boş bırakın.
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

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

Yanıt

{
  "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"
}

Her satırda artık form (son 5 maç sonucu, örn. "WWDWL") ve zone (varsa Avrupa kupası/küme düşme bölgesi) alanları da var. Yeni üst seviye home_standings / away_standings, aynı tabloyu sadece iç saha ve sadece deplasman sonuçlarına göre veriyor. Not: sayısal alanlar (rank, played, points vb.) artık string değil JSON sayı olarak dönüyor.

GET /league_fixtures

Bir ligin tüm fikstürünü hafta hafta döner; oynanan maçlar için skor, gelecek maçlar için başlama saati içerir.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
league_id	string	Evet	`/leagues` yanıtındaki lig kimliği
season	string	Hayır	Sezon kimliği, örn. `2025` veya `2025-2026`. Mevcut sezon için boş bırakın.
week	string	Hayır	Tek bir hafta/tur adına göre filtreler, örn. `1`. Boş bırakılırsa tüm haftalar döner.
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

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

Yanıt

{
  "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

Bir takımın sezon fikstürünü ve sonuçlarını döner — geçmiş ve yaklaşan maçlar.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
team_id	string	Evet	Maç verisindeki takım kimliği
season	string	Hayır	Sezon kimliği, örn. `2025` veya `2025-2026`. Mevcut sezon için boş bırakın.
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

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

Yanıt

{
  "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

Bir takımın oyuncu pozisyonları ve sırt numaraları ile tam kadrosunu döner.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
team_id	string	Evet	Maç verisindeki takım kimliği
season	string	Hayır	Sezon kimliği, örn. `2025` veya `2025-2026`. Mevcut sezon için boş bırakın.
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

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

Yanıt

{
  "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"
}

Her oyuncuda artık sezona ait yellow_cards / red_cards alanları da var. Yeni üst seviye coaches, takımın teknik ekibini listeliyor.

GET /team_standings

Bir takımın mevcut sezondaki lig(ler)deki pozisyonunu döner.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
team_id	string	Evet	Maç verisindeki takım kimliği
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

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

Yanıt

{
  "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

İsme göre takım arar. Eşleşen takımları ID ve logolarıyla birlikte döner.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
q	string	Evet	Arama kelimesi (takım veya oyuncu adı)
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

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

Yanıt

{
  "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"
}

Her sonuçta artık country (takımın/oyuncunun ülkesi) alanı da var. Bu arama artık önceki sağlayıcıda olduğu gibi ünlü tek kelimelik soyadlarında ("messi", "ronaldo", "kane") 500 hatası vermiyor.

GET /player

Bir oyuncunun profilini (biyografi, mevki, piyasa değeri) ve tüm kulüp/milli takım kariyeri geçmişini döner.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
player_id	string	Evet	`/player_search` yanıtındaki oyuncu kimliği
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

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

Yanıt

{
  "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

Bir oyuncunun tek bir takım ve sezon için maç maç kaydını (gol, asist, kart, ilk 11) döner.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
player_id	string	Evet	`/player_search` yanıtındaki oyuncu kimliği
team_id	string	Hayır	Oyuncunun forma giydiği takım kimliği; `/player` yanıtındaki `current_team.id` / `clubs_career[].team.id`. Verilmezse güncel takım kullanılır.
season	string	Hayır	Sezon etiketi (örn. "2024/2025"); `/player` yanıtındaki `clubs_career[].seasons[].name`. Verilmezse o takımda gerçekten maç oynadığı en güncel sezon kullanılır.
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

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

Yanıt

{
  "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"
}

team_id/season verilmezse, endpoint otomatik olarak oyuncunun gerçekten maça çıktığı en güncel takım+sezonu seçer (transfer sonrası 0 maçlık sezonları atlayarak).

GET /player_search

İsme göre oyuncu arar. Eşleşen oyuncuları ID ve fotoğraflarıyla birlikte döner.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
q	string	Evet	Arama kelimesi (takım veya oyuncu adı)
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

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

Yanıt

{
  "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

Canlı bir maçta gol atıldığında gerçek zamanlı bildirim almak için URL kaydedin. Kayıt ücretsiz. İletilen her gol bildirimi 1 kredi harcar.

Webhooklar HTTP POST ile iletilir. Uç noktanız 10 saniye içinde 2xx yanıtı döndürmelidir; aksi hâlde 3 kez yeniden denenir.

⚠️ Önemli Güvenlik Uyarısı Webhook bildirimleri sistemimizden 45.94.4.69 IP adresi üzerinden gönderilmektedir. Ek güvenlik sağlamak amacıyla sunucunuzda (Firewall tarafında) webhook endpoint'inize gelen istekleri sadece bu IP adresine izin verecek şekilde kısıtlayabilirsiniz.

Parametreler (POST gövdesi)

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
webhook_url	string	Evet	Geri çağrı URL'niz (HTTPS zorunlu)
label	string	Hayır	Bu webhook'u tanımlayan isteğe bağlı etiket

Örnek istek

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"
}

Yanıt

{
  "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

Hesabınıza kayıtlı tüm webhook aboneliklerini döner. Bu çağrı ücretsizdir.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız

Örnek istek

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

Yanıt

{
  "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

Bir webhook aboneliğini kalıcı olarak siler. Bu çağrı ücretsizdir.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
id	integer	Evet	Silinecek webhook kimliği (liste yanıtından)

Örnek istek

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

Yanıt

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

Payload Örnekleri

Kayıtlı URL'niz her gol atıldığında JSON gövdeli bir POST isteği alır — gönderilen tek olay tipi budur.

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 }
  }
}

Şu an gönderilen tek olay tipi gol — card, kickoff veya fulltime gibi bir olay yok, yapılandırılacak bir event_types parametresi de yok (kayıt sadece webhook_url ve isteğe bağlı label alır).