ScoreBat
Herramientas para desarrolladores

API oficial de vídeos de fútbol

Inicio rápido

  1. Obtén tu token de acceso en la pestaña de acceso.
  2. Llama a uno de los endpoints de la API, por ejemplo:
    GET
  3. Procesa la respuesta JSON.
  4. Inserta en tu página el HTML embed de uno de los vídeos de la respuesta para mostrar el reproductor. En aplicaciones móviles, puedes mostrar el vídeo en una vista web extrayendo su URL del código de inserción.

Token de acceso

Necesitas un token de acceso a la API para utilizar la API de vídeo.

Cada solicitud debe incluir tu token de acceso como parámetro token en la URL de la solicitud.

Puedes obtener tu token de acceso en la pestaña de acceso.

Endpoints

Puedes obtener los códigos de inserción de los vídeos en formato JSON desde los siguientes endpoints:

Free Feed

GET

El endpoint Free Feed te da acceso a una selección limitada de resúmenes de partidos. Incluye determinadas ligas y partidos antiguos, y sirve como muestra de la API de vídeo completa.

  • Solo incluye una parte de las ligas y los partidos, a menudo con encuentros antiguos o resúmenes seleccionados.
  • Devuelve vídeos oficiales e integrables procedentes de fuentes verificadas.
  • Ideal para hacer pruebas.
  • No incluye todas las competiciones ni las actualizaciones en directo disponibles en los planes de pago.

Featured Feed

GET

Devuelve un feed seleccionado y relevante que incluye partidos recientes e importantes de las principales ligas y competiciones de fútbol. El feed destaca los encuentros más populares y destacados, pero no incluye todos los partidos. Para acceder a todos los vídeos de una liga o un equipo concretos, utiliza los endpoints de competición o equipo.

  • Incluye una selección de partidos recientes de distintas ligas.
  • No incluye todos los partidos ni todas las competiciones, solo los más relevantes.
  • Disponible en todos los planes de pago.

Competición

GET

Puedes consultar los vídeos de cualquier competición mediante el endpoint Competición. Este endpoint devuelve vídeos de los últimos partidos de la competición indicada.

Por ejemplo, la URL siguiente devuelve vídeos de los partidos más recientes de la Premier League. La cadena england-premier-league es el identificador único (ID) de la Premier League.

Estos son los ID de algunas de las competiciones más populares:

Premier League
Serie A
La Liga
Bundesliga
Ligue 1

Puedes consultar aquí la lista de ID de todas las competiciones.

Equipo

GET

Puedes consultar los vídeos de cualquier equipo mediante el endpoint Equipo. Este endpoint devuelve vídeos de los últimos partidos del equipo indicado.

Por ejemplo, la URL siguiente devuelve vídeos de los partidos más recientes de Real Madrid. La cadena real-madrid es el identificador único (ID) de Real Madrid.

Estos son los ID de algunos de los equipos más populares:

Real Madrid
Barcelona
Arsenal
Chelsea
Liverpool
Manchester City
Manchester United

Puedes consultar aquí la lista de ID de todos los equipos.

Emisiones en directo

GET

Devuelve únicamente partidos con emisiones oficiales en directo disponibles, incluidos encuentros actualmente en juego y ya finalizados. Las entradas aparecen unos 5 minutos antes del inicio.

  • Muestra únicamente partidos con emisiones oficiales que se pueden integrar.
  • Incluye partidos en directo y finalizados recientemente, con repeticiones de la emisión cuando estén disponibles.
  • Los elementos empiezan a aparecer unos 5 minutos antes de la hora prevista de inicio.

Endpoints actualizados

GET

Este endpoint permite detectar qué feeds de competiciones o equipos se han actualizado recientemente, sin necesidad de consultar continuamente cada endpoint por separado.

Estructura de la respuesta

La respuesta es un objeto JSON que contiene una clave response con un array de objetos de partidos. Cada partido incluye su información básica, los datos de la competición correspondiente y una lista de vídeos disponibles.

JSON
{"response": [{"title": "Chelsea - Manchester United","competition": "ENGLAND: Premier League","matchviewUrl": "...","competitionUrl": "...","thumbnail": "...","date": "2029-05-18T15:00:00+0000","homeTeam": {"name": "Chelsea","slug": "chelsea","id": 229},"awayTeam": {"name": "Manchester United","slug": "manchester-united","id": 243},"videos": [{"title": "Highlights","embed": "..."},{"title": "Extended Highlights","embed": "..."}]},...]}

La clave response contiene un array de objetos de partidos. Cada objeto representa un partido de fútbol e incluye los campos siguientes:

  • title – El nombre del partido (p. ej., Chelsea - Manchester United).
  • competition – El nombre de la competición (p. ej., England Premier League).
  • date – La fecha y la hora de inicio del partido.
  • thumbnail – La URL de una imagen en miniatura del partido.
  • videos – Un array con todos los vídeos disponibles del partido. Cada objeto de vídeo incluye:
    • title – El título del vídeo (p. ej., Highlights o Extended Highlights).
    • embed – El código HTML de inserción del vídeo.
    • id – El identificador único del vídeo.
  • homeTeam / awayTeam – Objetos que representan a los equipos participantes en el partido e incluyen:
    • name – El nombre completo del equipo (p. ej., Chelsea).
    • slug – El slug del equipo utilizado en las URL (p. ej., chelsea).
    • id – El identificador único del equipo.
  • matchviewUrl – La URL de la página del widget del partido, que contiene información detallada como resultados en directo, estadísticas y clasificaciones.
  • competitionUrl – La URL del widget de la competición, que muestra clasificaciones en directo, resultados y próximos partidos.

Reproducción automática

Puedes activar la reproducción automática añadiendo el parámetro autoplay=1 a la URL del vídeo.

Por ejemplo:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1Si utilizas directamente el HTML embed, puedes añadir &autoplay=1 a la URL del vídeo dentro del atributo src del iframe.

Cuota

Cada plan incluye un límite mensual de solicitudes.

  • Cada visualización de vídeo o widget cuenta como 1 solicitud.
  • Cada llamada a la API de vídeo cuenta como 5 solicitudes de tu cuota mensual.

Por ejemplo:

  • El plan Starter incluye 5.000 solicitudes al mes.
  • El plan Standard incluye 20.000 solicitudes al mes.
  • El plan Advanced incluye 100.000 solicitudes al mes.
  • Si necesitas un límite mayor, contacta con nosotros para conocer nuestros planes Enterprise.

Si superas tu límite mensual de solicitudes, tu cuenta pasará automáticamente al plan gratuito hasta el siguiente periodo de facturación. Durante ese tiempo, aparecerán anuncios y logotipos de ScoreBat en los widgets y vídeos, y solo se podrá acceder al endpoint Free Feed.