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

PHP SDK: PHP mi kullanıyorsunuz? Resmi client kütüphanesini Composer ile kurun:

composer require forcescripts/live-football-api-php

Paketi Packagist'te görüntüleyin →

Node.js SDK: Node.js mi kullanıyorsunuz? Resmi client kütüphanesini npm ile kurun:

npm install live-football-api

Paketi npm'de görüntüleyin →

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 500 ü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 /referee	çağrı başına 1 kredi
GET /leagues	ç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	Geçersiz parametre (örn. hatalı tarih formatı)
401	Eksik veya geçersiz `api_key`
403	Erişim reddedildi — yetersiz kredi, günlük limit aşıldı veya hesap aktif değil
429	Hız limiti aşıldı — kredi sorunu değildir. Planınızın saniyedeki istek limitinden (req/s) daha hızlı istek gönderiyorsunuz (limitinizi görmek için planlar sayfasına bakın). Yanıttaki `Retry-After` başlığında belirtilen saniye kadar bekleyip tekrar deneyin.
500	Veritabanı hatası
503	Kaynak veri servisi erişilemez

{
  "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"
        },
        "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 — 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. week — Maçın oynandığı hafta/tur adı (ör. "3" veya "Çeyrek Final"); bilinmiyorsa 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",
    "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 her zaman küçük harf snake_case formatındadır — goal, own_goal, yellow_card, red_card, substitution değerlerinden biri. Bir asist kaydedildiyse golün detail alanında assist objesi de bulunur (yoksa hiç dönmez).

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. Ana hakem için ayrıca avg_yellow_cards ve avg_red_cards (maç başına ortalama gösterdiği sarı/kırmızı kart sayısı) alanları gelir; yardımcı hakem, dördüncü hakem ve VAR için bu alanlar null 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", "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

Bir hakemin profilini ve kariyer kart istatistiklerini döner — toplam ve maç başına ortalama sarı/kırmızı kart, faul ve verdiği penaltı sayısı, ayrıca her iki takıma gösterdiği kartları içeren maç maç geçmişi.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
referee_id	string	Evet	Hakem ID'si — /officials cevabındaki `id` alanından alınır
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

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

Yanıt

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

Ü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",   "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

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

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. live_standings, standings alanının hemen altında durur ve satır yapısı aynıdır. Maç oynanırken skor, canlı puana, sıraya ve gol sayılarına işlenmiş olur. Canlı maç yoksa live_standings boş listedir. Geçmiş sezonlarda gelmez. 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",
  "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"
    }
  }
}

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

Sitene tek satır kodla canlı maç listesi, tek maç skorbordu, lig puan durumu, takım kadrosu veya oyuncu profili göster — kredi ve limitler senin API anahtarın üzerinden işler, hiç kodlama gerekmez. Widget'ları panelden oluşturursun.

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

data-token değeri kalıcı widget token'ı DEĞİL, aşağıdaki /widget/session uç noktasından aldığın, saatlik geçerli bir session token'dır.

Widget oluşturmak, hangi özelliklerin (olaylar, kadro, H2H, puan durumu vb.) açık olacağını seçmek ve izinli domain(ler)i ayarlamak için: Panel → Widget'lar →

Aynı widget, script etiketine eklediğin data-type/data-id ile farklı şekillerde gömülebilir:

Parametre	Açıklama
(hiçbiri)	Günün maç listesi — canlı/gelecek/bitti filtresi ve tarih seçiciyle.
data-type="match" data-id="MATCH_ID"	Tek bir maçın skorbordu + olaylar/kadro/H2H/canlı saha sekmeleri.
data-type="league" data-id="LEAGUE_ID"	Lig puan durumu ve fikstürü.
data-type="team" data-id="TEAM_ID"	Takım kadrosu, maç geçmişi, puan durumu.
data-type="player" data-id="PLAYER_ID"	Oyuncu profili.

Aynı <script> etiketinde kullanabileceğin isteğe bağlı özellikler:

Parametre	Açıklama
data-lang="tr\|en\|de\|ru"	Ziyaretçinin tarayıcı diline bakmaksızın belirli bir dilde gösterir.
data-max-width="480px\|100%\|900px"	Widget varsayılan olarak 480px genişliğinde bir kart. Daha geniş bir kutuyu doldurmak için "100%" (veya herhangi bir CSS genişlik değeri) ver.
data-height="480px\|80vh\|none"	Maç listesinin kaydırılabilir alanı varsayılan olarak 480px ile sınırlı. Daha uzun veya tam ekran bir gömme için "none" ya da daha büyük bir değer (örn. "90vh") ver.

Boyutlandırma tamamen bu iki özellik ve widget'ı koyduğun kutunun boyutuyla kontrol edilir — özel bir CSS yazmana gerek yok.

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

Bir widget'ın veri çekebilmesi için önce, gerçek API anahtarınla değiştirdiğin, 1 saat geçerli imzalı bir session token alman gerekir. Kalıcı widget token'ı (panelde görünen) tek başına veri çekemez — sadece bu uç noktayla token değişimi yapmak için kullanılır.

Bu uç noktayı SADECE kendi sunucundan çağır — api_key gerçek, gizli anahtarındır ve asla tarayıcıya/istemci koduna gönderilmemelidir.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	Bu widget'ın bağlı olduğu API anahtarınız (gizli — sadece sunucu tarafında kullanın)
token	string	Evet	Panelde gördüğünüz kalıcı widget token'ı

Örnek istek

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

Yanıt

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

Otomatik yenileme

Token 1 saat sonra süresi doluyor. Statik bir sayfan varsa, sunucunda ~30 dakikada bir çalışan bir cron/zamanlanmış görevle yeni bir session token alıp sayfandaki data-token değerini güncelle. Dinamik bir sayfan varsa (her istekte sunucu tarafından render ediliyorsa), token'ı sayfa render edilirken taze alabilirsin.

#!/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

Bunu neden yapıyoruz: data-token her zaman sayfa kaynağında/network sekmesinde görünür olacaktır — bu, herhangi bir istemci tarafı kimlik bilgisinin doğası gereği böyledir. Süresi dolan bir token, biri onu kopyalayıp kendi başına kullansa bile bir saat içinde kendiliğinden geçersiz olur; kimsenin fark edip aksiyon almasına gerek kalmaz.