LiveScoreJSON API — Kullanım Kılavuzu

health_public

API veritabanı bağlantısının hayatta olup olmadığını denetlemek için kullanılan hafif ve dışa açık bir sağlık kontrolü (health check) uç noktası. UptimeRobot, Pingdom veya Yük Dengeleyiciler (Load Balancer) için önerilir.

GET /api/health_public.php

Örnek İstek

GET /api/health_public.php

Başarılı Yanıt (200 OK)

{
  "ok": true,
  "status": "healthy",
  "time": "2026-07-24T18:00:00+03:00"
}

Genel Bakış

API, HTTP GET istekleri ile çalışır. Tüm yanıtlar JSON formatındadır ve hiyerarşik yapıda döner.

Base URL

https://livescorejson.com/api/

Protokol

HTTPS GET — Tüm parametreler query string ile gönderilir

Yanıt Formatı

JSON (UTF-8), standart zarf yapısı (meta + data)

Kimlik Doğrulama

Her istekte Authorization: Bearer veya X-API-Key zorunlu

Futbol verileri aşağıdaki hiyerarşik yapıda organize edilmiştir:

Area (Bölge/Ülke)
 └─ Competition (Lig/Kupa)
     └─ Season (Sezon)
         └─ Round (Tur/Hafta)
             └─ Group (Alt Grup — opsiyonel)
                 └─ Match (Maç)
                     ├─ Events (Gol, Kart, Değişiklik...)
                     ├─ Statistics (Top kontrolü, Şut...)
                     └─ Formations (Diziliş)

Maç endpoint'leri bu hiyerarşiyi iç içe JSON olarak döndürür: competition → season → round → match

GET /api/{endpoint}.php?param1=val1&param2=val2
Authorization: Bearer ljson_live_...

Tüm endpoint parametreleri query string ile gönderilir. Kimlik doğrulama Authorization: Bearer veya X-API-Key header'ı ile yapılır.

Query string ile kullanıcı adı/şifre akışı ticari müşteri entegrasyonlarında desteklenmez.

Ticari SaaS entegrasyonları Authorization: Bearer ljson_live_... veya X-API-Key header'ı kullanır.

Kota cevap header'ları: X-Plan-Code, X-RateLimit-Limit-Minute, X-RateLimit-Remaining-Minute, X-RateLimit-Reset, X-Usage-Unit-Cost, X-Usage-Units-Current-Period. Limit aşımında 429 ve Retry-After döner.

Kimlik Doğrulama

Her API isteğinde ticari API key header olarak gönderilmelidir. Query string ile kullanıcı adı/şifre akışı dış müşteri entegrasyonlarında desteklenmez.

Header	Örnek	Açıklama
`Authorization`	`Bearer ljson_live_...`	Önerilen kimlik doğrulama yöntemi
`X-API-Key`	`ljson_live_...`	Header eklemesi kolay istemciler için alternatif

API key gizli değerdir; frontend koduna gömmeyin. Tarayıcıdan kullanım gerekiyorsa origin/IP allowlist ve kısıtlı scope kullanın.

Hızlı Başlangıç

İlk çağrını istediğin dilde yap. ljson_live_... yerine kendi API anahtarını koy. Aynı kalıp tüm endpoint'lerde çalışır — yalnız endpoint adı ve sorgu parametreleri değişir.

cURL

curl -s "https://livescorejson.com/api/get_matches_live.php?lang=tr" \
  -H "Authorization: Bearer ljson_live_..."

JavaScript (fetch)

const res = await fetch(
  "https://livescorejson.com/api/get_matches_live.php?lang=tr",
  { headers: { Authorization: "Bearer ljson_live_..." } }
);
const json = await res.json();
console.log(json.data);

Python (requests)

import requests
r = requests.get(
    "https://livescorejson.com/api/get_matches_live.php",
    params={"lang": "tr"},
    headers={"Authorization": "Bearer ljson_live_..."},
)
print(r.json()["data"])

PHP (cURL)

$ch = curl_init("https://livescorejson.com/api/get_matches_live.php?lang=tr");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer ljson_live_..."]);
$data = json_decode(curl_exec($ch), true);
print_r($data["data"]);

Resmi SDK'larımızı ve Postman koleksiyonunu tercih et (bkz. SDK ve Araçlar) — auth, base URL ve WebSocket token akışını senin yerine hallediyorlar.

Yanıt Formatı

Tüm yanıtlar aşağıdaki zarf (envelope) yapısında döner:

{
  "version": "3.0",
  "sport": "soccer",
  "lang": "en",
  "last_generated": "2026-04-16 12:34:56",
  "method": {
    "method_id": "2",
    "name": "get_matches",
    "parameter": [
      { "name": "type", "value": "season" },
      { "name": "id", "value": "24922" }
    ]
  },
  "data": {
    "competition": [ ... veri ... ]
  }
}

Alan	Açıklama
`version`	API versiyonu (3.0)
`sport`	Her zaman `soccer`
`last_generated`	Yanıtın üretildiği zaman (Europe/Istanbul, +03:00, `YYYY-MM-DD HH:MM:SS`)
`method`	Çağrılan metod bilgisi ve gönderilen parametreler
`data`	Endpoint'e göre değişen veri objesi (competition, area, team vb.)

Veri tazeliğini ölçme: canlı endpoint'ler (get_matches_live, get_matches_live_updates) bir X-Data-Event-Time yanıt header'ı döndürür — verinin kaynakta son güncellendiği anın UTC zamanı. Gerçek staleness: kendi UTC saatin − X-Data-Event-Time. (last_generated yanıt kurulum anıdır, Europe/Istanbul +03:00.)

Hata Kodları

API standart HTTP durum kodları kullanır.

Kod	Durum	Açıklama
200	OK	İstek başarılı, veri döndürüldü
400	Bad Request	Eksik veya geçersiz parametre
401	Unauthorized	Eksik veya geçersiz API key
403	Forbidden	Hesap devre dışı veya abonelik süresi dolmuş
500	Server Error	Sunucu tarafı hata

Hata durumunda yanıt:

{ "error": "Eksik parametre: type" }

Kimlik (ID) Kararlılığı

Oyuncu, takım, lig ve sezon ID'leri küresel olarak kararlı ve kalıcıdır — takım, sezon veya lig boyunca değişmez. Kendi eşleme/normalize katmanını kurmana gerek yok: tek bir ID, API'nin her yerinde aynı varlığı işaret eder; kendi veritabanında foreign key olarak güvenle saklayabilirsin.

ID	Şunlar boyunca kararlı	Kullanımı
`player_id`	oyuncunun yer aldığı her kulüp, sezon ve lig	oyuncunun tüm kariyeri, istatistikleri ve transferleri için tek anahtar
`team_id`	lig, kupa ve tüm sezonlar	her bağlamda kulüp için kalıcı anahtar
`competition_id`	tüm sezonları	bir lig/kupa için kalıcı anahtar
`season_id`	maçlar, tablolar, kadrolar ve ilgili tüm endpoint'ler	tek bir sezon için kalıcı anahtar

