OneFootball API

API ID 13509

OneFootball API (onefootball.com) Jogos de futebol por data detalhes da partida com escalações estatísticas e eventos classificação das competições e partidas páginas de equipe e elencos além de perfis de jogadores

Documentação da API

Endpoints

Requisição
Retorna o índice alfabético de todas as competições
Endpoint ID: 29905
GET https://docs.zylalabs.com/api/13509/onefootball+api/29905/get+all+competition+letters
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA 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"
    }
]
Obtenha todas as letras da competição — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna todas as competições para uma letra
Endpoint ID: 29906
GET https://docs.zylalabs.com/api/13509/onefootball+api/29906/get+competitions+by+letter
PARÂMETROS DE ENTRADA

Obtenha competições por letra — Recursos do endpoint

Objeto Descrição
letter Obrigatório Single letter (a-z) the results are filtered by.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

letter
RESPOSTA DE EXEMPLO DA 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"
    }
]
Obtenha competições por letra — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna detalhes para uma competição
Endpoint ID: 29907
GET https://docs.zylalabs.com/api/13509/onefootball+api/29907/get+competition+details
PARÂMETROS DE ENTRADA

Obter detalhes da competição — Recursos do endpoint

Objeto Descrição
competition_id Obrigatório Competition ID.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

competition_id
RESPOSTA DE EXEMPLO DA API
JSON
{
    "id": 10,
    "name": "LaLiga",
    "image": "https://images.onefootball.com/icons/leagueColoredCompetition/128/10.png",
    "url": "https://onefootball.com/en/competition/laliga-10"
}
Obter detalhes da competição — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna os jogos de uma competição
Endpoint ID: 29908
GET https://docs.zylalabs.com/api/13509/onefootball+api/29908/get+competition+fixtures
PARÂMETROS DE ENTRADA

Obtenha os jogos da competição — Recursos do endpoint

Objeto Descrição
competition_id Obrigatório Competition ID.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

competition_id
RESPOSTA DE EXEMPLO DA 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"
    }
]
Obtenha os jogos da competição — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna a tabela de classificações de uma competição Suporta tabelas simples e tabelas de múltiplos grupos
Endpoint ID: 29909
GET https://docs.zylalabs.com/api/13509/onefootball+api/29909/get+competition+table
PARÂMETROS DE ENTRADA

Obter tabela de competição — Recursos do endpoint

Objeto Descrição
competition_id Obrigatório Competition ID.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

competition_id
RESPOSTA DE EXEMPLO DA 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
                }
            ]
        }
    ]
}
Obter tabela de competição — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna a tabela de eliminação (fases com partidas) de uma competição
Endpoint ID: 29910
GET https://docs.zylalabs.com/api/13509/onefootball+api/29910/get+competition+knockout+tree
PARÂMETROS DE ENTRADA

Obter tabela de eliminatórias de competição — Recursos do endpoint

Objeto Descrição
competition_id Obrigatório Competition ID.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

competition_id
RESPOSTA DE EXEMPLO DA 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"
    }
]
Obter tabela de eliminatórias de competição — TRECHOS DE CÓDIGO

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' 


    
Requisição
Retorna os resultados de uma competição
Endpoint ID: 29911
GET https://docs.zylalabs.com/api/13509/onefootball+api/29911/get+competition+results
PARÂMETROS DE ENTRADA

Obter resultados de competição — Recursos do endpoint

Objeto Descrição
competition_id Obrigatório Competition ID.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

competition_id
RESPOSTA DE EXEMPLO DA 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"
    }
]
Obter resultados de competição — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna as transferências para uma competição
Endpoint ID: 29912
GET https://docs.zylalabs.com/api/13509/onefootball+api/29912/get+competition+transfers
PARÂMETROS DE ENTRADA

obter transferências de competição — Recursos do endpoint

Objeto Descrição
competition_id Obrigatório Competition ID.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

competition_id
RESPOSTA DE EXEMPLO DA 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"
    }
]
Obter transferências de competição — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna os jogos para uma data, agrupados por competição. Padrão é hoje
Endpoint ID: 29913
GET https://docs.zylalabs.com/api/13509/onefootball+api/29913/get+matches+by+date
PARÂMETROS DE ENTRADA

Obtenha partidas por data — Recursos do endpoint

Objeto Descrição
date Obrigatório Date in Y-m-d format.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

