Visão geral

O que a API Dados Futebol entrega e como a documentação está organizada.

A API Dados Futebol é uma API REST com dados de futebol para apps, análises e ferramentas de apostas. Ela entrega jogos, resultados, classificação, eventos, escalações, 35 métricas por time e 62 métricas por jogador em cada partida, xG, ratings de jogadores, probabilidades pré-jogo com odds justas e confronto direto.

O que você encontra

Recurso	Conteúdo
Probabilidades pré-jogo	Vitória, empate e derrota com odd justa, gols esperados, over 0.5 a 4.5, ambos marcam e placares mais prováveis
Confronto direto	Últimos encontros e médias recentes de gols, posse, finalizações, escanteios, faltas, cartões e xG
Jogadores	62 métricas por partida, xG, rating de 0 a 10 e estatísticas de temporada
Times	35 métricas por partida, no jogo inteiro e por tempo, e médias e percentuais de temporada
Classificação	Geral, em casa e fora, com punições de pontos detalhadas
Calendário	Jogos do dia e da temporada, no fuso horário que você escolher

Como a documentação está organizada

Primeiros passos: assinatura, chave e primeira chamada.
Conceitos: ids, temporadas, fuso horário, paginação e erros.
Probabilidades e confronto direto: o modelo, os mercados e como usar a odd justa.
Ratings de jogadores: como a nota é composta.
Métricas: a lista completa de estatísticas de times e jogadores.
Exemplos: chamadas prontas para os casos mais comuns.
Referência da API: todos os endpoints, parâmetros e exemplos de resposta.

Atualização dos dados

Dados	Frequência
Jogos, placares, eventos, escalações e estatísticas de partida	A cada 5 minutos
Classificação e estatísticas de temporada	A cada 5 minutos, após mudanças nos jogos
Times, jogadores e estádios	A cada hora
Probabilidades e confronto direto	A cada hora, para os jogos dos próximos 7 dias

Os dados passam por uma auditoria automática diária. O endpoint GET /v1/status mostra a última execução de cada rotina.