API Dados FutebolComeçar grátis

Referência

Referência da API

Endpoints, parâmetros, plano necessário e exemplos reais de resposta. URL base na RapidAPI:https://futapi.p.rapidapi.com

Especificação OpenAPI: openapi.json

Competições

Listar competições

BASIC

GET/v1/competitions

Todas as competições cobertas, com o rótulo da temporada atual.

Parâmetros

Nenhum.

Exemplo de resposta

{
  "data": [
    {
      "country_code": "ENG",
      "current_season": "2026/2027",
      "id": "cp_4k6Pew8vntAF",
      "name": "Premier League",
      "type": "league"
    }
  ],
  "meta": null,
  "paging": null
}

Consultar competição

BASIC

GET/v1/competitions/{competition_id}

Dados de uma competição.

Parâmetros

competition_idstringObrigatório
Id da competição (cp_...)

Exemplo de resposta

{
  "data": {
    "country_code": "ENG",
    "current_season": "2026/2027",
    "id": "cp_4k6Pew8vntAF",
    "name": "Premier League",
    "type": "league"
  },
  "meta": null,
  "paging": null
}

Listar temporadas

BASIC

GET/v1/competitions/{competition_id}/seasons

Temporadas disponíveis. Use o rótulo season nos outros endpoints.

Parâmetros

competition_idstringObrigatório
Id da competição (cp_...)

Exemplo de resposta

{
  "data": [
    {
      "end_date": "2026-11-22",
      "is_current": true,
      "season": "2026/2027",
      "start_date": "2026-08-21"
    },
    {
      "end_date": "2026-05-24",
      "is_current": false,
      "season": "2025/2026",
      "start_date": "2025-08-15"
    },
    {
      "end_date": "2025-05-25",
      "is_current": false,
      "season": "2024/2025",
      "start_date": "2024-08-16"
    }
  ],
  "meta": null,
  "paging": null
}

Classificação

BASIC

GET/v1/competitions/{competition_id}/standings

Tabela da temporada, geral ou só jogos em casa ou fora. points já inclui punições, detalhadas em points_adjustment e adjustment_reason.

Parâmetros

competition_idstringObrigatório
Id da competição (cp_...)
seasonstring
Rótulo da temporada, ex.: 2025/2026. Padrão: temporada atual
venueall | home | away, padrão all
Jogos considerados: all, home ou away

Exemplo de resposta