Kanıt: tek player_id, tüm kariyer

get_career'a verilen tek bir player_id, oyuncunun oynadığı her kulüp, lig ve sezonu döndürür — aynı ID, asla takıma/sezona göre yeniden kapsanmaz:

GET /api/get_career.php?type=player&id={player_id}
→ data.person.career[] — birden çok satır;
  team_id / competition_id / season_id farklı, ama hepsi aynı player_id altında

Aynı player_id doğrudan get_player_statistics, get_transfers ve get_squads'ta da çalışır — herhangi bir takım/sezon filtresinden bağımsız.

ID'ler kalıcıdır ve foreign key olarak kullanmak güvenlidir. (Derin tarihsel veride nadir varlık birleştirmeleri en-iyi-çaba ile ele alınır.)

Görsel URL Alanları

Takım, futbolcu, stadyum ve lig/kupa görselleri desteklenen standart API nesnelerine public HTTPS URL olarak eklenir.

Alan	Bağlı kimlik	İçerik
`team_logo_url`	`team_id`	Takım logosu
`player_photo_url`	`person_id` / `player_id`	Futbolcu fotoğrafı
`venue_photo_url`	`venue_id`	Stadyum fotoğrafı
`competition_logo_url`	`competition_id`	Lig veya kupa logosu

Görsel alanları string|null tipindedir. İlgili görsel mevcut değilse alan null döner. Ham detay bileşenleri ile teknik personel, futbolcu fotoğrafı alanına dahil değildir. Maçlarda team_A_logo_url/team_B_logo_url, transferlerde from_team_logo_url/to_team_logo_url kullanılır. Stadyumlardaki eski photo alanı kaynak/kredi metnidir; görsel URL'si değildir.

SDK ve Araçlar

Resmi ince SDK'lar (sıfır bağımlılık) ve tüm endpoint'leri kapsayan, içe aktarmaya hazır Postman koleksiyonu.

Postman Koleksiyonu

.json indir — Postman'a aktar, baseUrl ve bearerToken'ı ayarla, her endpoint'i çağır.

JavaScript (ESM)

Tarayıcı: livescorejson.v3.0.5.js · Node: livescorejson.v3.0.5.mjs — REST çağrıları modern tarayıcılarda ve Node 18+ üzerinde çalışır; WebSocket yardımcısı tarayıcı veya Node 22+ ister.

Python

livescorejson.py — Python 3.7+, yalnız standart kütüphane (pip install yok).

OpenAPI Spec

openapi.json — OpenAPI 3.0.3; openapi-generator ile istediğin dilde istemci üret.

Gömülebilir Widget'lar

Widget builder — <iframe> ile hazır canlı puan durumu & skorlar, sayfada API key yok. Light/dark, çok dilli.

JavaScript (ESM) SDK

import { LiveScoreJSON } from "./livescorejson.v3.0.2.mjs";
const api = new LiveScoreJSON({ apiKey: "ljson_live_..." });
const live = await api.getMatchesLive({ lang: "tr" });
console.log(live.data);

Python SDK

from livescorejson import LiveScoreJSON
api = LiveScoreJSON(api_key="ljson_live_...")
print(api.get_matches_live(lang="tr")["data"])

get_search

Takım, lig/kupa, ülke ve futbolcuları tek çağrıda arar. İstekte type verilmez; dört katalog otomatik taranır.

GET /api/get_search.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
q	string	Zorunlu	Arama metni; 2-80 karakter.
limit	int	Opsiyonel	1-100; varsayılan 20.
lang	string	Opsiyonel	İki harfli dil kodu; varsayılan `en`.

Yanıt Yapısı

data → search[]

Alan	Tip	Açıklama
entity	string	`team`, `competition`, `country` veya `player`
name	string	Gösterilecek ad
secondary_name	string\|null	Resmî, özgün veya alternatif tam ad
area_id / area_name	int / string	Takım, lig veya futbolcunun ülke/bölge bilgisi
countrycode	string\|null	Üç harfli ülke kodu
subtype	string\|null	Varlığın alt türü
team_logo_url / competition_logo_url / player_photo_url	string\|null	Sonuç türüne uygun public görsel URL'si

Örnek İstek

GET /api/get_search.php?q=fener&limit=20&lang=tr

get_areas

Bölge ve ülke listesini döndürür. Maçların, takımların ve liglerin bağlı olduğu coğrafi bölgeler.

GET /api/get_areas.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
area_id	int	Opsiyonel	Belirli bir bölge. Verilmezse tüm bölgeler döner.
lang	string	Opsiyonel	Language code

Yanıt Yapısı

data → area[]

Alan	Tip	Açıklama
area_id	int	Bölge ID'si
name	string	Bölge/ülke adı (İngilizce veya çeviri dili)
parent_area_id	int\|null	Bağlı olduğu üst bölge veya kıta ID'si (Örn: Avrupa, Asya)
countrycode	string	ISO ülke kodu (2/3 harfli)

Örnek İstek

GET /api/get_areas.php?area_id=221

get_competitions

Lig ve kupa listesini döndürür. Bölgeye veya türe göre filtrelenebilir.

GET /api/get_competitions.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
area_id	int	Opsiyonel	Bölgeye göre filtre
type	string	Opsiyonel	Tür filtresi (örn: league, cup)
lang	string	Opsiyonel	Language code

Yanıt Yapısı

data → competition[]

Alan	Tip	Açıklama
competition_id	int	Lig/kupa ID
competition_logo_url	string\|null	Lig/kupa logosunun public HTTPS URL'si
name	string	Lig adı
soccertype	string	Futbol türü
teamtype	string	Takım türü (club/national)
display_order	int	Görüntüleme sırası
type	string	Tür (league, cup, ...)
format	string	Format
area_id	int	Bağlı bölge ID
area_name	string	Bölge adı

Örnek İstek

GET /api/get_competitions.php?area_id=221

get_seasons

Bir yarışmanın sezonlarını döndürür. Yarışma bilgisi ile iç içe sarılmış olarak gelir.

GET /api/get_seasons.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
competition_id	int	Opsiyonel	Yarışmaya göre filtre. Verilmezse tüm sezonlar.
active	string	Opsiyonel	`yes` = sadece aktif sezonlar (end_date ≥ bugün)

Yanıt Yapısı

data → competition[] → season[]

Alan	Tip	Açıklama
season_id	int	Sezon ID
name	string	Sezon adı (örn: "2025/2026")
start_date	date	Başlangıç tarihi
end_date	date	Bitiş tarihi
service_level	string	Veri servis seviyesi

Örnek İstek

GET /api/get_seasons.php?competition_id=8&active=yes

get_rounds

Bir sezonun turlarını (hafta, eleme turu vb.) döndürür.

GET /api/get_rounds.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
season_id	int	Opsiyonel	Sezon ID
type	string	Opsiyonel	Filter type
id	int	Opsiyonel	Filter ID

