ScoreBat
Outils développeur

API vidéo officielle de football

Démarrage rapide

  1. Récupérez votre jeton d’accès dans l’onglet Accès.
  2. Appelez l’un des endpoints API, par exemple :
    GET
  3. Analysez la réponse JSON.
  4. Insérez dans votre page le code HTML embed de l’une des vidéos de la réponse afin d’afficher le lecteur. Dans une application mobile, vous pouvez afficher la vidéo dans une vue web en extrayant son URL du code d’intégration.

Jeton d’accès

Un jeton d’accès à l’API est nécessaire pour utiliser l’API vidéo.

Chaque requête doit inclure votre jeton d’accès dans le paramètre token de l’URL de la requête.

Vous pouvez obtenir votre jeton d’accès dans l’onglet Accès.

Endpoints

Vous pouvez récupérer les codes d’intégration des vidéos au format JSON depuis les endpoints suivants :

Free Feed

GET

L’endpoint Free Feed donne accès à une sélection limitée de résumés de matchs. Il comprend certains championnats et des rencontres plus anciennes afin de donner un aperçu de l’API vidéo complète.

  • Comprend uniquement une partie des championnats et des matchs, souvent des rencontres plus anciennes ou une sélection de résumés.
  • Renvoie des vidéos officielles et intégrables provenant de sources vérifiées.
  • Idéal pour les tests.
  • N’inclut pas toutes les compétitions ni les mises à jour en direct proposées dans les offres payantes.

Featured Feed

GET

Renvoie un flux pertinent et sélectionné comprenant des matchs récents et importants issus des principaux championnats et compétitions de football. Ce flux met en avant les rencontres les plus populaires et les plus marquantes, mais ne comprend pas tous les matchs. Pour accéder à toutes les vidéos d’un championnat ou d’une équipe, utilisez les endpoints de compétition ou d’équipe.

  • Comprend une sélection de matchs récents issus de différents championnats.
  • N’inclut pas tous les matchs ni toutes les compétitions, uniquement les plus pertinents.
  • Disponible avec toutes les offres payantes.

Compétition

GET

Vous pouvez rechercher les vidéos de n’importe quelle compétition à l’aide de l’endpoint Compétition. Cet endpoint renvoie les vidéos des derniers matchs de la compétition indiquée.

Par exemple, l’URL ci-dessous renvoie les vidéos des matchs les plus récents de Premier League. La chaîne england-premier-league est l’identifiant unique (ID) de Premier League.

Voici les ID de quelques-unes des compétitions les plus populaires :

Premier League
Serie A
La Liga
Bundesliga
Ligue 1

Vous trouverez la liste des ID de toutes les compétitions ici.

Équipe

GET

Vous pouvez rechercher les vidéos de n’importe quelle équipe à l’aide de l’endpoint Équipe. Cet endpoint renvoie les vidéos des derniers matchs de l’équipe indiquée.

Par exemple, l’URL ci-dessous renvoie les vidéos des matchs les plus récents de Real Madrid. La chaîne real-madrid est l’identifiant unique (ID) de Real Madrid.

Voici les ID de quelques-unes des équipes les plus populaires :

Real Madrid
Barcelona
Arsenal
Chelsea
Liverpool
Manchester City
Manchester United

Vous trouverez la liste des ID de toutes les équipes ici.

Diffusions en direct

GET

Renvoie uniquement les matchs pour lesquels une diffusion officielle est disponible, qu’ils soient en cours ou déjà terminés. Les éléments apparaissent environ 5 minutes avant le coup d’envoi.

  • Affiche uniquement les matchs disposant d’une diffusion officielle et intégrable.
  • Comprend les matchs en direct et récemment terminés, avec rediffusion lorsqu’elle est disponible.
  • Les éléments commencent à apparaître environ 5 minutes avant l’heure prévue du coup d’envoi.

Endpoints mis à jour

GET

Cet endpoint permet de détecter les flux de compétitions ou d’équipes récemment mis à jour, sans avoir à interroger chaque endpoint séparément.

Structure de la réponse

La réponse est un objet JSON contenant une clé response associée à un tableau d’objets de match. Chaque match comprend ses informations essentielles, les détails de la compétition correspondante et la liste des vidéos 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 clé response contient un tableau d’objets de match. Chaque objet représente un match de football et comprend les champs suivants :

  • title – Le nom du match (par exemple Chelsea - Manchester United).
  • competition – Le nom de la compétition (par exemple England Premier League).
  • date – La date et l’heure du coup d’envoi du match.
  • thumbnail – L’URL d’une miniature du match.
  • videos – Un tableau de toutes les vidéos disponibles pour le match. Chaque objet vidéo comprend :
    • title – Le titre de la vidéo (par exemple Highlights ou Extended Highlights).
    • embed – Le code HTML d’intégration de la vidéo.
    • id – L’identifiant unique de la vidéo.
  • homeTeam / awayTeam – Les objets représentant les équipes qui participent au match, notamment :
    • name – Le nom complet de l’équipe (par exemple Chelsea).
    • slug – Le slug de l’équipe utilisé dans les URL (par exemple chelsea).
    • id – L’identifiant unique de l’équipe.
  • matchviewUrl – L’URL de la page du widget de match, qui contient des informations détaillées comme les scores en direct, les statistiques et le classement.
  • competitionUrl – L’URL du widget de la compétition, qui affiche le classement en direct, les résultats et les prochains matchs.

Lecture automatique

Vous pouvez activer la lecture automatique en ajoutant le paramètre autoplay=1 à l’URL de la vidéo.

Par exemple :https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1Si vous utilisez directement le code HTML embed, vous pouvez ajouter &autoplay=1 à l’URL de la vidéo dans l’attribut src de l’iframe.

Quota

Chaque offre comprend une limite mensuelle de requêtes.

  • Chaque vue d’une vidéo ou affichage d’un widget compte comme 1 requête.
  • Chaque appel à l’API vidéo compte comme 5 requêtes dans votre quota mensuel.

Par exemple :

  • L’offre Starter comprend 5 000 requêtes par mois.
  • L’offre Standard comprend 20 000 requêtes par mois.
  • L’offre Advanced comprend 100 000 requêtes par mois.
  • Si vous avez besoin d’une limite supérieure, contactez-nous pour découvrir nos offres Enterprise.

Si vous dépassez votre limite mensuelle de requêtes, votre compte passera automatiquement à l’offre gratuite jusqu’à la prochaine période de facturation. Pendant ce temps, des publicités et des logos ScoreBat apparaîtront sur les widgets et les vidéos, et seul l’endpoint Free Feed restera accessible.