一足球 API

API ID 13509

按日期排列的足球比赛,比赛详情包括阵容、统计数据和事件,比赛排名和日程,球队页面和阵容,以及球员档案

393 ms 平均响应

API 文档

端点

请求
返回所有比赛的字母索引
Endpoint ID: 29905
GET https://docs.zylalabs.com/api/13509/onefootball+api/29905/get+all+competition+letters
输入参数

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。

API 示例响应
JSON
[
    {
        "letter": "A",
        "url": "https://onefootball.com/en/all-competitions/a"
    },
    {
        "letter": "B",
        "url": "https://onefootball.com/en/all-competitions/b"
    },
    {
        "letter": "C",
        "url": "https://onefootball.com/en/all-competitions/c"
    },
    {
        "letter": "D",
        "url": "https://onefootball.com/en/all-competitions/d"
    },
    {
        "letter": "E",
        "url": "https://onefootball.com/en/all-competitions/e"
    },
    {
        "letter": "F",
        "url": "https://onefootball.com/en/all-competitions/f"
    },
    {
        "letter": "G",
        "url": "https://onefootball.com/en/all-competitions/g"
    },
    {
        "letter": "H",
        "url": "https://onefootball.com/en/all-competitions/h"
    },
    {
        "letter": "I",
        "url": "https://onefootball.com/en/all-competitions/i"
    },
    {
        "letter": "J",
        "url": "https://onefootball.com/en/all-competitions/j"
    },
    {
        "letter": "K",
        "url": "https://onefootball.com/en/all-competitions/k"
    },
    {
        "letter": "L",
        "url": "https://onefootball.com/en/all-competitions/l"
    },
    {
        "letter": "M",
        "url": "https://onefootball.com/en/all-competitions/m"
    },
    {
        "letter": "N",
        "url": "https://onefootball.com/en/all-competitions/n"
    },
    {
        "letter": "O",
        "url": "https://onefootball.com/en/all-competitions/o"
    },
    {
        "letter": "P",
        "url": "https://onefootball.com/en/all-competitions/p"
    },
    {
        "letter": "Q",
        "url": "https://onefootball.com/en/all-competitions/q"
    },
    {
        "letter": "R",
        "url": "https://onefootball.com/en/all-competitions/r"
    },
    {
        "letter": "S",
        "url": "https://onefootball.com/en/all-competitions/s"
    },
    {
        "letter": "T",
        "url": "https://onefootball.com/en/all-competitions/t"
    },
    {
        "letter": "U",
        "url": "https://onefootball.com/en/all-competitions/u"
    },
    {
        "letter": "V",
        "url": "https://onefootball.com/en/all-competitions/v"
    },
    {
        "letter": "W",
        "url": "https://onefootball.com/en/all-competitions/w"
    },
    {
        "letter": "Y",
        "url": "https://onefootball.com/en/all-competitions/y"
    }
]
获取所有竞赛信件 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29905/get+all+competition+letters' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回一个字母的所有比赛
Endpoint ID: 29906
GET https://docs.zylalabs.com/api/13509/onefootball+api/29906/get+competitions+by+letter
输入参数

通过字母获取比赛 — 端点功能

对象 描述
letter 必需 Single letter (a-z) the results are filtered by.

剩余免费测试请求:3 / 3。


输入参数

letter
API 示例响应
JSON
[
    {
        "id": 2748,
        "name": "A Lyga",
        "url": "https://onefootball.com/en/competition/a-lyga-2748"
    },
    {
        "id": 84,
        "name": "A-League Men",
        "url": "https://onefootball.com/en/competition/a-league-men-84"
    },
    {
        "id": 2806,
        "name": "A-League Women",
        "url": "https://onefootball.com/en/competition/a-league-women-2806"
    },
    {
        "id": 3018,
        "name": "A-Leagues All Stars Game Women",
        "url": "https://onefootball.com/en/competition/a-leagues-all-stars-game-women-3018"
    },
    {
        "id": 156,
        "name": "AFC Asian Cup",
        "url": "https://onefootball.com/en/competition/afc-asian-cup-156"
    },
    {
        "id": 2797,
        "name": "AFC Asian Cup Qualifiers",
        "url": "https://onefootball.com/en/competition/afc-asian-cup-qualifiers-2797"
    },
    {
        "id": 73,
        "name": "AFC Asian Qualifiers – Road to 26",
        "url": "https://onefootball.com/en/competition/afc-asian-qualifiers-road-to-26-73"
    },
    {
        "id": 2945,
        "name": "AFC Challenge League",
        "url": "https://onefootball.com/en/competition/afc-challenge-league-2945"
    },
    {
        "id": 155,
        "name": "AFC Champions League Elite",
        "url": "https://onefootball.com/en/competition/afc-champions-league-elite-155"
    },
    {
        "id": 2760,
        "name": "AFC Champions League Two",
        "url": "https://onefootball.com/en/competition/afc-champions-league-two-2760"
    },
    {
        "id": 2997,
        "name": "AFC U-17 Asian Cup",
        "url": "https://onefootball.com/en/competition/afc-u-17-asian-cup-2997"
    },
    {
        "id": 2998,
        "name": "AFC U-17 Women's Asian Cup",
        "url": "https://onefootball.com/en/competition/afc-u-17-womens-asian-cup-2998"
    },
    {
        "id": 2996,
        "name": "AFC U-20 Women's Asian Cup",
        "url": "https://onefootball.com/en/competition/afc-u-20-womens-asian-cup-2996"
    },
    {
        "id": 2938,
        "name": "AFC U-23 Asian Cup",
        "url": "https://onefootball.com/en/competition/afc-u-23-asian-cup-2938"
    },
    {
        "id": 2783,
        "name": "AFC Women's Asian Cup",
        "url": "https://onefootball.com/en/competition/afc-womens-asian-cup-2783"
    },
    {
        "id": 2953,
        "name": "AFC Women's Champions League",
        "url": "https://onefootball.com/en/competition/afc-womens-champions-league-2953"
    },
    {
        "id": 2979,
        "name": "ASEAN Club Championship",
        "url": "https://onefootball.com/en/competition/asean-club-championship-2979"
    },
    {
        "id": 2777,
        "name": "ASEAN Hyundai Cup",
        "url": "https://onefootball.com/en/competition/asean-hyundai-cup-2777"
    },
    {
        "id": 2978,
        "name": "ASEAN Women's Championship",
        "url": "https://onefootball.com/en/competition/asean-womens-championship-2978"
    },
    {
        "id": 1877,
        "name": "Acreano",
        "url": "https://onefootball.com/en/competition/acreano-1877"
    },
    {
        "id": 2695,
        "name": "Africa Cup Of Nations Qualifiers",
        "url": "https://onefootball.com/en/competition/africa-cup-of-nations-qualifiers-2695"
    },
    {
        "id": 49,
        "name": "Africa Cup of Nations",
        "url": "https://onefootball.com/en/competition/africa-cup-of-nations-49"
    },
    {
        "id": 2822,
        "name": "Africa Women Cup of Nations",
        "url": "https://onefootball.com/en/competition/africa-women-cup-of-nations-2822"
    },
    {
        "id": 2901,
        "name": "African Football League",
        "url": "https://onefootball.com/en/competition/african-football-league-2901"
    },
    {
        "id": 2755,
        "name": "African Nations Championship",
        "url": "https://onefootball.com/en/competition/african-nations-championship-2755"
    },
    {
        "id": 1878,
        "name": "Alagoano",
        "url": "https://onefootball.com/en/competition/alagoano-1878"
    },
    {
        "id": 2957,
        "name": "Algeria Ligue 2",
        "url": "https://onefootball.com/en/competition/algeria-ligue-2-2957"
    },
    {
        "id": 62,
        "name": "Allsvenskan",
        "url": "https://onefootball.com/en/competition/allsvenskan-62"
    },
    {
        "id": 2909,
        "name": "Allsvenskan Relegation Play-off",
        "url": "https://onefootball.com/en/competition/allsvenskan-relegation-play-off-2909"
    },
    {
        "id": 1879,
        "name": "Amapaense",
        "url": "https://onefootball.com/en/competition/amapaense-1879"
    },
    {
        "id": 1880,
        "name": "Amazonense",
        "url": "https://onefootball.com/en/competition/amazonense-1880"
    },
    {
        "id": 2827,
        "name": "Arab Club Champions Cup",
        "url": "https://onefootball.com/en/competition/arab-club-champions-cup-2827"
    },
    {
        "id": 2837,
        "name": "Arabian Gulf Cup",
        "url": "https://onefootball.com/en/competition/arabian-gulf-cup-2837"
    },
    {
        "id": 2770,
        "name": "Armenian Premier League",
        "url": "https://onefootball.com/en/competition/armenian-premier-league-2770"
    },
    {
        "id": 2786,
        "name": "Arnold Clark Cup",
        "url": "https://onefootball.com/en/competition/arnold-clark-cup-2786"
    },
    {
        "id": 2722,
        "name": "Australia Cup",
        "url": "https://onefootball.com/en/competition/australia-cup-2722"
    },
    {
        "id": 26,
        "name": "Austrian Bundesliga",
        "url": "https://onefootball.com/en/competition/austrian-bundesliga-26"
    },
    {
        "id": 2771,
        "name": "Azerbaijan Premier League",
        "url": "https://onefootball.com/en/competition/azerbaijan-premier-league-2771"
    }
]
通过字母获取比赛 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29906/get+competitions+by+letter?letter=a' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
竞赛的退货详情
Endpoint ID: 29907
GET https://docs.zylalabs.com/api/13509/onefootball+api/29907/get+competition+details
输入参数

获取比赛详情 — 端点功能

对象 描述
competition_id 必需 Competition ID.

剩余免费测试请求:3 / 3。


输入参数

competition_id
API 示例响应
JSON
{
    "id": 10,
    "name": "LaLiga",
    "image": "https://images.onefootball.com/icons/leagueColoredCompetition/128/10.png",
    "url": "https://onefootball.com/en/competition/laliga-10"
}
获取比赛详情 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29907/get+competition+details?competition_id=10' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回比赛的比赛安排
Endpoint ID: 29908
GET https://docs.zylalabs.com/api/13509/onefootball+api/29908/get+competition+fixtures
输入参数

获取比赛安排 — 端点功能

对象 描述
competition_id 必需 Competition ID.

剩余免费测试请求:3 / 3。


输入参数

competition_id
API 示例响应
JSON
[
    {
        "name": "Matchday 1",
        "matches": [
            {
                "id": 2700185,
                "url": "https://onefootball.com/en/match/2700185",
                "datetime": "2026-08-15T17:30:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 1254,
                    "name": "Alavés",
                    "image": "https://images.onefootball.com/icons/teams/164/1254.png"
                },
                "awayTeam": {
                    "id": 216,
                    "name": "Getafe",
                    "image": "https://images.onefootball.com/icons/teams/164/216.png"
                }
            },
            {
                "id": 2700193,
                "url": "https://onefootball.com/en/match/2700193",
                "datetime": "2026-08-15T19:30:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 28,
                    "name": "Sevilla",
                    "image": "https://images.onefootball.com/icons/teams/164/28.png"
                },
                "awayTeam": {
                    "id": 690,
                    "name": "Rayo Vallecano",
                    "image": "https://images.onefootball.com/icons/teams/164/690.png"
                }
            },
            {
                "id": 2700191,
                "url": "https://onefootball.com/en/match/2700191",
                "datetime": "2026-08-16T15:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 222,
                    "name": "Racing de Santander",
                    "image": "https://images.onefootball.com/icons/teams/164/222.png"
                },
                "awayTeam": {
                    "id": 226,
                    "name": "Villarreal",
                    "image": "https://images.onefootball.com/icons/teams/164/226.png"
                }
            },
            {
                "id": 2700189,
                "url": "https://onefootball.com/en/match/2700189",
                "datetime": "2026-08-16T17:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 215,
                    "name": "Espanyol",
                    "image": "https://images.onefootball.com/icons/teams/164/215.png"
                },
                "awayTeam": {
                    "id": 218,
                    "name": "Levante",
                    "image": "https://images.onefootball.com/icons/teams/164/218.png"
                }
            },
            {
                "id": 2700188,
                "url": "https://onefootball.com/en/match/2700188",
                "datetime": "2026-08-17T19:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 214,
                    "name": "Deportivo A Coruña",
                    "image": "https://images.onefootball.com/icons/teams/164/214.png"
                },
                "awayTeam": {
                    "id": 682,
                    "name": "Elche",
                    "image": "https://images.onefootball.com/icons/teams/164/682.png"
                }
            },
            {
                "id": 2700186,
                "url": "https://onefootball.com/en/match/2700186",
                "datetime": "2026-08-19T19:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 3,
                    "name": "Atlético de Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/3.png"
                },
                "awayTeam": {
                    "id": 219,
                    "name": "Málaga",
                    "image": "https://images.onefootball.com/icons/teams/164/219.png"
                }
            },
            {
                "id": 2700194,
                "url": "https://onefootball.com/en/match/2700194",
                "datetime": "2026-08-25T19:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 143,
                    "name": "Valencia",
                    "image": "https://images.onefootball.com/icons/teams/164/143.png"
                },
                "awayTeam": {
                    "id": 691,
                    "name": "Real Betis",
                    "image": "https://images.onefootball.com/icons/teams/164/691.png"
                }
            },
            {
                "id": 2700192,
                "url": "https://onefootball.com/en/match/2700192",
                "datetime": "2026-08-26T19:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 26,
                    "name": "Real Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/26.png"
                },
                "awayTeam": {
                    "id": 223,
                    "name": "Real Sociedad",
                    "image": "https://images.onefootball.com/icons/teams/164/223.png"
                }
            },
            {
                "id": 2700187,
                "url": "https://onefootball.com/en/match/2700187",
                "datetime": "2026-08-27T18:30:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 680,
                    "name": "Celta de Vigo",
                    "image": "https://images.onefootball.com/icons/teams/164/680.png"
                },
                "awayTeam": {
                    "id": 221,
                    "name": "Osasuna",
                    "image": "https://images.onefootball.com/icons/teams/164/221.png"
                }
            },
            {
                "id": 2700190,
                "url": "https://onefootball.com/en/match/2700190",
                "datetime": "2026-08-27T19:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 5
                }
            }
        ]
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
获取比赛安排 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29908/get+competition+fixtures?competition_id=10' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回比赛的积分榜 支持单表和多组表
Endpoint ID: 29909
GET https://docs.zylalabs.com/api/13509/onefootball+api/29909/get+competition+table
输入参数