round_id veya season_id gönderin. Alternatif olarak type=round|season ile id birlikte gönderilebilir.

Yanıt Yapısı

data → competition[] → season[] → round[]

Alan	Tip	Açıklama
round_id	int	Tur ID
name	string	Tur adı
start_date	date	Başlangıç tarihi
end_date	date	Bitiş tarihi
type	string	Tur tipi
ordermethod	string	Sıralama metodu
groups	string	Grup bilgisi
has_outgroup_matches	boolean	Grup dışı maç var mı

Örnek İstek

GET /api/get_rounds.php?season_id=24922

get_groups

Bir tur veya sezondaki alt grupları döndürür (Şampiyonlar Ligi grupları gibi).

GET /api/get_groups.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
round_id	int	Opsiyonel	Tura göre filtre
season_id	int	Opsiyonel	Sezona göre filtre (tüm turları kapsar)
type	string	Opsiyonel	Filter type
id	int	Opsiyonel	Filter ID

Yanıt Yapısı

data → group[]

Alan	Tip	Açıklama
group_id	int	Grup ID
name	string	Grup adı (örn: "Group A")
round_id	int	Bağlı tur ID

get_teams

Takım bilgilerini döndürür. Bölge, sezon veya yarışma bazında filtrelenebilir.

GET /api/get_teams.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
type	string	Opsiyonel	`area` \| `season` \| `competition`
id	int	Opsiyonel	Seçilen türe göre filtre ID'si
team_id	int	Opsiyonel	Tek bir takım bilgisi
area_id	int	Opsiyonel	Doğrudan ülke/bölge ID'sine göre takımlar
status	string	Opsiyonel	`active` \| `inactive`
soccertype	string	Opsiyonel	`default` \| `women`
teamtype	string	Opsiyonel	`default` \| `u21` \| `u19`
city	string	Opsiyonel	Şehir adına göre filtre

Yanıt Yapısı

data → team[]

Alan	Tip	Açıklama
team_id	int	Takım ID
team_logo_url	string\|null	Takım armasının public HTTPS URL'si
club_name	string	Kulüp adı
short_name	string	Kısa ad
country	string	Ülke adı
city	string\|null	Kulübün bulunduğu şehir
founded	string\|null	Kuruluş yılı
url	string\|null	Resmî web sitesi URL'si
telephone	string\|null	Telefon
venue_id	int\|null	Ev sahibi stadyum ID
venue_name	string\|null	Ev sahibi stadyum adı
venue_city	string\|null	Stadyumun bulunduğu şehir
venue_capacity	string\|null	Stadyum seyirci kapasitesi
venue_surface	string\|null	Stadyum zemin türü (grass, artificial vb.)
venue_address	string\|null	Stadyum açık adresi
venue_photo_url	string\|null	Stadyum fotoğrafının public HTTPS URL'si
status	string	Kulüp durumu (active vb.)
soccertype	string	Futbol türü (default, women vb.)
teamtype	string	Takım türü (default, u21 vb.)

Örnek İstek

GET /api/get_teams.php?type=season&id=24922

get_venues

Stadyum bilgilerini döndürür.

GET /api/get_venues.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
type	string	Opsiyonel	`area` \| `season`
id	int	Opsiyonel	Seçilen türe göre filtre ID'si
venue_id	int	Opsiyonel	Tek bir stadyum bilgisi
team_id	int	Opsiyonel	Belirli bir takımın ev sahibi stadyumu
area_id	int	Opsiyonel	Ülke/bölge ID'sine göre stadyumlar
city	string	Opsiyonel	Şehre göre stadyum filtresi
surface	string	Opsiyonel	Zemin türüne göre filtre (grass, artificial vb.)

Yanıt Yapısı

data → venue[]

Alan	Tip	Açıklama
venue_id	int	Stadyum ID
venue_photo_url	string\|null	Stadyum fotoğrafının public HTTPS URL'si
name	string	Stadyum adı
city	string\|null	Şehir
capacity	int\|null	Seyirci kapasitesi
surface	string\|null	Zemin türü (grass, artificial vb.)
address	string\|null	Açık adres
opened	string\|null	Açılış yılı
latitude / maps_geocode_latitude	float\|null	Coğrafi enlem
longitude / maps_geocode_longitude	float\|null	Coğrafi boylam
country_code / area_name	string\|null	Ülke kodu / bölge adı

get_matches

Maçları hiyerarşik yapıda döndürür. En çok kullanılan endpoint. Çeşitli filtre seçenekleri sunar.

GET /api/get_matches.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
type	string	Zorunlu	`area` \| `season` \| `round` \| `group` \| `match` \| `team`
id	int	Zorunlu	Seçilen type'a göre ID
start_date	date	Opsiyonel	Başlangıç tarihi (YYYY-MM-DD)
end_date	date	Opsiyonel	Bitiş tarihi (YYYY-MM-DD)
status	string	Opsiyonel	Maç durumu: `Played` \| `Playing` \| `Fixture` \| `Postponed` \| `Cancelled`
gameweek	int	Opsiyonel	Hafta numarası
round_id	int	Opsiyonel	Sezon veya takım içinde tur filtresi
group_id	int	Opsiyonel	Turnuva grup filtresi
winner	string	Opsiyonel	Sonuç filtresi: `team_A` \| `team_B` \| `draw`
detailed	string	Opsiyonel	`yes` (varsayılan, olayları içerir) \| `no`
home_only / away_only	string	Opsiyonel	`yes` (type=team durumunda)
iddaa	string	Opsiyonel	`yes` verilirse iddaa oranlarını ekler

Yanıt Yapısı

data → competition[] → season[] → round[] → match[]

Alan	Tip	Açıklama
match_id	int	Maç ID
date_utc	date	Maç tarihi (UTC)
time_utc	time	Maç saati (UTC)
status	string	`Fixture` \| `Playing` \| `Played` \| `Postponed` \| `Cancelled` \| `Suspended`
team_A_id	int	Ev sahibi takım ID
team_B_id	int	Konuk takım ID
team_A_logo_url / team_B_logo_url	string\|null	Ev sahibi ve konuk takım logoları
team_A_name	string	Ev sahibi takım adı
team_B_name	string	Konuk takım adı
fs_A / fs_B	int	Maç sonu skor
hts_A / hts_B	int	İlk yarı skor
ets_A / ets_B	int	Uzatma skor
ps_A / ps_B	int	Penaltı skor

Her maçın altında 6 event grubu bulunabilir:

Grup	Kodlar	Açıklama
lineups	L	İlk 11 kadro
lineups_bench	SUB	Yedek oyuncular
goals	G, PG, OG	Goller (normal, penaltı, kendi kalesine)
substitutions	SI, SO	Oyuncu değişiklikleri (giren/çıkan)
bookings	YC, Y2C, RC	Kartlar (sarı, çift sarı, kırmızı)
penalty_shootout	PSG, PSM	Penaltı atışları (gol/kaçan)

