Endpoint de Próxima Partida do Barcelona — API Gratuita em Tempo Real 2026

O Endpoint de Próxima Partida

Um dos endpoints mais úteis da Barça API é o /api/next-match. Ele retorna a próxima partida agendada do FC Barcelona — com times, data, local, competição e número da rodada em uma única chamada.

Gratuito, sem chave de API.

Fazendo a Requisição

GET /api/next-match

curl https://api.fc-barcelona.app/api/next-match

Estrutura da 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"
  }
}

Se não houver partida agendada, data será null.

matchDate — Campo Mais Importante

O campo matchDate é retornado em ISO 8601 (UTC). Converta para horário local antes de exibir:

const matchDate = new Date(data.matchDate);
const localTime = matchDate.toLocaleString('pt-BR', {
  weekday: 'long',
  year: 'numeric',
  month: 'long',
  day: 'numeric',
  hour: '2-digit',
  minute: '2-digit',
  timeZoneName: 'short'
});
console.log(localTime); // "sábado, 22 de março de 2026 às 18:00 BRT"

Construindo um Contador Regressivo ao Vivo

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

  if (!data) return;

  const matchDate = new Date(data.matchDate);

  setInterval(() => {
    const diff = matchDate - new Date();
    if (diff <= 0) {
      document.getElementById('countdown').textContent = 'Partida em andamento!';
      return;
    }

    const days = Math.floor(diff / 86400000);
    const hours = Math.floor((diff % 86400000) / 3600000);
    const minutes = Math.floor((diff % 3600000) / 60000);
    const seconds = Math.floor((diff % 60000) / 1000);

    document.getElementById('countdown').textContent =
      `${days}d ${hours}h ${minutes}m ${seconds}s`;
  }, 1000);
}

Experimente ao Vivo

O terminal interativo exibe a próxima partida com contagem regressiva ao vivo. Execute /next-match para ver. A documentação completa contém o schema de resposta completo.