date
RESPOSTA DE EXEMPLO DA 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"
    }
]
Obtenha partidas por data — TRECHOS DE CÓDIGO

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' 


    
Requisição
Retorna as partidas ao vivo atualmente, agrupadas por competição
Endpoint ID: 29914
GET https://docs.zylalabs.com/api/13509/onefootball+api/29914/get+live+matches
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA 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"
                }
            }
        ]
    }
]
Assista a partidas ao vivo — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna detalhes de uma partida do OneFootball
Endpoint ID: 29915
GET https://docs.zylalabs.com/api/13509/onefootball+api/29915/get+match+details
PARÂMETROS DE ENTRADA

Obter detalhes da partida — Recursos do endpoint

Objeto Descrição
match_id Obrigatório ID of the match.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

match_id
RESPOSTA DE EXEMPLO DA 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"
        }
    ]
}
Obter detalhes da partida — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna os eventos (gols, cartões, substituições) para uma partida
Endpoint ID: 29916
GET https://docs.zylalabs.com/api/13509/onefootball+api/29916/get+match+events
PARÂMETROS DE ENTRADA

Obter eventos de jogo — Recursos do endpoint

Objeto Descrição
match_id Obrigatório ID of the match.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

match_id
RESPOSTA DE EXEMPLO DA 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"
    }
]
Obter eventos de jogo — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna as escalações para uma partida
Endpoint ID: 29917
GET https://docs.zylalabs.com/api/13509/onefootball+api/29917/get+match+lineup
PARÂMETROS DE ENTRADA

Obter escalação da partida — Recursos do endpoint

Objeto Descrição
match_id Obrigatório ID of the match.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

match_id
RESPOSTA DE EXEMPLO DA 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"
            }
        ]
    }
}
Obter escalação da partida — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna as estatísticas de uma partida
Endpoint ID: 29918
GET https://docs.zylalabs.com/api/13509/onefootball+api/29918/get+match+stats
PARÂMETROS DE ENTRADA

Obtenha estatísticas da partida — Recursos do endpoint

Objeto Descrição
match_id Obrigatório ID of the match.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

match_id
RESPOSTA DE EXEMPLO DA 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"
    }
]
Obtenha estatísticas da partida — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna a previsão dos fãs (votos) para uma partida
Endpoint ID: 29919
GET https://docs.zylalabs.com/api/13509/onefootball+api/29919/get+match+prediction
PARÂMETROS DE ENTRADA

Obtenha previsão de partida — Recursos do endpoint

Objeto Descrição
match_id Obrigatório ID of the match.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

match_id
RESPOSTA DE EXEMPLO DA API
JSON
{
    "title": "Who will win?",
    "home": {
        "name": "United States",
        "votes": 36659
    },
    "draw": {
        "name": "Draw",
        "votes": 2453
    },
    "away": {
        "name": "Bosnia & Herzegovina",
        "votes": 13401
    }
}
Obtenha previsão de partida — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna a forma recente de ambas as equipes em uma partida
Endpoint ID: 29920
GET https://docs.zylalabs.com/api/13509/onefootball+api/29920/get+match+form+guide
PARÂMETROS DE ENTRADA

obter guia de formulário de partida — Recursos do endpoint

Objeto Descrição
match_id Obrigatório ID of the match.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

match_id
RESPOSTA DE EXEMPLO DA 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"
                }
            }
        ]
    }
]
Obter guia de formulário de partida — TRECHOS DE CÓDIGO

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' 


    
Requisição
Retorna detalhes de um jogador do OneFootball
Endpoint ID: 29921
GET https://docs.zylalabs.com/api/13509/onefootball+api/29921/get+player+details
PARÂMETROS DE ENTRADA

Obter detalhes do jogador — Recursos do endpoint

Objeto Descrição
player_id Obrigatório Player ID.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

player_id
RESPOSTA DE EXEMPLO DA 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"
}
Obter detalhes do jogador — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna as estatísticas de um jogador para uma temporada, agrupadas por categoria
Endpoint ID: 29922
GET https://docs.zylalabs.com/api/13509/onefootball+api/29922/get+player+stats
PARÂMETROS DE ENTRADA

Obter estatísticas do jogador — Recursos do endpoint

Objeto Descrição
player_id Obrigatório Player ID.
season_id Obrigatório Season ID.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

player_id
season_id
RESPOSTA DE EXEMPLO DA 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"
            }
        ]
    }
]
Obter estatísticas do jogador — TRECHOS DE CÓDIGO

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' 


    
Requisição
Retorna as temporadas/competições para as quais um jogador possui estatísticas
Endpoint ID: 29923
GET https://docs.zylalabs.com/api/13509/onefootball+api/29923/get+player+seasons
PARÂMETROS DE ENTRADA

