Futbol API – Canlı Skor ve İstatistikler Football API – Live Scores and Statistics

Bu API, maç sonuçları, canlı skorlar, bahis oranları ve detaylı oyuncu, lig ve takım istatistikleri sağlar.

This API provides match results, live scores, betting odds, and detailed player, league and team statistics.

GitHub'da Görüntüle View on GitHub

GET Daily Match List

Retrieve all matches for a specific date.

https://samettopaloglu.com/futbol.php?date=09/02/2026

Response Example

{
    "date": "09\/02\/2026",
    "matches": [
        {
            "id": 4308508,
            "home": "Kayserispor",
            "homeGoals": 1,
            "away": "Kocaelispor",
            "awayGoals": 2,
            "status": "MS",
            "score": "1-2",
            "matchTime": "17:00",
            "matchDate": "09\/02\/2026",
            "leagueName": "Türkiye",
            "leagueType": "Süper Lig",
            "homeWin": "2.82",
            "draw": "2.86",
            "awayWin": "2.10",
            "detailUrl": "https:\/\/arsiv.mackolik.com\/Match\/Default.aspx?id=4308508"
        }
    ]
}

GET Single Match

Retrieve detailed information for a specific match using match ID.

https://samettopaloglu.com/futbol.php?date=09/02/2026&id=4308507

Response Example

{
    "date": "09\/02\/2026",
    "match": {
        "id": 4308507,
        "home": "Fenerbahçe",
        "homeGoals": 3,
        "away": "Gençlerbirliği",
        "awayGoals": 1,
        "status": "MS",
        "score": "3-1",
        "matchTime": "20:00",
        "matchDate": "09\/02\/2026",
        "leagueName": "Türkiye",
        "leagueType": "Süper Lig",
        "homeWin": "1.13",
        "draw": "5.39",
        "awayWin": "9.07",
        "detailUrl": "https:\/\/arsiv.mackolik.com\/Match\/Default.aspx?id=4308507",
        "referee": "Ali Şansalan",
        "stadium": "Chobani Stadyumu",
        "viewer": null,
        "publish": "beIN SPORTS 1",
        "home_form": "M,B,B,G,G",
        "away_form": "G,B,M,G,B"
    }
}

GET Match Statistics

Retrieve detailed player and team statistics for a specific match.

https://samettopaloglu.com/futbol.php?id=4308507&stats=1

Response Example

 {
    "id": "4308507",
    "stats": {
        "teams": {
            "Fenerbahçe": [
                {
                    "name": "Kerem Aktürkoğlu",
                    "pos": "AML",
                    "shots": 2,
                    "successShots": 2,
                    "passes": 20,
                    "successPasses": 16,
                    "takeons": 1,
                    "takeonsWon": 0,
                    "tackles": 3,
                    "tacklesWon": 3,
                    "fouls": 1,
                    "keyPasses": 1
                },
               ],
            },
        },
    },

Match Parameters

Parameter Type Status Description
date String Required* Date in format DD/MM/YYYY
id Integer Optional Specific Match ID
stats Integer Optional Set to 1 for Opta statistics

Archive & League Data

Historical competition data, standings, and weekly schedules.

GET Categories (Groups)

Retrieve a list of supported countries and global competition groups.

https://samettopaloglu.com/futbol.php?op=groups

Response Example

[
    {
        "groupid": 1,
        "name": "Turkey"
    },
    {
        "groupid": 17,
        "name": "England"
    },
    {
        "groupid": 14,
        "name": "Spain"
    },
    {
        "groupid": 2,
        "name": "Germany"
    },
    {
        "groupid": 10,
        "name": "Italy"
    }
]

GET Season Years

Get all available historical seasons for a specific country or group.

https://samettopaloglu.com/futbol.php?op=years&group=1

Response Example

[
  "2025/2026",
  "2024/2025",
  "2023/2024",
  "2022/2023",
  "2021/2022",
  "2020/2021",
  "2019/2020",
  "2018/2019",
  "2017/2018",
  "2016/2017",
  "2015/2016"
]

GET Sub-Leagues

Retrieve all sub-leagues and competitions under a category for a given year.

https://samettopaloglu.com/futbol.php?op=leagues&group=1&year=2025/2026

Response Example

{
"l": [
        {
            "leagueId": 70381,
            "leagueName": "Trendyol Süper Lig"
        },
        {
            "leagueId": 70388,
            "leagueName": "Trendyol 1. Lig"
        },
        {
            "leagueId": 70404,
            "leagueName": "Nesine 2.Lig Beyaz Grup"
        },
        {
            "leagueId": 70405,
            "leagueName": "Nesine 2.Lig Kırmızı Grup"
        }
    ]
}

GET League Table

Get the detailed league table (standings) with calculated points and team logos.

