Primeiros passos com a API Dados Futebol

O calendário mais cheio do mundo

Um clube grande no Brasil começa o ano em janeiro disputando o estadual, entra na Copa do Brasil por volta de março, encara Libertadores ou Sul-Americana no meio de semana e ainda tem 38 rodadas de pontos corridos entre abril e dezembro. Somando as fases de mata-mata, passa de 60 jogos oficiais numa única temporada — por clube.

Agora multiplique. Vinte clubes só na Série A. Mais Série B, C e D. Mais os estaduais de 27 federações, cada um com seu próprio formato. Mais as competições continentais. O futebol brasileiro produz partidas num ritmo que nenhuma planilha acompanha na mão.

E o problema de quem quer construir alguma coisa em cima disso nunca foi falta de dado — é que o dado mora espalhado. A tabela está num site, o placar ao vivo em outro, a escalação num terceiro, a artilharia num quarto. Cada um com seu formato, seu atraso de atualização e sua disposição de te bloquear se você tentar raspar o HTML.

Quem já tentou montar um bolão, um app de placar, um painel de scouting ou um bot de notificação conhece a sequência: dois dias empolgado com o produto, três semanas mantendo scraper.

O que a API resolve

A API Dados Futebol entrega campeonatos, rodadas, partidas ao vivo, tabelas de classificação, escalações, eventos e estatísticas do futebol brasileiro em JSON — com chaves em português, um envelope só e a mesma autenticação em todos os endpoints. Este guia mostra como sair do zero até a primeira requisição.

1. Crie sua conta e chave de API

Acesse dadosfutebol.com.br, crie sua conta gratuita e gere uma chave de API no painel. O plano free dá direito a 100 requisições por dia — suficiente para explorar a API inteira.

2. Faça a primeira requisição

Toda requisição é autenticada via Bearer token:

curl https://api.dadosfutebol.com.br/v1/campeonatos \
  -H "Authorization: Bearer SUA_CHAVE_AQUI"

A resposta vem no envelope padrão da API:

{
  "data": [
    {
      "id": 1,
      "nome": "Brasileirão Série A",
      "temporada": 2026,
      "formato": "pontos-corridos"
    }
  ],
  "meta": { "total": 10 }
}

O campo formato já diz o que esperar da estrutura: pontos-corridos tem tabela e rodadas; mata-mata tem fases e chaves. São duas geometrias diferentes, e a API não finge que são a mesma coisa.

3. Explore os recursos

Com o campeonato_id em mãos, você pode navegar por todo o resto:

• GET /v1/campeonatos/{id}/tabela — tabela de classificação
• GET /v1/campeonatos/{id}/partidas — partidas do campeonato
• GET /v1/partidas/ao-vivo — jogos acontecendo agora
• GET /v1/partidas/{id}/estatisticas — posse de bola, finalizações e mais

A referência completa de endpoints está em docs.dadosfutebol.com.br.

Próximos passos

Nos próximos posts vamos cobrir webhooks (receba um POST a cada gol), o servidor MCP para usar a API direto em assistentes de IA, e os campos avançados de estatísticas. Assine o RSS para acompanhar.