Você precisa de dados de esportes ao vivo que pode enviar esta semana: odds de vencedores de times por casa de apostas, notícias frescas de times/jogadores e um calendário de torneios de tênis que você pode integrar ao seu aplicativo sem fazer scraping. Ao final deste guia, você fará consultas à FlashScore - Live API para esses conjuntos de dados com requisições copiáveis, analisará as respostas e as integrará ao seu produto ou a um trabalho agendado.
O que você pode construir com FlashScore - Live API
A FlashScore - Live API fornece dados esportivos estruturados que estão prontos para uso em produção:
- Odds de vencedores de times em casas de apostas, com bandeiras de “melhor” e “ativo” que você pode usar para destacar preços líderes de mercado.
- Últimas notícias para times e jogadores específicos, incluindo título, link, fonte, imagem e horário de publicação (como um timestamp epoch).
- Um calendário de torneios de tênis (exemplo fornecido) com metadados do torneio, superfície, cronograma, país e detalhes do vencedor.
Casos de uso típicos incluem widgets de comparação de casas de apostas, páginas de conteúdo de apostas, aplicativos para fãs com feeds de notícias direcionados, personalização de CRM/email com base em menções de jogadores/teams, e módulos de cronograma de tênis. Tudo funciona sobre HTTPS via Zyla API Hub, então você usa uma única chave de API e assinatura em milhares de APIs.
Começando no Zyla API Hub
Abra a página da API, clique em Assinar ou Iniciar teste de 7 dias, e pegue sua chave de API. A autenticação é via Authorization: Bearer YOUR_API_KEY em cada requisição. A cobrança é por assinatura + cota (não é pago por chamada). Não há Plano Gratuito; a primeira API inclui um teste de 7 dias ou 50 requisições—verifique a página da API para opções de acesso e preços atuais.
- Iniciar teste de 7 dias na FlashScore - Live API
- Explore mais de 10.000 APIs públicas em Zyla API Hub
Endpoints que você pode usar hoje
Abaixo estão os endpoints disponíveis neste artigo, incluindo URLs de requisição exatas e métodos. Todas as requisições devem incluir o cabeçalho Authorization: Bearer YOUR_API_KEY.
1) Obter Odds de Vencedor de Time
Retorna as odds de um time específico para vencer cada torneio em que participa, por casa de apostas.
- Método: GET
- URL: https://zylalabs.com/api/12518/flashscore-live-api/40619/get-team-winner-odds
- Parâmetros de consulta:
- team_id (string, obrigatório): e.g., Wtn9Stg0
- geo_ip_code (string, opcional): e.g., GB (use para restringir a disponibilidade de casas de apostas por região)
cURL (copiar-colar):
curl -s -X GET "https://zylalabs.com/api/12518/flashscore-live-api/40630/get-tennis-tournament-calendar?type=atp" \
-H "Authorization: Bearer YOUR_API_KEY"
Notas para implementadores:
- Use is_best para destacar o preço atual mais alto.
- Exiba apenas mercados ativos (is_active) onde necessário para sua experiência do usuário.
- O mesmo time pode aparecer em múltiplos torneios; itere todos os itens do array.
2) Obter Notícias de Jogador
Retorna os últimos artigos de notícias sobre um jogador específico com título, link, imagem, fonte e horário de publicação.
- Método: GET
- URL: https://zylalabs.com/api/12518/flashscore-live-api/40617/get-player-news
- Parâmetros de consulta:
- player_id (string, obrigatório): e.g., dMPo6IPH
cURL (para referência):
Exemplo de resposta:
[
{
"name": "Brisbane ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/brisbane/",
"start_timestamp": 1767510600,
"end_timestamp": 1768104000,
"country": {
"country_id": 24,
"name": "Austrália"
},
"winner": {
"player_id": "O8qG0Nhb",
"name": "Medvedev Daniil",
"player_url": "/player/medvedev-daniil/O8qG0Nhb/",
"country": {
"country_id": 8,
"name": "Mundo"
}
}
},
{
"name": "Hong Kong ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/hong-kong/",
"start_timestamp": 1767591600,
"end_timestamp": 1768111200,
"country": {
"country_id": 222,
"name": "Hong Kong"
},
"winner": {
"player_id": "t0WN9vR6",
"name": "Bublik Alexander",
"player_url": "/player/bublik-alexander/t0WN9vR6/",
"country": {
"country_id": 102,
"name": "Cazaquistão"
}
}
},
{
"name": "Auckland ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/auckland/",
"start_timestamp": 1768171200,
"end_timestamp": 1768618800,
"country": {
"country_id": 140,
"name": "Nova Zelândia"
},
"winner": {
"player_id": "UFj257G8",
"name": "Mensik Jakub",
"player_url": "/player/mensik-jakub/UFj257G8/",
"country": {
"country_id": 62,
"name": "República Tcheca"
}
}
},
{
"name": "Adelaide ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/adelaide/",
"start_timestamp": 1768191300,
"end_timestamp": 1768618800,
"country": {
"country_id": 24,
"name": "Austrália"
},
"winner": {
"player_id": "S44E7UYr",
"name": "Machac Tomas",
"player_url": "/player/machac-tomas/S44E7UYr/",
"country": {
"country_id": 62,
"name": "República Tcheca"
}
}
},
{
"name": "Australian Open ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/australian-open/",
"start_timestamp": 1768694400,…
Campos a serem usados:
- title, url, image_url: conteúdo renderizável para seu feed.
- source: atribuição.
- published_at: timestamp Unix (segundos). Converta para o fuso horário do seu usuário no momento da renderização.
3) Obter Notícias de Time
Retorna os últimos artigos de notícias sobre um time específico com título, link, imagem, fonte e horário de publicação.
- Método: GET
- URL: https://zylalabs.com/api/12518/flashscore-live-api/40618/get-team-news
- Parâmetros de consulta:
- team_id (string, obrigatório): e.g., Wtn9Stg0
cURL (para referência):
Exemplo de resposta (truncado pela fonte):
[
{
"title": "Calvin Bassey responds to Man Utd interest after Fulham star frustrates Man City",
"url": "https://www.flashscore.com/newsfeed/fV482r4K/",
"image_url": "https://livesport-ott-images.ssl.cdn.cra.cz/r300x225q60/4f932562-5d33-4ea7-8801-53a3d021681b.jpeg",
"source": "Metro",
"published_at": 1795273228,
"is_flashscore_news": false
},
{
"title": "Iwobi, Bassey In Action As Fulham Share Spoils With Man City",
"url": "https://www.flashscore.com/newsfeed/xOJnSh9O/",
"image_url": "https://livesport-ott-images.ssl.cdn.cra.cz/r300x225q60/6180f2b3-7829-4ede-8d16-3223253a6997.jpeg",
"source": "Completesports",
"published_at": 1795272889,
"is_flashscore_news": false
},
{
"title": "VAR denies Haaland as Man City struggle to break down resolute Fulham",
"url": "https://www.flashscore.com/newsfeed/b9UIzKdK/",
"image_url": "https://livesport-ott-images.ssl.cdn.cra.cz/r300x225q60/47d8bb5a-7dc3-48c9-86e2-239488bdd4a6.jpeg",
"source": "timeslive.co.za",
"published_at": 1795272787,
"is_flashscore_news": false
},
{…
Dicas:
- Exiba um horário legível convertendo published_at (segundos) para sua localidade.
- is_flashscore_news indica se o artigo é da sala de imprensa da Flashscore ou de uma fonte externa.
Exemplo oficial: Obter Calendário de Torneios de Tênis
O seguinte exemplo oficial mostra como uma resposta de calendário de tênis é estruturada. Isso é útil para construir páginas de cronograma, prévias semana a semana ou filtragem por superfície.
cURL:
JSON:
[
{
"name": "Brisbane ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/brisbane/",
"start_timestamp": 1767510600,
"end_timestamp": 1768104000,
"country": {
"country_id": 24,
"name": "Australia"
},
"winner": {
"player_id": "O8qG0Nhb",
"name": "Medvedev Daniil",
"player_url": "/player/medvedev-daniil/O8qG0Nhb/",
"country": {
"country_id": 8,
"name": "World"
}
}
},
{
"name": "Hong Kong ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/hong-kong/",
"start_timestamp": 1767591600,
"end_timestamp": 1768111200,
"country": {
"country_id": 222,
"name": "Hong Kong"
},
"winner": {
"player_id": "t0WN9vR6",
"name": "Bublik Alexander",
"player_url": "/player/bublik-alexander/t0WN9vR6/",
"country": {
"country_id": 102,
"name": "Kazakhstan"
}
}
},
{
"name": "Auckland ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/auckland/",
"start_timestamp": 1768171200,
"end_timestamp": 1768618800,
"country": {
"country_id": 140,
"name": "New Zealand"
},
"winner": {
"player_id": "UFj257G8",
"name": "Mensik Jakub",
"player_url": "/player/mensik-jakub/UFj257G8/",
"country": {
"country_id": 62,
"name": "Czech Republic"
}
}
},
{
"name": "Adelaide ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/adelaide/",
"start_timestamp": 1768191300,
"end_timestamp": 1768618800,
"country": {
"country_id": 24,
"name": "Australia"
},
"winner": {
"player_id": "S44E7UYr",
"name": "Machac Tomas",
"player_url": "/player/machac-tomas/S44E7UYr/",
"country": {
"country_id": 62,
"name": "Czech Republic"
}
}
},
{
"name": "Australian Open ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/australian-open/",
"start_timestamp": 1768694400,…
Notas de implementação:
- start_timestamp e end_timestamp são segundos Unix. Use esses para renderizar intervalos de cronograma e filtrar por intervalos de datas.
- surface permite que você ative a interface de “filtrar por superfície”.
- winner está presente quando o torneio foi concluído; proteja-se contra dados de vencedor nulos/ausentes para eventos em andamento.
Um cliente Python mínimo que você pode integrar ao seu código
O trecho abaixo busca notícias de jogadores, converte timestamps para ISO8601 e imprime uma lista compacta para sua camada de UI. Troque a URL do endpoint para consultar notícias de times ou odds de vencedores de times com o mesmo padrão.
import requests
from datetime import datetime, timezone
API_KEY = "YOUR_API_KEY"
BASE = "https://zylalabs.com/api/12518/flashscore-live-api"
def iso(ts):
# ts vem como segundos Unix (int)
return datetime.fromtimestamp(ts, tz=timezone.utc).isoformat()
def get_player_news(player_id="dMPo6IPH"):
url = f"{BASE}/40617/get-player-news"
resp = requests.get(url, params={"player_id": player_id}, headers={"Authorization": f"Bearer {API_KEY}"})
resp.raise_for_status()
articles = resp.json()
results = []
for a in articles:
results.append({
"title": a.get("title"),
"url": a.get("url"),
"image": a.get("image_url"),
"source": a.get("source"),
"published_at_iso": iso(a["published_at"]) if a.get("published_at") else None,
"is_flashscore_news": a.get("is_flashscore_news"),
})
return results
if __name__ == "__main__":
for item in get_player_news():
print(f"[{item["published_at_iso"]}] {item["source"]}: {item["title"]} - {item["url"]}")
Este código usa o cabeçalho Authorization: Bearer, lê os campos de resposta documentados e converte timestamps. Você pode adaptar a mesma estrutura para:
- Notícias de time: mude o caminho para /40618/get-team-news e passe team_id.
- Odds de vencedores de time: mude o caminho para /40619/get-team-winner-odds e passe team_id (e opcionalmente geo_ip_code).
Casos de uso do mundo real e padrões de integração
Barra de comparação de odds para as chances diretas de um time
- Busque Obter Odds de Vencedor de Time com team_id.
- Classifique as odds por valor e destaque a linha com is_best = true.
- Filtre para is_active onde você precisa cumprir a disponibilidade atual.
- Se seu público é específico de localização, defina geo_ip_code (e.g., GB) para alinhar as casas de apostas a esse mercado.
Feeds de notícias de time e jogador
- Busque Obter Notícias de Time ou Obter Notícias de Jogador durante a renderização da página ou via um trabalho agendado.
- Mostre título, fonte e um horário relativo convertendo published_at (segundos) para o horário local.
- Use is_flashscore_news para distinguir peças oficiais da sala de imprensa de fontes externas.
Módulo de cronograma de tênis
- Use o exemplo do calendário de torneios de tênis para projetar seu esquema e UI.
- Permita filtragem por superfície e intervalos de datas via start_timestamp e end_timestamp.
- Exiba dados do vencedor quando presentes; caso contrário, mostre o estado em andamento/prévia.
Dicas de produção que economizam seu tempo
- Timestamps: Todos os exemplos mostram timestamps Unix em segundos. Converta no cliente ou servidor para seu fuso horário de exibição.
- Cache: Para notícias, um cache de 1–5 minutos é tipicamente bom para páginas de alto tráfego. Para odds, faça cache de forma mais conservadora se sua UI enfatiza a recência; sempre respeite is_active.
- Regionalização: geo_ip_code em odds ajuda a alinhar aos mercados de casas de apostas por região (exemplo: GB). Se não tiver certeza, defina como sem geo_ip_code para receber dados de disponibilidade geral.
- Tratamento de erros: Trate todos os endpoints como dependentes da rede. Implemente retry com backoff em 5xx e GETs idempotentes.
- Cotas e acesso: O acesso é por assinatura + cota. A primeira API geralmente fornece um teste de 7 dias ou 50 requisições—confirme os detalhes na página da API.
Se você está integrando várias APIs, a chave única e a cobrança consolidada no Zyla API Hub reduzem a sobrecarga quando você expande além dos esportes para serviços relacionados na mesma plataforma.
Chame a API de agentes de IA via MCP
Você pode expor a FlashScore - Live API para Claude Code, Cursor, Windsurf e qualquer cliente compatível com MCP através do endpoint MCP da Zyla. Aponte suas ferramentas de agente para a URL MCP abaixo, forneça sua chave de API Zyla e o agente pode invocar os mesmos endpoints mostrados acima:
Quando seu agente pedir odds de time, faça com que ele chame a ferramenta Obter Odds de Vencedor de Time com team_id, ou busque notícias de jogador/time com os parâmetros correspondentes. A autenticação permanece Authorization: Bearer YOUR_API_KEY através do MCP conforme configurado em seu cliente.
Colocando tudo junto rapidamente
Um caminho comum de lançamento:
- Assine e obtenha sua chave na página da API: Iniciar teste de 7 dias na FlashScore - Live API.
- Envie um componente de notícias usando Obter Notícias de Jogador ou Obter Notícias de Time. Converta published_at para o horário local, renderize título, image_url e fonte.
- Adicione um widget de comparação de odds usando Obter Odds de Vencedor de Time. Classifique por valor, destaque is_best e respeite is_active.
- Se você cobre tênis, integre a estrutura do exemplo do calendário para listar eventos e vencedores.
cURL que você pode executar agora: Obter Odds de Vencedor de Time
Cole no seu terminal (substitua YOUR_API_KEY):
Exemplo parcial de resposta (truncado pela fonte):
[
{
"tournament_id": "SY30SsKF",
"name": "Premier League",
"image_path": "https://static.flashscore.com/res/image/data/rN76jpW1-naArgzhi.png",
"odds": [
{
"bookmaker_id": 16,
"bookmaker_name": "bet365",
"bookmaker_image": "https://static.flashscore.com/res/image/data/bookmakers/80-16.png",
"value": 17,
"change": "UP",
"is_best": true,
"is_active": true
},
{
"bookmaker_id": 1281,
"bookmaker_name": "BetMGM.uk",
"bookmaker_image": "https://static.flashscore.com/res/image/data/bookmakers/80-1281.png",
"value": 15,
"change": "UP",
"is_best": false,
"is_active": false
},
{
"bookmaker_id": 21,
"bookmaker_name": "Betfred",
"bookmaker_image": "https://static.flashscore.com/res/image/data/bookmakers/80-21.png",
"value": 11,
"change": "UP",
"is_best": false,
"is_active…
Campos-chave:
- name: Nome do torneio para o mercado direto.
- odds[].value: Valor das odds a serem exibidas; combine com bookmaker_name e bookmaker_image.
- odds[].is_best: Indicador visual para o preço destacado.
- odds[].is_active: Use para filtrar mercados indisponíveis.
FAQ
-
Como faço para autenticar requisições?
Envie Authorization: Bearer YOUR_API_KEY em cada requisição para os endpoints da zylalabs.com.
-
Qual formato de horário os published_at e start_timestamp usam?
Eles são timestamps Unix em segundos. Converta-os para seu fuso horário desejado e formato em seu aplicativo.
-
O que geo_ip_code faz no endpoint de odds?
Ele limita a disponibilidade de casas de apostas por região (ex: GB). Se omitido, você receberá dados de disponibilidade geral.
-
Há um plano gratuito?
Não. O acesso é por assinatura + cota, não pago por chamada. A primeira API inclui um teste de 7 dias ou 50 requisições; verifique a página da API para detalhes atuais.
-
Posso chamar esta API de um agente de IA?
Sim. Use o endpoint MCP da Zyla em ferramentas compatíveis e direcione chamadas para esses endpoints através da sua chave de autorização configurada: Bearer.
Pronto para enviar? Crie sua chave e comece a integrar odds de times, notícias de jogadores/teams e cronogramas de tênis com a FlashScore - Live API. Comece aqui: Iniciar teste de 7 dias na FlashScore - Live API. Explore mais categorias a qualquer momento em Zyla API Hub.
Resposta oficial da API
[
{
"name": "Brisbane ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/brisbane/",
"start_timestamp": 1767510600,
"end_timestamp": 1768104000,
"country": {
"country_id": 24,
"name": "Austrália"
},
"winner": {
"player_id": "O8qG0Nhb",
"name": "Medvedev Daniil",
"player_url": "/player/medvedev-daniil/O8qG0Nhb/",
"country": {
"country_id": 8,
"name": "Mundo"
}
}
},
{
"name": "Hong Kong ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/hong-kong/",
"start_timestamp": 1767591600,
"end_timestamp": 1768111200,
"country": {
"country_id": 222,
"name": "Hong Kong"
},
"winner": {
"player_id": "t0WN9vR6",
"name": "Bublik Alexander",
"player_url": "/player/bublik-alexander/t0WN9vR6/",
"country": {
"country_id": 102,
"name": "Cazaquistão"
}
}
},
{
"name": "Auckland ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/auckland/",
"start_timestamp": 1768171200,
"end_timestamp": 1768618800,
"country": {
"country_id": 140,
"name": "Nova Zelândia"
},
"winner": {
"player_id": "UFj257G8",
"name": "Mensik Jakub",
"player_url": "/player/mensik-jakub/UFj257G8/",
"country": {
"country_id": 62,
"name": "República Tcheca"
}
}
},
{
"name": "Adelaide ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/adelaide/",
"start_timestamp": 1768191300,
"end_timestamp": 1768618800,
"country": {
"country_id": 24,
"name": "Austrália"
},
"winner": {
"player_id": "S44E7UYr",
"name": "Machac Tomas",
"player_url": "/player/machac-tomas/S44E7UYr/",
"country": {
"country_id": 62,
"name": "República Tcheca"
}
}
},
{
"name": "Australian Open ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/australian-open/",
"start_timestamp": 1768694400,…