Obter temporadas de jogadores — Recursos do endpoint

Objeto Descrição
player_id Obrigatório Player ID.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

player_id
RESPOSTA DE EXEMPLO DA 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"
    }
]
Obter temporadas de jogadores — TRECHOS DE CÓDIGO

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


    
Requisição
Equipes de busca competições jogadores e notícias
Endpoint ID: 29924
GET https://docs.zylalabs.com/api/13509/onefootball+api/29924/search
PARÂMETROS DE ENTRADA

Buscar — Recursos do endpoint

Objeto Descrição
q Obrigatório Search term.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

q
RESPOSTA DE EXEMPLO DA 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"
        }
    ]
}
Buscar — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna o índice alfabético de todas as equipes
Endpoint ID: 29925
GET https://docs.zylalabs.com/api/13509/onefootball+api/29925/get+all+team+letters
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA 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"
    }
]
Obtenha todas as cartas da equipe — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna todas as equipes para uma letra
Endpoint ID: 29926
GET https://docs.zylalabs.com/api/13509/onefootball+api/29926/get+teams+by+letter
PARÂMETROS DE ENTRADA

Obtenha equipes por letra — Recursos do endpoint

Objeto Descrição
letter Obrigatório Single letter (a-z) the results are filtered by.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

letter
RESPOSTA DE EXEMPLO DA 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"
    }
]
Obtenha equipes por letra — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna detalhes para uma equipe
Endpoint ID: 29927
GET https://docs.zylalabs.com/api/13509/onefootball+api/29927/get+team+details
PARÂMETROS DE ENTRADA

Obter detalhes da equipe — Recursos do endpoint

Objeto Descrição
team_id Obrigatório ID of the team.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

team_id
RESPOSTA DE EXEMPLO DA 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"
}
Obter detalhes da equipe — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna as próximas partidas de uma equipe, agrupadas por mês
Endpoint ID: 29928
GET https://docs.zylalabs.com/api/13509/onefootball+api/29928/get+team+fixtures
PARÂMETROS DE ENTRADA

Obtenha os jogos da equipe — Recursos do endpoint

Objeto Descrição
team_id Obrigatório ID of the team.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

team_id
RESPOSTA DE EXEMPLO DA 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"
    }
]
Obtenha os jogos da equipe — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna os resultados passados de uma equipe, agrupados por mês
Endpoint ID: 29929
GET https://docs.zylalabs.com/api/13509/onefootball+api/29929/get+team+results
PARÂMETROS DE ENTRADA

Obter resultados da equipe — Recursos do endpoint

Objeto Descrição
team_id Obrigatório ID of the team.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

team_id
RESPOSTA DE EXEMPLO DA 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ña",
                    "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áros",
                    "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"
                }
            }
        ]
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
Obter resultados da equipe — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna o elenco de uma equipe, agrupado por posição
Endpoint ID: 29930
GET https://docs.zylalabs.com/api/13509/onefootball+api/29930/get+team+squad
PARÂMETROS DE ENTRADA

Obter elenco da equipe — Recursos do endpoint

Objeto Descrição
team_id Obrigatório ID of the team.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

team_id
RESPOSTA DE EXEMPLO DA 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"
    }
]
Obter elenco da equipe — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna as transferências de uma equipe
Endpoint ID: 29931
GET https://docs.zylalabs.com/api/13509/onefootball+api/29931/get+team+transfers
PARÂMETROS DE ENTRADA

Obtenha transferências de equipe — Recursos do endpoint

Objeto Descrição
team_id Obrigatório ID of the team.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

team_id
RESPOSTA DE EXEMPLO DA 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"
        }
    }
]
Obtenha transferências de equipe — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna as competições em que uma equipe participa
Endpoint ID: 29932
GET https://docs.zylalabs.com/api/13509/onefootball+api/29932/get+team+competitions
PARÂMETROS DE ENTRADA

Obter competições de equipe — Recursos do endpoint

Objeto Descrição
team_id Obrigatório ID of the team.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

team_id
RESPOSTA DE EXEMPLO DA 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"
    }
]
Obter competições de equipe — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna os detalhes de uma transferência
Endpoint ID: 29933
GET https://docs.zylalabs.com/api/13509/onefootball+api/29933/get+transfer+details
PARÂMETROS DE ENTRADA

