API Sports

Matchs, calendriers et statistiques football et basketball, à intégrer dans vos bots et projets en quelques lignes de code.

Base URL https://allpredictor.com/api/v2 Production

ℹ️

Authentification. Toutes les requêtes nécessitent le header X-API-Key avec une clé générée depuis votre dashboard (page « Mes clés API »).

💡

Les réponses sont mises en cache côté serveur quelques dizaines de secondes — évitez d'interroger un même match plus d'une fois par minute.

Sports

Liste des matchs

GEThttps://allpredictor.com/api/v2/sports/{sport}

Retourne le calendrier ou les matchs en direct pour un sport donné. Sports disponibles : football, basketball.

Paramètre	Type	Description
date	string	optionnel Format `YYYY-MM-DD`. Aujourd'hui par défaut.
live	boolean	optionnel `true` pour ne récupérer que les matchs en cours.
league	number	optionnel ID de ligue (fournisseur API-Sports).

            
          curl "https://allpredictor.com/api/v2/sports/football?date=2026-08-06" \
  -H "X-API-Key: ap_votre_clé"
        
          const res = await fetch('https://allpredictor.com/api/v2/sports/football?date=2026-08-06', {
  headers: { 'X-API-Key': process.env.ALLPREDICTOR_KEY },
});
const { matches } = await res.json();
console.log(matches);
        
          r = requests.get("https://allpredictor.com/api/v2/sports/football",
  params={"date": "2026-08-06"},
  headers={"X-API-Key": "ap_votre_clé"}).json()
for m in r["matches"]: print(m["home"]["name"], "vs", m["away"]["name"])

Réponse

{
  "sport": "football",
  "count": 1,
  "matches": [
    {
      "id": 1234567,
      "date": "2026-08-06T19:00:00+00:00",
      "status": "NS",
      "status_long": "Not Started",
      "elapsed": null,
      "league": "Ligue 1",
      "home": { "id": 85, "name": "Paris Saint Germain", "logo": "https://media.api-sports.io/football/teams/85.png" },
      "away": { "id": 91, "name": "Monaco", "logo": "https://media.api-sports.io/football/teams/91.png" },
      "score": { "home": null, "away": null }
    }
  ]
}

Sports

Détail d'un match

GEThttps://allpredictor.com/api/v2/sports/{sport}/{id}

Retourne un match précis (identifié par l'id reçu dans la liste des matchs) ainsi que ses statistiques disponibles.

            
          curl "https://allpredictor.com/api/v2/sports/football/1234567" \
  -H "X-API-Key: ap_votre_clé"
        
          const res = await fetch('https://allpredictor.com/api/v2/sports/football/1234567', {
  headers: { 'X-API-Key': process.env.ALLPREDICTOR_KEY },
});
const { match, stats } = await res.json();
console.log(match.score, stats);
        
          r = requests.get("https://allpredictor.com/api/v2/sports/football/1234567",
  headers={"X-API-Key": "ap_votre_clé"}).json()
print(r["match"]["score"], r["stats"])

Réponse

{
  "sport": "football",
  "match": {
    "id": 1234567,
    "date": "2026-08-06T19:00:00+00:00",
    "status": "FT",
    "status_long": "Match Finished",
    "league": "Ligue 1",
    "home": { "id": 85, "name": "Paris Saint Germain" },
    "away": { "id": 91, "name": "Monaco" },
    "score": { "home": 3, "away": 1 }
  },
  "stats": [
    { "team": { "id": 85, "name": "Paris Saint Germain" },
      "statistics": [ { "type": "Ball Possession", "value": "58%" } ] }
  ]
}

⚠️

Le tableau stats peut être vide pour un match qui n'a pas encore commencé, ou si le fournisseur n'a pas encore publié les statistiques.

Sports

Codes d'erreur

Code	Signification
401	Clé API manquante ou invalide.
404	Sport inconnu, ou match introuvable pour l'`id` donné.
502	Le fournisseur de données sportives est indisponible ou a renvoyé une erreur.
503	Service temporairement non configuré côté serveur.