Endpoint del Próximo Partido del Barcelona — API Gratuita en Tiempo Real 2026

El Endpoint de Próximo Partido

Uno de los endpoints más útiles de la Barça API es /api/next-match. Devuelve el próximo partido programado del FC Barcelona — con equipos, fecha, sede, competición y número de jornada en una sola llamada.

Gratuito, sin clave de API.

Haciendo la Solicitud

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

Estructura de la Respuesta

{
  "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"
  }
}

matchDate — El Campo Más Importante

El campo matchDate se devuelve en ISO 8601 (UTC). Conviértelo a hora local antes de mostrarlo:

const matchDate = new Date(data.matchDate);
const localTime = matchDate.toLocaleString('es-ES', {
  weekday: 'long',
  year: 'numeric',
  month: 'long',
  day: 'numeric',
  hour: '2-digit',
  minute: '2-digit',
  timeZoneName: 'short'
});

Construyendo una Cuenta Atrás en 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 = '¡Partido en curso!';
      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);
}

Pruébalo en Vivo

El terminal interactivo muestra el próximo partido con una cuenta atrás en vivo. Ejecuta /next-match para verlo. La documentación completa contiene el esquema de respuesta completo.