Her event: event_id, code, person, person_id, player_photo_url, team_id, team_logo_url, minute, minute_extra, shirtnumber

Oran bulunan maçlara iddaa objesi eklenir. Oranlar periyodik olarak güncellenir.

Alan	Tip	Açıklama
iddaa.mbs	int	Minimum Bahis Sayısı (1–5)
iddaa.fetched_at	datetime	Son güncelleme zamanı (UTC)
iddaa.markets[]	array	Bahis marketleri listesi (~50 market)

Her market objesi:

Alan	Tip	Açıklama
MarketType.Id	int	Market tipi ID
MarketType.Name	string	Market adı (ör: Maç Sonucu, Çifte Şans, 2.5 Gol Alt/Üst)
MBS	int	Bu market için MBS
Outcomes[]	array	Sonuç seçenekleri
Outcomes[].OutcomeName	string	Seçenek adı (ör: 1, X, 2, Alt, Üst)
Outcomes[].Odd	float	Oran değeri

Yaygın market tipleri: Maç Sonucu, Çifte Şans, İlk Yarı/Maç Sonucu, 2.5 Gol Alt/Üst, Karşılıklı Gol, Handikaplı Maç Sonucu, Korner Alt/Üst, Kart Alt/Üst, Tek/Çift, 1.Yarı Sonucu vb.

İddaa verisi olmayan maçlarda iddaa alanı dönmez. Tüm maçlarda iddaa verisi bulunmaz — sadece İddaa programındaki maçlar.

Örnek İstekler

// Premier League 2025/2026 tüm maçları
GET /api/get_matches.php?type=season&id=24922

// Manchester United ev sahibi maçları (Ocak-Mart)
GET /api/get_matches.php?type=team&id=362&home_only=yes&start_date=2026-01-01&end_date=2026-03-31

// Tek maç (event'siz)
GET /api/get_matches.php?type=match&id=3456789&detailed=no

// Tek maç + İddaa oranları
GET /api/get_matches.php?type=match&id=4948913&iddaa=yes

get_matches_live Canlı

Belirli bir günün maçlarını canlı skorlarıyla döndürür. 30 saniye aralıklarla güncellenir.

GET /api/get_matches_live.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
date	yyyy-mm-dd	Opsiyonel	Tarih. Varsayılan: bugün.
detailed	string	Opsiyonel	`yes` (varsayılan) \| `no`
now_playing	string	Opsiyonel	`yes` = sadece şu an oynananlar
matchtype	string	Opsiyonel	`live` \| `fixture` \| `all`
sort	string	Opsiyonel	`custom` = ligleri `competition_order` sırasına göre öne al
competition_order	string	Opsiyonel	Virgülle ayrılmış `competition_id` listesi. İlk 50 geçerli ve benzersiz ID kullanılır; belirtilmeyen ligler mevcut sırasını korur.
iddaa	string	Opsiyonel	`yes` = mevcut İddaa bahis oranlarını ekle

Yanıt Yapısı

data → competition[] → season[] → round[] → match[]

Yanıt yapısı get_matches ile aynıdır.

Canlı skorlar 30 saniye aralıklarla güncellenir. Polling yaparken bu aralığı aşmamaya dikkat edin.

İddaa oranları yapısı için get_matches bölümündeki İddaa Oranları Yapısı accordion'una bakın.

Örnek İstekler

// Bugünün tüm canlı maçları
GET /api/get_matches_live.php?date=2026-04-16&now_playing=yes

// Bugünün maçları + İddaa oranları
GET /api/get_matches_live.php?date=2026-04-16&iddaa=yes

// Süper Lig, Bundesliga ve Premier League'i bu sırayla üste al
GET /api/get_matches_live.php?sort=custom&competition_order=19,9,8

get_matches_live_updates Delta

Belirtilen zamandan sonra güncellenen maçları döndürür. Bandwidth tasarrufu için idealdir.

GET /api/get_matches_live_updates.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
last_updated	yyyy-mm-dd hh:mm:ss	Zorunlu	Son güncelleme zamanı. Bu zamandan sonra değişen maçlar döner.

Yanıt Yapısı

data → next_since + data → competition[] → season[] → round[] → match[]

Alan	Tip	Açıklama
data.next_since	yyyy-mm-dd hh:mm:ss	Sunucunun verdiği otoritatif imleç (cursor). Bir sonraki poll'de bunu aynen `last_updated` olarak gönder — kendi saatini hesaplama, atlanan/çift-çekilen update olmaz. Ayrıca `X-Next-Since` header'ı olarak da döner.

Polling Döngüsü

İlk istek: günün başlangıcını (ya da geçmiş bir zamanı) gönder. Sonra sunucunun döndürdüğü next_since'i geçmeye devam et:

# 1) ilk poll
GET /api/get_matches_live_updates.php?last_updated=2026-04-16 00:00:00
→ data.next_since = "2026-04-16 15:30:12"

# 2) sonraki poll — next_since'i tekrar kullan, sende saat hesabı yok
GET /api/get_matches_live_updates.php?last_updated=2026-04-16 15:30:12

Bandwidth Tasarrufu (koşullu istek)

Her yanıt bir ETag taşır. Onu If-None-Match olarak geri gönder; son poll'den beri hiçbir şey değişmediyse API gövdesiz 304 Not Modified döner — boşta poll'ler neredeyse bedava olur.

GET /api/get_matches_live_updates.php?last_updated=2026-04-16 15:30:12
If-None-Match: "<önceki-yanıttaki-etag>"

← 304 Not Modified   (gövde yok)

En ucuz canlı polling için next_since + If-None-Match'i birlikte kullan. Hiç poll'lemeden gerçek-zamanlı push için WebSocket kanalını kullan.

get_aggregates

Eleme turu veya çok maçlı eşleşme için doğrulanmış galip bilgisini döndürür. Tek maçın winner alanından ayrı bir kavramdır.

GET /api/get_aggregates.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
id	int	Zorunlu	Maç ID. Sonuç en fazla bir aggregate kaydı içerir.

Yanıt Yapısı

data → aggregate[]

Alan	Tip	Açıklama
match_id	string	Aggregate kaydının bağlı olduğu maç.
round_id	string\|null	Maçın tur kimliği.
aggregate_winner_status	known \| draw \| unknown	`known` doğrulanmış takım; `draw` beraberlik; `unknown` belirsiz veya doğrulanamayan kayıt.
aggregate_winner_team_id	string\|null	Yalnız `known` durumunda maç katılımcılarından biri olan kanonik takım ID.
aggregate_winner_team_name	string\|null	Yalnız `known` durumunda kanonik takım adı.

Ham galip metni yayımlanmaz. Geçersiz, yetim veya maçın iki takımından biriyle eşleşmeyen kimlikler unknown olur ve takım alanları null döner.

Örnek İstek

GET /api/get_aggregates.php?id=5060309

get_runningball_matches Canlı

O anda Playing durumunda olan maçları döndürür.