{
  "data": {
    "competition": {
      "id": "cp_4k6Pew8vntAF",
      "name": "Premier League"
    },
    "season": "2026/2027",
    "table": [
      {
        "adjustment_reason": null,
        "drawn": 0,
        "form": "WWWWL",
        "goal_difference": 9,
        "goals_against": 5,
        "goals_for": 14,
        "lost": 1,
        "played": 9,
        "points": 24,
        "points_adjustment": 0,
        "position": 1,
        "team": {
          "id": "tm_ZeBeWo4C48CU",
          "name": "Arsenal",
          "short_name": "Arsenal"
        },
        "won": 8
      },
      {
        "adjustment_reason": null,
        "drawn": 0,
        "form": "LLWWW",
        "goal_difference": 10,
        "goals_against": 10,
        "goals_for": 20,
        "lost": 2,
        "played": 9,
        "points": 21,
        "points_adjustment": 0,
        "position": 2,
        "team": {
          "id": "tm_YyPQz5BpYmq1",
          "name": "Manchester City",
          "short_name": "Man City"
        },
        "won": 7
      },
      {
        "adjustment_reason": null,
        "drawn": 1,
        "form": "WLWWW",
        "goal_difference": 17,
        "goals_against": 7,
        "goals_for": 24,
        "lost": 2,
        "played": 9,
        "points": 19,
        "points_adjustment": 0,
        "position": 3,
        "team": {
          "id": "tm_LBRG0re7KGZb",
  ...

Jogos da competição

BASIC

GET/v1/competitions/{competition_id}/matches

Calendário e resultados da temporada, ordenados por data. As datas de from e to são lidas no timezone.

Parâmetros

competition_idstringObrigatório
Id da competição (cp_...)
seasonstring
Rótulo da temporada, ex.: 2025/2026. Padrão: temporada atual
statusscheduled | live | finished | cancelled
Filtra por status: scheduled, live, finished ou cancelled
roundstring
Rodada, ex.: 10
teamstring
Filtra por time (tm_...)
fromstring
Primeiro dia (AAAA-MM-DD), inclusive
tostring
Último dia (AAAA-MM-DD), inclusive
timezonestring
Fuso IANA para as datas, ex.: America/Sao_Paulo. Padrão: UTC
limitinteger, padrão 50
Itens por página (1 a 100). Padrão: 50
cursorstring
Cursor recebido em paging.next_cursor

Exemplo de resposta

{
  "data": [
    {
      "away_team": {
        "id": "tm_CVKC9xgo9U68",
        "name": "Coventry City",
        "short_name": "Coventry"
      },
      "competition": {
        "id": "cp_4k6Pew8vntAF",
        "name": "Premier League"
      },
      "home_team": {
        "id": "tm_ZeBeWo4C48CU",
        "name": "Arsenal",
        "short_name": "Arsenal"
      },
      "id": "mt_kA2xLhfaZU9R",
      "kickoff_at": "2026-08-21T19:00:00Z",
      "round": "1",
      "score": {
        "away": 0,
        "home": 3
      },
      "season": "2026/2027",
      "status": "finished",
      "venue": {
        "id": "vn_WBbWS6nR7wgy",
        "name": "Emirates Stadium"
      }
    },
    {
      "away_team": {
        "id": "tm_4jcICNmJi2Q2",
        "name": "Manchester United",
        "short_name": "Man United"
      },
      "competition": {
        "id": "cp_4k6Pew8vntAF",
        "name": "Premier League"
      },
      "home_team": {
        "id": "tm_FopEzp1cP0zk",
        "name": "Hull City",
        "short_name": "Hull"
      },
      "id": "mt_K4TcFd98b8yQ",
      "kickoff_at": "2026-08-22T11:30:00Z",
      "round": "1",
      "score": {
        "away": 0,
        "home": 2
      },
      "season": "2026/2027",
      "status": "finished",
      "venue": {
        "id": "vn_mYrNZTE0l2Vd",
        "name": "MKM Stadium"
      }
    },
  ...

Times da temporada

BASIC

GET/v1/competitions/{competition_id}/teams

Times participantes da temporada.

Parâmetros

competition_idstringObrigatório
Id da competição (cp_...)
seasonstring
Rótulo da temporada, ex.: 2025/2026. Padrão: temporada atual

Exemplo de resposta

{
  "data": [
    {
      "id": "tm_gThEQpEnF0vb",
      "name": "AFC Bournemouth",
      "short_name": "Bournemouth"
    },
    {
      "id": "tm_ZeBeWo4C48CU",
      "name": "Arsenal",
      "short_name": "Arsenal"
    },
    {
      "id": "tm_tYVRlBZjoBhf",
      "name": "Aston Villa",
      "short_name": "Aston Villa"
    }
  ],
  "meta": null,
  "paging": null
}

Estatísticas de temporada dos times

PRO

GET/v1/competitions/{competition_id}/teams/stats

Resultados, gols, médias por jogo e percentuais de todos os times. averages.xg_for e averages.xg_against exigem ULTRA.

Parâmetros

competition_idstringObrigatório
Id da competição (cp_...)
seasonstring
Rótulo da temporada, ex.: 2025/2026. Padrão: temporada atual
venueall | home | away, padrão all
Jogos considerados: all, home ou away

Exemplo de resposta

{
  "data": [
    {
      "averages": {
        "corners_against": 4,
        "corners_for": 4.56,
        "corners_total": 8.56,
        "first_half_goals_against": 0.44,
        "first_half_goals_for": 1,
        "goals_against": 1.44,
        "goals_for": 1.56,
        "red_cards": 0,
        "shots_against": 10.44,
        "shots_for": 14.11,
        "shots_on_target_for": 5,
        "xg_against": 1.11,
        "xg_for": 1.75,
        "yellow_cards": 2.67
      },
      "competition": {
        "id": "cp_4k6Pew8vntAF",
        "name": "Premier League"
      },
      "draws": 3,
      "goals_against": 13,
      "goals_for": 14,
      "losses": 3,
      "matches": 9,
      "percentages": {
        "btts": 55.6,
        "clean_sheets": 33.3,
        "failed_to_score": 11.1,
        "over_1_5": 88.9,
        "over_2_5": 55.6,
        "over_3_5": 33.3
      },
      "sample": {
        "matches_with_half_stats": 9,
        "matches_with_stats": 9,
        "matches_with_xg": 9
      },
      "season": "2026/2027",
      "team": {
        "id": "tm_gThEQpEnF0vb",
        "name": "AFC Bournemouth",
        "short_name": "Bournemouth"
      },
      "venue": "all",
      "wins": 3
    },
    {
      "averages": {
        "corners_against": 4.22,
        "corners_for": 5.44,
        "corners_total": 9.67,
        "first_half_goals_against": 0.33,
        "first_half_goals_for": 0.56,
        "goals_against": 0.56,
        "goals_for": 1.56,
        "red_cards": 0,
  ...

Estatísticas e rankings de jogadores

PRO

GET/v1/competitions/{competition_id}/players/stats

Estatísticas de temporada e rankings. xg, avg_rating, rated_matches e a ordenação por xg ou rating exigem ULTRA.

Parâmetros

competition_idstringObrigatório
Id da competição (cp_...)
seasonstring
Rótulo da temporada, ex.: 2025/2026. Padrão: temporada atual
teamstring
Filtra por time (tm_...)
sortgoals | assists | minutes | appearances | shots | yellow_cards | xg | rating, padrão goals
Ordenação do ranking, decrescente
min_minutesinteger, padrão 0
Mínimo de minutos jogados
limitinteger, padrão 50
Itens por página (1 a 100). Padrão: 50
cursorstring
Cursor recebido em paging.next_cursor

Exemplo de resposta

{
  "data": [
    {
      "appearances": 9,
      "assists": 0,
      "assists_per_90": 0,
      "avg_rating": 8.18,
      "competition": {
        "id": "cp_4k6Pew8vntAF",
        "name": "Premier League"
      },
      "goals": 9,
      "goals_per_90": 1.01,
      "minutes_played": 800,
      "penalties_scored": 0,
      "player": {
        "id": "pl_wu34X5fGCO2y",
        "name": "Erling Haaland"
      },
      "rated_matches": 9,
      "red_cards": 0,
      "season": "2026/2027",
      "shots": 34,
      "shots_on_target": 16,
      "starts": 9,
      "team": {
        "id": "tm_YyPQz5BpYmq1",
        "name": "Manchester City",
        "short_name": "Man City"
      },
      "xg": 6.56,
      "yellow_cards": 0
    },
    {
      "appearances": 10,
      "assists": 1,
      "assists_per_90": 0.11,
      "avg_rating": 7.43,
      "competition": {
        "id": "cp_4k6Pew8vntAF",
        "name": "Premier League"
      },
      "goals": 6,
      "goals_per_90": 0.63,
      "minutes_played": 855,
      "penalties_scored": 0,
      "player": {
        "id": "pl_zhQd5ela0vu9",
        "name": "Thierno Barry"
      },
      "rated_matches": 10,
      "red_cards": 0,
      "season": "2026/2027",
      "shots": 36,
      "shots_on_target": 15,
      "starts": 10,
      "team": {
        "id": "tm_tye75wZQ4VWo",
        "name": "Everton",
        "short_name": "Everton"
  ...

Partidas

Jogos por data

BASIC

GET/v1/matches

Todos os jogos de um dia. date é lida no timezone (padrão UTC) e o padrão é hoje.

Parâmetros

datestring
Dia (AAAA-MM-DD). Padrão: hoje
competitionstring
Filtra por competição (cp_...)
statusscheduled | live | finished | cancelled
Filtra por status: scheduled, live, finished ou cancelled
timezonestring
Fuso IANA para as datas, ex.: America/Sao_Paulo. Padrão: UTC
limitinteger, padrão 50
Itens por página (1 a 100). Padrão: 50
cursorstring
Cursor recebido em paging.next_cursor

Exemplo de resposta

{
  "data": [
    {
      "away_team": {
        "id": "tm_FSkMBkcR7wa3",
        "name": "Tottenham Hotspur",
        "short_name": "Tottenham"
      },
      "competition": {
        "id": "cp_4k6Pew8vntAF",
        "name": "Premier League"
      },
      "home_team": {
        "id": "tm_lC1q8SiYRRQ0",
        "name": "Leeds United",
        "short_name": "Leeds"
      },
      "id": "mt_C6lLw8fjh1nI",
      "kickoff_at": "2026-11-07T12:30:00Z",
      "round": "10",
      "score": {
        "away": 0,
        "home": 1
      },
      "season": "2026/2027",
      "status": "finished",
      "venue": {
        "id": "vn_ipnbxgz2Hkyo",
        "name": "Elland Road"
      }
    },
    {
      "away_team": {
        "id": "tm_9Ii8T6HAeySX",
        "name": "Newcastle United",
        "short_name": "Newcastle"
      },
      "competition": {
        "id": "cp_4k6Pew8vntAF",
        "name": "Premier League"
      },
      "home_team": {
        "id": "tm_tbk0C982GyLu",
        "name": "Fulham",
        "short_name": "Fulham"
      },
      "id": "mt_VR6L5SocNPiw",
      "kickoff_at": "2026-11-07T15:00:00Z",
      "round": "10",
      "score": {
        "away": 0,
        "home": 0
      },
      "season": "2026/2027",
      "status": "live",
      "venue": {
        "id": "vn_52wyvrQvP0bc",
        "name": "Craven Cottage"
      }
    },
  ...

Detalhes da partida

BASIC

GET/v1/matches/{match_id}

Placar, placar do intervalo, formações, estádio, público e árbitro.

Parâmetros

match_idstringObrigatório
Id da partida (mt_...)
timezonestring
Fuso IANA para as datas, ex.: America/Sao_Paulo. Padrão: UTC

Exemplo de resposta

{
  "data": {
    "attendance": null,
    "away_team": {
      "id": "tm_FSkMBkcR7wa3",
      "name": "Tottenham Hotspur",
      "short_name": "Tottenham"
    },
    "competition": {
      "id": "cp_4k6Pew8vntAF",
      "name": "Premier League"
    },
    "formations": {
      "away": "4-3-3",
      "home": "3-4-2-1"
    },
    "halftime_score": {
      "away": 0,
      "home": 0
    },
    "home_team": {
      "id": "tm_lC1q8SiYRRQ0",
      "name": "Leeds United",
      "short_name": "Leeds"
    },
    "id": "mt_C6lLw8fjh1nI",
    "kickoff_at": "2026-11-07T12:30:00Z",
    "referee_name": "John Brooks",
    "round": "10",
    "score": {
      "away": 0,
      "home": 1
    },
    "season": "2026/2027",
    "status": "finished",
    "venue": {
      "id": "vn_ipnbxgz2Hkyo",
      "name": "Elland Road"
    }
  },
  "meta": null,
  "paging": null
}

Eventos da partida

PRO

GET/v1/matches/{match_id}/events

Gols, cartões e substituições em ordem cronológica.

Parâmetros

match_idstringObrigatório
Id da partida (mt_...)

Exemplo de resposta

{
  "data": [
    {
      "detail": "yellow",
      "extra_minute": null,
      "minute": 15,
      "player": {
        "id": "pl_WTGvyH2oZSy6",
        "name": "Micky van de Ven"
      },
      "related_player": null,
      "team_id": "tm_FSkMBkcR7wa3",
      "type": "card"
    },
    {
      "detail": "yellow",
      "extra_minute": null,
      "minute": 22,
      "player": {
        "id": "pl_PSiEq8RoWikh",
        "name": "Sean Longstaff"
      },
      "related_player": null,
      "team_id": "tm_lC1q8SiYRRQ0",
      "type": "card"
    },
    {
      "detail": "injury",
      "extra_minute": null,
      "minute": 43,
      "player": {
        "id": "pl_rOx5hWk9gC2e",
        "name": "Dominic Solanke"
      },
      "related_player": {
        "id": "pl_pRx1Uoto4nBn",
        "name": "Mathys Tel"
      },
      "team_id": "tm_FSkMBkcR7wa3",
      "type": "substitution"
    }
  ],
  "meta": null,
  "paging": null
}

Escalações

PRO

GET/v1/matches/{match_id}/lineups

Titulares, reservas, posições e formações dos dois times.

Parâmetros

match_idstringObrigatório
Id da partida (mt_...)

Exemplo de resposta

{
  "data": {
    "away": {
      "formation": "4-3-3",
      "starters": [
        {
          "is_captain": false,
          "player": {
            "id": "pl_1kbA5wpRBwl5",
            "name": "Antonín KinskÛ"
          },
          "position": "GK",
          "position_group": "goalkeeper",
          "shirt_number": 31
        },
        {
          "is_captain": false,
          "player": {
            "id": "pl_6w7IzCPm1CeE",
            "name": "Jan Paul van Hecke"
          },
          "position": "CB",
          "position_group": "defender",
          "shirt_number": 6
        },
        {
          "is_captain": false,
          "player": {
            "id": "pl_WTGvyH2oZSy6",
            "name": "Micky van de Ven"
          },
          "position": "CB",
          "position_group": "defender",
          "shirt_number": 37
        }
      ],
      "substitutes": [
        {
          "is_captain": false,
          "player": {
            "id": "pl_rOx5hWk9gC2e",
            "name": "Dominic Solanke"
          },
          "position": null,
          "position_group": null,
          "shirt_number": 19
        },
        {
          "is_captain": false,
          "player": {
            "id": "pl_n0V9Qimkl1Jn",
            "name": "James Maddison"
          },
          "position": null,
          "position_group": null,
          "shirt_number": 10
        },
        {
          "is_captain": false,
          "player": {
  ...

Estatísticas dos times na partida

PRO

GET/v1/matches/{match_id}/stats

35 estatísticas por time (posse, finalizações, escanteios, cartões, xG...) no jogo inteiro ou em um dos tempos.

Parâmetros

match_idstringObrigatório
Id da partida (mt_...)
periodfull | first_half | second_half, padrão full
Jogo inteiro (full) ou um dos tempos (first_half, second_half)

Exemplo de resposta

{
  "data": {
    "away": {
      "stats": {
        "accurate_passes": 420,
        "accurate_passes_pct": 83,
        "aerials_pct": 46,
        "aerials_total": 28,
        "aerials_won": 13,
        "blocks": 5,
        "clearances": 32,
        "corners": 4,
        "dribbles_pct": 31,
        "dribbles_total": 16,
        "duels_won": 43,
        "fouls": 15,
        "goals": 0,
        "ground_duels_pct": 41,
        "ground_duels_total": 73,
        "ground_duels_won": 30,
        "hit_woodwork": 0,
        "interceptions": 4,
        "offsides": 1,
        "opposition_half_passes": 206,
        "own_half_passes": 214,
        "passes": 506,
        "possession": 61,
        "red_cards": 0,
        "saves": 2,
        "shots": 7,
        "shots_blocked": 0,
        "shots_inside_box": 5,
        "shots_off_target": 3,
        "shots_on_target": 4,
        "shots_outside_box": 2,
        "successful_dribbles": 5,
        "tackles": 15,
        "xg": 0.71,
        "yellow_cards": 3
      },
      "team": {
        "id": "tm_FSkMBkcR7wa3",
        "name": "Tottenham Hotspur",
        "short_name": "Tottenham"
      }
    },
    "home": {
      "stats": {
        "accurate_passes": 246,
        "accurate_passes_pct": 79,
        "aerials_pct": 54,
        "aerials_total": 28,
        "aerials_won": 15,
        "blocks": 0,
        "clearances": 37,
        "corners": 6,
        "dribbles_pct": 75,
        "dribbles_total": 8,
        "duels_won": 58,
        "fouls": 11,
  ...

Estatísticas dos jogadores na partida

ULTRA

GET/v1/matches/{match_id}/players

62 métricas por jogador, xG e rating interno com notas por categoria.

Parâmetros

match_idstringObrigatório
Id da partida (mt_...)

Exemplo de resposta

{
  "data": [
    {
      "player": {
        "id": "pl_JqMEZwimNXiD",
        "name": "Andrew Robertson"
      },
      "rating": {
        "bonus_total": 0,
        "categories": {
          "attack": 6,
          "defense": 6.56,
          "passing": 7.97,
          "possession": 8.29
        },
        "categories_relative": {
          "attack": -1.47,
          "defense": -3.18,
          "passing": 4.63,
          "possession": 2
        },
        "penalty_total": 0.55,
        "position_group": "FB",
        "rating": 6.86,
        "rating_base": 7.4135
      },
      "stats": {
        "acted_as_sweeper": 0,
        "aerials_total": 0,
        "aerials_won": 0,
        "assists": 0,
        "big_chances_created": 0,
        "big_chances_missed": 0,
        "blocks": 1,
        "chances_created": 1,
        "clearances": 4,
        "clearances_headed": 1,
        "crosses_accurate": 2,
        "crosses_total": 3,
        "defensive_actions": 5,
        "dispossessed": 0,
        "diving_saves": 0,
        "dribbled_past": 1,
        "dribbles_attempted": 0,
        "dribbles_successful": 0,
        "duels_lost": 2,
        "duels_won": 0,
        "fouls_committed": 1,
        "fouls_suffered": 0,
        "goalkeeper_success_pct": null,
        "goals": 0,
        "goals_conceded": 0,
        "goals_prevented": null,
        "ground_duels_total": 2,
        "ground_duels_won": 0,
        "high_claims": 0,
        "interceptions": 0,
        "long_balls_accurate": 3,
        "long_balls_total": 8,
        "minutes_played": 90,
  ...

Probabilidades pré-jogo

ULTRA

GET/v1/matches/{match_id}/prediction

Probabilidades de vitória, empate e derrota com odd justa, gols esperados, over/under, ambos marcam e placares mais prováveis. Disponível para jogos futuros; 404 quando não calculado.

Parâmetros

match_idstringObrigatório
Id da partida (mt_...)
timezonestring
Fuso IANA para as datas, ex.: America/Sao_Paulo. Padrão: UTC

Exemplo de resposta

{
  "data": {
    "btts_yes": 0.5871,
    "computed_at": "2026-11-07T15:00:03.307627Z",
    "expected_goals": {
      "away": 1.78,
      "home": 1.16
    },
    "most_likely_scores": [
      {
        "probability": 0.1255,
        "score": "1-1"
      },
      {
        "probability": 0.0971,
        "score": "1-2"
      },
      {
        "probability": 0.0837,
        "score": "0-2"
      }
    ],
    "over_under": {
      "over_0_5": 0.9308,
      "over_1_5": 0.8081,
      "over_2_5": 0.5632,
      "over_3_5": 0.3393,
      "over_4_5": 0.1748
    },
    "result": {
      "away_win": {
        "fair_odds": 2.11,
        "probability": 0.4735
      },
      "draw": {
        "fair_odds": 3.62,
        "probability": 0.276
      },
      "home_win": {
        "fair_odds": 3.99,
        "probability": 0.2505
      }
    }
  },
  "meta": null,
  "paging": null
}

Confronto direto

ULTRA

GET/v1/matches/{match_id}/h2h

Histórico dos últimos encontros e médias por jogo dos dois times (gols, posse, finalizações, escanteios, faltas, cartões, xG). Disponível para jogos futuros; 404 quando não calculado.

Parâmetros

match_idstringObrigatório
Id da partida (mt_...)
timezonestring
Fuso IANA para as datas, ex.: America/Sao_Paulo. Padrão: UTC

Exemplo de resposta

{
  "data": {
    "computed_at": "2026-11-07T15:00:03.307627Z",
    "summary": {
      "away_goals_avg": 2.25,
      "away_wins": 5,
      "draws": 2,
      "home_goals_avg": 0.62,
      "home_wins": 1,
      "matches": 8
    },
    "team_averages": {
      "away": {
        "corners": 6,
        "fouls": 11.22,
        "goals_conceded": 1.11,
        "goals_scored": 2.22,
        "matches": 9,
        "possession": 64.11,
        "red_cards": 0.11,
        "shots": 15.33,
        "shots_on_target": 5.56,
        "xg": 2.04,
        "yellow_cards": 1.44
      },
      "home": {
        "corners": 4.67,
        "fouls": 14.11,
        "goals_conceded": 1.33,
        "goals_scored": 0.67,
        "matches": 9,
        "possession": 47.56,
        "red_cards": 0,
        "shots": 16.89,
        "shots_on_target": 3.44,
        "xg": 1.63,
        "yellow_cards": 2.22
      }
    }
  },
  "meta": null,
  "paging": null
}

Times

Consultar time

BASIC

GET/v1/teams/{team_id}

Dados do time e estádio.

Parâmetros

team_idstringObrigatório
Id do time (tm_...)

Exemplo de resposta

{
  "data": {
    "country_code": "ENG",
    "country_name": "England",
    "gender": "male",
    "id": "tm_lC1q8SiYRRQ0",
    "name": "Leeds United",
    "short_name": "Leeds",
    "type": "club",
    "venue": {
      "id": "vn_ipnbxgz2Hkyo",
      "name": "Elland Road"
    }
  },
  "meta": null,
  "paging": null
}

Jogos do time

BASIC

GET/v1/teams/{team_id}/matches

Calendário e resultados do time, opcionalmente filtrados por competição e temporada.

Parâmetros

team_idstringObrigatório
Id do time (tm_...)
competitionstring
Filtra por competição (cp_...)
seasonstring
Rótulo da temporada, ex.: 2025/2026. Padrão: temporada atual
statusscheduled | live | finished | cancelled
Filtra por status: scheduled, live, finished ou cancelled
timezonestring
Fuso IANA para as datas, ex.: America/Sao_Paulo. Padrão: UTC
limitinteger, padrão 50
Itens por página (1 a 100). Padrão: 50
cursorstring
Cursor recebido em paging.next_cursor

Exemplo de resposta

{
  "data": [
    {
      "away_team": {
        "id": "tm_lC1q8SiYRRQ0",
        "name": "Leeds United",
        "short_name": "Leeds"
      },
      "competition": {
        "id": "cp_4k6Pew8vntAF",
        "name": "Premier League"
      },
      "home_team": {
        "id": "tm_N3LGNXITNvpf",
        "name": "Liverpool",
        "short_name": "Liverpool"
      },
      "id": "mt_yep3yD3pZ2la",
      "kickoff_at": "2020-09-12T16:30:00Z",
      "round": "1",
      "score": {
        "away": 3,
        "home": 4
      },
      "season": "2020/2021",
      "status": "finished",
      "venue": {
        "id": "vn_VaLwNClAs4JN",
        "name": "Anfield"
      }
    },
    {
      "away_team": {
        "id": "tm_tbk0C982GyLu",
        "name": "Fulham",
        "short_name": "Fulham"
      },
      "competition": {
        "id": "cp_4k6Pew8vntAF",
        "name": "Premier League"
      },
      "home_team": {
        "id": "tm_lC1q8SiYRRQ0",
        "name": "Leeds United",
        "short_name": "Leeds"
      },
      "id": "mt_dU41ChHo9F3X",
      "kickoff_at": "2020-09-19T14:00:00Z",
      "round": "2",
      "score": {
        "away": 3,
        "home": 4
      },
      "season": "2020/2021",
      "status": "finished",
      "venue": {
        "id": "vn_ipnbxgz2Hkyo",
        "name": "Elland Road"
      }
    },
  ...

Elenco

BASIC

GET/v1/teams/{team_id}/squad

Elenco atual com posição, número, nacionalidade e data de nascimento.

Parâmetros

team_idstringObrigatório
Id do time (tm_...)

Exemplo de resposta

{
  "data": [
    {
      "birth_date": "2002-10-10",
      "id": "pl_SncDa2Qupst1",
      "name": "James Trafford",
      "nationality_code": "ENG",
      "position": "GK",
      "position_group": "goalkeeper",
      "shirt_number": 1
    },
    {
      "birth_date": "2000-07-27",
      "id": "pl_lQyaefGjsxpM",
      "name": "Jayden Bogle",
      "nationality_code": "ENG",
      "position": "RWB",
      "position_group": "defender",
      "shirt_number": 2
    },
    {
      "birth_date": "1999-04-29",
      "id": "pl_PHuzSM2t2zoH",
      "name": "Gabriel Gudmundsson",
      "nationality_code": "SWE",
      "position": "LWB",
      "position_group": "defender",
      "shirt_number": 3
    }
  ],
  "meta": null,
  "paging": null
}

Estatísticas de temporada do time

PRO

GET/v1/teams/{team_id}/stats

Sem competition, retorna todas as temporadas atuais do time. averages.xg_for e averages.xg_against exigem ULTRA.

Parâmetros

team_idstringObrigatório
Id do time (tm_...)
competitionstring
Filtra por competição (cp_...)
seasonstring
Rótulo da temporada, ex.: 2025/2026. Padrão: temporada atual
venueall | home | away, padrão all
Jogos considerados: all, home ou away

Exemplo de resposta

{
  "data": [
    {
      "averages": {
        "corners_against": 4.1,
        "corners_for": 4.3,
        "corners_total": 8.4,
        "first_half_goals_against": 0.3,
        "first_half_goals_for": 0.3,
        "goals_against": 0.8,
        "goals_for": 1,
        "red_cards": 0,
        "shots_against": 13.2,
        "shots_for": 12,
        "shots_on_target_for": 3.7,
        "xg_against": 1.25,
        "xg_for": 1.32,
        "yellow_cards": 1.9
      },
      "competition": {
        "id": "cp_4k6Pew8vntAF",
        "name": "Premier League"
      },
      "draws": 5,
      "goals_against": 8,
      "goals_for": 10,
      "losses": 2,
      "matches": 10,
      "percentages": {
        "btts": 50,
        "clean_sheets": 40,
        "failed_to_score": 30,
        "over_1_5": 60,
        "over_2_5": 20,
        "over_3_5": 10
      },
      "sample": {
        "matches_with_half_stats": 10,
        "matches_with_stats": 10,
        "matches_with_xg": 10
      },
      "season": "2026/2027",
      "team": {
        "id": "tm_lC1q8SiYRRQ0",
        "name": "Leeds United",
        "short_name": "Leeds"
      },
      "venue": "all",
      "wins": 3
    }
  ],
  "meta": null,
  "paging": null
}

Jogadores

Consultar jogador

BASIC

GET/v1/players/{player_id}

Dados do jogador, posição e time atual.

Parâmetros

player_idstringObrigatório
Id do jogador (pl_...)

Exemplo de resposta

{
  "data": {
    "birth_date": "2002-10-10",
    "current_team": {
      "id": "tm_lC1q8SiYRRQ0",
      "name": "Leeds United",
      "short_name": "Leeds"
    },
    "first_name": "James",
    "gender": "male",
    "height_cm": 197,
    "id": "pl_SncDa2Qupst1",
    "last_name": "Trafford",
    "name": "James Trafford",
    "nationality_code": "ENG",
    "nationality_name": "England",
    "position": "GK",
    "position_group": "goalkeeper",
    "preferred_foot": "right",
    "shirt_number": 1
  },
  "meta": null,
  "paging": null
}

Jogos do jogador

PRO

GET/v1/players/{player_id}/matches

Histórico de partidas com estatísticas por jogo. stats.xg, stats.xgot_faced, stats.goals_prevented e rating exigem ULTRA.

Parâmetros

player_idstringObrigatório
Id do jogador (pl_...)
competitionstring
Filtra por competição (cp_...)
seasonstring
Rótulo da temporada, ex.: 2025/2026. Padrão: temporada atual
timezonestring
Fuso IANA para as datas, ex.: America/Sao_Paulo. Padrão: UTC
limitinteger, padrão 50
Itens por página (1 a 100). Padrão: 50
cursorstring
Cursor recebido em paging.next_cursor

Exemplo de resposta

{
  "data": [
    {
      "match": {
        "away_team": {
          "id": "tm_FSkMBkcR7wa3",
          "name": "Tottenham Hotspur",
          "short_name": "Tottenham"
        },
        "competition": {
          "id": "cp_4k6Pew8vntAF",
          "name": "Premier League"
        },
        "home_team": {
          "id": "tm_lC1q8SiYRRQ0",
          "name": "Leeds United",
          "short_name": "Leeds"
        },
        "id": "mt_C6lLw8fjh1nI",
        "kickoff_at": "2026-11-07T12:30:00Z",
        "round": "10",
        "score": {
          "away": 0,
          "home": 1
        },
        "season": "2026/2027",
        "status": "finished",
        "venue": {
          "id": "vn_ipnbxgz2Hkyo",
          "name": "Elland Road"
        }
      },
      "rating": 9.88,
      "stats": {
        "acted_as_sweeper": 4,
        "aerials_total": 0,
        "aerials_won": 0,
        "assists": 0,
        "big_chances_created": 0,
        "big_chances_missed": 0,
        "blocks": 0,
        "chances_created": 0,
        "clearances": 4,
        "clearances_headed": 0,
        "crosses_accurate": 0,
        "crosses_total": 0,
        "defensive_actions": 4,
        "dispossessed": 0,
        "diving_saves": 4,
        "dribbled_past": 0,
        "dribbles_attempted": 0,
        "dribbles_successful": 0,
        "duels_lost": 0,
        "duels_won": 0,
        "fouls_committed": 0,
        "fouls_suffered": 0,
        "goalkeeper_success_pct": null,
        "goals": 0,
        "goals_conceded": 0,
        "goals_prevented": 1.48,
  ...

Estatísticas de temporada do jogador

PRO

GET/v1/players/{player_id}/stats

Sem competition, retorna todas as temporadas atuais do jogador. xg, avg_rating e rated_matches exigem ULTRA.

Parâmetros

player_idstringObrigatório
Id do jogador (pl_...)
competitionstring
Filtra por competição (cp_...)
seasonstring
Rótulo da temporada, ex.: 2025/2026. Padrão: temporada atual

Exemplo de resposta

{
  "data": [
    {
      "appearances": 10,
      "assists": 0,
      "assists_per_90": 0,
      "avg_rating": 8.05,
      "competition": {
        "id": "cp_4k6Pew8vntAF",
        "name": "Premier League"
      },
      "goals": 0,
      "goals_per_90": 0,
      "minutes_played": 900,
      "penalties_scored": 0,
      "player": {
        "id": "pl_SncDa2Qupst1",
        "name": "James Trafford"
      },
      "rated_matches": 10,
      "red_cards": 0,
      "season": "2026/2027",
      "shots": 0,
      "shots_on_target": 0,
      "starts": 10,
      "team": {
        "id": "tm_lC1q8SiYRRQ0",
        "name": "Leeds United",
        "short_name": "Leeds"
      },
      "xg": null,
      "yellow_cards": 0
    }
  ],
  "meta": null,
  "paging": null
}

Estádios

Consultar estádio

BASIC

GET/v1/venues/{venue_id}

Cidade, país, capacidade, ano de inauguração e gramado.

Parâmetros

venue_idstringObrigatório
Id do estádio (vn_...)

Exemplo de resposta

{
  "data": {
    "capacity": 37645,
    "city": "Leeds, West Yorkshire",
    "country": "England",
    "id": "vn_ipnbxgz2Hkyo",
    "name": "Elland Road",
    "opened_year": 1897,
    "surface": "Grass"
  },
  "meta": null,
  "paging": null
}

Sistema

Status dos dados

BASIC

GET/v1/status

Última execução de cada rotina de sincronização.

Parâmetros

Nenhum.

Exemplo de resposta

{
  "data": [
    {
      "job": "aggregates",
      "last_run_at": "2026-11-07T15:06:45.576476Z",
      "status": "ok"
    },
    {
      "job": "audit",
      "last_run_at": "2026-11-07T08:38:41.997694Z",
      "status": "ok"
    },
    {
      "job": "matches",
      "last_run_at": "2026-11-07T15:06:28.520533Z",
      "status": "ok"
    }
  ],
  "meta": null,
  "paging": null
}