{ "openapi": "3.0.3", "info": { "title": "LiveScoreJSON — Soccer Live Score & Stats API", "description": "Sub-second futbol canlı skor, maç istatistikleri, dizilişler, lig tabloları, head2head, transferler, oyuncu/takım istatistikleri ve daha fazlası. Tüm yanıtlar Opta uyumlu JSON formatındadır. Geçmiş veri 1901'e kadar geriye gider.", "version": "3.0.1", "contact": { "name": "LiveScoreJSON", "url": "https://livescorejson.com", "email": "info@livescorejson.com" }, "termsOfService": "https://livescorejson.com/terms.html", "license": { "name": "Commercial", "url": "https://livescorejson.com/terms.html" } }, "servers": [ { "url": "https://livescorejson.com/api", "description": "Production" } ], "externalDocs": { "description": "Tam dokümantasyon ve kod örnekleri", "url": "https://livescorejson.com/docs/en.html" }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "tags": [ { "name": "LiveScoreJSON", "description": "Tüm endpoint'ler aynı zarf yapısını döndürür." } ], "paths": { "/get_areas.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Bölge/ülke listesi", "description": "API: get_areas — Bölge/ülke listesi\nParametreler: area_id (opsiyonel), lang (opsiyonel, varsayılan: en)", "operationId": "get_areas", "parameters": [ { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Dil kodu (en/tr/es/de/fr vb.) — varsayılan: en" }, { "name": "area_id", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "examples": { "Example_1": { "summary": "Basarili yanit", "value": { "version": "3.0", "sport": "soccer", "lang": "en", "last_generated": "2026-06-22 12:02:57", "method": { "method_id": "1", "name": "get_areas", "parameter": [ { "name": "area_id", "value": "1" }, { "name": "lang", "value": "en" } ] }, "data": { "area": [ { "area_id": "1", "name": "World", "parent_area_id": null, "countrycode": null, "last_updated": "2026-04-13 10:22:45" } ] } } } } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_competitions.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Lig/kupa listesi", "description": "API: get_competitions — Lig/kupa listesi\nParametreler: area_id (opsiyonel), type (opsiyonel), lang (opsiyonel)", "operationId": "get_competitions", "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Dil kodu (en/tr/es/de/fr vb.) — varsayılan: en" }, { "name": "area_id", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "examples": { "Example_1": { "summary": "Basarili yanit", "value": { "version": "3.0", "sport": "soccer", "lang": "en", "last_generated": "2026-06-22 12:02:57", "method": { "method_id": "3", "name": "get_competitions", "parameter": [ { "name": "area_id", "value": "1" }, { "name": "lang", "value": "en" } ] }, "data": { "competition": [ { "competition_id": "72", "area_id": "1", "name": "FIFA World Cup", "teamtype": "default", "display_order": "1", "type": "international", "format": null, "countrycode": null, "ow_competition_id": "4", "last_updated": "2026-06-22 05:12:27", "soccertype": "default", "area_name": "World" }, { "competition_id": "221", "area_id": "1", "name": "Olympics Men", "teamtype": "youth", "display_order": "20", "type": "international", "format": "International cup", "countrycode": null, "ow_competition_id": "378", "last_updated": "2026-06-17 07:52:41", "soccertype": "youth", "area_name": "World" } ] } } } } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_seasons.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Sezon listesi", "description": "API: get_seasons — Sezon listesi\nParametreler: competition_id (opsiyonel), active (opsiyonel: yes/no)", "operationId": "get_seasons", "parameters": [ { "name": "active", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "competition_id", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "examples": { "Example_1": { "summary": "Basarili yanit", "value": { "version": "3.0", "sport": "soccer", "lang": "en", "last_generated": "2026-06-22 12:02:57", "method": { "method_id": "4", "name": "get_seasons", "parameter": [ { "name": "competition_id", "value": "732" }, { "name": "lang", "value": "en" } ] }, "data": { "competition": [ { "competition_id": "732", "ow_competition_id": "34", "name": "Club Friendlies", "soccertype": "default", "teamtype": "default", "display_order": "210", "type": "club", "format": "", "area_id": "1", "countrycode": "", "area_name": "World", "last_updated": "2026-06-21 23:30:34", "season": [ { "season_id": "27685", "name": "2026", "start_date": "2026-01-01", "end_date": "2026-12-31", "last_updated": "2026-06-21 23:30:34", "service_level": "0" }, { "season_id": "25828", "name": "2025", "start_date": "2025-01-01", "end_date": "2025-12-31", "last_updated": "2026-06-21 23:30:34", "service_level": "0" } ] } ] } } } } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_rounds.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Tur/hafta listesi", "description": "API: get_rounds — Tur/hafta listesi\nParametreler: season_id (zorunlu)", "operationId": "get_rounds", "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" }, { "name": "season_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "id", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "examples": { "Example_1": { "summary": "Basarili yanit", "value": { "version": "3.0", "sport": "soccer", "lang": "en", "last_generated": "2026-06-22 12:02:57", "method": { "method_id": "5", "name": "get_rounds", "parameter": [ { "name": "season_id", "value": "25828" }, { "name": "lang", "value": "en" } ] }, "data": { "competition": [ { "competition_id": "732", "season": [ { "season_id": "25828", "name": "2025", "round": [ "...", "..." ] } ] } ] } } } } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_groups.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Grup listesi", "description": "API: get_groups — Grup listesi\nParametreler: round_id (zorunlu) veya season_id", "operationId": "get_groups", "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" }, { "name": "round_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "season_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "id", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_season_coverage.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Sezon kapsam haritası", "description": "API: get_season_coverage — Sezon kapsam haritası\nParametreler: season_id (zorunlu)\nDöndürür: bu sezonda hangi veri yeteneklerinin (skor, kadro, kart, transfer...) mevcut\nolduğu, zamanlaması (maç öncesi/sonrası/canlı) ve güncelleme sıklığı.\nAlıcı entegrasyondan önce bir sezonda neyin kapsandığını görebilir (şeffaflık).", "operationId": "get_season_coverage", "parameters": [ { "name": "season_id", "in": "query", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "examples": { "Example_1": { "summary": "Basarili yanit", "value": { "version": "3.0", "sport": "soccer", "lang": "en", "last_generated": "2026-06-22 12:02:59", "method": { "method_id": "0", "name": "get_season_coverage", "parameter": [ { "name": "season_id", "value": "25828" }, { "name": "lang", "value": "en" } ] }, "data": { "season_coverage": { "season_id": "25828", "capabilities": [ { "capability": "assists", "available": false, "timing": "Not available", "update_interval_minutes": null }, { "capability": "attendance", "available": false, "timing": "Not available", "update_interval_minutes": 1440 } ] } } } } } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_teams.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Takım bilgileri", "description": "API: get_teams — Takım bilgileri\nParametreler: type (area/season/competition), id, team_id (tek takım)", "operationId": "get_teams", "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" }, { "name": "team_id", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_squads.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Kadro listeleri", "description": "API: get_squads — Kadro listeleri\nParametreler: type (season, zorunlu), id (season_id, zorunlu), team_id (opsiyonel)", "operationId": "get_squads", "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" }, { "name": "team_id", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_squads_changes.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Kadro değişiklikleri (delta)", "description": "API: get_squads_changes — Kadro değişiklikleri (delta)\nParametreler: type (match/season, zorunlu), id (zorunlu), last_updated (opsiyonel)\nNEDEN: upstream feed'e proxy yerine team_persons tablosundan last_updated ile delta sorgusu.", "operationId": "get_squads_changes", "parameters": [ { "name": "type", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" }, { "name": "id", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" }, { "name": "last_updated", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_venues.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Stadyum bilgileri", "description": "API: get_venues — Stadyum bilgileri\nParametreler: type (area/season), id, venue_id (tek stadyum)", "operationId": "get_venues", "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" }, { "name": "id", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" }, { "name": "venue_id", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_referees.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Hakem bilgileri", "description": "API: get_referees — Hakem bilgileri\nParametreler: type (season/round/match/referee/area), id (zorunlu)\nNEDEN: upstream feed season/round/match_id/referee destekler. area bizim ek filtremiz.", "operationId": "get_referees", "parameters": [ { "name": "type", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" }, { "name": "id", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_matches.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Maçlar + olaylar", "description": "API: get_matches — Maçlar + olaylar\nParametreler: type (area/season/round/group/match/team), id (zorunlu),\nstart_date, end_date, detailed (yes/no), home_only, away_only", "operationId": "get_matches", "parameters": [ { "name": "type", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" }, { "name": "id", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" }, { "name": "start_date", "in": "query", "required": false, "schema": { "type": "string" }, "description": "YYYY-MM-DD başlangıç tarihi" }, { "name": "end_date", "in": "query", "required": false, "schema": { "type": "string" }, "description": "YYYY-MM-DD bitiş tarihi" }, { "name": "detailed", "in": "query", "required": false, "schema": { "type": "string" }, "description": "yes/no — olayları ve detayları döndür" }, { "name": "home_only", "in": "query", "required": false, "schema": { "type": "string" }, "description": "yes — sadece ev sahibi maçları" }, { "name": "away_only", "in": "query", "required": false, "schema": { "type": "string" }, "description": "yes — sadece deplasman maçları" }, { "name": "iddaa", "in": "query", "required": false, "schema": { "type": "string" }, "description": "yes — iddaa oranlarını ekle" } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "examples": { "Example_1": { "summary": "Basarili yanit", "value": { "version": "3.0", "sport": "soccer", "lang": "en", "last_generated": "2026-06-22 12:02:57", "method": { "method_id": "2", "name": "get_matches", "parameter": [ { "name": "type", "value": "season" }, { "name": "id", "value": "25393" } ] }, "data": { "competition": [ { "competition_id": "1562", "ow_competition_id": "861", "name": "Play-offs 2/3", "soccertype": "default", "teamtype": "default", "display_order": "310", "type": "club", "format": "Domestic cup", "area_id": "156", "countrycode": "PRT", "area_name": "Portugal", "last_updated": "2026-06-01 13:49:34", "season": [ { "season_id": "25393", "name": "2024/2025", "start_date": "2025-05-24", "end_date": "2025-06-01", "last_updated": "2026-05-18 12:19:33", "service_level": "0", "round": [ "..." ] } ] } ] } } } } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_matches_live.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Bugünün canlı maçları", "description": "API: get_matches_live — Bugünün canlı maçları\nParametreler: date (opt), detailed (yes/no), now_playing (yes),\nmatchtype (live/fixture/all)\nNEDEN: Canlı maçlar live_sync.php ile 30sn aralıklarla DB'ye yazılır.\nBu endpoint sadece DB'den okur, on-demand sync yapmaz.", "operationId": "get_matches_live", "parameters": [ { "name": "date", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "detailed", "in": "query", "required": false, "schema": { "type": "string" }, "description": "yes/no — olayları ve detayları döndür" }, { "name": "now_playing", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "matchtype", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "iddaa", "in": "query", "required": false, "schema": { "type": "string" }, "description": "yes — iddaa oranlarını ekle" } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "examples": { "Example_1": { "summary": "Basarili yanit", "value": { "version": "3.0", "sport": "soccer", "lang": "en", "last_generated": "2026-06-22 12:02:57", "method": { "method_id": "11", "name": "get_matches_live", "parameter": [ { "name": "date", "value": "2025-12-30" }, { "name": "lang", "value": "en" } ] }, "data": { "competition": [ { "competition_id": "732", "ow_competition_id": "34", "name": "Club Friendlies", "soccertype": "default", "teamtype": "default", "display_order": "210", "type": "club", "format": "", "area_id": "1", "countrycode": "", "area_name": "World", "last_updated": "2026-06-21 23:30:34", "season": [ { "season_id": "25828", "name": "2025", "start_date": "2025-01-01", "end_date": "2025-12-31", "last_updated": "2026-06-21 23:30:34", "service_level": "0", "round": [ "...", "..." ] } ] }, { "competition_id": "477", "ow_competition_id": "", "name": "Premier League", "soccertype": "default", "teamtype": "default", "display_order": "10", "type": "club", "format": "Domestic league", "area_id": "101", "countrycode": "JAM", "area_name": "Jamaica", "last_updated": "2026-05-29 14:02:04", "season": [ { "season_id": "27128", "name": "2025/2026", "start_date": "2025-08-24", "end_date": "2026-05-25", "last_updated": "2026-05-29 14:01:51", "service_level": "0", "round": [ "..." ] } ] } ] } } } } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_matches_live_updates.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Son güncellenen maçlar (delta)", "description": "API: get_matches_live_updates — Son güncellenen maçlar (delta)\nParametreler: last_updated (zorunlu, 'yyyy-mm-dd hh:mm:ss')\nNEDEN: Client'ın son aldığı zaman damgasından bu yana değişen maçları döndürür.\nDB'deki last_updated sütununa göre filtreler.", "operationId": "get_matches_live_updates", "parameters": [ { "name": "last_updated", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_match_statistics.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Maç istatistikleri (on-demand)", "description": "API: get_match_statistics — Maç istatistikleri (on-demand)\nParametreler: id (match_id, zorunlu)", "operationId": "get_match_statistics", "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "examples": { "Example_1": { "summary": "Basarili yanit", "value": { "version": "3.0", "sport": "soccer", "lang": "en", "last_generated": "2026-06-22 12:02:57", "method": { "method_id": "20", "name": "get_match_statistics", "parameter": [ { "name": "id", "value": "4891367" }, { "name": "lang", "value": "en" } ] }, "data": { "competition": [ { "competition_id": "732", "ow_competition_id": "34", "name": "Club Friendlies", "soccertype": "default", "teamtype": "default", "display_order": "210", "type": "club", "format": "", "area_id": "1", "countrycode": "", "area_name": "World", "last_updated": "2026-06-21 23:30:34", "season": [ { "season_id": "25828", "name": "2025", "start_date": "2025-01-01", "end_date": "2025-12-31", "last_updated": "2026-06-21 23:30:34", "service_level": "0", "round": [ "..." ] } ] } ] } } } } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_match_formations.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Maç dizilişleri (on-demand)", "description": "API: get_match_formations — Maç dizilişleri (on-demand)\nParametreler: id (match_id, zorunlu)", "operationId": "get_match_formations", "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "examples": { "Example_1": { "summary": "Basarili yanit", "value": { "version": "3.0", "sport": "soccer", "lang": "en", "last_generated": "2026-06-22 12:02:58", "method": { "method_id": "36", "name": "get_match_formations", "parameter": [ { "name": "id", "value": "4891367" }, { "name": "lang", "value": "en" } ] }, "data": { "competition": [ { "competition_id": "732", "ow_competition_id": "34", "name": "Club Friendlies", "soccertype": "default", "teamtype": "default", "display_order": "210", "type": "club", "format": "", "area_id": "1", "countrycode": "", "area_name": "World", "last_updated": "2026-06-21 23:30:34", "season": [ { "season_id": "25828", "name": "2025", "start_date": "2025-01-01", "end_date": "2025-12-31", "last_updated": "2026-06-21 23:30:34", "service_level": "0", "round": [ "..." ] } ] } ] } } } } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_match_commentary.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Maç yorumları (on-demand)", "description": "API: get_match_commentary — Maç yorumları (on-demand)\nParametreler: id (match_id, zorunlu)", "operationId": "get_match_commentary", "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "examples": { "Example_1": { "summary": "Basarili yanit", "value": { "version": "3.0", "sport": "soccer", "lang": "en", "last_generated": "2026-06-22 12:02:58", "method": { "method_id": "19", "name": "get_match_commentary", "parameter": [ { "name": "id", "value": "4891367" }, { "name": "lang", "value": "en" } ] }, "data": { "competition": [ { "competition_id": "732", "ow_competition_id": "34", "name": "Club Friendlies", "soccertype": "default", "teamtype": "default", "display_order": "210", "type": "club", "format": "", "area_id": "1", "countrycode": "", "area_name": "World", "last_updated": "2026-06-21 23:30:34", "season": [ { "season_id": "25828", "name": "2025", "start_date": "2025-01-01", "end_date": "2025-12-31", "last_updated": "2026-06-21 23:30:34", "service_level": "0", "round": [ "..." ] } ] } ] } } } } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_match_extra.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Maç ekstra bilgileri (deprecated ama uyumluluk için)", "description": "API: get_match_extra — Maç ekstra bilgileri (deprecated ama uyumluluk için)\nParametreler: id (match_id)\nNEDEN: upstream feed deprecated olarak işaretlemiş ama bazı client'lar hâlâ kullanıyor olabilir.\nmatch_info tablosundan döndürür.", "operationId": "get_match_extra", "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "examples": { "Example_1": { "summary": "Basarili yanit", "value": { "version": "3.0", "sport": "soccer", "lang": "en", "last_generated": "2026-06-22 12:02:58", "method": { "method_id": "35", "name": "get_match_extra", "parameter": [ { "name": "id", "value": "4891367" }, { "name": "lang", "value": "en" } ] }, "data": { "match_extra": { "match_id": "4891367", "venue_id": "12820", "referee_person_id": null, "referee_name": null, "assistant_referee_1_id": null, "assistant_referee_1_name": null, "assistant_referee_2_id": null, "assistant_referee_2_name": null, "fourth_official_id": null, "fourth_official_name": null, "coach_a_id": null, "coach_a_name": null, "coach_b_id": null, "coach_b_name": null, "attendance": null, "last_updated": "2026-06-22 12:02:57", "formation_a": null, "formation_b": null, "venue_name": "Estádio Paulo Barreto de Menezes", "venue_city": "Lagarto, Sergipe", "venue_capacity": null } } } } } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_match_editorials.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Maç editöryal yazıları", "description": "API: get_match_editorials — Maç editöryal yazıları\nParametreler: id (match_id, zorunlu), lang (opsiyonel, varsayılan 'en')\nNEDEN: match_editorials tablosu mevcut ancak henüz sync fonksiyonu yok.\nŞimdilik upstream feed'e proxy yapılır.", "operationId": "get_match_editorials", "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Dil kodu (en/tr/es/de/fr vb.) — varsayılan: en" } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_tables.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Puan tabloları", "description": "API: get_tables — Puan tabloları\nParametreler: type (season/round), id (zorunlu), group_id (opsiyonel)", "operationId": "get_tables", "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" }, { "name": "group_id", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "examples": { "Example_1": { "summary": "Basarili yanit", "value": { "version": "3.0", "sport": "soccer", "lang": "en", "last_generated": "2026-06-22 12:03:59", "method": { "method_id": "12", "name": "get_tables", "parameter": [ { "name": "type", "value": "season" }, { "name": "id", "value": "27218" } ] }, "data": { "competition": [ { "competition_id": "1914", "ow_competition_id": "", "name": "Autonómicas", "soccertype": "default", "teamtype": "default", "display_order": "50", "type": "club", "format": "", "area_id": "176", "countrycode": "ESP", "area_name": "Spain", "last_updated": "2026-06-22 00:25:22", "season": [ { "season_id": "27218", "name": "2025/2026", "start_date": "2025-08-22", "end_date": "2026-06-22", "last_updated": "2026-06-22 00:25:22", "service_level": "0", "round": [ "...", "..." ] } ] } ] } } } } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_tables_live.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Canlı puan tablosu", "description": "API: get_tables_live — Canlı puan tablosu\nParametreler: type (season/round), id (zorunlu)\nNEDEN: standings tablosundan okuruz. Canlı güncelleme live_sync ile yapılır.", "operationId": "get_tables_live", "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "examples": { "Example_1": { "summary": "Basarili yanit", "value": { "version": "3.0", "sport": "soccer", "lang": "en", "last_generated": "2026-06-22 12:03:59", "method": { "method_id": "38", "name": "get_tables_live", "parameter": [ { "name": "type", "value": "season" }, { "name": "id", "value": "27218" } ] }, "data": { "competition": [ { "competition_id": "1914", "ow_competition_id": "", "name": "Autonómicas", "soccertype": "default", "teamtype": "default", "display_order": "50", "type": "club", "format": "", "area_id": "176", "countrycode": "ESP", "area_name": "Spain", "last_updated": "2026-06-22 00:25:22", "season": [ { "season_id": "27218", "name": "2025/2026", "start_date": "2025-08-22", "end_date": "2026-06-22", "last_updated": "2026-06-22 00:25:22", "service_level": "0", "round": [ "...", "..." ] } ] } ] } } } } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_tables_cumulative.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Kümülatif puan tabloları", "description": "API: get_tables_cumulative — Kümülatif puan tabloları\nParametreler: type (season), id (zorunlu)\nNEDEN: standings tablosundan table_type='cumulative' veya tüm round'ların gösterilmesi.", "operationId": "get_tables_cumulative", "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "examples": { "Example_1": { "summary": "Basarili yanit", "value": { "version": "3.0", "sport": "soccer", "lang": "en", "last_generated": "2026-06-22 12:03:59", "method": { "method_id": "26", "name": "get_tables_cumulative", "parameter": [ { "name": "type", "value": "season" }, { "name": "id", "value": "27218" } ] }, "data": { "competition": [ { "competition_id": "1914", "ow_competition_id": "", "name": "Autonómicas", "soccertype": "default", "teamtype": "default", "display_order": "50", "type": "club", "format": "", "area_id": "176", "countrycode": "ESP", "area_name": "Spain", "last_updated": "2026-06-22 00:25:22", "season": [ { "season_id": "27218", "name": "2025/2026", "start_date": "2025-08-22", "end_date": "2026-06-22", "last_updated": "2026-06-22 00:25:22", "service_level": "0", "round": [ "...", "..." ] } ] } ] } } } } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_head2head.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "API: get_head2head — İki takım karşılaştırması (tamamen yerel hesaplama)", "description": "API: get_head2head — İki takım karşılaştırması (tamamen yerel hesaplama)\nParametreler: team_A_id/team1_id (zorunlu), team_B_id/team2_id (zorunlu),\ncompetition_id (opt), start_date (opt), end_date (opt)\nNEDEN tablo yok: matches tablosu yeterli, cache gereksiz — sorgu hafif.", "operationId": "get_head2head", "parameters": [ { "name": "team1_id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "team2_id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "team_A_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "team_B_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start_date", "in": "query", "required": false, "schema": { "type": "string" }, "description": "YYYY-MM-DD başlangıç tarihi" }, { "name": "end_date", "in": "query", "required": false, "schema": { "type": "string" }, "description": "YYYY-MM-DD bitiş tarihi" }, { "name": "competition_id", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "examples": { "Example_1": { "summary": "Basarili yanit", "value": { "version": "3.0", "sport": "soccer", "lang": "en", "last_generated": "2026-06-22 12:02:59", "method": { "method_id": "42", "name": "get_head2head", "parameter": [ { "name": "team1_id", "value": "20757" }, { "name": "team2_id", "value": "6294" } ] }, "data": { "head2head": { "team_A_id": "20757", "team_B_id": "6294", "team_A_name": "Lagarto", "team_B_name": "CSA", "ow_team_A_id": "9713", "ow_team_B_id": "9631", "total": "3", "wins_A": "1", "wins_B": "0", "draws": "2", "tables": { "total": [ { "team_id": "20757", "matches_total": "3", "matches_won": "1", "matches_draw": "1", "matches_lost": "1", "goals_pro": "2", "goals_against": "1", "home_matches": "2", "away_matches": "1", "goals_diff": "1", "points": "4", "rank": "1" }, { "team_id": "6294", "matches_total": "3", "matches_won": "0", "matches_draw": "1", "matches_lost": "2", "goals_pro": "1", "goals_against": "2", "home_matches": "1", "away_matches": "2", "goals_diff": "-1", "points": "1", "rank": "2" } ], "home": [ { "team_id": "20757", "matches_total": "2", "matches_won": "1", "matches_draw": "1", "matches_lost": "0", "goals_pro": "2", "goals_against": "1", "home_matches": "2", "away_matches": "0", "goals_diff": "1", "points": "4", "rank": "1" }, { "team_id": "6294", "matches_total": "1", "matches_won": "0", "matches_draw": "0", "matches_lost": "1", "goals_pro": "0", "goals_against": "0", "home_matches": "1", "away_matches": "0", "goals_diff": "0", "points": "0", "rank": "2" } ], "away": [ { "team_id": "20757", "matches_total": "1", "matches_won": "0", "matches_draw": "0", "matches_lost": "1", "goals_pro": "0", "goals_against": "0", "home_matches": "0", "away_matches": "1", "goals_diff": "0", "points": "0", "rank": "2" }, { "team_id": "6294", "matches_total": "2", "matches_won": "0", "matches_draw": "1", "matches_lost": "1", "goals_pro": "1", "goals_against": "2", "home_matches": "0", "away_matches": "2", "goals_diff": "-1", "points": "1", "rank": "1" } ] }, "match": [ { "match_id": "4974178", "round_id": "91327", "group_id": null, "team_A_id": "6294", "team_B_id": "20757", "date_utc": "2026-06-27", "time_utc": "20:00:00", "date_london": "2026-06-27", "time_london": "21:00:00", "status": "Fixture", "gameweek": null, "winner": "yet unknown", "fs_A": null, "fs_B": null, "hts_A": null, "hts_B": null, "ets_A": null, "ets_B": null, "ps_A": null, "ps_B": null, "p1s_A": null, "p1s_B": null, "p2s_A": null, "p2s_B": null, "sds_A": null, "sds_B": null, "pts_A": null, "pts_B": null, "minute": null, "minute_extra": null, "match_period": null, "time_unknown": null, "ow_match_id": null, "last_updated": "2026-06-16 10:29:37", "team_A_name": "CSA", "team_B_name": "Lagarto", "ow_team_A_id": "9631", "ow_team_B_id": "9713", "team_A_country": null, "team_B_country": null }, { "match_id": "4974177", "round_id": "91327", "group_id": null, "team_A_id": "20757", "team_B_id": "6294", "date_utc": "2026-06-21", "time_utc": "19:00:00", "date_london": "2026-06-21", "time_london": "20:00:00", "status": "Played", "gameweek": null, "winner": "draw", "fs_A": "1", "fs_B": "1", "hts_A": "0", "hts_B": "1", "ets_A": null, "ets_B": null, "ps_A": null, "ps_B": null, "p1s_A": null, "p1s_B": null, "p2s_A": null, "p2s_B": null, "sds_A": null, "sds_B": null, "pts_A": null, "pts_B": null, "minute": null, "minute_extra": null, "match_period": null, "time_unknown": null, "ow_match_id": null, "last_updated": "2026-06-21 22:57:22", "team_A_name": "Lagarto", "team_B_name": "CSA", "ow_team_A_id": "9713", "ow_team_B_id": "9631", "team_A_country": null, "team_B_country": null } ] } } } } } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_predictions.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "İstatistiksel maç tahmini", "description": "API: get_predictions — İstatistiksel maç tahmini\nParametreler: match_id (zorunlu)\nDöndürür: 1X2 / alt-üst 2.5 / KG (BTTS) olasılıkları + olası skorlar + model gol beklentisi.\nNEDEN: Kendi Poisson form modelimiz (lib/predict.php) — son form + lig ev/dep ortalaması.\nxG/ML DEĞİL (xG verimiz yok). Bilgilendirme amaçlıdır, bahis tavsiyesi değildir.", "operationId": "get_predictions", "parameters": [ { "name": "match_id", "in": "query", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "examples": { "Example_1": { "summary": "Basarili yanit", "value": { "version": "3.0", "sport": "soccer", "lang": "en", "last_generated": "2026-06-22 12:02:59", "method": { "method_id": "0", "name": "get_predictions", "parameter": [ { "name": "match_id", "value": "4891367" }, { "name": "lang", "value": "en" } ] }, "data": { "prediction": { "match_id": "4891367", "team_A_id": "20757", "team_B_id": "6294", "team_A_name": "Lagarto", "team_B_name": "CSA", "date": "2025-12-30", "model": "statistical_poisson_form", "disclaimer": "LiveScoreJSON kendi istatistiksel modeli (Poisson, son form). Tahmindir; bahis tavsiyesi degildir.", "projected_goals": { "home": 1.1, "away": 0.55 }, "result": { "home_win": 0.49, "draw": 0.3267, "away_win": 0.1833 }, "over_under_2_5": { "over": 0.2302, "under": 0.7698 }, "btts": { "yes": 0.2826, "no": 0.7174 }, "likely_scores": [ { "score": "1-0", "probability": 0.2112 }, { "score": "0-0", "probability": 0.1917 } ], "form_window": { "home_matches": 10, "away_matches": 10 } } } } } } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_transfers.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Transfer listesi", "description": "API: get_transfers — Transfer listesi\nParametreler: type (person/team/season/player), id (zorunlu), limit (opt), offset (opt)\nNEDEN: upstream feed type=person kullanır, geriye uyum için player da kabul ediyoruz.", "operationId": "get_transfers", "parameters": [ { "name": "type", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" }, { "name": "id", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_players_abroad.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Yurtdışında oynayan oyuncular", "description": "API: get_players_abroad — Yurtdışında oynayan oyuncular\nParametreler: id (area_id, zorunlu), type (area, opsiyonel), date (opsiyonel)", "operationId": "get_players_abroad", "parameters": [ { "name": "area_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_career.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Oyuncu/Takım kariyer geçmişi", "description": "API: get_career — Oyuncu/Takım kariyer geçmişi\nParametreler: type (player/team, zorunlu), id (zorunlu)", "operationId": "get_career", "parameters": [ { "name": "type", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" }, { "name": "id", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "examples": { "Example_1": { "summary": "Basarili yanit", "value": { "version": "3.0", "sport": "soccer", "lang": "en", "last_generated": "2026-06-22 12:02:59", "method": { "method_id": "16", "name": "get_career", "parameter": [ { "name": "type", "value": "player" }, { "name": "id", "value": "13928" } ] }, "data": { "person": { "person_id": "13928", "career": [ { "id": "28827", "season_id": "27905", "competition_id": "454", "appearances": "3", "goals": "0", "assists": "0", "minutes_played": "259", "yellow_cards": "1", "red_cards": "0", "substituted_in": "0", "last_updated": "2026-04-14 19:24:33.530063", "team_name": "Bartolomé Mitre", "competition_name": "Torneo Federal A", "season_name": "2026" }, { "id": "28828", "season_id": "26101", "competition_id": "454", "appearances": "21", "goals": "0", "assists": "0", "minutes_played": "1851", "yellow_cards": "3", "red_cards": "0", "substituted_in": "0", "last_updated": "2026-04-14 19:24:33.53123", "team_name": "Bartolomé Mitre", "competition_name": "Torneo Federal A", "season_name": "2025" } ] } } } } } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_player_statistics.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Oyuncu istatistikleri (inline hesaplama)", "description": "API: get_player_statistics — Oyuncu istatistikleri (inline hesaplama)\nplayer_statistics tablosu kullanmaz; doğrudan match_events'ten hesaplar.\nParametreler: type (season/round), id (zorunlu), team_id (opt), player_id (opt), limit (opt)", "operationId": "get_player_statistics", "parameters": [ { "name": "type", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" }, { "name": "id", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" }, { "name": "team_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "player_id", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_team_statistics.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Takım istatistikleri", "description": "API: get_team_statistics — Takım istatistikleri\nParametreler: team_id (zorunlu), season_id (opsiyonel), form (opsiyonel)\nNEDEN: upstream feed sadece team_id zorunlu parametresi bekler, type/id değil.", "operationId": "get_team_statistics", "parameters": [ { "name": "team_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "form", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "season_id", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "examples": { "Example_1": { "summary": "Basarili yanit", "value": { "version": "3.0", "sport": "soccer", "lang": "en", "last_generated": "2026-06-22 12:02:59", "method": { "method_id": "14", "name": "get_team_statistics", "parameter": [ { "name": "team_id", "value": "20757" }, { "name": "lang", "value": "en" } ] }, "data": { "team_statistic": [ { "id": "2879686", "team_id": "20757", "season_id": "27549", "stat_type": "away_clean_sheets", "stat_value": "1", "last_updated": "2026-06-21 22:58:25", "team_name": "Lagarto" }, { "id": "2879685", "team_id": "20757", "season_id": "27549", "stat_type": "away_draw_percent", "stat_value": "60", "last_updated": "2026-06-21 22:58:25", "team_name": "Lagarto" } ] } } } } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_injuries.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Sakatlık listesi", "description": "API: get_injuries — Sakatlık listesi\nParametreler: type (season/round/team/competition/player/match), id (zorunlu)", "operationId": "get_injuries", "parameters": [ { "name": "type", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" }, { "name": "id", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_suspensions.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Cezalı oyuncular", "description": "API: get_suspensions — Cezalı oyuncular\nParametreler: id (zorunlu), type (opsiyonel: match/player/season/team)", "operationId": "get_suspensions", "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_trophies.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Kupa/ödül listesi", "description": "API: get_trophies — Kupa/ödül listesi\nParametreler: type (competition/season/team/player), id", "operationId": "get_trophies", "parameters": [ { "name": "type", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" }, { "name": "id", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "examples": { "Example_1": { "summary": "Basarili yanit", "value": { "version": "3.0", "sport": "soccer", "lang": "en", "last_generated": "2026-06-22 12:02:59", "method": { "method_id": "39", "name": "get_trophies", "parameter": [ { "name": "type", "value": "team" }, { "name": "id", "value": "20757" } ] }, "data": { "trophy": [ { "id": "1020280", "competition_id": "402", "season_id": "19297", "team_id": "20757", "person_id": null, "trophy_type": "Brazil", "position": "2", "last_updated": "2026-04-03 03:54:35", "team_name": "Lagarto", "person_name": null, "competition_name": "Sergipano 1", "season_name": "2021" } ] } } } } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_rankings.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "FIFA/UEFA sıralamaları", "description": "API: get_rankings — FIFA/UEFA sıralamaları\nParametreler: type (opsiyonel), year (opsiyonel), month (opsiyonel)", "operationId": "get_rankings", "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" }, { "name": "year", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "month", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "examples": { "Example_1": { "summary": "Basarili yanit", "value": { "version": "3.0", "sport": "soccer", "lang": "en", "last_generated": "2026-06-22 12:02:59", "method": { "method_id": "15", "name": "get_rankings", "parameter": [ { "name": "area_id", "value": "1" }, { "name": "lang", "value": "en" } ] }, "data": { "ranking": [ { "id": "100734", "area_id": "176", "team_id": "2137", "rank": "1", "points": "1877.18", "ranking_type": "fifa", "ranking_date": "2026-01-01", "last_updated": null, "team_name": "Spain", "area_name": "Spain" }, { "id": "100735", "area_id": "16", "team_id": "132", "rank": "2", "points": "1873.33", "ranking_type": "fifa", "ranking_date": "2026-01-01", "last_updated": null, "team_name": "Argentina", "area_name": "Argentina" } ] } } } } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_deleted.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Silinen kayıtlar", "description": "API: get_deleted — Silinen kayıtlar\nParametreler: start_date (opsiyonel, varsayılan son 24h), type (opsiyonel)", "operationId": "get_deleted", "parameters": [ { "name": "start_date", "in": "query", "required": false, "schema": { "type": "string" }, "description": "YYYY-MM-DD başlangıç tarihi" }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_betting_statistics.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Bahis istatistikleri", "description": "API: get_betting_statistics — Bahis istatistikleri\nParametreler: type (season), id (zorunlu), market (opsiyonel)\nBu veri sezon bazlı aggregate olduğu için type=season destekleniyor.", "operationId": "get_betting_statistics", "parameters": [ { "name": "type", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" }, { "name": "id", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "examples": { "Example_1": { "summary": "Basarili yanit", "value": { "version": "3.0", "sport": "soccer", "lang": "en", "last_generated": "2026-06-22 12:02:59", "method": { "method_id": "18", "name": "get_betting_statistics", "parameter": [ { "name": "type", "value": "season" }, { "name": "id", "value": "25828" } ] }, "data": { "betting_statistic": [ { "season_id": "25828", "market": "correct_score", "category_code": "2h", "subcategory_code": "total", "outcome_code": "0-0", "outcome_value": "29", "outcome_percentage": "18" }, { "season_id": "25828", "market": "correct_score", "category_code": "2h", "subcategory_code": "total", "outcome_code": "0-1", "outcome_value": "13", "outcome_percentage": "8" } ] } } } } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_runningball_matches.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Devam eden maçlar (şu an oynanıyor)", "description": "API: get_runningball_matches — Devam eden maçlar (şu an oynanıyor)\nParametreler: yok (veya date opsiyonel)\nNEDEN: status='Playing' olan maçlar. live_sync ile 30sn'de bir güncellenir.", "operationId": "get_runningball_matches", "parameters": [ { "name": "date", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_hashtags.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "Hashtag listesi", "description": "API: get_hashtags — Hashtag listesi\nParametreler: type (competition/team/match), id (zorunlu)", "operationId": "get_hashtags", "parameters": [ { "name": "type", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Filtre türü (örn. area/season/round/group/match/team)" }, { "name": "id", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "Filtre kimliği (type ile birlikte kullanılır)" } ], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } }, "/get_ws_token.php": { "get": { "tags": [ "LiveScoreJSON" ], "summary": "WebSocket token endpoint.", "description": "WebSocket token endpoint.\nNEDEN: Client (web/android) önce HTTPS ile buradan token alır,\nsonra WSS bağlantısını bu token ile kurar. Credential'lar asla WS üzerinden geçmez.\nKullanım: GET /v3/api/get_ws_token.php\nHeader: Authorization: Bearer ljson_live_...\nYanıt: {\"token\": \"...\", \"expires_at\": \"2026-04-20T...\", \"ws_url\": \"wss://...\"}", "operationId": "get_ws_token", "parameters": [], "responses": { "200": { "description": "Başarılı yanıt (Opta uyumlu JSON zarfı)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, "401": { "description": "Kimlik doğrulama hatası" }, "403": { "description": "Yetkisiz veya plan kapsamı dışı" }, "429": { "description": "Rate limit / kota aşıldı" } } } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "description": "Doğrudan/portal müşterileri: \"Authorization: Bearer ljson_live_...\". RapidAPI üzerinden gelenlerde GEREKMEZ — RapidAPI proxy kimliği otomatik enjekte eder." }, "apiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-API-Key", "description": "Bearer alternatifi (doğrudan/portal kanalı)." } }, "schemas": { "ApiResponse": { "type": "object", "properties": { "version": { "type": "string", "example": "3.0", "description": "API sürümü" }, "sport": { "type": "string", "example": "soccer", "description": "Her zaman \"soccer\"" }, "lang": { "type": "string", "example": "en", "description": "Yanıt dili (en/tr/es/de/fr)" }, "last_generated": { "type": "string", "example": "2026-04-16 12:34:56", "description": "Yanıtın üretildiği an (Europe/Istanbul +03:00, YYYY-MM-DD HH:MM:SS)" }, "method": { "type": "object", "description": "Çağrılan metot ve gönderilen parametreler", "properties": { "method_id": { "type": "integer", "example": 2 }, "name": { "type": "string", "example": "get_matches" }, "parameter": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "example": "type" }, "value": { "type": "string", "example": "season" } } } } } }, "data": { "type": "object", "description": "Endpoint'e göre değişen veri nesnesi (competition/area/team vb.)" } }, "example": { "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": [] } } } } } }