Times

Operações relacionadas a times

Detalhes de um time

get

Retorna informações detalhadas sobre um time específico.

Autorizações
Parâmetros de rota
identificadorstringObrigatório

Pode ser o ID do time ou o nome do time. Exemplo: 3 ou Flamengo

Example: 3
Respostas
200

Detalhes do time

application/json
get
GET /api/v1/times/{identificador} HTTP/1.1
Host: api.sportmetrics.com.br
Authorization: Bearer API_TOKEN
Accept: */*

{
  "time_id": 3,
  "nome": "Flamengo",
  "sigla": "FLA",
  "estadio": {
    "id": "maracana",
    "nome": "Maracanã",
    "endereco": "Av. Pres. Castelo Branco, s/n",
    "cidade": "Rio de Janeiro",
    "capacidade": 78838,
    "superficie": "grama",
    "imagem": "https://estadios.com/maracana.png"
  },
  "fundacao": 1895,
  "pais": "Brasil",
  "escudo": "https://escudos.com/flamengo.png"
}

Estatísticas de um time

get

Retorna estatísticas de um time em uma competição específica.

Autorizações
Parâmetros de consulta
competicao_idstringObrigatório

ID da competição. Exemplo: 1

Example: 1
time_idstringObrigatório

ID do time. Exemplo: 3

Example: 3
temporadastringObrigatório

Ano/temporada da competição. Exemplo: 2024

Example: 2024
Respostas
200

Estatísticas do time

application/json
get
GET /api/v1/times/estatisticas HTTP/1.1
Host: api.sportmetrics.com.br
Authorization: Bearer API_TOKEN
Accept: */*

