Skip to main content

​
API Dados Futebol

A API Dados Futebol é uma API REST que fornece dados estruturados do futebol brasileiro: campeonatos, rodadas, partidas, tabelas de classificação, artilharia e elencos dos clubes. Todas as respostas são em português, com chaves JSON semânticas como placar_mandante, campeonato_id e ao_vivo. A API segue o padrão REST sobre HTTPS, retorna JSON em todas as rotas e usa autenticação via API Key no header Authorization.

​
O que você pode fazer

Campeonatos e Tabela

Liste competições, filtre por temporada e status, e consulte a classificação completa com pontos, saldo e aproveitamento.

Partidas

Consulte placares e histórico de jogos, com filtros por rodada, status, time e intervalo de datas.

Times e Jogadores

Busque clubes por nome ou sigla, veja elencos completos e consulte artilheiros por campeonato.

Autenticação e Limites

Entenda como usar sua API Key, os planos disponíveis e os headers de rate limiting retornados em cada resposta.

​
Como funciona

Toda requisição precisa de uma API Key enviada como Bearer Token. A API valida a key, aplica o rate limit do plano correspondente e retorna os dados em JSON. As respostas de listagem seguem sempre o mesmo envelope: 
{
  "data": [ ... ],
  "meta": {
    "total": 2,
    "por_pagina": 15,
    "pagina_atual": 1,
    "ultima_pagina": 1
  }
}
Respostas de item único omitem o meta e retornam apenas "data": { ... }. Erros retornam um objeto com "erro" e "mensagem" em português.

​
Início rápido

​
1. Obtenha sua API Key

Para testes locais, use a key de sandbox gratuita: 
test-api-key-free-sandbox
Em produção, solicite uma key pelo painel administrativo ou entre em contato.

​
2. Faça sua primeira requisição

curl -H "Authorization: Bearer test-api-key-free-sandbox" \
  https://api.dadosfutebol.com.br/v1/campeonatos

​
3. Resposta esperada

{
  "data": [
    {
      "id": 1,
      "nome": "Campeonato Brasileiro Série A",
      "temporada": "2026",
      "tipo": "pontos-corridos",
      "status": "andamento"
    },
    {
      "id": 2,
      "nome": "Copa do Brasil",
      "temporada": "2026",
      "tipo": "mata-mata",
      "status": "andamento"
    }
  ],
  "meta": {
    "total": 2,
    "por_pagina": 15,
    "pagina_atual": 1,
    "ultima_pagina": 1
  }
}

​
Base URL

AmbienteURL base
Produçãohttps://api.dadosfutebol.com.br
Desenvolvimento localhttp://localhost:8000
Todos os endpoints começam com o prefixo /v1: 
GET https://api.dadosfutebol.com.br/v1/campeonatos
GET https://api.dadosfutebol.com.br/v1/campeonatos/1/partidas

​
Convenções gerais

AspectoComportamento
FormatoJSON (Content-Type: application/json)
AutenticaçãoAuthorization: Bearer {api_key}
DatasISO 8601 com timezone (2026-04-19T16:00:00-03:00)
ErrosSempre em português com campos erro e mensagem
CacheListagens: 60s