获取比赛表格 — 端点功能

对象 描述
competition_id 必需 Competition ID.

剩余免费测试请求:3 / 3。


输入参数

competition_id
API 示例响应
JSON
{
    "hasGroups": false,
    "groups": [
        {
            "title": "",
            "standings": [
                {
                    "position": 1,
                    "positionChange": null,
                    "team": {
                        "id": 55,
                        "name": "Argentina",
                        "image": "https://images.onefootball.com/icons/teams/164/55.png",
                        "url": "https://onefootball.com/en/team/argentina-55"
                    },
                    "played": 18,
                    "won": 12,
                    "drawn": 2,
                    "lost": 4,
                    "goalsDiff": 21,
                    "points": 38
                },
                {
                    "position": 2,
                    "positionChange": "UP",
                    "team": {
                        "id": 101,
                        "name": "Ecuador",
                        "image": "https://images.onefootball.com/icons/teams/164/101.png",
                        "url": "https://onefootball.com/en/team/ecuador-101"
                    },
                    "played": 18,
                    "won": 8,
                    "drawn": 8,
                    "lost": 2,
                    "goalsDiff": 9,
                    "points": 29
                },
                {
                    "position": 3,
                    "positionChange": "UP",
                    "team": {
                        "id": 118,
                        "name": "Colombia",
                        "image": "https://images.onefootball.com/icons/teams/164/118.png",
                        "url": "https://onefootball.com/en/team/colombia-118"
                    },
                    "played": 18,
                    "won": 7,
                    "drawn": 7,
                    "lost": 4,
                    "goalsDiff": 10,
                    "points": 28
                },
                {
                    "position": 4,
                    "positionChange": "DOWN",
                    "team": {
                        "id": 56,
                        "name": "Uruguay",
                        "image": "https://images.onefootball.com/icons/teams/164/56.png",
                        "url": "https://onefootball.com/en/team/uruguay-56"
                    },
                    "played": 18,
                    "won": 7,
                    "drawn": 7,
                    "lost": 4,
                    "goalsDiff": 10,
                    "points": 28
                },
                {
                    "position": 5,
                    "positionChange": "DOWN",
                    "team": {
                        "id": 79,
                        "name": "Brazil",
                        "image": "https://images.onefootball.com/icons/teams/164/79.png",
                        "url": "https://onefootball.com/en/team/brazil-79"
                    },
                    "played": 18,
                    "won": 8,
                    "drawn": 4,
                    "lost": 6,
                    "goalsDiff": 7,
                    "points": 28
                },
                {
                    "position": 6,
                    "positionChange": null,
                    "team": {
                        "id": 47,
                        "name": "Paraguay",
                        "image": "https://images.onefootball.com/icons/teams/164/47.png",
                        "url": "https://onefootball.com/en/team/paraguay-47"
                    },
                    "played": 18,
                    "won": 7,
                    "drawn": 7,
                    "lost": 4,
                    "goalsDiff": 4,
                    "points": 28
                },
                {
                    "position": 7,
                    "positionChange": "UP",
                    "team": {
                        "id": 840,
                        "name": "Bolivia",
                        "image": "https://images.onefootball.com/icons/teams/164/840.png",
                        "url": "https://onefootball.com/en/team/bolivia-840"
                    },
                    "played": 18,
                    "won": 6,
                    "drawn": 2,
                    "lost": 10,
                    "goalsDiff": -18,
                    "points": 20
                },
                {
                    "position": 8,
                    "positionChange": "DOWN",
                    "team": {
                        "id": 591,
                        "name": "Venezuela",
                        "image": "https://images.onefootball.com/icons/teams/164/591.png",
                        "url": "https://onefootball.com/en/team/venezuela-591"
                    },
                    "played": 18,
                    "won": 4,
                    "drawn": 6,
                    "lost": 8,
                    "goalsDiff": -10,
                    "points": 18
                },
                {
                    "position": 9,
                    "positionChange": null,
                    "team": {
                        "id": 127,
                        "name": "Peru",
                        "image": "https://images.onefootball.com/icons/teams/164/127.png",
                        "url": "https://onefootball.com/en/team/peru-127"
                    },
                    "played": 18,
                    "won": 2,
                    "drawn": 6,
                    "lost": 10,
                    "goalsDiff": -15,
                    "points": 12
                },
                {
                    "position": 10,
                    "positionChange": null,
                    "team": {
                        "id": 35,
                        "name": "Chile",
                        "image": "https://images.onefootball.com/icons/teams/164/35.png",
                        "url": "https://onefootball.com/en/team/chile-35"
                    },
                    "played": 18,
                    "won": 2,
                    "drawn": 5,
                    "lost": 11,
                    "goalsDiff": -18,
                    "points": 11
                }
            ]
        }
    ]
}
获取比赛表格 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29909/get+competition+table?competition_id=74' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回比赛的淘汰赛阶段(有比赛的阶段)
Endpoint ID: 29910
GET https://docs.zylalabs.com/api/13509/onefootball+api/29910/get+competition+knockout+tree
输入参数

获取比赛淘汰树 — 端点功能

对象 描述
competition_id 必需 Competition ID.

剩余免费测试请求:3 / 3。


输入参数

competition_id
API 示例响应
JSON
[
    {
        "title": "Round of 16",
        "matches": [
            {
                "id": 2650264,
                "datetime": "2026-07-04T17:00:00Z",
                "timePeriod": "04/07/2026",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 132,
                    "name": "Canada",
                    "image": "https://images.onefootball.com/icons/teams/56/132.png",
                    "score": "0"
                },
                "awayTeam": {
                    "id": 108,
                    "name": "Morocco",
                    "image": "https://images.onefootball.com/icons/teams/56/108.png",
                    "score": "3"
                },
                "url": "https://onefootball.com/en/match/2650264"
            },
            {
                "id": 2650263,
                "datetime": "2026-07-04T21:00:00Z",
                "timePeriod": "04/07/2026",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 47,
                    "name": "Paraguay",
                    "image": "https://images.onefootball.com/icons/teams/56/47.png",
                    "score": "0"
                },
                "awayTeam": {
                    "id": 45,
                    "name": "France",
                    "image": "https://images.onefootball.com/icons/teams/56/45.png",
                    "score": "1"
                },
                "url": "https://onefootball.com/en/match/2650263"
            },
            {
                "id": 2650267,
                "datetime": "2026-07-06T19:00:00Z",
                "timePeriod": "06/07/2026",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 43,
                    "name": "Portugal",
                    "image": "https://images.onefootball.com/icons/teams/56/43.png",
                    "score": "0"
                },
                "awayTeam": {
                    "id": 34,
                    "name": "Spain",
                    "image": "https://images.onefootball.com/icons/teams/56/34.png",
                    "score": "1"
                },
                "url": "https://onefootball.com/en/match/2650267"
            },
            {
                "id": 2650270,
                "datetime": "2026-07-07T00:00:00Z",
                "timePeriod": "07/07/2026",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 81,
                    "name": "United States",
                    "image": "https://images.onefootball.com/icons/teams/56/81.png",
                    "score": "1"
                },
                "awayTeam": {
                    "id": 116,
                    "name": "Belgium",
                    "image": "https://images.onefootball.com/icons/teams/56/116.png",
                    "score": "4"
                },
                "url": "https://onefootball.com/en/match/2650270"
            },
            {
                "id": 2650266,
                "datetime": "2026-07-05T20:00:00Z",
                "timePeriod": "05/07/2026",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 79,
                    "name": "Brazil",
                    "image": "https://images.onefootball.com/icons/teams/56/79.png",
                    "score": "1"
                },
                "awayTeam": {
                    "id": 115,
                    "name": "Norway",
                    "image": "https://images.onefootball.com/icons/teams/56/115.png",
                    "score": "2"
                },
                "url": "https://onefootball.com/en/match/2650266"
            },
            {
                "id": 2650268,
                "datetime": "2026-07-06T01:00:00Z",
                "timePeriod": "06/07/2026",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 69,
                    "name": "Mexico",
                    "image": "https://images.onefootball.com/icons/teams/56/69.png",
                    "score": "2"
                },
                "awayTeam": {
                    "id": 61,
                    "name": "England",
                    "image": "https://images.onefootball.com/icons/teams/56/61.png",
                    "score": "3"
                },
                "url": "https://onefootball.com/en/match/2650268"
            },
            {
                "id": 2650271,
                "datetime": "2026-07-07T16:00:00Z",
                "timePeriod": "07/07/2026",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 55,
                    "name": "Argentina",
                    "image": "https://images.onefootball.com/icons/teams/56/55.png",
                    "score": "3"
                },
                "awayTeam": {
                    "id": 590,
                    "name": "Egypt",
                    "image": "https://images.onefootball.com/icons/teams/56/590.png",
                    "score": "2"
                },
                "url": "https://onefootball.com/en/match/2650271"
            },
            {
                "id": 2650269,
                "datetime": "2026-07-07T20:00:00Z",
                "timePeriod": "07/07/2026",
                "period": "FULL_TIME_PENALTIES",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": true
                },
                "homeTeam": {
                    "id": 93,
                    "name": "Switzerland",
                    "image": "https://images.onefootball.com/icons/teams/56/93.png",
                    "score": "0(4)"
                },
                "awayTeam": {
                    "id": 118,
                    "name": "Colombia",
                    "image": "https://images.onefootball.com/icons/teams/56/118.png",
                    "score": "0(3)"
                },
                "url": "https://onefootball.com/en/match/2650269"
            }
        ]
    },
    {
        "title": "Quarter-finals",
        "matches": [
            {
                "id": 2650272,
                "datetime": "2026-07-09T20:00:00Z",
                "timePeriod": "09/07/2026",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 45,
                    "name": "France",
                    "image": "https://images.onefootball.com/icons/teams/56/45.png",
                    "score": "2"
                },
                "awayTeam": {
                    "id": 108,
                    "name": "Morocco",
                    "image": "https://images.onefootball.com/icons/teams/56/108.png",
                    "score": "0"
                }
            }
        ]
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
获取比赛淘汰树 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29910/get+competition+knockout+tree?competition_id=12' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回比赛的结果
Endpoint ID: 29911
GET https://docs.zylalabs.com/api/13509/onefootball+api/29911/get+competition+results
输入参数

获取比赛结果 — 端点功能

对象 描述
competition_id 必需 Competition ID.

剩余免费测试请求:3 / 3。


输入参数

competition_id
API 示例响应
JSON
[
    {
        "name": "Final",
        "matches": [
            {
                "id": 2645095,
                "url": "https://onefootball.com/en/match/2645095",
                "datetime": "2026-07-19T19:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 34,
                    "name": "Spain",
                    "image": "https://images.onefootball.com/icons/teams/164/34.png",
                    "score": "1"
                },
                "awayTeam": {
                    "id": 55,
                    "name": "Argentina",
                    "image": "https://images.onefootball.com/icons/teams/164/55.png",
                    "score": "0"
                }
            }
        ]
    },
    {
        "name": "Match for third place",
        "matches": [
            {
                "id": 2650276,
                "url": "https://onefootball.com/en/match/2650276",
                "datetime": "2026-07-18T21:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 45,
                    "name": "France",
                    "image": "https://images.onefootball.com/icons/teams/164/45.png",
                    "score": "4"
                },
                "awayTeam": {
                    "id": 61,
                    "name": "England",
                    "image": "https://images.onefootball.com/icons/teams/164/61.png",
                    "score": "6"
                }
            }
        ]
    },
    {
        "name": "Semi-finals",
        "matches": [
            {
                "id": 2645094,
                "url": "https://onefootball.com/en/match/2645094",
                "datetime": "2026-07-15T19:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 61,
                    "name": "England",
                    "image": "https://images.onefootball.com/icons/teams/164/61.png",
                    "score": "1"
                },
                "awayTeam": {
                    "id": 55,
                    "name": "Argentina",
                    "image": "https://images.onefootball.com/icons/teams/164/55.png",
                    "score": "2"
                }
            },
            {
                "id": 2645093,
                "url": "https://onefootball.com/en/match/2645093",
                "datetime": "2026-07-14T19:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 45,
                    "name": "France",
                    "image": "https://images.onefootball.com/icons/teams/164/45.png",
                    "score": "0"
                },
                "awayTeam": {
                    "id": 34,
                    "name": "Spain",
                    "image": "https://images.onefootball.com/icons/teams/164/34.png",
                    "score": "2"
                }
            }
        ]
    },
    {
        "name": "Quarter-finals",
        "matches": [
            {
                "id": 2650275,
                "url": "https://onefootball.com/en/match/2650275",
                "datetime": "2026-07-12T01:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 55,
                    "name": "Argentina",
                    "image": "https://images.onefootball.com/icons/teams/164/55.png",
                    "score": "3"
                },
                "awayTeam": {
                    "id": 93,
                    "name": "Switzerland",
                    "image": "https://images.onefootball.com/icons/teams/164/93.png",
                    "score": "1"
                }
            },
            {
                "id": 2650274,
                "url": "https://onefootball.com/en/match/2650274",
                "datetime": "2026-07-11T21:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 115,
                    "name": "Norway",
                    "image": "https://images.onefootball.com/icons/teams/164/115.png",
                    "score": "1"
                },
                "awayTeam": {
                    "id": 61,
                    "name": "England",
                    "image": "https://images.onefootball.com/icons/teams/164/61.png",
                    "score": "2"
                }
            },
            {
                "id": 2650273,
                "url": "https://onefootball.com/en/match/2650273",
                "datetime": "2026-07-10T19:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 34,
                    "name": "Spain",
                    "image": "https://images.onefootball.com/icons/teams/164/34.png",
                    "score": "2"
                },
                "awayTeam": {
                    "id": 116,
                    "name": "Belgium",
                    "image": "https://images.onefootball.com/icons/teams/164/116.png",
                    "score": "1"
                }
            },
            {
                "id": 2650272,
                "url": "https://onefootball.com/en/match/2650272",
                "datetime": "2026-07-09T20:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 45,
                    "name": "France",
                    "image": "https://images.onefootball.com/icons/teams/164/45.png",
                    "score": "2"
                },
                "awayTeam": {
                    "id": 108,
                    "name": "Morocco",
                    "image": "https://images.onefootball.com/icons/teams/164/108.png",
                    "score": "0"
                }
            }
        ]
    },
    {
        "name": "Round of 16",
        "matches": [
            {
                "id": 2650269,
                "url": "https://onefootball.com/en/match/2650269",
                "datetime": "2026-07-07T20:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME_PENALTIES",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": true
                },
                "homeTeam": {
                    "id": 93,
                    "name": "Switzerland",
                    "image": "https://images.onefootball.com/icons/teams/164/93.png"
                }
            }
        ]
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
获取比赛结果 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29911/get+competition+results?competition_id=12' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回比赛的转会
Endpoint ID: 29912
GET https://docs.zylalabs.com/api/13509/onefootball+api/29912/get+competition+transfers
输入参数

