LiveScoreJSON API Kılavuzu

Genel Bakış

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

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

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

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.

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"]);

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

Hata Kodları

API standart HTTP durum kodları kullanır.

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.

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.

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.

JavaScript SDK

import { LiveScoreJSON } from "./livescorejson.js";
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_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?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?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?competition_id=8&active=yes

get_rounds

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

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_teams

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

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

get_venues

Stadyum bilgilerini döndürür.

get_matches

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

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

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

get_matches_live_updates  Delta

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

# 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

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)

get_match_statistics

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

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_match_extra

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

get_tables

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

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_player_statistics  Gerçek Zamanlı Hesaplama

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

// 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?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.

// Manchester United vs Liverpool
GET /api/get_head2head.php?team1_id=362&team2_id=364

get_rankings

FIFA/UEFA dünya sıralamalarını döndürür.

GET /api/get_rankings.php?year=2026&month=4

get_squads

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

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_career

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

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

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.

GET /api/get_predictions.php?match_id=4350869

get_transfers

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

get_injuries

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

get_suspensions

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

get_players_abroad

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

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

get_referees

Hakem bilgilerini döndürür. Sezon, tur, maç veya bölge bazında.

get_trophies

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

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?season_id=27218