GET /api/get_runningball_matches.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
date	yyyy-mm-dd	Opsiyonel	Kullanımdan kaldırıldı; geriye uyumluluk için kabul edilir ancak sonucu filtrelemez.

Yanıt Yapısı

data → competition[] → season[] → round[] → match[]

Maç yapısı get_matches_live ile aynıdır; yalnızca o anda oynanan maçlar yer alır.

Örnek İstek

GET /api/get_runningball_matches.php

get_match_statistics

Bir maçın detaylı istatistiklerini döndürür (top kontrolü, şut, korner vb.).

GET /api/get_match_statistics.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
id	int	Zorunlu	Maç ID
detailed	string	Opsiyonel	Detaylı istatistikler (yes/no)
components	string	Opsiyonel	Virgülle ayrılmış bileşenler

Yanıt Yapısı

data → competition[] → ... → match → data[]

Alan	Tip	Açıklama
type	string	İstatistik türü (possession, shots_on_target, corners... Sabit 36-anahtarlı şema garantilidir)
value_team_A	string	Ev sahibi değer
value_team_B	string	Konuk değer

Örnek İstek

GET /api/get_match_statistics.php?id=3456789

get_match_formations

Bir maçın kadro dizilişini ve maç bilgilerini (hakem, stadyum, teknik direktör) döndürür.

GET /api/get_match_formations.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
id	int	Zorunlu	Maç ID

Yanıt Yapısı

data → competition[] → ... → match → formation[] + matchinfo[]

Alan	Tip	Açıklama
team_id	int	Takım ID
person_id	string	Oyuncu ID
player_photo_url	string\|null	Futbolcu fotoğrafının public HTTPS URL'si
position_x	int	Saha X koordinatı
position_y	int	Saha Y koordinatı
position_name	string	Pozisyon adı (GK, DF, MF, FW)

get_match_commentary

Bir maçın zaman çizelgesi yorumlarını döndürür.

GET /api/get_match_commentary.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
id	int	Zorunlu	Maç ID

Yanıt Yapısı

data → competition[] → season[] → round[] → match[] → commentary[]

Alan	Tip	Açıklama
minute / minute_extra / second	string\|null	Yorumun maç zamanı
period	string\|null	Maç periyodu
comment	string	Yorum metni
type	string\|null	Yorum türü
goal / important / is_old	string\|null	Yorum işaretleri
last_updated	string\|null	Son güncelleme zamanı

Örnek İstek

GET /api/get_match_commentary.php?id=4891367

get_match_extra

Maçın ek bilgilerini döndürür: stadyum, seyirci, hava durumu, hakem.

GET /api/get_match_extra.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
id	int	Zorunlu	Maç ID
include	string	Opsiyonel	Ekstra verileri dahil et (örn. commentary)
components	string	Opsiyonel	Virgülle ayrılmış bileşenler

Yanıt Yapısı

data → competition[] → ... → match → matchinfo

Alan	Tip	Açıklama
match_id	int	Maç ID
venue_id	int\|null	Stadyum ID
venue_name	string\|null	Stadyum adı
venue_city	string\|null	Stadyum şehri
venue_capacity	string\|null	Stadyum kapasitesi
venue_address	string\|null	Stadyum açık adresi
venue_surface	string\|null	Stadyum zemin türü (grass, artificial vb.)
venue_opened	string\|null	Stadyum açılış yılı
venue_photo	string\|null	Stadyum görseli / referansı
referee_person_id / referee_name	int / string	Baş hakem bilgisi
coach_a_id / coach_a_name	int / string	A Takımı teknik direktörü
coach_b_id / coach_b_name	int / string	B Takımı teknik direktörü
attendance	int\|null	Resmî seyirci sayısı
formation_a / formation_b	string\|null	Taktik dizilişler (örn: 4-2-3-1)

get_match_editorials

Bir maça ait mevcut editöryal içerikleri döndürür.

GET /api/get_match_editorials.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
id	int	Zorunlu	Maç ID
lang	string	Opsiyonel	Yanıt zarfının dil kodu; varsayılan `en`

Yanıt Yapısı

data → editorial[]

Kayıtlar mevcut halleriyle döner. İçerik bulunmadığında editorial listesi boştur.

Örnek İstek

GET /api/get_match_editorials.php?id=4891367&lang=tr

get_tables

Puan tablosunu döndürür. Sezon veya tur bazında.

GET /api/get_tables.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
id	int	Zorunlu	Sezon ID veya Tur ID
type	string	Opsiyonel	`season` (varsayılan) \| `round`
round_id	int	Opsiyonel	Sezon içinde belirli turun puan durumu
group_id	int	Opsiyonel	Turnuva grubu filtresi
team_id	int	Opsiyonel	Belirli bir takımın puan tablosu satırı

Yanıt Yapısı

data → competition[] → season[] → round[] → resultstable → ranking[]

Alan	Tip	Açıklama
rank	int	Sıralama
team_id	int	Takım ID
club_name	string	Takım adı
matches_total	int	Toplam maç
matches_won	int	Galibiyet
matches_draw	int	Beraberlik
matches_lost	int	Mağlubiyet
goals_pro	int	Atılan gol
goals_against	int	Yenen gol
points	int	Puan

Örnek İstek

GET /api/get_tables.php?type=season&id=24922

get_tables_live Canlı

Anlık puan tablosu. Devam eden maçların mevcut skorlarını da hesaba katarak, "maçlar bu skorlarla bitse tablo nasıl görünür" sorusuna cevap verir.

GET /api/get_tables_live.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
type	string	Opsiyonel	`season` (varsayılan) \| `round`
id	int	Zorunlu	season_id veya round_id

Yanıt Yapısı

Yanıt yapısı get_tables ile aynıdır.

Devam eden maçlar bittiğinde sıralama otomatik olarak kesinleşir. Maç yokken get_tables ile aynı sonucu döndürür.

get_tables_cumulative

Bir sezonun turlar boyunca biriken puan tablolarını döndürür.

GET /api/get_tables_cumulative.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
id	int	Zorunlu	Sezon ID
type	string	Opsiyonel	Kullanımdan kaldırıldı; kabul edilir ancak sonucu değiştirmez.

Yanıt Yapısı

data → competition[] → season[] → round[] → resultstable[] → ranking[]

id her zaman sezon kimliği olarak değerlendirilir. Sıralama alanları get_tables ile aynıdır.

Örnek İstek

GET /api/get_tables_cumulative.php?id=27218

get_betting_statistics

Sezon veya yarışma kapsamındaki toplu bahis eğilimlerini döndürür; maç oranı endpoint'i değildir.

GET /api/get_betting_statistics.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
type	string	Zorunlu	`season` \| `competition`
id	int	Zorunlu	Sezon veya yarışma ID
market	string	Opsiyonel	Pazar kodu filtresi

Yanıt Yapısı

data → betting_statistic[]