{
  "liga": {
    "id": 71,
    "nome": "Serie A",
    "pais": "Brazil",
    "logo": "https://media.api-sports.io/football/leagues/71.png",
    "bandeira": "https://media.api-sports.io/flags/br.svg",
    "temporada": 2023
  },
  "time": {
    "id": 154,
    "nome": "Fortaleza EC",
    "logo": "https://media.api-sports.io/football/teams/154.png"
  },
  "historico": "DWWDDDLWDLWWLWLLLLWWWLWWDWLLLLDLLDDWWW",
  "partidas": {
    "disputadas": {
      "casa": 19,
      "fora": 19,
      "total": 38
    },
    "vitorias": {
      "casa": 9,
      "fora": 6,
      "total": 15
    },
    "empates": {
      "casa": 6,
      "fora": 3,
      "total": 9
    },
    "derrotas": {
      "casa": 4,
      "fora": 10,
      "total": 14
    }
  },
  "gols": {
    "marcados": {
      "total": {
        "casa": 28,
        "fora": 17,
        "total": 45
      },
      "media": {
        "casa": "1.5",
        "fora": "0.9",
        "total": "1.2"
      },
      "minutos": {
        "0-15": {
          "total": 4,
          "porcentagem": "8.70%"
        },
        "16-30": {
          "total": 7,
          "porcentagem": "15.22%"
        },
        "31-45": {
          "total": 8,
          "porcentagem": "17.39%"
        },
        "46-60": {
          "total": 11,
          "porcentagem": "23.91%"
        },
        "61-75": {
          "total": 3,
          "porcentagem": "6.52%"
        },
        "76-90": {
          "total": 7,
          "porcentagem": "15.22%"
        },
        "91-105": {
          "total": 6,
          "porcentagem": "13.04%"
        },
        "106-120": {
          "total": null,
          "porcentagem": null
        }
      },
      "acima_abaixo": {
        "0.5": {
          "acima": 25,
          "abaixo": 13
        },
        "1.5": {
          "acima": 13,
          "abaixo": 25
        },
        "2.5": {
          "acima": 5,
          "abaixo": 33
        },
        "3.5": {
          "acima": 2,
          "abaixo": 36
        },
        "4.5": {
          "acima": 0,
          "abaixo": 38
        }
      }
    },
    "sofridos": {
      "total": {
        "casa": 20,
        "fora": 24,
        "total": 44
      },
      "media": {
        "casa": "1.1",
        "fora": "1.3",
        "total": "1.2"
      },
      "minutos": {
        "0-15": {
          "total": 4,
          "porcentagem": "9.30%"
        },
        "16-30": {
          "total": 6,
          "porcentagem": "13.95%"
        },
        "31-45": {
          "total": 3,
          "porcentagem": "6.98%"
        },
        "46-60": {
          "total": 8,
          "porcentagem": "18.60%"
        },
        "61-75": {
          "total": 7,
          "porcentagem": "16.28%"
        },
        "76-90": {
          "total": 10,
          "porcentagem": "23.26%"
        },
        "91-105": {
          "total": 5,
          "porcentagem": "11.63%"
        },
        "106-120": {
          "total": null,
          "porcentagem": null
        }
      },
      "acima_abaixo": {
        "0.5": {
          "acima": 28,
          "abaixo": 10
        },
        "1.5": {
          "acima": 13,
          "abaixo": 25
        },
        "2.5": {
          "acima": 3,
          "abaixo": 35
        },
        "3.5": {
          "acima": 0,
          "abaixo": 38
        },
        "4.5": {
          "acima": 0,
          "abaixo": 38
        }
      }
    }
  },
  "maiores": {
    "sequencias": {
      "vitorias": 3,
      "empates": 3,
      "derrotas": 4
    },
    "vitorias": {
      "casa": "4-0",
      "fora": "0-3"
    },
    "derrotas": {
      "casa": "0-3",
      "fora": "3-1"
    },
    "gols": {
      "marcados": {
        "casa": 4,
        "fora": 3
      },
      "sofridos": {
        "casa": 3,
        "fora": 3
      }
    }
  },
  "sem_sofrer_gols": {
    "casa": 6,
    "fora": 4,
    "total": 10
  },
  "sem_marcar_gols": {
    "casa": 6,
    "fora": 7,
    "total": 13
  },
  "penaltis": {
    "convertidos": {
      "total": 5,
      "porcentagem": "100.00%"
    },
    "perdidos": {
      "total": 0,
      "porcentagem": "0%"
    },
    "total": 5
  },
  "formacoes": [
    {
      "formacao": "4-2-3-1",
      "utilizadas": 22
    },
    {
      "formacao": "4-4-2",
      "utilizadas": 9
    },
    {
      "formacao": "3-4-1-2",
      "utilizadas": 2
    },
    {
      "formacao": "4-2-2-2",
      "utilizadas": 1
    },
    {
      "formacao": "3-5-2",
      "utilizadas": 1
    },
    {
      "formacao": "5-3-2",
      "utilizadas": 1
    },
    {
      "formacao": "4-1-4-1",
      "utilizadas": 1
    },
    {
      "formacao": "4-3-3",
      "utilizadas": 1
    }
  ],
  "cartoes": {
    "amarelos": {
      "0-15": {
        "total": 9,
        "porcentagem": "9.47%"
      },
      "16-30": {
        "total": 12,
        "porcentagem": "12.63%"
      },
      "31-45": {
        "total": 14,
        "porcentagem": "14.74%"
      },
      "46-60": {
        "total": 14,
        "porcentagem": "14.74%"
      },
      "61-75": {
        "total": 13,
        "porcentagem": "13.68%"
      },
      "76-90": {
        "total": 14,
        "porcentagem": "14.74%"
      },
      "91-105": {
        "total": 16,
        "porcentagem": "16.84%"
      },
      "106-120": {
        "total": null,
        "porcentagem": null
      },
      "sem_registro": {
        "total": 3,
        "porcentagem": "3.16%"
      }
    },
    "vermelhos": {
      "0-15": {
        "total": null,
        "porcentagem": null
      },
      "16-30": {
        "total": null,
        "porcentagem": null
      },
      "31-45": {
        "total": null,
        "porcentagem": null
      },
      "46-60": {
        "total": null,
        "porcentagem": null
      },
      "61-75": {
        "total": 1,
        "porcentagem": "100.00%"
      },
      "76-90": {
        "total": null,
        "porcentagem": null
      },
      "91-105": {
        "total": null,
        "porcentagem": null
      },
      "106-120": {
        "total": null,
        "porcentagem": null
      }
    }
  }
}