https://samettopaloglu.com/futbol.php?op=table&league=70381

Response Example

[
    {
        "rank": 1,
        "teamId": 1,
        "teamName": "Galatasaray",
        "played": 29,
        "won": 21,
        "draw": 5,
        "lost": 3,
        "gf": 67,
        "ga": 22,
        "average": 45,
        "points": 68,
        "logo": "https:\/\/im.mackolik.com\/img\/logo\/buyuk\/1.gif"
    },
    {
        "rank": 2,
        "teamId": 2,
        "teamName": "Fenerbahçe",
        "played": 30,
        "won": 19,
        "draw": 10,
        "lost": 1,
        "gf": 68,
        "ga": 30,
        "average": 38,
        "points": 67,
        "logo": "https:\/\/im.mackolik.com\/img\/logo\/buyuk\/2.gif"
    }
]

GET Weekly Fixtures

Get match schedules and results for a specific league and week.

https://samettopaloglu.com/futbol.php?op=fixtures&league=70381&week=25

Response Example

[
    {
        "id": 4308541,
        "date": "07\/03",
        "status": "MS",
        "homeId": 451,
        "home": "Başakşehir FK",
        "homeLogo": "https://im.mackolik.com/img/logo/buyuk/451.gif",
        "awayId": 15,
        "away": "Göztepe",
        "awayLogo": "https://im.mackolik.com/img/logo/buyuk/15.gif",
        "score": "2 - 1",
        "homeGoals": 2,
        "awayGoals": 1,
        "detailUrl": "https:\/\/arsiv.mackolik.com\/Match\/Default.aspx?id=4308541"
    },
    {
        "id": 4308542,
        "date": "07\/03",
        "status": "MS",
        "homeId": 3,
        "home": "Beşiktaş",
        "homeLogo": "https://im.mackolik.com/img/logo/buyuk/3.gif",
        "awayId": 1,
        "away": "Galatasaray",
        "awayLogo": "https://im.mackolik.com/img/logo/buyuk/1.gif",
        "score": "0 - 1",
        "homeGoals": 0,
        "awayGoals": 1,
        "detailUrl": "https:\/\/arsiv.mackolik.com\/Match\/Default.aspx?id=4308542"
    }
]

Archive Parameters

Parameter Type Status Description
op String Required* Operation: groups, years, leagues, table, fixtures
league Integer Required* League ID for table or fixtures
group Integer Required* Group ID for years or seasons
year String Required* Season year (e.g. 2024/2025)
week Integer Required* Week number for fixtures

Team Information

Detailed squad data, player statistics and market values.

Finding Team IDs: There is no dedicated endpoint to list all teams. You can find the teamId for any club within the League Table endpoint (op=table) response.

GET Team Squad & Stats

Retrieve detailed team information including total value, average age, and full squad statistics for a specific season.

https://samettopaloglu.com/futbol.php?op=team&id=2&season=2025/2026

Response Example

{
    "teamValue": "257,40 M €",
    "averageAge": "25",
    "team": {
        "Goalkeepers": [
            {
                "jersey": 31,
                "playerId": 215319,
                "name": "Ederson",
                "nationality": "Brezilya",
                "age": 32,
                "matches": 34,
                "starts": 34,
                "minutes": 3060,
                "asist": 0,
                "goals": 0,
                "yellowCards": 7,
                "redCards": 0,
                "marketValue": "21.000.000",
                "isCaptain": false,
                "photo": "https:\/\/im.mackolik.com\/img\/oyuncu\/215319_01.jpg"
            }
        ],
        "Defenders": [],
        "Midfielders": [],
        "Forwards": []
    }
}

Team Parameters

Parameter Type Status Description
op String Required* Value: team
id Integer Required* Specific Team ID
season String Required* Season year (e.g. 2025/2026)
fixtures Integer Optional Set to 1 to include match history, upcoming games, and Opta stats

GET Team Fixtures & Stats

Retrieve the full season schedule, including played match statistics and upcoming fixtures with stage details.

https://samettopaloglu.com/futbol.php?op=team&id=2&season=2025/2026&fixtures=1

Response Example

[
    {
        "competition": "Türkiye Süper Lig",
        "fixtures": [
            {
                "date": "16.08.2025",
                "home": "Göztepe",
                "score": "0 - 0",
                "away": "Fenerbahçe",
                "matchId": "4308334",
                "stats": {
                    "possessionPercentage": "60",
                    "shots": "12",
                    "shotsOnTarget": "1",
                    "passPercentage": "85",
                    "accuratePasses": "337"
                }
            },
            {
                "date": "26.04.2026",
                "home": "Galatasaray",
                "score": "v",
                "away": "Fenerbahçe",
                "matchId": "4308596",
                "stage": "Lig Aşaması"
            }
        ]
    }
]

Error Responses