获取竞争转会 — 端点功能

对象 描述
competition_id 必需 Competition ID.

剩余免费测试请求:3 / 3。


输入参数

competition_id
API 示例响应
JSON
[
    {
        "id": "43267726",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43267726",
        "player": {
            "id": 545067,
            "name": "Rockson Yeboah",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/545067.jpg"
        },
        "transferDatetime": "2026-08-12T19:30:57Z",
        "price": "€3,000,000.00",
        "teamOld": {
            "name": "IFK Göteborg"
        },
        "teamNew": {
            "id": 221,
            "name": "Osasuna",
            "image": "https://images.onefootball.com/icons/teams/164/221.png"
        }
    },
    {
        "id": "43267230",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43267230",
        "player": {
            "id": 477068,
            "name": "Nobel Mendy",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/477068.jpg"
        },
        "transferDatetime": "2026-08-12T17:36:57Z",
        "price": "€25,000,000.00",
        "teamOld": {
            "name": "Rayo Vallecano"
        },
        "teamNew": {
            "id": 276,
            "name": "Hull City",
            "image": "https://images.onefootball.com/icons/teams/164/276.png"
        }
    },
    {
        "id": "43265860",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43265860",
        "player": {
            "id": 262743,
            "name": "Federico Gattoni",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/262743.jpg"
        },
        "transferDatetime": "2026-08-12T12:57:57Z",
        "price": null,
        "teamOld": {
            "name": "Sevilla"
        },
        "teamNew": {
            "id": 725,
            "name": "Ascoli",
            "image": "https://images.onefootball.com/icons/teams/164/725.png"
        }
    },
    {
        "id": "43265079",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43265079",
        "player": {
            "id": 175818,
            "name": "Nahuel Molina",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/175818.jpg"
        },
        "transferDatetime": "2026-08-12T10:12:57Z",
        "price": "€18,000,000.00",
        "teamOld": {
            "name": "Atlético de Madrid"
        },
        "teamNew": {
            "id": 145,
            "name": "Roma",
            "image": "https://images.onefootball.com/icons/teams/164/145.png"
        }
    },
    {
        "id": "43264849",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43264849",
        "player": {
            "id": 285889,
            "name": "Pep Chavarria",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/285889.jpg"
        },
        "transferDatetime": "2026-08-12T09:27:57Z",
        "price": "€19,000,000.00",
        "teamOld": {
            "name": "Rayo Vallecano"
        },
        "teamNew": {
            "id": 9,
            "name": "Chelsea",
            "image": "https://images.onefootball.com/icons/teams/164/9.png"
        }
    },
    {
        "id": "43262206",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43262206",
        "player": {
            "id": 481208,
            "name": "Thiago Fernández",
            "position": "Forward",
            "image": "https://images.onefootball.com/players/180/481208.jpg"
        },
        "transferDatetime": "2026-08-11T17:45:57Z",
        "price": "LOAN",
        "teamOld": {
            "name": "Villarreal"
        },
        "teamNew": {
            "id": 218,
            "name": "Levante",
            "image": "https://images.onefootball.com/icons/teams/164/218.png"
        }
    },
    {
        "id": "43259968",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43259968",
        "player": {
            "id": 384138,
            "name": "Robbie Ure",
            "position": "Forward",
            "image": "https://images.onefootball.com/players/180/384138.jpg"
        },
        "transferDatetime": "2026-08-11T10:36:57Z",
        "price": null,
        "teamOld": {
            "name": "Sirius"
        },
        "teamNew": {
            "id": 28,
            "name": "Sevilla",
            "image": "https://images.onefootball.com/icons/teams/164/28.png"
        }
    },
    {
        "id": "43259427",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43259427",
        "player": {
            "id": 407647,
            "name": "Carlos Dominguez Caceres",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/407647.jpg"
        },
        "transferDatetime": "2026-08-11T08:39:57Z",
        "price": "LOAN",
        "teamOld": {
            "name": "Celta de Vigo"
        },
        "teamNew": {
            "id": 1239,
            "name": "Real Oviedo",
            "image": "https://images.onefootball.com/icons/teams/164/1239.png"
        }
    },
    {
        "id": "43257171",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43257171",
        "player": {
            "id": 250203,
            "name": "Ronald Araújo",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/250203.jpg"
        },
        "transferDatetime": "2026-08-10T17:43:00Z",
        "price": "LOAN",
        "teamOld": {
            "name": "Barcelona"
        },
        "teamNew": {
            "id": 18,
            "name": "Liverpool FC",
            "image": "https://images.onefootball.com/icons/teams/164/18.png"
        }
    },
    {
        "id": "43256657",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43256657",
        "player": {
            "id": 428493,
            "name": "Alberto Flores Lopez",
            "position": "Goalkeeper",
            "image": "https://images.onefootball.com/players/180/428493.jpg"
        },
        "transferDatetime": "2026-08-10T16:03:57Z",
        "price": "FREE",
        "teamOld": {
            "name": "Sevilla"
        },
        "teamNew": {
            "id": 686,
            "name": "Granada",
            "image": "https://images.onefootball.com/icons/teams/164/686.png"
        }
    },
    {
        "id": "43250844",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43250844",
        "player": {
            "id": 266348,
            "name": "Thiago Almada",
            "position": "Midfielder",
            "image": "https://images.onefootball.com/players/180/266348.jpg"
        },
        "transferDatetime": "2026-08-09T09:51:57Z",
        "price": "€20,000,000.00",
        "teamOld": {
            "name": "Atlético de Madrid"
        },
        "teamNew": {
            "id": 1829,
            "name": "Club Atlético River Plate",
            "image": "https://images.onefootball.com/icons/teams/164/1829.png"
        }
    },
    {
        "id": "43250809",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43250809",
        "player": {
            "id": 482641,
            "name": "Mario Domínguez",
            "position": "Forward",
            "image": "https://images.onefootball.com/players/180/482641.jpg"
        },
        "transferDatetime": "2026-08-09T09:40:01Z",
        "price": "LOAN",
        "teamOld": {
            "name": "Valencia"
        },
        "teamNew": {
            "id": 2025,
            "name": "Excelsior",
            "image": "https://images.onefootball.com/icons/teams/164/2025.png"
        }
    },
    {
        "id": "43246203",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43246203",
        "player": {
            "id": 214342,
            "name": "Orel Mangala",
            "position": "Midfielder",
            "image": "https://images.onefootball.com/players/180/214342.jpg"
        },
        "transferDatetime": "2026-08-08T08:34:01Z",
        "price": "LOAN",
        "teamOld": {
            "name": "Lyon"
        },
        "teamNew": {
            "id": 216,
            "name": "Getafe",
            "image": "https://images.onefootball.com/icons/teams/164/216.png"
        }
    },
    {
        "id": "43245103",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43245103",
        "player": {
            "id": 412550,
            "name": "Álex Forés",
            "position": "Forward",
            "image": "https://images.onefootball.com/players/180/412550.jpg"
        },
        "transferDatetime": "2026-08-07T21:18:57Z",
        "price": null,
        "teamOld": {
            "name": "Villarreal"
        },
        "teamNew": {
            "id": 2051,
            "name": "Burgos",
            "image": "https://images.onefootball.com/icons/teams/164/2051.png"
        }
    },
    {
        "id": "43245098",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43245098",
        "player": {
            "id": 431005,
            "name": "Facundo Buonanotte",
            "position": "Midfielder"
        }
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
获取竞争转会 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29912/get+competition+transfers?competition_id=10' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回按比赛分组的日期匹配结果默认为今天
Endpoint ID: 29913
GET https://docs.zylalabs.com/api/13509/onefootball+api/29913/get+matches+by+date
输入参数

按日期获取比赛 — 端点功能

对象 描述
date 必需 Date in Y-m-d format.

剩余免费测试请求:3 / 3。


输入参数

date
API 示例响应
JSON
[
    {
        "competition": {
            "id": 41,
            "name": "EFL Cup",
            "round": "First round",
            "image": "https://images.onefootball.com/icons/leagueColoredCompetition/128/41.png",
            "url": "https://onefootball.com/en/competition/efl-cup-41"
        },
        "matches": [
            {
                "id": 2698439,
                "url": "https://onefootball.com/en/match/2698439",
                "datetime": "2026-08-10T19:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 637,
                    "name": "Plymouth Argyle",
                    "image": "https://images.onefootball.com/icons/teams/164/637.png",
                    "score": "2"
                },
                "awayTeam": {
                    "id": 598,
                    "name": "Exeter City",
                    "image": "https://images.onefootball.com/icons/teams/164/598.png",
                    "score": "0"
                }
            }
        ]
    },
    {
        "competition": {
            "id": 132,
            "name": "1 Liga",
            "round": "Matchday 3",
            "image": "https://images.onefootball.com/icons/leagueColoredCompetition/128/132.png",
            "url": "https://onefootball.com/en/competition/1-liga-132"
        },
        "matches": [
            {
                "id": 2693983,
                "url": "https://onefootball.com/en/match/2693983",
                "datetime": "2026-08-10T17:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 16021,
                    "name": "Unia Skierniewice",
                    "image": "https://images.onefootball.com/icons/teams/164/16021.png",
                    "score": "2"
                },
                "awayTeam": {
                    "id": 2212,
                    "name": "Arka Gdynia",
                    "image": "https://images.onefootball.com/icons/teams/164/2212.png",
                    "score": "0"
                }
            }
        ]
    },
    {
        "competition": {
            "id": 121,
            "name": "1. Lig",
            "round": "Matchday 1",
            "image": "https://images.onefootball.com/icons/leagueColoredCompetition/128/121.png",
            "url": "https://onefootball.com/en/competition/1-lig-121"
        },
        "matches": [
            {
                "id": 2710317,
                "url": "https://onefootball.com/en/match/2710317",
                "datetime": "2026-08-10T18:30:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 1771,
                    "name": "Pendikspor",
                    "image": "https://images.onefootball.com/icons/teams/164/1771.png",
                    "score": "2"
                },
                "awayTeam": {
                    "id": 3951,
                    "name": "Batman Petrol",
                    "image": "https://images.onefootball.com/icons/teams/164/3951.png",
                    "score": "2"
                }
            }
        ]
    },
    {
        "competition": {
            "id": 2728,
            "name": "1. SNL",
            "round": "Matchday 4",
            "image": "https://images.onefootball.com/icons/leagueColoredCompetition/128/2728.png",
            "url": "https://onefootball.com/en/competition/1-snl-2728"
        },
        "matches": [
            {
                "id": 2694350,
                "url": "https://onefootball.com/en/match/2694350",
                "datetime": "2026-08-10T16:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 13557,
                    "name": "Mura",
                    "image": "https://images.onefootball.com/icons/teams/164/13557.png",
                    "score": "1"
                },
                "awayTeam": {
                    "id": 4290,
                    "name": "Radomlje",
                    "image": "https://images.onefootball.com/icons/teams/164/4290.png",
                    "score": "3"
                }
            }
        ]
    },
    {
        "competition": {
            "id": 2985,
            "name": "1. divisjon",
            "round": "Matchday 17",
            "image": "https://images.onefootball.com/icons/leagueColoredCompetition/128/2985.png",
            "url": "https://onefootball.com/en/competition/1-divisjon-2985"
        },
        "matches": [
            {
                "id": 2655585,
                "url": "https://onefootball.com/en/match/2655585",
                "datetime": "2026-08-10T17:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 4974,
                    "name": "Moss",
                    "image": "https://images.onefootball.com/icons/teams/164/4974.png",
                    "score": "3"
                },
                "awayTeam": {
                    "id": 1329,
                    "name": "Odd",
                    "image": "https://images.onefootball.com/icons/teams/164/1329.png",
                    "score": "3"
                }
            }
        ]
    },
    {
        "competition": {
            "id": 2748,
            "name": "A Lyga",
            "round": "Matchday 27",
            "image": "https://images.onefootball.com/icons/leagueColoredCompetition/128/2748.png",
            "url": "https://onefootball.com/en/competition/a-lyga-2748"
        },
        "matches": [
            {
                "id": 2684526,
                "url": "https://onefootball.com/en/match/2684526",
                "datetime": "2026-08-10T15:45:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 22893,
                    "name": "TransINVEST",
                    "image": "https://images.onefootball.com/icons/teams/164/22893.png",
                    "score": "0"
                },
                "awayTeam": {
                    "id": 54258,
                    "name": "Panevėžys",
                    "image": "https://images.onefootball.com/icons/teams/164/54258.png",
                    "score": "2"
                }
            },
            {
                "id": 2684527,
                "url": "https://onefootball.com/en/match/2684527",
                "datetime": "2026-08-10T16:30:00Z",
                "timePeriod": "Abandoned",
                "period": "ABANDONED",
                "status": {
                    "isCancelled": true,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 5198,
                    "name": "Riteriai",
                    "image": "https://images.onefootball.com/icons/teams/164/5198.png",
                    "score": "0"
                },
                "awayTeam": {
                    "id": 1065,
                    "name": "Žalgiris",
                    "image": "https://images.onefootball.com/icons/teams/164/1065.png",
                    "score": "0"
                }
            }
        ]
    },
    {
        "competition": {
            "id": 62
        }
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
按日期获取比赛 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29913/get+matches+by+date?date=2026-08-10' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回当前进行中的比赛,按比赛分组
Endpoint ID: 29914
GET https://docs.zylalabs.com/api/13509/onefootball+api/29914/get+live+matches
输入参数

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。

API 示例响应
JSON
[
    {
        "competition": {
            "id": 2762,
            "name": "UEFA Conference League",
            "round": "Round 3 second leg",
            "image": "https://images.onefootball.com/icons/leagueColoredCompetition/128/2762.png",
            "url": "https://onefootball.com/en/competition/uefa-conference-league-2762"
        },
        "matches": [
            {
                "id": 2714850,
                "url": "https://onefootball.com/en/match/2714850",
                "datetime": "2026-08-13T15:00:00Z",
                "timePeriod": "0'",
                "period": "FIRST_HALF",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": true,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 536,
                    "name": "Tobol",
                    "image": "https://images.onefootball.com/icons/teams/164/536.png",
                    "score": "0"
                },
                "awayTeam": {
                    "id": 354,
                    "name": "Partizan",
                    "image": "https://images.onefootball.com/icons/teams/164/354.png",
                    "score": "0"
                }
            }
        ]
    }
]
获取直播比赛 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29914/get+live+matches' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
来自OneFootball的比赛详情
Endpoint ID: 29915
GET https://docs.zylalabs.com/api/13509/onefootball+api/29915/get+match+details
输入参数

