# Dados Futebol ## Docs - [Chave do campeonato mata-mata](https://docs.dadosfutebol.com.br/api-reference/campeonatos/chave-do-campeonato-mata-mata.md): Retorna a chave (bracket) completa de um campeonato mata-mata, com todas as fases e confrontos organizados em formato de chaveamento eliminatório. - [Detalhes do campeonato](https://docs.dadosfutebol.com.br/api-reference/campeonatos/detalhes-do-campeonato.md): Retorna os dados de um campeonato específico pelo ID. - [Listar campeonatos](https://docs.dadosfutebol.com.br/api-reference/campeonatos/listar-campeonatos.md): Retorna todos os campeonatos cadastrados. Suporta filtros por temporada, status e tipo. - [Tabela de classificação da fase](https://docs.dadosfutebol.com.br/api-reference/campeonatos/tabela-de-classificação-da-fase.md): Retorna a tabela de classificação de uma fase específica de um campeonato. Útil para fases de grupos ou fases com pontos corridos dentro de um campeonato mata-mata. - [Detalhes de uma fase](https://docs.dadosfutebol.com.br/api-reference/fases/detalhes-de-uma-fase.md): Retorna os detalhes de uma fase específica, incluindo chaves com partidas de ida e volta (mata-mata) ou rodadas (pontos corridos). - [Fases do campeonato](https://docs.dadosfutebol.com.br/api-reference/fases/fases-do-campeonato.md): Retorna todas as fases de um campeonato mata-mata, ordenadas pela sequência. Cada fase inclui navegação para a fase anterior e a próxima. - [Artilheiros do campeonato](https://docs.dadosfutebol.com.br/api-reference/jogadores/artilheiros-do-campeonato.md): Retorna os artilheiros de um campeonato, ordenados por número de gols (decrescente). Jogadores com 0 gols são excluídos. - [Buscar jogadores por nome](https://docs.dadosfutebol.com.br/api-reference/jogadores/buscar-jogadores-por-nome.md): Pesquisa jogadores pelo nome. O parâmetro é obrigatório com ao menos 2 caracteres. Retorna no máximo 20 resultados, sem paginação. - [Detalhes de um jogador](https://docs.dadosfutebol.com.br/api-reference/jogadores/detalhes-de-um-jogador.md): Retorna os dados de um jogador específico pelo ID. - [Escalação de uma partida](https://docs.dadosfutebol.com.br/api-reference/partidas/escalação-de-uma-partida.md): Retorna a escalação de cada lado: formação, técnico, titulares e reservas (com número, posição e substituições). Disponível a partir do pré-jogo, quando a fonte confirma a escalação. Retorna 404 quando não há escalação para a partida. - [Estatísticas de uma partida](https://docs.dadosfutebol.com.br/api-reference/partidas/estatísticas-de-uma-partida.md): Retorna estatísticas detalhadas por lado: finalizações (total, no gol, fora, na trave, bloqueadas), pênaltis, escanteios, faltas, impedimentos, cartões, defesas, desarmes, passes (total, errados) e precisão de passes. Observação: posse de bola não é fornecida pela fonte atual e vem nula. - [Eventos de uma partida (indisponível)](https://docs.dadosfutebol.com.br/api-reference/partidas/eventos-de-uma-partida-indisponível.md): Endpoint temporariamente indisponível. A coleta de eventos (gols, cartões, substituições, pênaltis) não está disponível no momento e o endpoint responde com HTTP 501. Retorna 404 quando a partida não existe. - [Partidas ao vivo](https://docs.dadosfutebol.com.br/api-reference/partidas/partidas-ao-vivo.md): Retorna todas as partidas com status `ao_vivo` no momento. Atualizado a cada 15 segundos via cache. - [Partidas do campeonato](https://docs.dadosfutebol.com.br/api-reference/partidas/partidas-do-campeonato.md): Lista todas as partidas de um campeonato. Filtre por rodada, status, time ou intervalo de datas. - [Estatísticas de uso da API Key](https://docs.dadosfutebol.com.br/api-reference/perfil/estatísticas-de-uso-da-api-key.md): Retorna estatísticas detalhadas de uso da API Key autenticada, incluindo tempo médio de resposta e histórico de requisições recentes. - [Perfil da API Key](https://docs.dadosfutebol.com.br/api-reference/perfil/perfil-da-api-key.md): Retorna informações do perfil da API Key autenticada, incluindo plano, limites e consumo atual. - [Rodadas do campeonato](https://docs.dadosfutebol.com.br/api-reference/rodadas/rodadas-do-campeonato.md): Retorna todas as rodadas de um campeonato, ordenadas por número, incluindo as partidas de cada rodada com placares e status. - [Status da API](https://docs.dadosfutebol.com.br/api-reference/status/status-da-api.md): Retorna o status atual da API, a versão e o ambiente. Endpoint público, não requer autenticação. - [Tabela de classificação](https://docs.dadosfutebol.com.br/api-reference/tabela/tabela-de-classificação.md): Retorna a tabela de classificação completa de um campeonato, ordenada por posição. - [Buscar times por nome ou sigla](https://docs.dadosfutebol.com.br/api-reference/times/buscar-times-por-nome-ou-sigla.md): Pesquisa clubes e seleções pelo nome ou sigla. O parâmetro é obrigatório com ao menos 2 caracteres. Retorna no máximo 20 resultados, sem paginação. - [Jogadores de um time](https://docs.dadosfutebol.com.br/api-reference/times/jogadores-de-um-time.md): Retorna todos os jogadores de um time específico, ordenados por posição e nome. - [Autenticação](https://docs.dadosfutebol.com.br/autenticacao.md): Como autenticar suas requisições usando API Key via Bearer Token. - [Campeonatos](https://docs.dadosfutebol.com.br/campeonatos.md): Endpoints para consultar campeonatos, rodadas, partidas e tabela de classificação. - [MCP (IA)](https://docs.dadosfutebol.com.br/integracao-mcp.md): Conecte os dados de futebol a assistentes de IA (Claude, Cursor) via Model Context Protocol. - [Introdução](https://docs.dadosfutebol.com.br/introduction.md): Bem-vindo à API Dados Futebol — a API REST do futebol brasileiro. - [Partidas](https://docs.dadosfutebol.com.br/partidas.md): Endpoints para consultar partidas, placares e histórico de jogos. - [Times e Jogadores](https://docs.dadosfutebol.com.br/times.md): Endpoints para buscar clubes, consultar elencos e pesquisar jogadores por nome ou posição. - [Webhooks](https://docs.dadosfutebol.com.br/webhooks.md): Receba eventos em tempo real via HTTP POST assinado quando os dados mudam. ## OpenAPI Specs - [openapi](https://docs.dadosfutebol.com.br/openapi.json)