API de Calendário de Partidas do Barcelona — Acesso Gratuito 2026

Calendário de Partidas do Barcelona via API

Acompanhar as partidas do FC Barcelona na La Liga, Copa del Rey e competições europeias pode ser trabalhoso. A Barça API resolve isso com dois endpoints dedicados: um para a próxima partida e outro para o calendário completo da temporada.

Ambos são gratuitos e não exigem autenticação.

Endpoint de Próxima Partida

Obtenha detalhes instantâneos sobre o próximo jogo do Barcelona:

GET /api/next-match

Exemplo de resposta:

{
  "data": {
    "id": 15,
    "homeTeam": "FC Barcelona",
    "awayTeam": "Real Madrid",
    "matchDate": "2026-03-22T21:00:00Z",
    "venue": "Spotify Camp Nou",
    "competition": "La Liga",
    "matchday": 29,
    "status": "scheduled"
  }
}

Perfeito para um contador regressivo, um widget de "próximo jogo" ou um sistema de notificações.

Endpoint de Calendário Completo

Obtenha todas as partidas da temporada:

GET /api/calendar

A resposta inclui todas as partidas agendadas e concluídas, com datas, placares (para partidas passadas), locais e nomes de competição. Suporta paginação:

GET /api/calendar?page=1&limit=10

Campos de Dados das Partidas

Campo	Tipo	Descrição
homeTeam	string	Nome do time mandante
awayTeam	string	Nome do time visitante
matchDate	ISO 8601	Data e hora da partida (UTC)
venue	string	Nome do estádio
competition	string	Nome da competição
matchday	number	Número da rodada
status	string	scheduled ou completed
homeScore	number?	Gols do mandante (apenas concluídas)
awayScore	number?	Gols do visitante (apenas concluídas)

Construindo um Contador Regressivo

O campo matchDate é um timestamp ISO 8601 que você pode usar diretamente com Date do JavaScript:

const response = await fetch('https://api.fc-barcelona.app/api/next-match');
const { data } = await response.json();

const matchDate = new Date(data.matchDate);
const now = new Date();
const diff = matchDate - now;

const days = Math.floor(diff / (1000 * 60 * 60 * 24));
const hours = Math.floor((diff % (1000 * 60 * 60 * 24)) / (1000 * 60 * 60));

console.log(`Próxima partida em ${days} dias e ${hours} horas`);

Terminal Interativo

O terminal interativo tem o comando /next-match que mostra a próxima partida com contagem regressiva ao vivo. Experimente — sem código necessário.