Obter detalhes da transferência — Recursos do endpoint

Objeto Descrição
transfer_id Obrigatório Transfer ID.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

transfer_id
RESPOSTA DE EXEMPLO DA 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"
    }
}
Obter detalhes da transferência — TRECHOS DE CÓDIGO

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


    

Chave de acesso à API e autenticação

Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a OneFootball API basta incluir seu token Bearer no cabeçalho Authorization.

Cabeçalhos
Cabeçalho Descrição
Authorization Obrigatório Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.

Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.

(Economize 2 meses com cobrança anual 🎉)

🚀 Plano Empresarial

A partir de
$ 10.000/Ano


  • Volume personalizado
  • Limite de taxa personalizado
  • Suporte ao cliente especializado
  • Monitoramento de API em tempo real

Visão Geral

API OneFootball (onefootball.com). Jogos de futebol por data, detalhes do jogo com escalações, estatísticas e eventos, classificações e calendário de competições, páginas de equipes e elencos, além de perfis de jogadores

OneFootball API FAQs

Cada endpoint retorna dados específicos relacionados ao futebol, como detalhes da competição, partidas agendadas, resultados, perfis de jogadores e estatísticas das equipes. Por exemplo, o endpoint "Obter partidas da competição" fornece detalhes das partidas futuras, enquanto "Obter estatísticas do jogador" retorna métricas de desempenho individuais

Os campos-chave variam conforme o ponto final, mas geralmente incluem identificadores (id), nomes (nome), URLs para mais informações e atributos específicos como pontuações, datas e detalhes da equipe. Por exemplo, os detalhes da partida incluem os nomes das equipes da casa e visitante, pontuações e status da partida

Os dados de resposta estão estruturados no formato JSON, tipicamente organizados em arrays e objetos. Por exemplo, os dados da partida incluem objetos aninhados para equipes e suas respectivas estatísticas, tornando fácil de analisar e utilizar em aplicações

Cada endpoint fornece informações distintas por exemplo "Obter eventos da partida" retorna detalhes sobre gols e substituições enquanto "Obter tabela de competição" mostra a classificação Isso permite que os usuários acessem dados abrangentes sobre partidas equipes e jogadores

Os usuários podem personalizar solicitações utilizando parâmetros como ID da competição, data ou nome da equipe Por exemplo, o endpoint "Obter partidas por data" é padrão para hoje, mas pode ser ajustado para recuperar partidas de qualquer data especificada

Os dados são provenientes da extensa base de dados da OneFootball, que agrega informações de várias ligas, competições e partidas em todo o mundo. Isso garante uma ampla cobertura de eventos de futebol e estatísticas de jogadores

Casos de uso típicos incluem desenvolver aplicações esportivas criar plataformas de futebol fantasia ou analisar o desempenho da equipe Por exemplo desenvolvedores podem usar estatísticas de jogadores para aumentar o engajamento dos usuários em ligas de fantasia

Os usuários podem aproveitar as respostas JSON estruturadas para integrar dados de futebol em suas aplicações Por exemplo eles podem exibir atualizações de partidas ao vivo estatísticas de jogadores ou classificações de competições dinamicamente com base nas respostas da API

Perguntas Frequentes Gerais

O Zyla API Hub é como uma grande loja de APIs, onde você pode encontrar milhares delas em um só lugar. Também oferecemos suporte dedicado e monitoramento em tempo real de todas as APIs. Após se cadastrar, você pode escolher quais APIs deseja usar. Lembre-se apenas de que cada API precisa de sua própria assinatura. Mas se você se inscrever em várias, usará a mesma chave para todas elas, facilitando as coisas para você.
Os preços são listados em USD (Dólar Americano), EUR (Euro), CAD (Dólar Canadense), AUD (Dólar Australiano) e GBP (Libra Esterlina). Aceitamos todos os principais cartões de débito e crédito. Nosso sistema de pagamento usa a mais recente tecnologia de segurança e é operado pela Stripe, uma das empresas de pagamento mais confiáveis do mundo. Se tiver problemas para pagar com cartão, entre em contato conosco em [email protected]