Temporadas de um time

get

Retorna as temporadas em que um time participou.

Autorizações
Parâmetros de consulta
time_idstringObrigatório

ID do time. Exemplo: 3

Example: 3
Respostas
200

Temporadas do time

application/json
get
GET /api/v1/times/temporadas HTTP/1.1
Host: api.sportmetrics.com.br
Authorization: Bearer API_TOKEN
Accept: */*

{
  "time_id": 3,
  "temporadas": [
    2018,
    2019,
    2020,
    2021,
    2022,
    2023,
    2024,
    2025
  ]
}

Próximos jogos do time

get

Retorna a lista dos próximos jogos do time informado.

Autorizações
Parâmetros de rota
time_idstringObrigatório

ID do time. Exemplo: 3

Example: 3
Respostas
200

Lista dos próximos jogos do time

application/json
Respostaobject[]
get
GET /api/v1/times/{time_id}/proximos-jogos HTTP/1.1
Host: api.sportmetrics.com.br
Authorization: Bearer API_TOKEN
Accept: */*
200

Lista dos próximos jogos do time

[
  {
    "partida_id": 2001,
    "data_hora": "2024-07-10T19:00:00Z",
    "estadio": "Maracanã",
    "cidade": "Rio de Janeiro",
    "time_mandante": {
      "time_id": 3,
      "nome": "Flamengo",
      "sigla": "FLA",
      "escudo": "https://escudos.com/flamengo.png"
    },
    "time_visitante": {
      "time_id": 6,
      "nome": "Vasco",
      "sigla": "VAS",
      "escudo": "https://escudos.com/vasco.png"
    },
    "status": "agendado"
  }
]

Jogos passados do time

get

Retorna a lista dos jogos passados do time informado.

Autorizações
Parâmetros de rota
time_idstringObrigatório

ID do time. Exemplo: 3

Example: 3
Respostas
200

Lista dos jogos passados do time

application/json
Respostaobject[]
get
GET /api/v1/times/{time_id}/jogos-passados HTTP/1.1
Host: api.sportmetrics.com.br
Authorization: Bearer API_TOKEN
Accept: */*
200

Lista dos jogos passados do time

[
  {
    "partida_id": 1999,
    "data_hora": "2024-06-01T19:00:00Z",
    "estadio": "Maracanã",
    "cidade": "Rio de Janeiro",
    "time_mandante": {
      "time_id": 3,
      "nome": "Flamengo",
      "sigla": "FLA",
      "escudo": "https://escudos.com/flamengo.png"
    },
    "time_visitante": {
      "time_id": 2,
      "nome": "Palmeiras",
      "sigla": "PAL",
      "escudo": "https://escudos.com/palmeiras.png"
    },
    "placar_mandante": 2,
    "placar_visitante": 1,
    "status": "finalizado"
  }
]

Jogos ao vivo do time

get

Retorna a lista dos jogos ao vivo do time informado.

Autorizações
Parâmetros de rota
time_idstringObrigatório

ID do time. Exemplo: 3

Example: 3
Respostas
200

Lista dos jogos ao vivo do time

application/json
Respostaobject[]
get
GET /api/v1/times/{time_id}/ao-vivo HTTP/1.1
Host: api.sportmetrics.com.br
Authorization: Bearer API_TOKEN
Accept: */*
200

Lista dos jogos ao vivo do time

[
  {
    "partida_id": 2010,
    "data_hora": "2024-07-01T20:00:00Z",
    "estadio": "Maracanã",
    "cidade": "Rio de Janeiro",
    "time_mandante": {
      "time_id": 3,
      "nome": "Flamengo",
      "sigla": "FLA",
      "escudo": "https://escudos.com/flamengo.png"
    },
    "time_visitante": {
      "time_id": 4,
      "nome": "Corinthians",
      "sigla": "COR",
      "escudo": "https://escudos.com/corinthians.png"
    },
    "placar_mandante": 1,
    "placar_visitante": 1,
    "status": "em andamento"
  }
]
AnteriorCampeonatosPróximoAtletas