API de Confrontos do Barcelona — Dados de Rivalidade Gratuitos para 2026

Dados de Confrontos de Graça

A Barça API fornece o histórico de confrontos entre o FC Barcelona e qualquer adversário através de um simples endpoint GET. Você obtém cada partida encerrada com placares, mais um resumo de vitórias, empates, derrotas e gols — tudo em uma resposta JSON limpa.

Sem chave de API. Sem conta. Completamente gratuito.

O Endpoint de Confrontos

GET /api/h2h?team=Real Madrid

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
team	string	sim	Nome do adversário (busca parcial, mín 2 caracteres)
season	número	não	Ano da temporada (ex: 2025). Omitir para histórico completo

O parâmetro team suporta busca parcial — "Real" vai encontrar "Real Madrid", "Atlético" vai encontrar "Atlético Madrid".

Exemplo de resposta:

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

As partidas são retornadas em ordem decrescente por data. O resumo é sempre da perspectiva do Barcelona.

Campos da Resposta

Campos da Partida

Campo	Descrição
homeTeam	Time mandante
awayTeam	Time visitante
matchDate	Data e hora (ISO 8601)
homeScore / awayScore	Gols
competition	Nome da competição
matchday	Rodada/jornada

Campos do Resumo

Campo	Descrição
played	Total de partidas
wins	Vitórias do Barcelona
draws	Empates
losses	Derrotas do Barcelona
goalsFor	Gols marcados
goalsAgainst	Gols sofridos

Exemplos de Uso

Histórico do El Clásico

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

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

Rivalidade por Temporada

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

Teste no Terminal

Use o terminal interativo com o comando /h2h:

/h2h Real Madrid        — Histórico completo vs Real Madrid
/h2h Atlético 2025      — Temporada 2025-26 vs Atlético

Documentação

Veja a documentação completa para detalhes do schema, configuração de CORS e informações de rate limit.