获取比赛详情 — 端点功能

对象 描述
match_id 必需 ID of the match.

剩余免费测试请求:3 / 3。


输入参数

match_id
API 示例响应
JSON
{
    "id": 2650258,
    "competition": {
        "id": 12,
        "name": "FIFA World Cup™",
        "image": "https://images.onefootball.com/icons/leagueColoredCompetition/128/12.png",
        "url": "https://onefootball.com/en/competition/fifa-world-cup-12"
    },
    "datetime": "2026-07-02T00:00:00Z",
    "timePeriod": "Full time",
    "period": "FULL_TIME",
    "status": {
        "isCancelled": false,
        "isPostponed": false,
        "isStarted": true,
        "isInProgress": false,
        "isFinished": true,
        "isFinishedAfterPenalties": false
    },
    "homeTeam": {
        "id": 81,
        "name": "United States",
        "image": "https://images.onefootball.com/icons/teams/164/81.png",
        "score": "2",
        "url": "https://onefootball.com/en/team/united-states-81"
    },
    "awayTeam": {
        "id": 297,
        "name": "Bosnia & Herzegovina",
        "image": "https://images.onefootball.com/icons/teams/164/297.png",
        "score": "0",
        "url": "https://onefootball.com/en/team/bosnia-herzegovina-297"
    },
    "info": [
        {
            "title": "Competition",
            "value": "FIFA World Cup™"
        },
        {
            "title": "Kick-off",
            "value": "Yesterday"
        },
        {
            "title": "Stadium",
            "value": "San Francisco Bay Area Stadium"
        },
        {
            "title": "TV guide",
            "value": "MagentaTV"
        }
    ]
}
获取比赛详情 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29915/get+match+details?match_id=2650258' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回比赛的事件(进球、黄牌、替换球员)
Endpoint ID: 29916
GET https://docs.zylalabs.com/api/13509/onefootball+api/29916/get+match+events
输入参数

获取比赛事件 — 端点功能

对象 描述
match_id 必需 ID of the match.

剩余免费测试请求:3 / 3。


输入参数

match_id
API 示例响应
JSON
[
    {
        "minute": "45'",
        "type": "Goal",
        "team": "home",
        "player": "Folarin Balogun",
        "playerIn": null,
        "playerOut": null
    },
    {
        "minute": "51'",
        "type": "Substitution",
        "team": "away",
        "player": null,
        "playerIn": "Esmir Bajraktarević",
        "playerOut": "Armin Gigovic"
    },
    {
        "minute": "51'",
        "type": "Substitution",
        "team": "away",
        "player": null,
        "playerIn": "Benjamin Tahirović",
        "playerOut": "Ivan Sunjic"
    },
    {
        "minute": "51'",
        "type": "Substitution",
        "team": "away",
        "player": null,
        "playerIn": "Ermin Mahmić",
        "playerOut": "Edin Dzeko"
    },
    {
        "minute": "64'",
        "type": "Red card",
        "team": "home",
        "player": "Folarin Balogun",
        "playerIn": null,
        "playerOut": null
    },
    {
        "minute": "75'",
        "type": "Substitution",
        "team": "away",
        "player": null,
        "playerIn": "Haris Tabakovic",
        "playerOut": "Sead Kolasinac"
    },
    {
        "minute": "75'",
        "type": "Substitution",
        "team": "away",
        "player": null,
        "playerIn": "Amar Memić",
        "playerOut": "Nikola Katic"
    },
    {
        "minute": "80'",
        "type": "Yellow card",
        "team": "away",
        "player": "Stjepan Radeljic",
        "playerIn": null,
        "playerOut": null
    },
    {
        "minute": "80'",
        "type": "Yellow card",
        "team": "away",
        "player": "Player 0",
        "playerIn": null,
        "playerOut": null
    },
    {
        "minute": "82'",
        "type": "Goal",
        "team": "home",
        "player": "Malik Tillman",
        "playerIn": null,
        "playerOut": null
    },
    {
        "minute": "87'",
        "type": "Substitution",
        "team": "home",
        "player": null,
        "playerIn": "Sebastian Berhalter",
        "playerOut": "Sergiño Dest"
    },
    {
        "minute": "88'",
        "type": "Substitution",
        "team": "home",
        "player": null,
        "playerIn": "Ricardo Pepi",
        "playerOut": "Christian Pulisic"
    },
    {
        "minute": "95'",
        "type": "Substitution",
        "team": "home",
        "player": null,
        "playerIn": "Giovanni Reyna",
        "playerOut": "Weston McKennie"
    }
]
获取比赛事件 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29916/get+match+events?match_id=2650258' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回比赛的阵容
Endpoint ID: 29917
GET https://docs.zylalabs.com/api/13509/onefootball+api/29917/get+match+lineup
输入参数

获取比赛阵容 — 端点功能

对象 描述
match_id 必需 ID of the match.

剩余免费测试请求:3 / 3。


输入参数

match_id
API 示例响应
JSON
{
    "title": "LINE-UPS (CONFIRMED)",
    "homeTeam": {
        "name": "United States",
        "players": [
            {
                "id": 165454,
                "name": "Christian Pulisic",
                "number": 10,
                "image": "https://images.onefootball.com/players/180/165454.jpg",
                "url": "https://onefootball.com/en/player/christian-pulisic-165454"
            },
            {
                "id": 257487,
                "name": "Folarin Balogun",
                "number": 20,
                "image": "https://images.onefootball.com/players/180/257487.jpg",
                "url": "https://onefootball.com/en/player/folarin-balogun-257487"
            },
            {
                "id": 250700,
                "name": "Sergiño Dest",
                "number": 2,
                "image": "https://images.onefootball.com/players/180/250700.jpg",
                "url": "https://onefootball.com/en/player/sergino-dest-250700"
            },
            {
                "id": 313239,
                "name": "Malik Tillman",
                "number": 17,
                "image": "https://images.onefootball.com/players/180/313239.jpg",
                "url": "https://onefootball.com/en/player/malik-tillman-313239"
            },
            {
                "id": 139813,
                "name": "Tyler Adams",
                "number": 4,
                "image": "https://images.onefootball.com/players/180/139813.jpg",
                "url": "https://onefootball.com/en/player/tyler-adams-139813"
            },
            {
                "id": 208265,
                "name": "Weston McKennie",
                "number": 8,
                "image": "https://images.onefootball.com/players/180/208265.jpg",
                "url": "https://onefootball.com/en/player/weston-mckennie-208265"
            },
            {
                "id": 145799,
                "name": "Antonee Robinson",
                "number": 5,
                "image": "https://images.onefootball.com/players/180/145799.jpg",
                "url": "https://onefootball.com/en/player/antonee-robinson-145799"
            },
            {
                "id": 19137,
                "name": "Tim Ream",
                "number": 13,
                "image": "https://images.onefootball.com/players/180/19137.jpg",
                "url": "https://onefootball.com/en/player/tim-ream-19137"
            },
            {
                "id": 254656,
                "name": "Chris Richards",
                "number": 3,
                "image": "https://images.onefootball.com/players/180/254656.jpg",
                "url": "https://onefootball.com/en/player/chris-richards-254656"
            },
            {
                "id": 474016,
                "name": "Alex Freeman",
                "number": 16,
                "image": "https://images.onefootball.com/players/180/474016.jpg",
                "url": "https://onefootball.com/en/player/alex-freeman-474016"
            },
            {
                "id": 310744,
                "name": "Matt Freese",
                "number": 24,
                "image": "https://images.onefootball.com/players/180/310744.jpg",
                "url": "https://onefootball.com/en/player/matt-freese-310744"
            }
        ]
    },
    "awayTeam": {
        "name": "Bosnia & Herzegovina",
        "players": [
            {
                "id": 219481,
                "name": "Ermedin Demirovic",
                "number": 10,
                "image": "https://images.onefootball.com/players/180/219481.jpg",
                "url": "https://onefootball.com/en/player/ermedin-demirovic-219481"
            },
            {
                "id": 1002,
                "name": "Edin Dzeko",
                "number": 11,
                "image": "https://images.onefootball.com/players/180/1002.jpg",
                "url": "https://onefootball.com/en/player/edin-dzeko-1002"
            },
            {
                "id": 514224,
                "name": "Kerim Alajbegović",
                "number": 19,
                "image": "https://images.onefootball.com/players/180/514224.jpg",
                "url": "https://onefootball.com/en/player/kerim-alajbegovic-514224"
            },
            {
                "id": 170086,
                "name": "Ivan Sunjic",
                "number": 14,
                "image": "https://images.onefootball.com/players/180/170086.jpg",
                "url": "https://onefootball.com/en/player/ivan-sunjic-170086"
            },
            {
                "id": 317445,
                "name": "Armin Gigovic",
                "number": 8,
                "image": "https://images.onefootball.com/players/180/317445.jpg",
                "url": "https://onefootball.com/en/player/armin-gigovic-317445"
            },
            {
                "id": 24865,
                "name": "Sead Kolasinac",
                "number": 5,
                "image": "https://images.onefootball.com/players/180/24865.jpg",
                "url": "https://onefootball.com/en/player/sead-kolasinac-24865"
            },
            {
                "id": 183272,
                "name": "Stjepan Radeljic",
                "number": 21,
                "image": "https://images.onefootball.com/players/180/183272.jpg",
                "url": "https://onefootball.com/en/player/stjepan-radeljic-183272"
            },
            {
                "id": 398106,
                "name": "Tarik Muharemović",
                "number": 4,
                "image": "https://images.onefootball.com/players/180/398106.jpg",
                "url": "https://onefootball.com/en/player/tarik-muharemovic-398106"
            },
            {
                "id": 176800,
                "name": "Nikola Katic",
                "number": 18,
                "image": "https://images.onefootball.com/players/180/176800.jpg",
                "url": "https://onefootball.com/en/player/nikola-katic-176800"
            },
            {
                "id": 269041,
                "name": "Amar Dedic",
                "number": 7,
                "image": "https://images.onefootball.com/players/180/269041.jpg",
                "url": "https://onefootball.com/en/player/amar-dedic-269041"
            },
            {
                "id": 49221,
                "name": "Nikola Vasilj",
                "number": 1,
                "image": "https://images.onefootball.com/players/180/49221.jpg",
                "url": "https://onefootball.com/en/player/nikola-vasilj-49221"
            }
        ]
    }
}
获取比赛阵容 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29917/get+match+lineup?match_id=2650258' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回比赛的统计数据
Endpoint ID: 29918
GET https://docs.zylalabs.com/api/13509/onefootball+api/29918/get+match+stats
输入参数

获取比赛统计 — 端点功能

对象 描述
match_id 必需 ID of the match.

剩余免费测试请求:3 / 3。


输入参数

match_id
API 示例响应
JSON
[
    {
        "title": "Possession",
        "home": 48,
        "away": 52,
        "unit": "PERCENT"
    },
    {
        "title": "Total shots",
        "home": 8,
        "away": 10,
        "unit": null
    },
    {
        "title": "Shots on target",
        "home": 2,
        "away": 3,
        "unit": null
    },
    {
        "title": "Duels won",
        "home": 58,
        "away": 43,
        "unit": "PERCENT"
    }
]
获取比赛统计 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29918/get+match+stats?match_id=2650258' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回比赛的粉丝预测(投票)
Endpoint ID: 29919
GET https://docs.zylalabs.com/api/13509/onefootball+api/29919/get+match+prediction
输入参数

获取比赛预测 — 端点功能

对象 描述
match_id 必需 ID of the match.

剩余免费测试请求:3 / 3。


输入参数

match_id
API 示例响应
JSON
{
    "title": "Who will win?",
    "home": {
        "name": "United States",
        "votes": 36659
    },
    "draw": {
        "name": "Draw",
        "votes": 2453
    },
    "away": {
        "name": "Bosnia & Herzegovina",
        "votes": 13401
    }
}
获取比赛预测 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29919/get+match+prediction?match_id=2650258' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回比赛中两支球队的近期状态
Endpoint ID: 29920
GET https://docs.zylalabs.com/api/13509/onefootball+api/29920/get+match+form+guide
输入参数

获取比赛表格指南 — 端点功能

对象 描述
match_id 必需 ID of the match.

剩余免费测试请求:3 / 3。


输入参数

