API de Historial del Barcelona — Datos de Rivalidad Gratuitos para 2026

Datos de Historial Gratis

La Barça API proporciona el historial de enfrentamientos entre el FC Barcelona y cualquier rival a través de un simple endpoint GET. Obtienes cada partido completado con marcadores, más un resumen de victorias, empates, derrotas y goles — todo en una respuesta JSON limpia.

Sin clave de API. Sin cuenta. Completamente gratis.

El Endpoint de Historial

GET /api/h2h?team=Real Madrid

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
team	string	sí	Nombre del rival (búsqueda parcial, mín 2 caracteres)
season	número	no	Año de temporada (ej: 2025). Omitir para historial completo

El parámetro team soporta búsqueda parcial — "Real" encontrará "Real Madrid", "Atlético" encontrará "Atlético Madrid".

Ejemplo de respuesta:

{
  "data": {
    "matches": [
      {
        "id": 42,
        "homeTeam": "Barcelona",
        "awayTeam": "Real Madrid",
        "matchDate": "2026-03-15T20:00:00.000Z",
        "homeScore": 3,
        "awayScore": 1,
        "competition": "La Liga",
        "competitionShortName": "LAL",
        "matchday": 28,
        "homeTeamImageUrl": "https://api.fc-barcelona.app/teams/barcelona.png",
        "awayTeamImageUrl": "https://api.fc-barcelona.app/teams/real-madrid.png"
      }
    ],
    "summary": {
      "played": 12,
      "wins": 6,
      "draws": 3,
      "losses": 3,
      "goalsFor": 22,
      "goalsAgainst": 15
    }
  },
  "meta": {
    "cached_at": "2026-03-21T12:00:00.000Z",
    "cache_expires_at": "2026-03-22T12:00:00.000Z"
  }
}

Los partidos se devuelven en orden descendente por fecha. El resumen es siempre desde la perspectiva del Barcelona.

Campos de la Respuesta

Campos del Partido

Campo	Descripción
homeTeam	Equipo local
awayTeam	Equipo visitante
matchDate	Fecha y hora (ISO 8601)
homeScore / awayScore	Goles
competition	Nombre de la competición
matchday	Jornada

Campos del Resumen

Campo	Descripción
played	Total de partidos
wins	Victorias del Barcelona
draws	Empates
losses	Derrotas del Barcelona
goalsFor	Goles a favor
goalsAgainst	Goles en contra

Ejemplos de Uso

Historial del Clásico

const response = await fetch('https://api.fc-barcelona.app/api/h2h?team=Real Madrid');
const { data } = await response.json();

console.log(`Récord vs Real Madrid: ${data.summary.wins}V ${data.summary.draws}E ${data.summary.losses}D`);

Rivalidad por Temporada

GET /api/h2h?team=Atlético Madrid&season=2025

Pruébalo en el Terminal

Usa el terminal interactivo con el comando /h2h:

/h2h Real Madrid        — Historial completo vs Real Madrid
/h2h Atlético 2025      — Temporada 2025-26 vs Atlético

Documentación

Consulta la documentación completa para detalles del schema, configuración de CORS e información de rate limit.