Você precisa de dados de partidas de futebol ao vivo em seu aplicativo esta semana: os jogos de hoje, o que está em andamento e detalhes rápidos das partidas por ID. Ao final deste guia, você irá buscar partidas ao vivo para uma data, paginar por todos os jogos em um dia e recuperar os detalhes de uma partida usando a API de Futebol Ao Vivo FotMob no Zyla API Hub com Python e curl—usando uma única chave de API e assinatura.
O que a API de Futebol Ao Vivo FotMob fornece
A API de Futebol Ao Vivo FotMob retorna:
- Partidas ao vivo para uma data UTC (padrão é hoje) com equipes, status, minuto, placar, torneio e um identificador de partida que você pode reutilizar para detalhes.
- Todos os jogos para uma data UTC específica (agendados, ao vivo e finalizados) com controles de paginação adequados para jogos de dia inteiro.
- Detalhes da partida por ID da partida, incluindo equipes, placar, torneio e status.
Casos de uso comuns incluem tickers de placar ao vivo, painéis de controle de partidas, sistemas de alerta e páginas pré-jogo construídas por aplicativos esportivos, sites de clubes e ferramentas de apostas.
Autenticação e cobrança no Zyla API Hub
- Auth: Envie Authorization: Bearer YOUR_API_KEY em cada solicitação.
- Billing: Assinatura + cota (não pago por chamada). Não há Plano Gratuito. Para sua primeira API no Zyla, você pode começar com um teste de 7 dias ou 50 solicitações; verifique a página da API para opções de acesso e preços atuais.
- Uma chave funciona em todas as APIs do Zyla; gerencie tudo em uma conta.
Você pode navegar por mais de 10.000 APIs públicas no Zyla API Hub e se inscrever quando estiver pronto.
Começando no Zyla API Hub
- Abra a página da API de Futebol Ao Vivo FotMob.
- Clique em Inscrever-se ou Começar Teste Gratuito (quando disponível).
- Copie sua chave de API do seu painel.
- Chame os endpoints com o cabeçalho Authorization: Bearer YOUR_API_KEY.
Ainda não tem uma conta? Registre-se para obter uma chave de API e começar a integrar.
Endpoints que você usará
1) Partidas de Futebol Ao Vivo FotMob
Método: GET
URL: https://zylalabs.com/api/13929/fotmob-live-football-api/32101/fotmob-football-live-matches
Descrição: Retorna partidas de futebol em andamento em uma data UTC. O padrão é hoje. Use o ID da partida para detalhes e estatísticas.
Parâmetros de consulta:
- date (data, obrigatório): Por exemplo 2026-09-23
curl (copie e cole como está):
curl -s -X GET "https://zylalabs.com/api/13929/fotmob-live-football-api/32101/fotmob-football-live-matches?date=2026-09-23" \
-H "Authorization: Bearer YOUR_API_KEY"Exemplo de resposta JSON oficial:
{
"source": "fotmob",
"count": 2,
"matches": [
{
"source": "fotmob",
"source_event_id": 6278448,
"sport": "football",
"status": "Ao Vivo",
"status_code": 3,
"minute": "98’",
"start_timestamp": 1790179200,
"home": {
"id": 507764,
"name": "Gibraltar",
"short_name": "Gibraltar"
},
"away": {
"id": 287979,
"name": "São Tomé e Príncipe",
"short_name": "São Tomé e Príncipe"
},
"score": {
"home": 0,
"away": 0,
"text": null
},
"tournament": {
"id": 914609,
"name": "Amistosos",
"country": "INT"
},
"meta": {
"is_live": true
}
},
{
"source": "fotmob",
"source_event_id": 1000021847,
"sport": "football",
"status": "Intervalo",
"status_code": 10,
"minute": "HT",
"start_timestamp": 1790182800,
"home": {
"id": 394121,
"name": "VfL Wolfsburg",
"short_name": "VfL Wolfsburg"
},
"away": {
"id": 644409,
"name": "Sturm Graz",
"short_name": "Sturm Graz"
},
"score": {
"home": 4,
"away": 0,
"text": null
},
"tournament": {
"id": 1000001490,
"name": "Copa da UEFA Feminina - 2ª Fase de Qualificação",
"country": "INT"
},
"meta": {
"is_live": true
}
}
],
"date": "2026-09-23",
"cache": {
"hit": false,
"ttl_seconds": 20
}
}O que você usará:
- matches[].source_event_id — o ID da partida para reutilizar.
- status, status_code, minute — impulsionam tickers ao vivo e transições de estado.
- score.home, score.away — placar atual.
- start_timestamp — segundos epoch UTC; converta para seu local para exibição.
- campos do torneio — metadados da competição.
- cache.ttl_seconds — dica de cache upstream; planeje seu intervalo de polling.
2) Jogos FotMob por Data
Método: GET
URL: https://zylalabs.com/api/13929/fotmob-live-football-api/32102/fotmob-fixtures-by-date
Descrição: Retorna todas as partidas de futebol em uma data UTC (ao vivo e agendadas). As respostas são paginadas: padrão de 100 partidas por página (máx. 100). Verifique pagination.has_more; quando verdadeiro, solicite page=2, page=3, etc.
Parâmetros de consulta:
- date (data, obrigatório): Por exemplo 2026-09-22
- page (número, opcional): índice da página baseado em 1
- per_page (número, opcional): até 100
curl (copie e cole como está):
Notas:
- Use isso para jogos pré-jogo onde você precisa de jogos agendados e quaisquer ao vivo/finalizados no mesmo dia.
- Leia os indicadores de paginação na resposta; quando has_more for verdadeiro, incremente a página.
3) Detalhes da Partida por ID da Partida
Método: GET
URL: https://zylalabs.com/api/13929/fotmob-live-football-api/32103/fotmob-match-detail-by-match-id
Descrição: Retorna equipes, placar, status e competição para um ID de partida FotMob.
Parâmetros de solicitação: nenhum está documentado em exemplos de usuários. Autentique-se e chame o endpoint para recuperar detalhes.
curl (copie e cole como está):
Exemplo de resposta JSON oficial:
Dica: Use o ID da partida (source_event_id) dos endpoints ao vivo ou de jogos para buscar ou atualizar visualizações de detalhes.
Python: buscar partidas ao vivo para uma data
O trecho abaixo chama as Partidas de Futebol Ao Vivo FotMob para uma data UTC, imprime um placar compacto e mostra como lidar com campos principais do exemplo oficial acima.
import os
import requests
from datetime import datetime, timezone
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
DATE = "2026-09-23" # data UTC
url = "https://zylalabs.com/api/13929/fotmob-live-football-api/32101/fotmob-football-live-matches"
params = {"date": DATE}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()
print(f"Fonte: {data.get('source')}, Partidas: {data.get('count')}, Data: {data.get('date')}")
cache = data.get("cache") or {}
if cache:
print(f"Cache TTL (s): {cache.get('ttl_seconds')}")
for m in data.get("matches", []):
mid = m.get("source_event_id")
status = m.get("status")
minute = m.get("minute")
start_ts = m.get("start_timestamp")
start_utc = datetime.fromtimestamp(start_ts, tz=timezone.utc).isoformat() if start_ts else "n/a"
home = m.get("home", {}).get("short_name") or m.get("home", {}).get("name")
away = m.get("away", {}).get("short_name") or m.get("away", {}).get("name")
sh = m.get("score", {}).get("home")
sa = m.get("score", {}).get("away")
tourney = m.get("tournament", {}).get("name")
country = m.get("tournament", {}).get("country")
line = f"[{status} {minute or ''}] {home} {sh}-{sa} {away} | {tourney} ({country}) | match_id={mid} | start={start_utc}"
print(line.strip())Execute isso como uma tarefa cron ou em segundo plano. Use cache.ttl_seconds como um limite inferior para seu intervalo de polling.
Notas práticas de integração
- Fuso horário e timestamps: start_timestamp é segundos epoch UTC. Converta para exibição nos locais dos clientes.
- Tratamento de status: status e status_code impulsionam transições de estado; trate minute como uma string ("HT", "98’"). Não analise minute como um inteiro sem verificar.
- Placar seguro contra nulos: Antes do início, score.home e score.away podem ser nulos. Proteja seus formatadores.
- Paginando: Para jogos de dia inteiro, use Jogos FotMob por Data e itere a página até que a resposta indique que não há mais páginas. O padrão per_page é 100 e o máximo é 100.
- Cache: cache.ttl_seconds indica o TTL recomendado; evite sobrecarregar o endpoint com muita frequência.
- Identidade da partida: Use matches[].source_event_id como sua chave estável para correlacionar tick ao vivo e visualizações de detalhes.
- Auth: Sempre passe Authorization: Bearer YOUR_API_KEY; falhar em fazê-lo resultará em erros de autenticação.
Exemplos de fluxo de trabalho de ponta a ponta
- Ticker ao vivo: Consulte as Partidas de Futebol Ao Vivo FotMob para a data UTC de hoje, renderize placares, minutos e torneios. Vincule cada linha a uma visualização de detalhes usando o ID da partida.
- Página de destino pré-jogo: Chame Jogos FotMob por Data para o dia escolhido e pagine. Mostre partidas Não iniciadas agrupadas por competição.
- Tela de detalhes: Use o ID da partida extraído de qualquer um dos endpoints e chame Detalhes da Partida por ID da Partida para renderizar equipes, placar e campos de competição.
- Alertas: Quando o status transitar para Ao Vivo ou Intervalo/Finalizado, acione notificações. Use status_code para evitar casos extremos de correspondência de strings.
Chamando de agentes de IA via MCP
Se você automatiza tarefas com clientes compatíveis com MCP (Claude Code, Cursor, Windsurf e outros), você pode chamar as APIs do Zyla através do endpoint MCP:
Endpoint: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
Qualquer ferramenta configurada para falar MCP pode encaminhar solicitações para o Zyla. Reutilize o mesmo modelo de Autorização (sua chave de API está vinculada à sua conta e assinatura do Zyla). Para detalhes de configuração do cliente, veja a página MCP.
Dica: Mantenha sua lógica de busca de partidas sem estado e idempotente para que as ferramentas MCP possam tentar novamente com segurança. Observe cache.ttl_seconds para evitar chamadas desnecessárias dos seus loops de agente.
curl para jogos e detalhes (pronto para colar)
Todos os jogos para uma data (com controles de paginação):
Detalhes da partida por ID da partida:
Lista de verificação operacional
- Assumptions UTC: Tanto os endpoints ao vivo quanto os de jogos operam em datas UTC.
- Cadência de polling: Comece com cache.ttl_seconds; ajuste com base nas necessidades de UX e sua cota de assinatura.
- Tratamento de erros: Trate não-2xx como transitórios (tente novamente com backoff) a menos que seu cliente indique o contrário.
- Planejamento de cota: Esta API usa assinatura + cota. Sem Plano Gratuito. Para sua primeira API, você pode começar com um teste de 7 dias ou 50 solicitações—verifique os detalhes na página da API.
- Gerenciamento de segredos: Armazene YOUR_API_KEY em sua configuração do lado do servidor ou variáveis de ambiente. Não insira chaves no código do lado do cliente.
Links e próximos passos
- Navegue e inscreva-se na API de Futebol Ao Vivo FotMob.
- Crie sua conta: Registre-se.
- Explore mais listagens esportivas no Zyla API Hub.
FAQ
Como faço para autenticar?
Envie Authorization: Bearer YOUR_API_KEY em cada solicitação.
Em que fuso horário estão as datas e horas?
Os endpoints aceitam datas UTC. Os campos start_timestamp são segundos epoch UTC.
Como faço para obter todos os jogos para um dia de partida movimentado?
Use Jogos FotMob por Data com page e per_page, e continue buscando páginas subsequentes enquanto a resposta indicar mais dados.
Como faço para vincular linhas de partidas ao vivo a páginas de detalhes?
Use matches[].source_event_id dos endpoints ao vivo ou de jogos, e então chame Detalhes da Partida por ID da Partida com seu cabeçalho de autenticação.
Há um plano gratuito?
Não há Plano Gratuito. A primeira API oferece um teste de 7 dias ou 50 solicitações. Verifique a página da API para opções de acesso e preços atuais.
Pronto para enviar sua integração? Crie sua conta, obtenha sua chave e comece a chamar a API de Futebol Ao Vivo FotMob hoje. Registre-se agora.