Alan	Tip	Açıklama
season_id	string	Sezon ID
market	string	Pazar kodu
category_code / subcategory_code	string\|null	Kategori kodları
outcome_code	string\|null	Sonuç kodu
outcome_value / outcome_percentage	string\|null	Toplu sonuç değeri ve yüzdesi
last_updated	string\|null	LiveScoreJSON kayıt güncelleme zamanı; kaynak olay zamanı değildir

Örnek İstek

GET /api/get_betting_statistics.php?type=season&id=25828

get_player_statistics Gerçek Zamanlı Hesaplama

Oyuncu istatistikleri (gol, asist, kart). Maç event'lerinden anlık hesaplanır, önbellek yoktur.

GET /api/get_player_statistics.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
type	string	Zorunlu	`season` \| `round`
id	int	Zorunlu	season_id veya round_id
team_id	int	Opsiyonel	Takıma göre filtre
player_id	int	Opsiyonel	Tek oyuncu
limit	int	Opsiyonel	Top N oyuncu (örn: 10)

İstatistik Türleri

stat_type	Kapsam	Açıklama
goals	G + PG	Normal + penaltı golleri (kendi kalesine goller hariç)
assists	AS	Asistler
yellow_cards	YC + Y2C	Sarı + çift sarı kartlar
red_cards	RC	Kırmızı kartlar

Yanıt Yapısı

data → competition[] → season[] → player_statistic[]

Alan	Tip	Açıklama
person_id	string	Oyuncu ID
player_photo_url	string\|null	Futbolcu fotoğrafının public HTTPS URL'si
person	string	Oyuncu adı
team_id	int	Takım ID
team_name	string	Takım adı
stat_type	string	İstatistik türü
count	int	Adet
rank	int	Sıralama

Transfer durumunda oyuncu en fazla event'inin olduğu takıma atanır.

Örnek İstek

// Premier League gol kralları (Top 10)
GET /api/get_player_statistics.php?type=season&id=24922&limit=10

get_team_statistics

Bir takımın sezon bazlı detaylı istatistiklerini döndürür.

GET /api/get_team_statistics.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
team_id	int	Zorunlu	Takım ID
season_id	int	Opsiyonel	Sezona göre filtre
form	string	Opsiyonel	`yes`: yalnız `form-*`; `no`: yalnız normal türler. Verilmezse tümü.

Yanıt Yapısı

data → team → team_statistic[]

Alan	Tip	Açıklama
stat_type	string	İstatistik türü (total_matches, home_won_percent, avg_goals...)
stat_value	string	Değer
season_id	string\|null	Sezon ID

Örnek İstek

GET /api/get_team_statistics.php?team_id=362&season_id=24922

get_head2head Gerçek Zamanlı Hesaplama

İki takımın karşılıklı maç istatistiklerini hesaplar. Maç verilerinden anlık hesaplanır.

GET /api/get_head2head.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
team_A_id	int	Koşullu	İlk takım için canonical parametre
team_B_id	int	Koşullu	İkinci takım için canonical parametre
team1_id	int	Koşullu	`team_A_id` için geriye uyumlu alternatif
team2_id	int	Koşullu	`team_B_id` için geriye uyumlu alternatif
competition_id	int	Opsiyonel	Yarışmaya göre filtre
start_date	yyyy-mm-dd	Opsiyonel	Başlangıç tarihi filtresi
end_date	yyyy-mm-dd	Opsiyonel	Bitiş tarihi filtresi

Her takım için bir parametre gerekir: team_A_id veya team1_id; team_B_id veya team2_id. İkisi birlikte gönderilirse canonical parametre kullanılır.

Yanıt Yapısı

data → head_2_head[]

Toplam maç, galibiyet/beraberlik dağılımı, ev/deplasman performansı, gol istatistikleri.

Örnek İstek

// Manchester United vs Liverpool
GET /api/get_head2head.php?team_A_id=362&team_B_id=364

get_predictions İstatistiksel Model

Maç sonucu olasılıkları (1X2), 2.5 alt/üst, karşılıklı gol ve en olası skorlar — kendi istatistiksel modelimizle (son form üzerine Poisson + lig ev/dep ortalaması) hesaplanır. Bilgilendirme amaçlı bir tahmindir, bahis tavsiyesi değildir.