Além disso, se você já tiver uma assinatura ativa em qualquer uma dessas moedas (USD, EUR, CAD, AUD, GBP), essa moeda será mantida para assinaturas subsequentes. Você pode alterar a moeda a qualquer momento, desde que não tenha assinaturas ativas.
A moeda local exibida na página de preços é baseada no país do seu endereço IP e é fornecida apenas como referência. Os preços reais são em USD (Dólar Americano). Ao efetuar o pagamento, a cobrança aparecerá no extrato do seu cartão em USD, mesmo que você veja o valor equivalente em sua moeda local em nosso site. Isso significa que você não pode pagar diretamente com sua moeda local.
Ocasionalmente, o banco pode recusar a cobrança devido às configurações de proteção contra fraude. Sugerimos contatar seu banco inicialmente para verificar se estão bloqueando nossas cobranças. Você também pode acessar o Portal de Cobrança e alterar o cartão associado para realizar o pagamento. Se isso não funcionar e precisar de mais ajuda, entre em contato com nossa equipe em [email protected]
Os preços são determinados por uma assinatura recorrente mensal ou anual, dependendo do plano escolhido.
As chamadas de API são descontadas do seu plano com base nas requisições bem-sucedidas. Cada plano possui um número específico de chamadas por mês. Apenas chamadas bem-sucedidas, indicadas por uma resposta com Status 200, serão contabilizadas, garantindo que falhas não afetem sua cota mensal.
O Zyla API Hub funciona com um sistema de assinatura mensal recorrente. Seu ciclo de cobrança começa no dia em que você compra um dos planos pagos e será renovado no mesmo dia do mês seguinte. Portanto, cancele sua assinatura com antecedência se quiser evitar cobranças futuras.
Para fazer upgrade do seu plano atual, acesse a página de preços da API e selecione o novo plano desejado. O upgrade é instantâneo, permitindo aproveitar imediatamente os recursos do novo plano. Observe que as chamadas restantes do plano anterior não serão transferidas; você será cobrado pelo valor integral do novo plano.
Para verificar quantas chamadas de API restam para o mês atual, consulte o campo 'X-Zyla-API-Calls-Monthly-Remaining' no cabeçalho da resposta. Por exemplo, se seu plano permite 1.000 requisições por mês e você usou 100, este campo no cabeçalho da resposta indicará 900 chamadas restantes.
Para ver o número máximo de requisições de API que seu plano permite, verifique o cabeçalho de resposta 'X-Zyla-RateLimit-Limit'. Por exemplo, se seu plano inclui 1.000 requisições por mês, este cabeçalho exibirá 1.000.
O cabeçalho 'X-Zyla-RateLimit-Reset' mostra o número de segundos até seu limite de taxa ser redefinido. Isso informa quando sua contagem de requisições começará do zero. Por exemplo, se exibir 3.600, significa que restam 3.600 segundos até o limite ser redefinido.
Sim, você pode cancelar seu plano a qualquer momento acessando sua conta e selecionando a opção de cancelamento na página de Cobrança. Observe que upgrades, downgrades e cancelamentos têm efeito imediato. Além disso, após o cancelamento, você não terá mais acesso ao serviço, mesmo que ainda tenha chamadas restantes na sua cota.
Para oferecer a oportunidade de experimentar nossas APIs sem compromisso, oferecemos um teste gratuito de 7 dias que permite realizar até 50 chamadas de API sem custo. Esse teste pode ser usado apenas uma vez; recomendamos aplicá-lo à API que mais interessa. Embora a maioria das APIs ofereça teste gratuito, algumas podem não oferecer. O teste termina após 7 dias ou quando você atingir 50 requisições, o que ocorrer primeiro. Se atingir o limite, será necessário "Iniciar seu plano pago" para continuar. Você encontra esse botão no perfil em Assinatura -> Escolha a API -> aba Preços. Se não cancelar até o 7º dia, sua assinatura será cobrada automaticamente, liberando todas as chamadas do plano.
Após 7 dias, será cobrado o valor total do plano ao qual você estava inscrito durante o teste. Portanto, é importante cancelar antes do término do período. Solicitações de reembolso por esquecimento de cancelamento não são aceitas.
Ao assinar um teste gratuito de API, você pode fazer até 50 chamadas. Se desejar fazer chamadas adicionais além desse limite, a API solicitará que você "Inicie seu plano pago". Você encontra o botão no perfil em Assinatura -> Escolha a API -> aba Preços.
As Ordens de Pagamento são processadas entre os dias 20 e 30 de cada mês. Se você enviar sua solicitação antes do dia 20, seu pagamento será processado dentro desse período.
Você pode nos contatar via chat para receber assistência imediata. Estamos online de 8h às 17h (EST). Se nos contatar após esse horário, retornaremos o mais rápido possível. Além disso, você pode enviar um e-mail para [email protected]

APIs relacionadas