match_id
API 示例响应
JSON
[
    {
        "team": "United States",
        "matches": [
            {
                "id": 2650258,
                "url": "https://onefootball.com/en/match/2650258",
                "datetime": "2026-07-02T00:00:00Z",
                "outcome": "Win",
                "homeTeam": {
                    "id": 81,
                    "name": "United States",
                    "image": "https://images.onefootball.com/icons/teams/164/81.png",
                    "score": "2"
                },
                "awayTeam": {
                    "id": 297,
                    "name": "Bosnia & Herzegovina",
                    "image": "https://images.onefootball.com/icons/teams/164/297.png",
                    "score": "0"
                }
            },
            {
                "id": 2650065,
                "url": "https://onefootball.com/en/match/2650065",
                "datetime": "2026-06-26T02:00:00Z",
                "outcome": "Loss",
                "homeTeam": {
                    "id": 123,
                    "name": "Türkiye",
                    "image": "https://images.onefootball.com/icons/teams/164/123.png",
                    "score": "3"
                },
                "awayTeam": {
                    "id": 81,
                    "name": "United States",
                    "image": "https://images.onefootball.com/icons/teams/164/81.png",
                    "score": "2"
                }
            },
            {
                "id": 2645062,
                "url": "https://onefootball.com/en/match/2645062",
                "datetime": "2026-06-19T19:00:00Z",
                "outcome": "Win",
                "homeTeam": {
                    "id": 81,
                    "name": "United States",
                    "image": "https://images.onefootball.com/icons/teams/164/81.png",
                    "score": "2"
                },
                "awayTeam": {
                    "id": 74,
                    "name": "Australia",
                    "image": "https://images.onefootball.com/icons/teams/164/74.png",
                    "score": "0"
                }
            },
            {
                "id": 2645043,
                "url": "https://onefootball.com/en/match/2645043",
                "datetime": "2026-06-13T01:00:00Z",
                "outcome": "Win",
                "homeTeam": {
                    "id": 81,
                    "name": "United States",
                    "image": "https://images.onefootball.com/icons/teams/164/81.png",
                    "score": "4"
                },
                "awayTeam": {
                    "id": 47,
                    "name": "Paraguay",
                    "image": "https://images.onefootball.com/icons/teams/164/47.png",
                    "score": "1"
                }
            },
            {
                "id": 2657793,
                "url": "https://onefootball.com/en/match/2657793",
                "datetime": "2026-06-06T18:30:00Z",
                "outcome": "Loss",
                "homeTeam": {
                    "id": 81,
                    "name": "United States",
                    "image": "https://images.onefootball.com/icons/teams/164/81.png",
                    "score": "1"
                },
                "awayTeam": {
                    "id": 96,
                    "name": "Germany",
                    "image": "https://images.onefootball.com/icons/teams/164/96.png",
                    "score": "2"
                }
            }
        ]
    },
    {
        "team": "Bosnia & Herzegovina",
        "matches": [
            {
                "id": 2650258,
                "url": "https://onefootball.com/en/match/2650258",
                "datetime": "2026-07-02T00:00:00Z",
                "outcome": "Loss",
                "homeTeam": {
                    "id": 81,
                    "name": "United States",
                    "image": "https://images.onefootball.com/icons/teams/164/81.png",
                    "score": "2"
                },
                "awayTeam": {
                    "id": 297,
                    "name": "Bosnia & Herzegovina",
                    "image": "https://images.onefootball.com/icons/teams/164/297.png",
                    "score": "0"
                }
            },
            {
                "id": 2650060,
                "url": "https://onefootball.com/en/match/2650060",
                "datetime": "2026-06-24T19:00:00Z",
                "outcome": "Win",
                "homeTeam": {
                    "id": 297,
                    "name": "Bosnia & Herzegovina",
                    "image": "https://images.onefootball.com/icons/teams/164/297.png",
                    "score": "3"
                },
                "awayTeam": {
                    "id": 586,
                    "name": "Qatar",
                    "image": "https://images.onefootball.com/icons/teams/164/586.png",
                    "score": "1"
                }
            },
            {
                "id": 2650056,
                "url": "https://onefootball.com/en/match/2650056",
                "datetime": "2026-06-18T19:00:00Z",
                "outcome": "Loss",
                "homeTeam": {
                    "id": 93,
                    "name": "Switzerland",
                    "image": "https://images.onefootball.com/icons/teams/164/93.png",
                    "score": "4"
                },
                "awayTeam": {
                    "id": 297,
                    "name": "Bosnia & Herzegovina",
                    "image": "https://images.onefootball.com/icons/teams/164/297.png",
                    "score": "1"
                }
            },
            {
                "id": 2650050,
                "url": "https://onefootball.com/en/match/2650050",
                "datetime": "2026-06-12T19:00:00Z",
                "outcome": "Draw",
                "homeTeam": {
                    "id": 132,
                    "name": "Canada",
                    "image": "https://images.onefootball.com/icons/teams/164/132.png",
                    "score": "1"
                },
                "awayTeam": {
                    "id": 297,
                    "name": "Bosnia & Herzegovina",
                    "image": "https://images.onefootball.com/icons/teams/164/297.png",
                    "score": "1"
                }
            },
            {
                "id": 2682126,
                "url": "https://onefootball.com/en/match/2682126",
                "datetime": "2026-06-06T19:00:00Z",
                "outcome": "Draw",
                "homeTeam": {
                    "id": 1022,
                    "name": "Panama",
                    "image": "https://images.onefootball.com/icons/teams/164/1022.png",
                    "score": "1"
                },
                "awayTeam": {
                    "id": 297,
                    "name": "Bosnia & Herzegovina",
                    "image": "https://images.onefootball.com/icons/teams/164/297.png",
                    "score": "1"
                }
            }
        ]
    }
]
获取比赛表格指南 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29920/get+match+form+guide?match_id=2650258' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回 OneFootball 上某个玩家的详细信息
Endpoint ID: 29921
GET https://docs.zylalabs.com/api/13509/onefootball+api/29921/get+player+details
输入参数

获取玩家详情 — 端点功能

对象 描述
player_id 必需 Player ID.

剩余免费测试请求:3 / 3。


输入参数

player_id
API 示例响应
JSON
{
    "id": 823,
    "name": "Cristiano Ronaldo",
    "image": "https://images.onefootball.com/players/180/823.jpg",
    "club": "Al-Nassr",
    "age": "41",
    "position": "Forward",
    "country": "Portugal",
    "height": "188 cm",
    "weight": "80 kg",
    "number": "7",
    "teams": [
        {
            "id": 43,
            "name": "Portugal",
            "image": "https://images.onefootball.com/icons/teams/164/43.png",
            "url": "https://onefootball.com/en/team/portugal-43"
        },
        {
            "id": 2329,
            "name": "Al-Nassr",
            "image": "https://images.onefootball.com/icons/teams/164/2329.png",
            "url": "https://onefootball.com/en/team/al-nassr-2329"
        }
    ],
    "url": "https://onefootball.com/en/player/cristiano-ronaldo-823"
}
获取玩家详情 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29921/get+player+details?player_id=823' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回一个赛季的球员统计,按类别分组
Endpoint ID: 29922
GET https://docs.zylalabs.com/api/13509/onefootball+api/29922/get+player+stats
输入参数

获取玩家统计数据 — 端点功能

对象 描述
player_id 必需 Player ID.
season_id 必需 Season ID.

剩余免费测试请求:3 / 3。


输入参数

player_id
season_id
API 示例响应
JSON
[
    {
        "title": "KEY STATS",
        "stats": [
            {
                "name": "Goals",
                "value": "5"
            },
            {
                "name": "Assists",
                "value": "0"
            },
            {
                "name": "Shot Accuracy",
                "value": "46.15"
            },
            {
                "name": "Pass Accuracy",
                "value": "91.4"
            }
        ]
    },
    {
        "title": "DEFENCE",
        "stats": [
            {
                "name": "Tackles",
                "value": "0"
            },
            {
                "name": "Tackles Won",
                "value": "0.0"
            },
            {
                "name": "Duels",
                "value": "21"
            },
            {
                "name": "Duels won",
                "value": "19.05 %"
            },
            {
                "name": "Aerial duels won",
                "value": "36.36 %"
            },
            {
                "name": "Clearances",
                "value": "0"
            },
            {
                "name": "Blocked shots",
                "value": "0"
            },
            {
                "name": "Interceptions",
                "value": "0"
            }
        ]
    },
    {
        "title": "DISTRIBUTION",
        "stats": [
            {
                "name": "Assists",
                "value": "0"
            },
            {
                "name": "Total passes",
                "value": "93"
            },
            {
                "name": "Pass accuracy",
                "value": "91.4 %"
            },
            {
                "name": "Passes / 90 minutes",
                "value": "22.32"
            },
            {
                "name": "Touches / game",
                "value": "139"
            },
            {
                "name": "Total crosses",
                "value": "1"
            },
            {
                "name": "Cross accuracy",
                "value": "100.00"
            }
        ]
    },
    {
        "title": "OFFENSE",
        "stats": [
            {
                "name": "Goals",
                "value": "5"
            },
            {
                "name": "Minutes / goal",
                "value": "75.0"
            },
            {
                "name": "Shot accuracy",
                "value": "46.15 %"
            },
            {
                "name": "Right foot goals",
                "value": "4"
            },
            {
                "name": "Left foot goals",
                "value": "1"
            },
            {
                "name": "Headed goals",
                "value": "0"
            },
            {
                "name": "Goals - inside the box",
                "value": "4"
            },
            {
                "name": "Goals - outside the box",
                "value": "1"
            },
            {
                "name": "Other goals",
                "value": "0"
            },
            {
                "name": "Successful dribbles",
                "value": "0"
            },
            {
                "name": "Offsides",
                "value": "5"
            }
        ]
    },
    {
        "title": "DISCIPLINE",
        "stats": [
            {
                "name": "Yellow cards",
                "value": "0"
            },
            {
                "name": "Yellow - red cards",
                "value": "0"
            },
            {
                "name": "Red cards",
                "value": "1"
            },
            {
                "name": "Fouls conceded",
                "value": "3"
            },
            {
                "name": "Fouls won",
                "value": "0"
            }
        ]
    }
]
获取玩家统计数据 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29922/get+player+stats?player_id=823&season_id=42055' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回球员有统计数据的赛季/比赛
Endpoint ID: 29923
GET https://docs.zylalabs.com/api/13509/onefootball+api/29923/get+player+seasons
输入参数

获取玩家赛季 — 端点功能

对象 描述
player_id 必需 Player ID.

剩余免费测试请求:3 / 3。


输入参数

player_id
API 示例响应
JSON
[
    {
        "id": 42055,
        "name": "UEFA World Cup Qualifying"
    },
    {
        "id": 43402,
        "name": "UEFA Nations League"
    },
    {
        "id": 41041,
        "name": "EURO 2024"
    },
    {
        "id": 40183,
        "name": "Euro 2024 Qualifying"
    },
    {
        "id": 43241,
        "name": "World Cup"
    },
    {
        "id": 43342,
        "name": "International Friendlies"
    },
    {
        "id": 43643,
        "name": "Saudi Pro League"
    },
    {
        "id": 43051,
        "name": "Saudi Super Cup"
    },
    {
        "id": 43555,
        "name": "King's Cup"
    },
    {
        "id": 43313,
        "name": "Club Friendly Games"
    },
    {
        "id": 40706,
        "name": "Arab Club Champions Cup"
    }
]
获取玩家赛季 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29923/get+player+seasons?player_id=823' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
搜索团队 比赛 球员 和 新闻
Endpoint ID: 29924
GET https://docs.zylalabs.com/api/13509/onefootball+api/29924/search
输入参数

搜索 — 端点功能

对象 描述
q 必需 Search term.

剩余免费测试请求:3 / 3。


输入参数

