Guía de Documentación de la API del FC Barcelona — Todo lo que Necesitas en 2026

Entendiendo la Documentación de la Barça API

La Barça API ofrece dos formas de explorar la documentación: docs interactivos con Scalar y un terminal en el navegador para exploración rápida.

Los Docs Interactivos

Accede a /docs para la documentación completa OpenAPI con Scalar:

• Navega por todos los endpoints con la lista completa de parámetros
• Ve objetos de solicitud y respuesta con ejemplos
• Envía solicitudes de prueba directamente desde el navegador
• Entiende respuestas de error y códigos de estado

Haciendo una Solicitud de Prueba

1. Accede a /docs
2. Haz clic en el endpoint /api/squad
3. Haz clic en "Try it"
4. Opcionalmente agrega position=FW como query parameter
5. Haz clic en Send — verás la respuesta en vivo de la API real

Sin clave de API, sin configuración.

El Terminal Interactivo

El terminal te permite consultar la API vía línea de comandos en el navegador.

Comandos Disponibles

/help              — Muestra todos los comandos
/squad             — Plantilla completa
/squad FW          — Filtrar delanteros
/player <número>   — Jugador por número de dorsal
/next-match        — Próximo partido
/calendar          — Calendario de partidos
/standings         — Clasificación de La Liga
/scorers           — Goleadores (LAL o UCL)
/h2h <equipo>      — Historial vs rival
/lang es           — Cambiar a español
/clear             — Limpiar terminal

Formato de las Solicitudes

Todos los endpoints de la Barça API son:

• Método HTTP: solo GET
• URL base: https://api.fc-barcelona.app
• Formato de respuesta: JSON con campo data
• Autenticación: No requerida
• CORS: Habilitado para todos los orígenes

Sobre de Respuesta Estándar

{
  "data": { ... },
  "meta": {
    "cached_at": "2026-03-21T12:00:00.000Z",
    "cache_expires_at": "2026-03-22T12:00:00.000Z"
  }
}

Respuestas de Error

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Jugador no encontrado"
  }
}

Ejemplos de Código

JavaScript / TypeScript

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

Python

import requests
response = requests.get('https://api.fc-barcelona.app/api/squad')
data = response.json()['data']

Empieza a Explorar

Accede a los docs interactivos o abre el terminal — ambos son gratuitos, no requieren configuración y se conectan a la API en vivo.