Maç Sonuçları API
Süper Lig'den 3. Lig'e maç sonuçları, oynanan maçların skoru ve yarının fikstürü; tek istekte.
/v1/spor/maclar ligleri, tarihi, takımı ve durumu (bitti, canli, oynanacak, ertelendi) süzerek maçları döndürür: ev sahibi ve deplasman takımı, skor, ilk yarı skoru, hafta, dakika ve başlama saati; kaynakta varsa stadyum ve hakem. Puan durumu için /v1/spor/puan-durumu kullanılır; iki uç aynı lig kodlarını paylaşır.
Maçlar oynanırken skor 15 dakikada bir, biten maçlar bitişten kısa süre sonra yenilenir; anlık (saniye saniye) canlı skor değildir. Kayıtlar 01.11.2026'dan başlar; fikstür en çok bir gün sonrasını kapsar.
Hızlı başlangıç
Anahtarınızı X-API-Key başlığında gönderin (ücretsiz anahtar al).
Anahtarı tarayıcı koduna koymayın; sunucunuzdan çağırıp sonucu önbelleğe alın.
<?php
$ch = curl_init('https://api.veriapi.pro/v1/spor/maclar?lig=super-lig&durum=bitti');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 10,
CURLOPT_HTTPHEADER => ['X-API-Key: va_ANAHTARINIZ'],
]);
$yanit = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($yanit['veri']);
const yanit = await fetch("https://api.veriapi.pro/v1/spor/maclar?lig=super-lig&durum=bitti", {
headers: { "X-API-Key": "va_ANAHTARINIZ" },
});
const { veri, kaynak } = await yanit.json();
console.log(veri);
import requests
r = requests.get("https://api.veriapi.pro/v1/spor/maclar?lig=super-lig&durum=bitti",
headers={"X-API-Key": "va_ANAHTARINIZ"}, timeout=10)
print(r.json()["veri"])
curl -H "X-API-Key: va_ANAHTARINIZ" \ "https://api.veriapi.pro/v1/spor/maclar?lig=super-lig&durum=bitti"
Örnek yanıt
GET https://api.veriapi.pro/v1/spor/maclar?lig=super-lig&durum=bitti — gerçek veriyle; listeler kısaltıldı.
{
"veri": {
"adet": 5,
"maclar": [
{
"id": 1584452,
"lig": "super-lig",
"lig_adi": "Süper Lig",
"sezon": 2026,
"hafta": 10,
"zaman": "2026-11-02T20:00:00+03:00",
"durum": "FT",
"durum_adi": "Bitti",
"dakika": 90,
"ev": {
"id": 997,
"ad": "Gençlerbirliği S.K."
},
"deplasman": {
"id": 996,
"ad": "Alanyaspor"
},
"skor": {
"ev": 5,
"deplasman": 0
},
"ilk_yari": {
"ev": 1,
"deplasman": 0
},
"stadyum": "Eryaman Stadyumu",
"sehir": "Ankara",
"hakem": "Fatih Tokail, Türkiye"
},
{
"id": 1584453,
"lig": "super-lig",
"lig_adi": "Süper Lig",
"sezon": 2026,
"hafta": 10,
"zaman": "2026-11-01T19:00:00+03:00",
"durum": "FT",
"durum_adi": "Bitti",
"dakika": 90,
"ev": {
"id": 1004,
"ad": "Kasımpaşa"
},
"deplasman": {
"id": 549,
"ad": "Beşiktaş"
},
"skor": {
"ev": 2,
"deplasman": 2
},
"ilk_yari": {
"ev": 0,
"deplasman": 1
},
"stadyum": "Recep Tayyip Erdogan Stadium",
"sehir": "Istanbul",
"hakem": "Resat Onur Coskunses, Türkiye"
},
{
"id": 1584449,
"lig": "super-lig",
"lig_adi": "Süper Lig",
"sezon": 2026,
"hafta": 10,
"zaman": "2026-11-01T16:00:00+03:00",
"durum": "FT",
"durum_adi": "Bitti",
"dakika": 90,
"ev": {
"id": 564,
"ad": "Başakşehir"
},
"deplasman": {
"id": 3603,
"ad": "Samsunspor"
},
"skor": {
"ev": 5,
"deplasman": 2
},
"ilk_yari": {
"ev": 3,
"deplasman": 1
},
"stadyum": "Basaksehir Fatih Terim Stadium",
"sehir": "Istanbul",
"hakem": "Ozan Ergun, Türkiye"
},
"… 2 öğe daha"
],
"not": "Kayıtlar 01.11.2026'dan başlar. Saatler Türkiye saatidir."
},
"kaynak": [
{
"kod": "apifootball",
"ad": "API-Football (api-sports.io)",
"lisans": "API-Sports koşulları; yeniden dağıtım için yazılı izin alındı (03.11.2026)",
"atif": "Maç verisi: API-Football (https://www.api-football.com)",
"url": "https://www.api-football.com/"
}
],
"guncelleme": "2026-11-03T09:02:00",
"bayat": false
}
Uçlar ve parametreler
GET /v1/spor/maclar
ücretli paket
2 birim
Futbol: Süper Lig – 3. Lig maç sonuçları, canlı skor ve fikstür
| Parametre | Tür | Açıklama |
|---|---|---|
| lig | metin | Virgülle lig kodları (super-lig, 1-lig, 2-lig, 3-lig-1…) |
| tarih | metin | Gün (YYYY-AA-GG) |
| baslangic | metin | |
| bitis | metin | |
| takim | metin | Takım adının bir kısmı (ör. düzcespor) |
| durum | metin | |
| limit | tam sayı | varsayılan: 200 |
GET /v1/spor/ligler
ücretli paket
2 birim
Desteklenen ligler ve hangi verinin olduğu
Konum alan uçlarda konum (slug), il + ilce (ad, slug ya da plaka) ya da enlem + boylam kullanılabilir.
Tüm parametreler: OpenAPI belgesi.
Nerelerde kullanılır?
- ✓Spor haberlerinde günün sonuçları
- ✓Yerel haber sitesinde şehrin takımının son maçları ve sıradaki maçı
- ✓Taraftar uygulamaları ve bildirimler
Kaynak ve lisans
- API-Football (api-sports.io) · API-Sports koşulları; yeniden dağıtım için yazılı izin alındı (03.11.2026) · kaynak
Atıf: Maç verisi: API-Football (https://www.api-football.com)
Her yanıtın kaynak alanı bu bilgiyi taşır; veriyi gösterdiğiniz yerde atıf metnini yazın.
Sık sorulan sorular
Maç sonuçları ücretsiz pakette var mı?
Hayır; spor uçları Başlangıç ve üstü paketlerdedir (istek başına 2 birim).
Canlı skor anlık mı?
Hayır; oynanan maçlar 15 dakikada bir güncellenir. Saniye saniye canlı skor sunulmaz.
Geçmiş sezonlar var mı?
Hayır; kayıtlar 01.11.2026'dan itibaren tutulur ve her gün birikir.
Bu sayfa şu aramalar için de: süper lig maç sonuçları api · fikstür api · canlı skor json · futbol api türkçe