q
API 示例响应
JSON
{
    "teams": [
        {
            "id": 26,
            "name": "Real Madrid",
            "country": {
                "name": "Spain",
                "code": "es"
            },
            "image": "https://images.onefootball.com/icons/teams/164/26.png",
            "url": "https://onefootball.com/en/team/real-madrid-26"
        },
        {
            "id": 1142,
            "name": "Real Madrid II",
            "country": {
                "name": "Spain",
                "code": "es"
            },
            "image": "https://images.onefootball.com/icons/teams/164/1142.png",
            "url": "https://onefootball.com/en/team/real-madrid-ii-1142"
        },
        {
            "id": 10668,
            "name": "Real Madrid U19",
            "country": {
                "name": "Spain",
                "code": "es"
            },
            "image": "https://images.onefootball.com/icons/teams/164/10668.png",
            "url": "https://onefootball.com/en/team/real-madrid-u19-10668"
        },
        {
            "id": 60713,
            "name": "Real Madrid U20",
            "country": {
                "name": "Spain",
                "code": "es"
            },
            "image": "https://images.onefootball.com/icons/teams/164/60713.png",
            "url": "https://onefootball.com/en/team/real-madrid-u20-60713"
        },
        {
            "id": 18568,
            "name": "Real Madrid Women",
            "country": {
                "name": "Spain",
                "code": "es"
            },
            "image": "https://images.onefootball.com/icons/teams/164/18568.png",
            "url": "https://onefootball.com/en/team/real-madrid-women-18568"
        }
    ],
    "competitions": [],
    "players": [],
    "news": [
        {
            "id": 43271342,
            "title": "Spanish Super Cup to be played in Istanbul",
            "date": "2026-08-13T14:25:09Z",
            "image": "https://image-service.onefootball.com/crop/face?h=826&image=https%3A%2F%2Fcdn-img.staticzz.com%2Fimg%2Fnoticias%2F538%2FimgS620I1174538T20260813152110.jpg&q=40&w=1240",
            "url": "https://onefootball.com/editorial/43271342?language=en"
        },
        {
            "id": 43271248,
            "title": "Jose Mourinho talks team progression as Real Madrid secure victory in penultimate pre-season friendly",
            "date": "2026-08-13T14:15:14Z",
            "image": "https://image-service.onefootball.com/crop/face?h=4000&image=https%3A%2F%2Ficdn.siempremadrid.com%2Fwp-content%2Fuploads%2F2026%2F08%2Frc-deportivo-a-coruna-v-real-madrid-trofeo-teresa-herrera-1.jpg&q=40&w=5892",
            "url": "https://onefootball.com/editorial/43271248?language=en"
        },
        {
            "id": 43271244,
            "title": "Real Madrid players react to friendly win against Deportivo La Coruna",
            "date": "2026-08-13T14:15:13Z",
            "image": "https://image-service.onefootball.com/crop/face?h=2081&image=https%3A%2F%2Ficdn.siempremadrid.com%2Fwp-content%2Fuploads%2F2026%2F08%2Frc-deportivo-a-coruna-v-real-madrid-trofeo-teresa-herrera-2-1.jpg&q=40&w=3078",
            "url": "https://onefootball.com/editorial/43271244?language=en"
        },
        {
            "id": 43271239,
            "title": "Real Madrid trailing Liverpool in race to sign midfielder",
            "date": "2026-08-13T14:15:12Z",
            "image": "https://image-service.onefootball.com/crop/face?h=2190&image=https%3A%2F%2Ficdn.siempremadrid.com%2Fwp-content%2Fuploads%2F2026%2F08%2Fengland-v-uruguay-international-friendly.jpg&q=40&w=3556",
            "url": "https://onefootball.com/editorial/43271239?language=en"
        },
        {
            "id": 43271109,
            "title": "Atatürk Olympic Stadium to stage 2027 Spanish Super Cup in Istanbul",
            "date": "2026-08-13T13:51:57Z",
            "image": "https://image-service.onefootball.com/crop/face?h=80&image=https%3A%2F%2Fimage-service.onefootball.com%2Fresize%3Ffit%3Dmax%26q%3D40%26w%3D640%26image%3Dhttps%3A%2F%2Ffilebucket.onefootball.com%2F2025%2F12%2F1764849173511-news_update_2.png&q=40&w=1280",
            "url": "https://onefootball.com/editorial/43271109?language=en"
        },
        {
            "id": 43271049,
            "title": "Bellingham delighted by the chance to work with Mourinho at Real Madrid: ‘A dream for me’",
            "date": "2026-08-13T13:40:21Z",
            "image": "https://image-service.onefootball.com/crop/face?h=675&image=https%3A%2F%2Fmadriduniversal.com%2Fwp-content%2Fuploads%2F2026%2F08%2Fimage-20.png&q=40&w=1200",
            "url": "https://onefootball.com/editorial/43271049?language=en"
        },
        {
            "id": 43270809,
            "title": "Real Madrid refuse to force departures as Mourinho’s squad is declared complete",
            "date": "2026-08-13T12:55:16Z",
            "image": "https://image-service.onefootball.com/crop/face?h=1244&image=https%3A%2F%2Fmadriduniversal.com%2Fwp-content%2Fuploads%2F2026%2F08%2Freal-madrid-v-fiorentina-pre-season-friendly-8-scaled.jpg&q=40&w=1920",
            "url": "https://onefootball.com/editorial/43270809?language=en"
        },
        {
            "id": 43270731,
            "title": "José Mourinho lands first trophy of the season with Real Madrid",
            "date": "2026-08-13T12:40:16Z",
            "image": "https://image-service.onefootball.com/crop/face?h=689&image=https%3A%2F%2Fglorioso1904.pt%2Fstorage%2Fmedia-items%2Fimage%2F2026%2F08%2Fjose-mourinho-benfica-real-madrid_20260813013725.webp&q=40&w=1224",
            "url": "https://onefootball.com/editorial/43270731?language=en"
        },
        {
            "id": 43270686,
            "title": "Atlético Madrid Accept €18m Deal as Molina Nears Roma Move",
            "date": "2026-08-13T12:35:09Z",
            "image": "https://image-service.onefootball.com/crop/face?h=675&image=https%3A%2F%2Fwww.football-espana.net%2Fwp-content%2Fuploads%2F2026%2F08%2Fatletico-madrid-accept-18m-deal-molina-roma-move.webp&q=40&w=1200",
            "url": "https://onefootball.com/editorial/43270686?language=en"
        },
        {
            "id": 43270422,
            "title": "Confirmed: Spanish Super Cup 2027 to be held in Istanbul in February",
            "date": "2026-08-13T11:30:23Z",
            "image": "https://image-service.onefootball.com/crop/face?h=1280&image=https%3A%2F%2Fmadriduniversal.com%2Fwp-content%2Fuploads%2F2026%2F08%2Freal-madrid-cf-v-fc-barcelona-super-copa-de-espana-final-scaled.jpg&q=40&w=1920",
            "url": "https://onefootball.com/editorial/43270422?language=en"
        }
    ]
}
搜索 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29924/search?q=real madrid' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回所有团队的字母索引
Endpoint ID: 29925
GET https://docs.zylalabs.com/api/13509/onefootball+api/29925/get+all+team+letters
输入参数

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。

API 示例响应
JSON
[
    {
        "letter": "A",
        "url": "https://onefootball.com/en/all-teams/a"
    },
    {
        "letter": "B",
        "url": "https://onefootball.com/en/all-teams/b"
    },
    {
        "letter": "C",
        "url": "https://onefootball.com/en/all-teams/c"
    },
    {
        "letter": "D",
        "url": "https://onefootball.com/en/all-teams/d"
    },
    {
        "letter": "E",
        "url": "https://onefootball.com/en/all-teams/e"
    },
    {
        "letter": "F",
        "url": "https://onefootball.com/en/all-teams/f"
    },
    {
        "letter": "G",
        "url": "https://onefootball.com/en/all-teams/g"
    },
    {
        "letter": "H",
        "url": "https://onefootball.com/en/all-teams/h"
    },
    {
        "letter": "I",
        "url": "https://onefootball.com/en/all-teams/i"
    },
    {
        "letter": "J",
        "url": "https://onefootball.com/en/all-teams/j"
    },
    {
        "letter": "K",
        "url": "https://onefootball.com/en/all-teams/k"
    },
    {
        "letter": "L",
        "url": "https://onefootball.com/en/all-teams/l"
    },
    {
        "letter": "M",
        "url": "https://onefootball.com/en/all-teams/m"
    },
    {
        "letter": "N",
        "url": "https://onefootball.com/en/all-teams/n"
    },
    {
        "letter": "O",
        "url": "https://onefootball.com/en/all-teams/o"
    },
    {
        "letter": "P",
        "url": "https://onefootball.com/en/all-teams/p"
    },
    {
        "letter": "Q",
        "url": "https://onefootball.com/en/all-teams/q"
    },
    {
        "letter": "R",
        "url": "https://onefootball.com/en/all-teams/r"
    },
    {
        "letter": "S",
        "url": "https://onefootball.com/en/all-teams/s"
    },
    {
        "letter": "T",
        "url": "https://onefootball.com/en/all-teams/t"
    },
    {
        "letter": "U",
        "url": "https://onefootball.com/en/all-teams/u"
    },
    {
        "letter": "V",
        "url": "https://onefootball.com/en/all-teams/v"
    },
    {
        "letter": "W",
        "url": "https://onefootball.com/en/all-teams/w"
    },
    {
        "letter": "X",
        "url": "https://onefootball.com/en/all-teams/x"
    },
    {
        "letter": "Y",
        "url": "https://onefootball.com/en/all-teams/y"
    },
    {
        "letter": "Z",
        "url": "https://onefootball.com/en/all-teams/z"
    }
]
获取所有团队信件 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29925/get+all+team+letters' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回字母的所有团队
Endpoint ID: 29926
GET https://docs.zylalabs.com/api/13509/onefootball+api/29926/get+teams+by+letter
输入参数

按字母获取团队 — 端点功能

对象 描述
letter 必需 Single letter (a-z) the results are filtered by.

剩余免费测试请求:3 / 3。


输入参数