Bu bir istatistiksel modeldir (son form, Poisson); xG/ML ürünü değildir ve kaynaklı tahmin değildir. 210B maç üzerinde backtest edildi (%51.7 1X2 isabet, ev-yanlılığı baseline'ını geçiyor). Olasılıksal bir sinyal olarak kullanın, garanti değil.

GET /api/get_predictions.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
match_id	int	Zorunlu	Tahmin edilecek maç. Her iki takımın da en az 6 önceki oynanmış maçı olmalı.

Yanıt Yapısı

data → prediction

Alan	Tip	Açıklama
result	object	`home_win` / `draw` / `away_win` olasılıkları (toplamı 1)
over_under_2_5	object	2.5 `over` / `under` olasılıkları
btts	object	Karşılıklı gol `yes` / `no` olasılıkları
projected_goals	object	Taraf başına model gol beklentisi (Poisson λ — xG değil)
likely_scores	array	En olası 5 skor + olasılıkları
disclaimer	string	Model + bahis-tavsiyesi-değildir notu

Örnek İstek

GET /api/get_predictions.php?match_id=4350869

get_rankings

Takım sıralamalarını tür ve yayın tarihine göre döndürür.

GET /api/get_rankings.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
type	string	Opsiyonel	`ranking_type` filtresi; mevcut tür `fifa`
year	int	Opsiyonel	Yıl filtresi
month	int	Opsiyonel	Ay filtresi

Yanıt Yapısı

data → ranking[]

Alan	Tip	Açıklama
rank	string	Sıra
area_id	string\|null	Ülke ID
team_id	string\|null	Milli takım ID
points	string\|null	Puan
ranking_type	string	Sıralama türü
ranking_date	string	Sıralama tarihi

Örnek İstek

GET /api/get_rankings.php?type=fifa&year=2026&month=1

get_squads

Takım kadrolarını döndürür. Sezon bazında oyuncu listesi.

GET /api/get_squads.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
id	int	Opsiyonel	Sezon ID (örn: 27549)
team_id	int	Opsiyonel	Takım ID (örn: 10471)
position	string	Opsiyonel	`Goalkeeper` \| `Defender` \| `Midfielder` \| `Attacker`
role	string	Opsiyonel	`Player` \| `Coach`
type	string	Opsiyonel	`season` (varsayılan)

Yanıt Yapısı

data → team[] → person[]

Alan	Tip	Açıklama
person_id	int	Oyuncu ID
player_photo_url	string\|null	Futbolcu fotoğrafının public HTTPS URL'si
name	string	Tam ad
first_name	string	Ad
last_name	string	Soyad
nationality_id	int	Uyruk (area_id)
date_of_birth	date	Doğum tarihi
height	int	Boy (cm)
weight	int	Kilo (kg)
foot	string	Baskın ayak (left/right/both)
shirtnumber	int	Forma numarası
role	string	Pozisyon (Goalkeeper, Defender, Midfielder, Attacker)
status	string	Kadro durumu (active, on_loan...)
appearances / goals / assists	string\|null	Sezon maç, gol ve asist toplamları
minutes_played / substituted_in	string\|null	Oynanan dakika ve oyuna sonradan giriş toplamı
yellow_cards / red_cards	string\|null	Sarı ve kırmızı kart toplamları

Örnek İstek

GET /api/get_squads.php?id=24922&team_id=362

get_squads_changes Delta

Kadro değişikliklerini döndürür. Belirtilen zamandan sonra güncellenen kayıtlar.

GET /api/get_squads_changes.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
type	string	Zorunlu	`match` \| `season`
id	int	Zorunlu	match_id veya season_id
last_updated	yyyy-mm-dd hh:mm:ss	Opsiyonel	Delta zamanı

Yanıt Yapısı

Yanıt yapısı get_squads ile aynıdır. Sadece güncellenen kayıtlar döner.

get_career

Oyuncu veya takım kariyer istatistiklerini döndürür.

GET /api/get_career.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
type	string	Zorunlu	`player` \| `team`
id	int	Zorunlu	person_id veya team_id

Yanıt Yapısı

data → person|team → career[]

Alan	Tip	Açıklama
season_id	int	Sezon ID
competition_id	int	Yarışma ID
team_id	int	Takım ID
appearances	int	Maç sayısı
goals	int	Gol
assists	int	Asist

Örnek İstek

// Mohamed Salah'ın kariyer istatistikleri
GET /api/get_career.php?type=player&id=174352

get_transfers

Transfer kayıtlarını döndürür. Sezon, takım veya oyuncu bazında filtrelenebilir. Sayfalama destekler.

GET /api/get_transfers.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
type	string	Zorunlu	`team` \| `player` \| `season`
id	int	Zorunlu	Seçilen türe göre ID
start_date	date	Opsiyonel	Tarihten sonraki transferler (YYYY-MM-DD)
end_date	date	Opsiyonel	Tarihten önceki transferler (YYYY-MM-DD)
year	int	Opsiyonel	Yıla göre transferler (örn: 2024)
transfer_type	string	Opsiyonel	`Loan` \| `Transfer` \| `Free transfer`
limit	int	Opsiyonel	Kayıt sayısı (varsayılan 20, maks 100)
offset	int	Opsiyonel	Başlangıç noktası (sayfalama)

Yanıt Yapısı

data → transfer[]

Alan	Tip	Açıklama
id	int	Transfer kayıt ID
person_id	int	Futbolcu ID
person_name	string	Futbolcu adı
from_team_id	int\|null	Eski takım ID
from_team_name	string\|null	Eski takım adı
to_team_id	int\|null	Yeni takım ID
to_team_name	string\|null	Yeni takım adı
transfer_date	date	Transfer tarihi
transfer_type / type	string\|null	Transfer türü (Kiralık, Bedelsiz, Bonservisli vb.)
amount	string\|null	Bonservis / tazminat bedeli
proceeded	string\|null	Transfer kesinleşme durumu

get_players

Yalnız type=player olan oyuncu profillerini döndürür. Teknik ekip ve dahili alanlar yanıta dahil edilmez.

GET /api/get_players.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
id	int	Opsiyonel	Tek bir futbolcu ID'si
cursor	int	Opsiyonel	Keyset sayfalama imleci (en son person_id)
limit	int	Opsiyonel	Sayfa boyutu (1-500, varsayılan 100)
area_id / country_id	int	Opsiyonel	Uyruk veya doğum ülkesi filtresi
team_id	int	Opsiyonel	Takım ID'sine göre oyuncu filtresi

Yanıt Yapısı

data → player[] + pagination

Alan	Tip	Açıklama
person_id	int	Oyuncu ID
type	string	Sabit `player`
first_name	string\|null	Ad
middle_name	string\|null	İkinci ad
last_name	string\|null	Soyad
name	string\|null	Görünen tam ad
nationality_area_id	string\|null	Uyruğun bölge ID'si
nationality	string\|null	Uyruk
date_of_birth	date\|null	Doğum tarihi
place_of_birth	string\|null	Doğum yeri
country_of_birth_id	string\|null	Doğduğu ülkenin ID'si
country_of_birth	string\|null	Doğduğu ülke
foot	string\|null	Tercih edilen ayak
status	string\|null	Oyuncu durumu
height	string\|null	Boy (cm)
weight	string\|null	Ağırlık (kg)
international_caps	string\|null	Millî maç sayısı
international_goals	string\|null	Millî gol sayısı
player_photo_url	string\|null	Oyuncu fotoğrafı URL'si

Sayfalama

Alan	Tip	Açıklama
limit	int	Uygulanan sayfa limiti
has_more	bool	Sonraki sayfa varsa `true`
next_cursor	string\|null	Sonraki istekte kullanılacak cursor

Örnek İstekler

// ID ile tek oyuncu profili
GET /api/get_players.php?id=119

// Cursor ile oyuncu kataloğunun sonraki sayfası
GET /api/get_players.php?cursor=119&limit=100

get_injuries

Sakatlık kayıtlarını döndürür. 6 farklı filtre tipi.

GET /api/get_injuries.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
type	string	Zorunlu	`season` \| `round` \| `competition` \| `player` \| `team` \| `match`
id	int	Zorunlu	Seçilen type'a göre ID

Yanıt Yapısı

data → injury[]

Alan	Tip	Açıklama
person_id	int	Oyuncu ID
person_full_name	string	Oyuncu tam adı
team_id	int	Takım ID
expected_end_date	date	Tahmini dönüş tarihi
status	string	Durum
injury_type	string	Sakatlık türü

get_suspensions

Cezalı oyuncuları döndürür (kırmızı kart veya kart birikimi).

GET /api/get_suspensions.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
id	int	Zorunlu	Filtre ID'si
type	string	Opsiyonel	`season` \| `team` \| `match` \| `player`

Yanıt Yapısı

data → suspension[]

Alan	Tip	Açıklama
id	int	Ceza kayıt ID
person_id / person_name / person_full_name	int / string	Cezalı futbolcu/teknik adam bilgisi
team_id / team_name / team_full_name	int / string	Bağlı olduğu takım bilgisi
season_id / round_id / match_id	int\|null	İlgili sezon, tur ve maç ID'si
suspended_matches	int\|null	Ceza maç sayısı
suspension_type	string\|null	Ceza türü (matches, period vb.)
start_date / end_date	date\|null	Ceza tarih aralığı
description	string\|null	Cezanın resmî gerekçesi / açıklaması

get_players_abroad

Bir ülkenin yurtdışında oynayan oyuncularını döndürür.

GET /api/get_players_abroad.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
id	int	Koşullu	Ülke/bölge ID'si; canonical parametre
area_id	int	Koşullu	`id` için geriye uyumlu alternatif

id veya area_id gönderilmelidir. İkisi birlikte gönderilirse id kullanılır.

Yanıt Yapısı

data → player[]

Alan	Tip	Açıklama
person_id	int	Oyuncu ID
player_photo_url	string\|null	Futbolcu fotoğrafının public HTTPS URL'si
name	string	Oyuncu adı
nationality_area_id	int	Uyruk
team_id	string	Mevcut takım ID
team_name	string	Mevcut takım adı
team_area_id	int	Takım ülke ID
team_area_name	string	Takım ülke adı

Örnek İstek

// Türk oyuncular yurtdışında
GET /api/get_players_abroad.php?id=221

get_referees

Maç, tur veya sezondaki ana hakem atamalarını maç bazında döndürür. Bu uç kişi profili veya milliyet bilgisi üretmez; yardımcı hakemler maç detay uçlarında sunulur.

GET /api/get_referees.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
type	string	Zorunlu	`match` \| `round` \| `season`
id	int	Zorunlu	Seçilen type değerine ait pozitif ID (en fazla 2147483647)

Yanıt Yapısı

data → referee[]

Alan	Tip	Açıklama
match_id	string	Hakem atamasının ait olduğu maç ID
round_id	string	Tur ID
season_id	string	Sezon ID
referee_person_id	string	Ana hakem kimliği
referee_name	string\|null	Ana hakem adı; bilinmiyorsa null

Her satır bir maçın ana hakem atamasıdır. Atama yoksa referee boş dizi döner. referee ve area filtreleri desteklenmez.

Örnek İstek

GET /api/get_referees.php?type=match&id=4661321

get_trophies

Kupa ve ödül kayıtlarını döndürür.

GET /api/get_trophies.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
type	string	Zorunlu	`competition` \| `season` \| `team` \| `player`
id	int	Zorunlu	Seçilen type'a göre ID

Yanıt Yapısı

data → trophy[]

Alan	Tip	Açıklama
id	int	Başarı / Kupa kayıt ID
competition_id / competition_name	int / string	Turnuva / Lig detayları
season_id / season_name	int / string	Sezon detayları
team_id / team_name	int / string	Takım detayları
person_id / person_name	int / string\|null	Futbolcu detayları (bireysel ödüller için)
trophy_type	string\|null	Kupa / Başarı türü (Lig şampiyonluğu, Kupa şampiyonluğu vb.)
position	int\|null	Derece (1: Şampiyon/Kazanan, 2: İkinci)

get_season_coverage

Sezon başına kapsam haritası: bir sezonda hangi veri yeteneklerinin (canlı skor, kadro, kart, transfer, sakatlık…) mevcut olduğu, zamanlaması (maç öncesi/sonrası, canlı) ve güncelleme sıklığı. Entegrasyondan önce kontrol et — alt-lig sezonunda kadro var mı diye tahmin etmek yok.

GET /api/get_season_coverage.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
season_id	int	Zorunlu	İncelenecek sezon (`get_seasons`'dan).

Yanıt Yapısı

data → season_coverage → capabilities[]

Alan	Tip	Açıklama
capability	string	Veri türü, ör. `live_scores`, `lineups`, `cards`, `transfers`, `injuries`
available	bool	Bu yeteneğin sezonda sağlanıp sağlanmadığı
timing	string	`Live` / `Before the match` / `After the match` / `Not available`
update_interval_minutes	int	Dakika cinsinden güncelleme sıklığı (geçerliyse)

Örnek İstek

GET /api/get_season_coverage.php?season_id=27218

get_deleted

Belirtilen zamandan sonra silinen kayıtları döndürür.

GET /api/get_deleted.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
start_date	string	Opsiyonel	Başlangıç zamanı; varsayılan son 24 saat
type	string	Opsiyonel	Yanıttaki `item_type` filtresi: area, competition, season, round, group, match, event, team veya person

Yanıt Yapısı

data → deleted_item[]

start_date dahil olmak üzere bu zamandan sonra silinen kayıtlar, en yeni silinenden başlayarak döner.

Örnek İstek

GET /api/get_deleted.php?start_date=2026-08-12%2000:00:00&type=match

get_hashtags

Bir yarışma, takım veya maçla ilişkili hashtag'leri döndürür.

GET /api/get_hashtags.php

Parametreler

Parametre	Tip	Zorunlu	Açıklama
type	string	Zorunlu	`competition` \| `team` \| `match`
id	int	Zorunlu	Seçilen türe ait ID

Yanıt Yapısı

data → hashtag[]

Örnek İstek

GET /api/get_hashtags.php?type=team&id=2212

get_ws_token

WebSocket bağlantısı için kısa ömürlü token üretir. Standart API zarfı yerine doğrudan aşağıdaki JSON objesini döndürür.

GET /api/get_ws_token.php

Yanıt Yapısı

doğrudan JSON objesi

Alan	Tip	Açıklama
token	string	Kısa ömürlü bağlantı tokeni
token_jti	string	Token oturum kimliği
expires_at	date-time string	UTC son kullanım zamanı
ws_url	URI string	WebSocket bağlantı adresi

API anahtarını WebSocket üzerinden göndermeyin. HTTPS ile aldığınız kısa ömürlü tokeni ws_url bağlantısında kullanın.

Örnek İstek

GET /api/get_ws_token.php

health_public

Örnek İstek

Başarılı Yanıt (200 OK)

LiveScoreJSON API Kılavuzu

Genel Bakış

Kimlik Doğrulama

Hızlı Başlangıç

cURL

JavaScript (fetch)

Python (requests)

PHP (cURL)

Yanıt Formatı

Hata Kodları

Kimlik (ID) Kararlılığı

Kanıt: tek player_id, tüm kariyer

Görsel URL Alanları

SDK ve Araçlar

JavaScript (ESM) SDK

Python SDK

get_search

Parametreler

Yanıt Yapısı

Örnek İstek

get_areas

Parametreler

Yanıt Yapısı

Örnek İstek

get_competitions

Parametreler

Yanıt Yapısı

Örnek İstek

get_seasons

Parametreler

Yanıt Yapısı

Örnek İstek

get_rounds

Parametreler

Yanıt Yapısı

Örnek İstek

get_groups

Parametreler

Yanıt Yapısı

get_teams

Parametreler

Yanıt Yapısı

Örnek İstek

get_venues

Parametreler

Yanıt Yapısı

get_matches

Parametreler

Yanıt Yapısı

Örnek İstekler

get_matches_live Canlı

Parametreler

Yanıt Yapısı

Örnek İstekler

get_matches_live_updates Delta

Parametreler

Yanıt Yapısı

Polling Döngüsü

Bandwidth Tasarrufu (koşullu istek)

get_aggregates

Parametreler

Yanıt Yapısı

Örnek İstek

get_runningball_matches Canlı

Parametreler

Yanıt Yapısı

Örnek İstek

get_match_statistics

Parametreler

Yanıt Yapısı

Örnek İstek

get_match_formations

Parametreler

Yanıt Yapısı

get_match_commentary

Parametreler

Yanıt Yapısı