/v1/live/contests
const url = 'https://example.com/v1/live/contests?date=2026-10-10&sport=302&competition=103&limit=20&lang=ar';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://example.com/v1/live/contests?date=2026-10-10&sport=302&competition=103&limit=20&lang=ar'Parameters
Section intitulée « Parameters »Query Parameters
Section intitulée « Query Parameters »Jour (UTC) : tous les contests du jour, toutes compétitions confondues
Example
2026-10-10Jour (UTC) : tous les contests du jour, toutes compétitions confondues
Un sport (id de /v1/sports)
Example
302Un sport (id de /v1/sports)
Une compétition (id de /v1/competitions)
Example
103Une compétition (id de /v1/competitions)
Curseur de la page suivante, tel que renvoyé dans meta.cursor
Curseur de la page suivante, tel que renvoyé dans meta.cursor
Taille de la page, de 1 à 100 (défaut : 20)
Example
20Taille de la page, de 1 à 100 (défaut : 20)
Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l’anglais, puis le français.
Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l’anglais, puis le français.
Responses
Section intitulée « Responses »Contests du jour réduits au statut et au score (podium pour une épreuve classée). meta.pollAfter : secondes avant la prochaine lecture, null quand plus rien ne bougera. Tant qu’elle se relit, en cache pollAfter secondes dans le navigateur (Cache-Control: public, max-age=<pollAfter>) et une minute au CDN, rafraîchie à chaque changement ; ensuite, la classe de son contenu.
object
Duel en direct
object
Identifiant opaque d’un contest (match, course, épreuve)
Un sport : code pour le rendu, id pour filtrer les autres routes (?sport=)
object
Identifiant opaque d’un sport
Code stable d’un sport, qui choisit son profil de rendu ; other sans profil dédié. Liste ouverte : ignorer une valeur inconnue.
Instant ISO 8601 en UTC (2026-10-10T13:30:00.000Z)
Statut normalisé ; statusLabel donne le libellé exact de la source (« Mi-temps », « Manche 3 »…). Liste ouverte : ignorer une valeur inconnue.
Un camp d’un duel en direct : la part de ContestSide qui bouge
object
Score principal ; null tant que le match n’a pas commencé
Un camp d’un duel en direct : la part de ContestSide qui bouge
object
Score principal ; null tant que le match n’a pas commencé
Épreuve classée en direct : le podium du moment
object
Identifiant opaque d’un contest (match, course, épreuve)
Un sport : code pour le rendu, id pour filtrer les autres routes (?sport=)
object
Identifiant opaque d’un sport
Code stable d’un sport, qui choisit son profil de rendu ; other sans profil dédié. Liste ouverte : ignorer une valeur inconnue.
Instant ISO 8601 en UTC (2026-10-10T13:30:00.000Z)
Statut normalisé ; statusLabel donne le libellé exact de la source (« Mi-temps », « Manche 3 »…). Liste ouverte : ignorer une valeur inconnue.
Un concurrent d’une épreuve classée ; position vaut null pour un non classé
object
Une équipe
object
Identifiant opaque d’une équipe
Logo d’une équipe, en PNG carré : small en 32 × 32 px (liste, tableau), large en 100 × 100 px (fiche, en-tête de match). Servi pour les équipes de football, null pour les autres sports. Une équipe dont iDalgo n’a pas le fichier répond 404 à cette adresse : prévoyez un repli (écusson neutre)
object
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Un athlète seul
object
Identifiant opaque d’une personne (athlète, arbitre)
Portrait d’une personne, en JPEG au format 5:7 : small en 50 × 70 px (liste, composition), large en 100 × 141 px (fiche). Beaucoup de personnes n’ont pas de portrait : l’adresse répond alors 404, prévoyez un repli (silhouette neutre)
object
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Plusieurs athlètes sans équipe (relais, double) ; name réunit leurs noms
object
Identifiant opaque d’un équipage (relais, double)
Une personne : athlète, joueur, arbitre
object
Identifiant opaque d’une personne (athlète, arbitre)
Portrait d’une personne, en JPEG au format 5:7 : small en 50 × 70 px (liste, composition), large en 100 × 141 px (fiche). Beaucoup de personnes n’ont pas de portrait : l’adresse répond alors 404, prévoyez un repli (silhouette neutre)
object
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
object
Date de génération de la réponse
Version du contrat de la réponse : v1 pour une ressource /v1, celle du module pour un module (/modules/<nom>/v<n> → v<n>)
Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l’anglais, puis le français.
Secondes avant de relire la vue (plus court pour les sports rapides) ; null quand plus rien ne bougera (tout est terminé, reporté ou annulé) : le widget s’arrête
object
Chemin de la ressource, paramètres triés
Page suivante ; absent sur la dernière
Example
{ "data": [ { "type": "head-to-head" } ], "meta": { "version": "v1", "lang": "ar" }}Contenu inchangé depuis l’ETag envoyé en If-None-Match
Paramètre invalide, inconnu ou manquant, ou curseur invalide
Erreur au format application/problem+json (RFC 9457)
object
Code stable d’une erreur de l’API. Liste ouverte : ignorer une valeur inconnue.
Explication propre à cette requête
Identifiant de la requête (aussi en en-tête X-Request-Id) sur une erreur internal-error, à donner au support
Example generated
{ "type": "example", "title": "example", "status": 1, "code": "example", "detail": "example", "requestId": "example"}