letter
API 示例响应
JSON
[
    {
        "id": 3944,
        "name": "68 Aksarayspor",
        "url": "https://onefootball.com/en/team/68-aksarayspor-3944"
    },
    {
        "id": 14849,
        "name": "A Quilmes",
        "url": "https://onefootball.com/en/team/a-quilmes-14849"
    },
    {
        "id": 54150,
        "name": "A-Leagues All Stars",
        "url": "https://onefootball.com/en/team/a-leagues-all-stars-54150"
    },
    {
        "id": 50332,
        "name": "A. Melilla",
        "url": "https://onefootball.com/en/team/a-melilla-50332"
    },
    {
        "id": 12501,
        "name": "A.C.S.M.",
        "url": "https://onefootball.com/en/team/acsm-12501"
    },
    {
        "id": 59440,
        "name": "AA Lapalisse Football",
        "url": "https://onefootball.com/en/team/aa-lapalisse-football-59440"
    },
    {
        "id": 5944,
        "name": "AB",
        "url": "https://onefootball.com/en/team/ab-5944"
    },
    {
        "id": 57208,
        "name": "ABB",
        "url": "https://onefootball.com/en/team/abb-57208"
    },
    {
        "id": 2661,
        "name": "ABC",
        "url": "https://onefootball.com/en/team/abc-2661"
    },
    {
        "id": 53033,
        "name": "ABECAT",
        "url": "https://onefootball.com/en/team/abecat-53033"
    },
    {
        "id": 43729,
        "name": "AC Guaratinguetá U20",
        "url": "https://onefootball.com/en/team/ac-guaratingueta-u20-43729"
    },
    {
        "id": 55271,
        "name": "AC Milan U20",
        "url": "https://onefootball.com/en/team/ac-milan-u20-55271"
    },
    {
        "id": 55260,
        "name": "AC Monza U20",
        "url": "https://onefootball.com/en/team/ac-monza-u20-55260"
    },
    {
        "id": 58347,
        "name": "AC Palermo",
        "url": "https://onefootball.com/en/team/ac-palermo-58347"
    },
    {
        "id": 60826,
        "name": "AC Studenterna",
        "url": "https://onefootball.com/en/team/ac-studenterna-60826"
    },
    {
        "id": 58624,
        "name": "ACD Maceratese",
        "url": "https://onefootball.com/en/team/acd-maceratese-58624"
    },
    {
        "id": 29889,
        "name": "ACF Brescia Femminile",
        "url": "https://onefootball.com/en/team/acf-brescia-femminile-29889"
    },
    {
        "id": 23527,
        "name": "ACF Fiorentina U19",
        "url": "https://onefootball.com/en/team/acf-fiorentina-u19-23527"
    },
    {
        "id": 31593,
        "name": "ACF Fiorentina U20",
        "url": "https://onefootball.com/en/team/acf-fiorentina-u20-31593"
    },
    {
        "id": 836,
        "name": "ACR Messina",
        "url": "https://onefootball.com/en/team/acr-messina-836"
    },
    {
        "id": 59938,
        "name": "ACS Academica Balș",
        "url": "https://onefootball.com/en/team/acs-academica-bals-59938"
    },
    {
        "id": 55760,
        "name": "ACS CIL Blaj",
        "url": "https://onefootball.com/en/team/acs-cil-blaj-55760"
    },
    {
        "id": 23578,
        "name": "ACS Kids Tâmpa Braşov",
        "url": "https://onefootball.com/en/team/acs-kids-tampa-brasov-23578"
    },
    {
        "id": 53010,
        "name": "ACS Mediaş",
        "url": "https://onefootball.com/en/team/acs-medias-53010"
    },
    {
        "id": 53083,
        "name": "ACS Progresul Fundulea",
        "url": "https://onefootball.com/en/team/acs-progresul-fundulea-53083"
    },
    {
        "id": 26463,
        "name": "ACS Recolta Gheorghe Doja",
        "url": "https://onefootball.com/en/team/acs-recolta-gheorghe-doja-26463"
    },
    {
        "id": 23580,
        "name": "ACS Unirea Braniştea",
        "url": "https://onefootball.com/en/team/acs-unirea-branistea-23580"
    },
    {
        "id": 56959,
        "name": "ACS Viitorul Arad",
        "url": "https://onefootball.com/en/team/acs-viitorul-arad-56959"
    },
    {
        "id": 5325,
        "name": "ACV",
        "url": "https://onefootball.com/en/team/acv-5325"
    },
    {
        "id": 59471,
        "name": "AD Aracaju",
        "url": "https://onefootball.com/en/team/ad-aracaju-59471"
    },
    {
        "id": 8939,
        "name": "ADESG",
        "url": "https://onefootball.com/en/team/adesg-8939"
    },
    {
        "id": 55788,
        "name": "ADIFFEM",
        "url": "https://onefootball.com/en/team/adiffem-55788"
    },
    {
        "id": 2159,
        "name": "ADO 20",
        "url": "https://onefootball.com/en/team/ado-20-2159"
    },
    {
        "id": 899,
        "name": "ADO Den Haag",
        "url": "https://onefootball.com/en/team/ado-den-haag-899"
    },
    {
        "id": 29724,
        "name": "ADO Den Haag Women",
        "url": "https://onefootball.com/en/team/ado-den-haag-women-29724"
    },
    {
        "id": 20673,
        "name": "ADT",
        "url": "https://onefootball.com/en/team/adt-20673"
    },
    {
        "id": 10986,
        "name": "AEA",
        "url": "https://onefootball.com/en/team/aea-10986"
    },
    {
        "id": 553,
        "name": "AEK Athens",
        "url": "https://onefootball.com/en/team/aek-athens-553"
    },
    {
        "id": 56038,
        "name": "AEK Boco",
        "url": "https://onefootball.com/en/team/aek-boco-56038"
    },
    {
        "id": 900,
        "name": "AEK Larnaca",
        "url": "https://onefootball.com/en/team/aek-larnaca-900"
    },
    {
        "id": 59127,
        "name": "AEK Larnaca U19",
        "url": "https://onefootball.com/en/team/aek-larnaca-u19-59127"
    },
    {
        "id": 1098,
        "name": "AEL Limassol",
        "url": "https://onefootball.com/en/team/ael-limassol-1098"
    },
    {
        "id": 21046,
        "name": "AEM Lleida",
        "url": "https://onefootball.com/en/team/aem-lleida-21046"
    },
    {
        "id": 17556,
        "name": "AERP",
        "url": "https://onefootball.com/en/team/aerp-17556"
    },
    {
        "id": 53024,
        "name": "AF CS Viitorul Curiţa",
        "url": "https://onefootball.com/en/team/af-cs-viitorul-curita-53024"
    },
    {
        "id": 37031,
        "name": "AF Elbasani",
        "url": "https://onefootball.com/en/team/af-elbasani-37031"
    },
    {
        "id": 31285,
        "name": "AFA Olaine",
        "url": "https://onefootball.com/en/team/afa-olaine-31285"
    },
    {
        "id": 27632,
        "name": "AFAD",
        "url": "https://onefootball.com/en/team/afad-27632"
    },
    {
        "id": 2155,
        "name": "AFC",
        "url": "https://onefootball.com/en/team/afc-2155"
    },
    {
        "id": 622,
        "name": "AFC Bournemouth",
        "url": "https://onefootball.com/en/team/afc-bournemouth-622"
    },
    {
        "id": 28660,
        "name": "AFC Bournemouth FC Under 18",
        "url": "https://onefootball.com/en/team/afc-bournemouth-fc-under-18-28660"
    },
    {
        "id": 19335,
        "name": "AFC Bournemouth Women",
        "url": "https://onefootball.com/en/team/afc-bournemouth-women-19335"
    },
    {
        "id": 4790,
        "name": "AFC Eskilstuna",
        "url": "https://onefootball.com/en/team/afc-eskilstuna-4790"
    },
    {
        "id": 1458,
        "name": "AFC Fylde",
        "url": "https://onefootball.com/en/team/afc-fylde-1458"
    },
    {
        "id": 19346,
        "name": "AFC Fylde Women",
        "url": "https://onefootball.com/en/team/afc-fylde-women-19346"
    },
    {
        "id": 57503,
        "name": "AFC Inter Stars 2020 Sibiu",
        "url": "https://onefootball.com/en/team/afc-inter-stars-2020-sibiu-57503"
    },
    {
        "id": 26430,
        "name": "AFC Liverpool",
        "url": "https://onefootball.com/en/team/afc-liverpool-26430"
    },
    {
        "id": 21153,
        "name": "AFC Malmö",
        "url": "https://onefootball.com/en/team/afc-malmoe-21153"
    },
    {
        "id": 7441,
        "name": "AFC Mansfield",
        "url": "https://onefootball.com/en/team/afc-mansfield-7441"
    },
    {
        "id": 30263,
        "name": "AFC Portchester",
        "url": "https://onefootball.com/en/team/afc-portchester-30263"
    },
    {
        "id": 51956,
        "name": "AFC Portchester Ladies",
        "url": "https://onefootball.com/en/team/afc-portchester-ladies-51956"
    },
    {
        "id": 7037,
        "name": "AFC Rushden & Diamonds",
        "url": "https://onefootball.com/en/team/afc-rushden-diamonds-7037"
    },
    {
        "id": 8290,
        "name": "AFC Stoneham",
        "url": "https://onefootball.com/en/team/afc-stoneham-8290"
    },
    {
        "id": 20449,
        "name": "AFC Stoneham Ladies",
        "url": "https://onefootball.com/en/team/afc-stoneham-ladies-20449"
    },
    {
        "id": 54897,
        "name": "AFC Sudbury",
        "url": "https://onefootball.com/en/team/afc-sudbury-54897"
    },
    {
        "id": 20347,
        "name": "AFC Sudbury",
        "url": "https://onefootball.com/en/team/afc-sudbury-20347"
    },
    {
        "id": 56859,
        "name": "AFC Toronto",
        "url": "https://onefootball.com/en/team/afc-toronto-56859"
    },
    {
        "id": 1460,
        "name": "AFC Totton"
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
按字母获取团队 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29926/get+teams+by+letter?letter=a' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
团队的返回细节
Endpoint ID: 29927
GET https://docs.zylalabs.com/api/13509/onefootball+api/29927/get+team+details
输入参数

获取团队详情 — 端点功能

对象 描述
team_id 必需 ID of the team.

剩余免费测试请求:3 / 3。


输入参数

team_id
API 示例响应
JSON
{
    "id": 26,
    "name": "Real Madrid",
    "image": "https://images.onefootball.com/icons/teams/164/26.png",
    "url": "https://onefootball.com/en/team/real-madrid-26"
}
获取团队详情 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29927/get+team+details?team_id=26' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回一个团队即将进行的比赛,按月份分组
Endpoint ID: 29928
GET https://docs.zylalabs.com/api/13509/onefootball+api/29928/get+team+fixtures
输入参数

获取球队赛程 — 端点功能

对象 描述
team_id 必需 ID of the team.

剩余免费测试请求:3 / 3。


输入参数

team_id
API 示例响应
JSON
[
    {
        "name": "August 2026",
        "matches": [
            {
                "id": 2720425,
                "url": "https://onefootball.com/en/match/2720425",
                "datetime": "2026-08-16T15:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 144,
                    "name": "Schalke 04",
                    "image": "https://images.onefootball.com/icons/teams/164/144.png"
                },
                "awayTeam": {
                    "id": 26,
                    "name": "Real Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/26.png"
                }
            },
            {
                "id": 2700199,
                "url": "https://onefootball.com/en/match/2700199",
                "datetime": "2026-08-22T19:30:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 215,
                    "name": "Espanyol",
                    "image": "https://images.onefootball.com/icons/teams/164/215.png"
                },
                "awayTeam": {
                    "id": 26,
                    "name": "Real Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/26.png"
                }
            },
            {
                "id": 2700192,
                "url": "https://onefootball.com/en/match/2700192",
                "datetime": "2026-08-26T19:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 26,
                    "name": "Real Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/26.png"
                },
                "awayTeam": {
                    "id": 223,
                    "name": "Real Sociedad",
                    "image": "https://images.onefootball.com/icons/teams/164/223.png"
                }
            },
            {
                "id": 2700212,
                "url": "https://onefootball.com/en/match/2700212",
                "datetime": "2026-08-30T15:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 26,
                    "name": "Real Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/26.png"
                },
                "awayTeam": {
                    "id": 219,
                    "name": "Málaga",
                    "image": "https://images.onefootball.com/icons/teams/164/219.png"
                }
            }
        ]
    },
    {
        "name": "September 2026",
        "matches": [
            {
                "id": 2700217,
                "url": "https://onefootball.com/en/match/2700217",
                "datetime": "2026-09-04T19:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 691,
                    "name": "Real Betis",
                    "image": "https://images.onefootball.com/icons/teams/164/691.png"
                },
                "awayTeam": {
                    "id": 26,
                    "name": "Real Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/26.png"
                }
            },
            {
                "id": 2700231,
                "url": "https://onefootball.com/en/match/2700231",
                "datetime": "2026-09-13T12:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 26,
                    "name": "Real Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/26.png"
                },
                "awayTeam": {
                    "id": 690,
                    "name": "Rayo Vallecano",
                    "image": "https://images.onefootball.com/icons/teams/164/690.png"
                }
            },
            {
                "id": 2700239,
                "url": "https://onefootball.com/en/match/2700239",
                "datetime": "2026-09-16T12:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 682,
                    "name": "Elche",
                    "image": "https://images.onefootball.com/icons/teams/164/682.png"
                },
                "awayTeam": {
                    "id": 26,
                    "name": "Real Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/26.png"
                }
            },
            {
                "id": 2700246,
                "url": "https://onefootball.com/en/match/2700246",
                "datetime": "2026-09-20T12:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 3,
                    "name": "Atlético de Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/3.png"
                },
                "awayTeam": {
                    "id": 26,
                    "name": "Real Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/26.png"
                }
            }
        ]
    },
    {
        "name": "October 2026",
        "matches": [
            {
                "id": 2700263,
                "url": "https://onefootball.com/en/match/2700263",
                "datetime": "2026-10-11T12:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 26,
                    "name": "Real Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/26.png"
                },
                "awayTeam": {
                    "id": 226,
                    "name": "Villarreal",
                    "image": "https://images.onefootball.com/icons/teams/164/226.png"
                }
            }
        ]
    },
    {
        "name": "October 2026",
        "matches": [
            {
                "id": 2700272,
                "url": "https://onefootball.com/en/match/2700272",
                "datetime": "2026-10-18T12:00:00Z"
            }
        ]
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
获取球队赛程 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29928/get+team+fixtures?team_id=26' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回一个团队按月份分组的过往结果
Endpoint ID: 29929
GET https://docs.zylalabs.com/api/13509/onefootball+api/29929/get+team+results
输入参数

获取团队结果 — 端点功能

对象 描述
team_id 必需 ID of the team.

剩余免费测试请求:3 / 3。


输入参数

team_id
API 示例响应
JSON
[{"name":"August 2026","matches":[{"id":2707086,"url":"https:\/\/onefootball.com\/en\/match\/2707086","datetime":"2026-08-12T19:00:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":214,"name":"Deportivo A Coru\u00f1a","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/214.png","score":"0"},"awayTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"1"}},{"id":2716753,"url":"https:\/\/onefootball.com\/en\/match\/2716753","datetime":"2026-08-08T17:00:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":932,"name":"Ferencv\u00e1ros","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/932.png","score":"1"},"awayTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"2"}},{"id":2709950,"url":"https:\/\/onefootball.com\/en\/match\/2709950","datetime":"2026-08-01T16:00:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"2"},"awayTeam":{"id":15,"name":"Fiorentina","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/15.png","score":"2"}}]},{"name":"January 2026","matches":[{"id":2659806,"url":"https:\/\/onefootball.com\/en\/match\/2659806","datetime":"2026-01-14T20:00:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":678,"name":"Albacete","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/678.png","score":"3"},"awayTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"2"}}]},{"name":"December 2025","matches":[{"id":2650070,"url":"https:\/\/onefootball.com\/en\/match\/2650070","datetime":"2025-12-17T20:00:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":5740,"name":"Talavera","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/5740.png","score":"2"},"awayTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"3"}}]},{"name":"July 2025","matches":[{"id":2593163,"url":"https:\/\/onefootball.com\/en\/match\/2593163","datetime":"2025-07-09T19:10:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":263,"name":"PSG","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/263.png","score":"4"},"awayTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"0"}},{"id":2593161,"url":"https:\/\/onefootball.com\/en\/match\/2593161","datetime":"2025-07-05T20:00:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"3"},"awayTeam":{"id":155,"name":"Borussia Dortmund","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/155.png","score":"2"}},{"id":2593156,"url":"https:\/\/onefootball.com\/en\/match\/2593156","datetime":"2025-07-01T19:00:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"1"},"awayTeam":{"id":17,"name":"Juventus","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/17.png","score":"0"}}]},{"name":"June 2025","matches":[{"id":2558752,"url":"https:\/\/onefootball.com\/en\/match\/2558752","datetime":"2025-06-27T01:00:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":379,"name":"RB Salzburg","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/379.png","score":"0"},"awayTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"3"}},{"id":2558735,"url":"https:\/\/onefootball.com\/en\/match\/2558735","datetime":"2025-06-22T19:00:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"3"},"awayTeam":{"id":1838,"name":"Pachuca","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/1838.png","score":"1"}}]},{"name":"June 2025","matches":[{"id":2558716,"url":"https:\/\/onefootball.com\/en\/match\/2558716","datetime":"2025-06-18T19:00:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"1"},"awayTeam":{"id":2328,"name":"Al-Hilal","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/2328.png","score":"1"}}]}]
获取团队结果 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29929/get+team+results?team_id=26' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回按位置分组的团队阵容
Endpoint ID: 29930
GET https://docs.zylalabs.com/api/13509/onefootball+api/29930/get+team+squad
输入参数

获取团队阵容 — 端点功能

对象 描述
team_id 必需 ID of the team.

剩余免费测试请求:3 / 3。


输入参数

team_id
API 示例响应
JSON
[
    {
        "position": "Goalkeeper",
        "players": [
            {
                "id": 48058,
                "name": "Andriy Lunin",
                "number": 13,
                "position": "Goalkeeper",
                "image": "https://images.onefootball.com/players/180/48058.jpg",
                "url": "https://onefootball.com/en/player/andriy-lunin-48058"
            },
            {
                "id": 615454,
                "name": "Javi Navarro",
                "number": 29,
                "position": "Goalkeeper",
                "image": "https://images.onefootball.com/players/180/615454.jpg",
                "url": "https://onefootball.com/en/player/javi-navarro-615454"
            },
            {
                "id": 514089,
                "name": "Sergio Mestre",
                "number": 43,
                "position": "Goalkeeper",
                "image": "https://images.onefootball.com/players/180/514089.jpg",
                "url": "https://onefootball.com/en/player/sergio-mestre-514089"
            },
            {
                "id": 9719,
                "name": "Thibaut Courtois",
                "number": 1,
                "position": "Goalkeeper",
                "image": "https://images.onefootball.com/players/180/9719.jpg",
                "url": "https://onefootball.com/en/player/thibaut-courtois-9719"
            }
        ]
    },
    {
        "position": "DEFENCE",
        "players": [
            {
                "id": 611415,
                "name": "Aimar García",
                "number": null,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/611415.jpg",
                "url": "https://onefootball.com/en/player/aimar-garcia-611415"
            },
            {
                "id": 20953,
                "name": "Antonio Rüdiger",
                "number": 22,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/20953.jpg",
                "url": "https://onefootball.com/en/player/antonio-ruediger-20953"
            },
            {
                "id": 463335,
                "name": "Dean Huijsen",
                "number": 4,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/463335.jpg",
                "url": "https://onefootball.com/en/player/dean-huijsen-463335"
            },
            {
                "id": 96338,
                "name": "Denzel Dumfries",
                "number": 24,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/96338.jpg",
                "url": "https://onefootball.com/en/player/denzel-dumfries-96338"
            },
            {
                "id": 120836,
                "name": "Ferland Mendy",
                "number": 23,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/120836.jpg",
                "url": "https://onefootball.com/en/player/ferland-mendy-120836"
            },
            {
                "id": 200826,
                "name": "Ibrahima Konaté",
                "number": 16,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/200826.jpg",
                "url": "https://onefootball.com/en/player/ibrahima-konate-200826"
            },
            {
                "id": 553436,
                "name": "Jesús Fortea",
                "number": 32,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/553436.jpg",
                "url": "https://onefootball.com/en/player/jesus-fortea-553436"
            },
            {
                "id": 555725,
                "name": "Joan Martínez",
                "number": 36,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/555725.jpg",
                "url": "https://onefootball.com/en/player/joan-martinez-555725"
            },
            {
                "id": 609541,
                "name": "Lamini Fati",
                "number": 48,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/609541.jpg",
                "url": "https://onefootball.com/en/player/lamini-fati-609541"
            },
            {
                "id": 188965,
                "name": "Marc Cucurella",
                "number": 17,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/188965.jpg",
                "url": "https://onefootball.com/en/player/marc-cucurella-188965"
            },
            {
                "id": 602174,
                "name": "Mario Rivas",
                "number": 49,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/602174.jpg",
                "url": "https://onefootball.com/en/player/mario-rivas-602174"
            },
            {
                "id": 454811,
                "name": "Raúl Asencio",
                "number": 2,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/454811.jpg",
                "url": "https://onefootball.com/en/player/raul-asencio-454811"
            },
            {
                "id": 187991,
                "name": "Trent Alexander-Arnold",
                "number": 12,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/187991.jpg",
                "url": "https://onefootball.com/en/player/trent-alexander-arnold-187991"
            },
            {
                "id": 416495,
                "name": "Álvaro Carreras",
                "number": 18,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/416495.jpg",
                "url": "https://onefootball.com/en/player/alvaro-carreras-416495"
            },
            {
                "id": 168738,
                "name": "Éder Militão",
                "number": 3,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/168738.jpg",
                "url": "https://onefootball.com/en/player/eder-militao-168738"
            }
        ]
    },
    {
        "position": "Midfielder",
        "players": [
            {
                "id": 416314,
                "name": "Arda Güler",
                "number": 15,
                "position": "Midfielder",
                "image": "https://images.onefootball.com/players/180/416314.jpg",
                "url": "https://onefootball.com/en/player/arda-gueler-416314"
            },
            {
                "id": 195848,
                "name": "Aurélien Tchouaméni",
                "number": 14,
                "position": "Midfielder",
                "image": "https://images.onefootball.com/players/180/195848.jpg",
                "url": "https://onefootball.com/en/player/aurelien-tchouameni-195848"
            },
            {
                "id": 63999,
                "name": "Bernardo Silva",
                "number": 20,
                "position": "Midfielder",
                "image": "https://images.onefootball.com/players/180/63999.jpg",
                "url": "https://onefootball.com/en/player/bernardo-silva-63999"
            },
            {
                "id": 193595,
                "name": "Brahim Diaz",
                "number": 21,
                "position": "Midfielder",
                "image": "https://images.onefootball.com/players/180/193595.jpg",
                "url": "https://onefootball.com/en/player/brahim-diaz-193595"
            },
            {
                "id": 562931,
                "name": "Cestero",
                "number": 28,
                "position": "Midfielder",
                "image": "https://images.onefootball.com/players/180/562931.jpg",
                "url": "https://onefootball.com/en/player/cestero-562931"
            },
            {
                "id": 631181,
                "name": "Diego Lacosta",
                "number": null,
                "position": "Midfielder",
                "image": "https://images.onefootball.com/players/180/631181.jpg",
                "url": "https://onefootball.com/en/player/diego-lacosta-631181"
            },
            {
                "id": 271651,
                "name": "Eduardo Camavinga",
                "number": 6,
                "position": "Midfielder",
                "image": "https://images.onefootball.com/players/180/271651.jpg",
                "url": "https://onefootball.com/en/player/eduardo-camavinga-271651"
            },
            {
                "id": 176958,
                "name": "Federico Valverde",
                "number": 8,
                "position": "Midfielder",
                "image": "https://images.onefootball.com/players/180/176958.jpg",
                "url": "https://onefootball.com/en/player/federico-valverde-176958"
            },
            {
                "id": 343087,
                "name": "Jude Bellingham",
                "number": 5,
                "position": "Midfielder",
                "image": "https://images.onefootball.com/players/180/343087.jpg"
            }
        ]
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
获取团队阵容 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29930/get+team+squad?team_id=26' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回一个团队的转会
Endpoint ID: 29931
GET https://docs.zylalabs.com/api/13509/onefootball+api/29931/get+team+transfers
输入参数

获取团队转移 — 端点功能

对象 描述
team_id 必需 ID of the team.

剩余免费测试请求:3 / 3。


输入参数

team_id
API 示例响应
JSON
[
    {
        "id": "43239805",
        "status": "CONTRACT RENEWAL",
        "url": "https://onefootball.com/en/transfers/43239805",
        "player": {
            "id": 201900,
            "name": "Vinícius Júnior",
            "position": "Forward",
            "image": "https://images.onefootball.com/players/180/201900.jpg"
        },
        "transferDatetime": "2026-08-06T18:42:57Z",
        "price": "RENEWAL",
        "teamOld": {
            "name": "Real Madrid"
        },
        "teamNew": {
            "id": 26,
            "name": "Real Madrid",
            "image": "https://images.onefootball.com/icons/teams/164/26.png"
        }
    },
    {
        "id": "43225468",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43225468",
        "player": {
            "id": 454785,
            "name": "Gonzalo García",
            "position": "Forward",
            "image": "https://images.onefootball.com/players/180/454785.jpg"
        },
        "transferDatetime": "2026-08-03T20:12:48Z",
        "price": "€40,000,000.00",
        "teamOld": {
            "name": "Real Madrid"
        },
        "teamNew": {
            "id": 211,
            "name": "Fulham",
            "image": "https://images.onefootball.com/icons/teams/164/211.png"
        }
    },
    {
        "id": "43222178",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43222178",
        "player": {
            "id": 513926,
            "name": "Fran González",
            "position": "Goalkeeper",
            "image": "https://images.onefootball.com/players/180/513926.jpg"
        },
        "transferDatetime": "2026-08-03T06:00:48Z",
        "price": null,
        "teamOld": {
            "name": "Real Madrid"
        },
        "teamNew": {
            "id": 28,
            "name": "Sevilla",
            "image": "https://images.onefootball.com/icons/teams/164/28.png"
        }
    },
    {
        "id": "43114720",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43114720",
        "player": {
            "id": 279639,
            "name": "Fran García",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/279639.jpg"
        },
        "transferDatetime": "2026-07-08T19:42:35Z",
        "price": "€4,000,000.00",
        "teamOld": {
            "name": "Real Madrid"
        },
        "teamNew": {
            "id": 691,
            "name": "Real Betis",
            "image": "https://images.onefootball.com/icons/teams/164/691.png"
        }
    },
    {
        "id": "43099140",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43099140",
        "player": {
            "id": 96338,
            "name": "Denzel Dumfries",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/96338.jpg"
        },
        "transferDatetime": "2026-07-05T10:18:35Z",
        "price": null,
        "teamOld": {
            "name": "Inter"
        },
        "teamNew": {
            "id": 26,
            "name": "Real Madrid",
            "image": "https://images.onefootball.com/icons/teams/164/26.png"
        }
    },
    {
        "id": "43025049",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43025049",
        "player": {
            "id": 200826,
            "name": "Ibrahima Konaté",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/200826.jpg"
        },
        "transferDatetime": "2026-06-18T09:12:13Z",
        "price": "FREE",
        "teamOld": {
            "name": "Liverpool FC"
        },
        "teamNew": {
            "id": 26,
            "name": "Real Madrid",
            "image": "https://images.onefootball.com/icons/teams/164/26.png"
        }
    },
    {
        "id": "43020199",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43020199",
        "player": {
            "id": 63999,
            "name": "Bernardo Silva",
            "position": "Midfielder",
            "image": "https://images.onefootball.com/players/180/63999.jpg"
        },
        "transferDatetime": "2026-06-17T09:12:13Z",
        "price": "FREE",
        "teamOld": {
            "name": "Manchester City"
        },
        "teamNew": {
            "id": 26,
            "name": "Real Madrid",
            "image": "https://images.onefootball.com/icons/teams/164/26.png"
        }
    },
    {
        "id": "43020182",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43020182",
        "player": {
            "id": 63999,
            "name": "Bernardo Silva",
            "position": "Midfielder",
            "image": "https://images.onefootball.com/players/180/63999.jpg"
        },
        "transferDatetime": "2026-06-17T09:09:14Z",
        "price": "FREE",
        "teamOld": {
            "name": "Manchester City"
        },
        "teamNew": {
            "id": 26,
            "name": "Real Madrid",
            "image": "https://images.onefootball.com/icons/teams/164/26.png"
        }
    },
    {
        "id": "43015401",
        "status": "CONTRACT RENEWAL",
        "url": "https://onefootball.com/en/transfers/43015401",
        "player": {
            "id": 20953,
            "name": "Antonio Rüdiger",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/20953.jpg"
        },
        "transferDatetime": "2026-06-16T09:15:13Z",
        "price": "RENEWAL",
        "teamOld": {
            "name": "Real Madrid"
        },
        "teamNew": {
            "id": 26,
            "name": "Real Madrid",
            "image": "https://images.onefootball.com/icons/teams/164/26.png"
        }
    },
    {
        "id": "43010877",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43010877",
        "player": {
            "id": 188965,
            "name": "Marc Cucurella",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/188965.jpg"
        },
        "transferDatetime": "2026-06-15T09:24:13Z",
        "price": "€55,000,000.00",
        "teamOld": {
            "name": "Chelsea"
        },
        "teamNew": {
            "id": 26,
            "name": "Real Madrid",
            "image": "https://images.onefootball.com/icons/teams/164/26.png"
        }
    },
    {
        "id": "43008441",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43008441",
        "player": {
            "id": 188965,
            "name": "Marc Cucurella",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/188965.jpg"
        },
        "transferDatetime": "2026-06-14T16:45:14Z",
        "price": "€55,000,000.00",
        "teamOld": {
            "name": "Chelsea"
        },
        "teamNew": {
            "id": 26,
            "name": "Real Madrid",
            "image": "https://images.onefootball.com/icons/teams/164/26.png"
        }
    },
    {
        "id": "42933803",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/42933803",
        "player": {
            "id": 461111,
            "name": "Mario Martín",
            "position": "Midfielder",
            "image": "https://images.onefootball.com/players/180/461111.jpg"
        },
        "transferDatetime": "2026-05-28T10:26:29Z",
        "price": null,
        "teamOld": {
            "name": "Real Madrid"
        },
        "teamNew": {
            "id": 216,
            "name": "Getafe",
            "image": "https://images.onefootball.com/icons/teams/164/216.png"
        }
    }
]
获取团队转移 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29931/get+team+transfers?team_id=26' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回一个团队参与的比赛
Endpoint ID: 29932
GET https://docs.zylalabs.com/api/13509/onefootball+api/29932/get+team+competitions
输入参数

获取团队竞赛 — 端点功能

对象 描述
team_id 必需 ID of the team.

剩余免费测试请求:3 / 3。


输入参数

team_id
API 示例响应
JSON
[
    {
        "id": 140,
        "name": "Club Friendly Games"
    },
    {
        "id": 18,
        "name": "Copa del Rey"
    },
    {
        "id": 2955,
        "name": "FIFA Club World Cup"
    },
    {
        "id": 10,
        "name": "LaLiga"
    },
    {
        "id": 63,
        "name": "Supercopa de España"
    }
]
获取团队竞赛 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29932/get+team+competitions?team_id=26' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回转账的详细信息
Endpoint ID: 29933
GET https://docs.zylalabs.com/api/13509/onefootball+api/29933/get+transfer+details
输入参数

获取转账详情 — 端点功能

对象 描述
transfer_id 必需 Transfer ID.

剩余免费测试请求:3 / 3。


输入参数

transfer_id
API 示例响应
JSON
{
    "id": 43088238,
    "status": "Done deal",
    "price": "€6,000,000.00",
    "type": "Standard",
    "age": "29",
    "position": "Midfielder",
    "country": "Spain",
    "height": "187cm",
    "player": {
        "id": 221194,
        "name": "Brais Mendez",
        "image": "https://images.onefootball.com/players/180/221194.jpg"
    },
    "teamOld": {
        "id": 223,
        "name": "Real Sociedad",
        "url": "https://onefootball.com/en/team/real-sociedad-223",
        "image": "https://images.onefootball.com/icons/teams/164/223.png"
    },
    "teamNew": {
        "id": 855,
        "name": "Columbus Crew",
        "url": "https://onefootball.com/en/team/columbus-crew-855",
        "image": "https://images.onefootball.com/icons/teams/164/855.png"
    }
}
获取转账详情 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29933/get+transfer+details?transfer_id=43088238' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 一足球 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

(年度计费可节省 2 个月 🎉)

🚀 企业版套餐

起价
$ 10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

概览

按日期排列的足球比赛,比赛详情包括阵容、统计数据和事件,赛事排名和赛程,球队页面和阵容,以及球员简介

一足球 API FAQs

每个端点返回特定的足球相关数据,如比赛详情、比赛安排、结果、球员档案和球队统计信息。例如,“获取比赛安排”端点提供即将比赛的详细信息,而“获取球员统计”返回个人表现指标

关键字段因端点而异,但通常包括标识符(id)、名称(name)、获取更多信息的URL,以及特定属性如分数、日期和队伍细节。例如,比赛细节包括主队和客队名称、分数和比赛状态

响应数据以JSON格式结构化,通常组织成数组和对象。例如,比赛数据包括嵌套对象以表示团队及其各自的统计信息,这使得在应用程序中解析和使用变得简单

每个端点提供不同的信息例如“获取比赛事件”返回关于进球和换人的详细信息而“获取比赛积分表”显示排名这使得用户能够访问比赛球队和球员的全面数据

用户可以通过使用参数如竞赛 ID、日期或队名来自定义请求。例如,“按日期获取比赛”端点默认是今天,但可以调整以检索任何指定日期的比赛

数据来源于OneFootball广泛的数据库,该数据库汇集了来自全球各种联赛、比赛和赛事的信息。这确保了足球事件和球员统计的广泛覆盖

典型的用例包括开发体育应用程序创建梦幻足球平台或分析团队表现例如开发者可以使用球员统计数据来增强用户在梦幻联赛中的参与度

用户可以利用结构化的JSON响应将足球数据集成到他们的应用程序中例如,他们可以根据API响应动态显示实时比赛更新球员统计数据或比赛排名

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

相关 API