DÉVELOPPEURS

API de prédiction football — 1X2, Plus/Moins de 2.5 et BTTS | Footalytics

API gratuite de prédiction football : probabilités victoire/nul/défaite, plus/moins de 2.5 et BTTS avec niveaux de confiance pour la Premier League, La Liga, la Bundesliga, la Serie A, la Ligue 1 et la Ligue des champions. Réponses JSON, 5 appels gratuits et un serveur MCP pour assistants IA.

Une API gratuite de prédiction football pour développeurs et assistants IA : réponses JSON avec probabilités victoire/nul/défaite, plus/moins de 2.5, les deux équipes marquent, niveaux de confiance et notes d'équipes pour la Premier League, La Liga, la Bundesliga, la Serie A, la Ligue 1, la Ligue des champions et plus. Les mêmes prédictions sont évaluées dans notre registre public de précision. Quatre endpoints couvrent tout le flux : prédire un match, parcourir les matchs, consulter les notes d'équipes et lire les résultats finalisés.

  • 5 appels API gratuits par compte — aucune carte requise.
  • JSON en entrée, probabilités en sortie : 1X2, plus/moins de 2.5, BTTS, scores probables et niveaux de confiance.
  • Serveur MCP inclus — les assistants IA se connectent directement.
  • Chaque prédiction est évaluée publiquement avec des scores Brier.

Tarifs — 5 appels API gratuits par compte, sans carte. Ensuite, 1 crédit par appel — les mêmes crédits que le chat du site, rechargeables sur la page des tarifs. Aucun abonnement mensuel.

Recharger des crédits Obtenir une clé API gratuite →

Démarrage rapide

  1. Créez une clé gratuite sur la page des clés API — chaque nouveau compte démarre avec 5 appels API gratuits.
  2. Appelez l'endpoint avec votre clé :
    curl "https://footalytics.farvor.com/api/v1/predictions?home=Chelsea&away=Manchester%20United" \
      -H "Authorization: Bearer fxk_your_key"
  3. Lisez la prédiction :
    {
      "provider": "Footalytics",
      "match": {
        "id": "ESPN-401879248", "home": "Chelsea", "away": "Manchester United",
        "league": "Premier League", "kickoff_utc": "2026-10-31T12:30:00Z", "status": "pending"
      },
      "prediction": {
        "outcome": { "home": 0.474, "draw": 0.267, "away": 0.259, "pick": "home" },
        "confidence": "medium",
        "xg": { "home": 1.61, "away": 1.13 },
        "top_scores": [{ "score": "1-1", "p": 0.127 }, { "score": "2-1", "p": 0.094 }],
        "over_2_5": 0.55, "btts": 0.52
      },
      "result": null,
      "links": {
        "match_page": "/match/401879248-chelsea-vs-manchester-united",
        "share": "https://footalytics.farvor.com/p/x4affkwufz2c",
        "accuracy": "https://footalytics.farvor.com/accuracy"
      }
    }

Authentification

Envoyez votre clé comme token bearer à chaque requête. La clé brute n'est affichée qu'une fois à la création — conservez-la en sécurité et ne la commitez jamais dans le contrôle de source. Révoquez-la et recréez-en une à tout moment sur la page des clés API.

Authorization: Bearer fxk_your_key

GET /api/v1/predictions

Un appel réussi coûte 1 unité. Les recherches échouées ne coûtent rien.

ParamètreDescription
home + awayLa méthode simple. Noms d'équipes, ex. home=Chelsea&away=Manchester United (encodez les espaces en URL sous forme de %20). Résolu via la fenêtre de matchs en direct de 14 jours ; si plusieurs matchs correspondent, celui avec une prédiction publiée est servi.
fixtureLa méthode précise, quand vous connaissez déjà l'id : l'un de 401879248, ESPN-401879248 ou ESPN-eng.1-401879248. C'est le seul moyen d'accéder aux matchs déjà commencés.
dateFacultatif, YYYY-MM-DD (UTC) — distingue les matchs retour.
{
  "provider": "Footalytics",
  "match": {
    "id": "ESPN-401879248", "home": "Chelsea", "away": "Manchester United",
    "league": "Premier League", "kickoff_utc": "2026-10-31T12:30:00Z", "status": "pending"
  },
  "prediction": {
    "outcome": { "home": 0.474, "draw": 0.267, "away": 0.259, "pick": "home" },
    "confidence": "medium",
    "xg": { "home": 1.61, "away": 1.13 },
    "top_scores": [{ "score": "1-1", "p": 0.127 }, { "score": "2-1", "p": 0.094 }],
    "over_2_5": 0.55, "btts": 0.52
  },
  "result": null,
  "links": {
    "match_page": "/match/401879248-chelsea-vs-manchester-united",
    "share": "https://footalytics.farvor.com/p/x4affkwufz2c",
    "accuracy": "https://footalytics.farvor.com/accuracy"
  }
}

Couverture : les prédictions officielles sont publiées jusqu'à 48 heures avant le coup d'envoi. Tous les matchs de Premier League, La Liga, Bundesliga, Serie A, Ligue 1 et Ligue des champions sont couverts, plus les affiches les plus relevées d'autres ligues. La recherche par nom d'équipe couvre les matchs à venir dans la fenêtre de matchs en direct — pour les matchs déjà commencés, transmettez l'id du match.

GET /api/v1/fixtures

Matchs à venir avec leurs ids de match — la moitié découverte du flux : trouvez le match ici (has_prediction indique si une prédiction est déjà publiée), puis appelez predictions. Facturé exactement comme predictions.

ParamètreDescription
teamSous-chaîne du nom d'équipe, ex. team=Arsenal — correspond à domicile ou extérieur.
leagueClé ESPN (eng.1) ou slug de ligue (premier-league).
dateFacultatif, YYYY-MM-DD (UTC).
limitFacultatif, par défaut 20, max. 50.

Au moins l'un de team / league est requis.

curl "https://footalytics.farvor.com/api/v1/fixtures?league=eng.1&limit=3" \
  -H "Authorization: Bearer fxk_your_key"
Réponse :
{
  "provider": "Footalytics",
  "fixtures": [
    {
      "fixture": "ESPN-401879251", "home": "AFC Bournemouth", "away": "Leeds United",
      "competition": "Premier League", "kickoff_utc": "2026-10-31T15:00Z",
      "has_prediction": false,
      "links": { "match_page": "/match/401879251-afc-bournemouth-vs-leeds-united" }
    }
  ]
}

GET /api/v1/teams

Profils d'équipes issus de notre tableau de notes : la note de type Elo derrière chaque prédiction.

ParamètreDescription
nameSous-chaîne du nom d'équipe, min. 2 caractères, ex. name=arsenal.
leagueFiltre facultatif, clé ESPN ou slug.
limitFacultatif, par défaut 20, max. 50.

Au moins l'un de name / league est requis.

curl "https://footalytics.farvor.com/api/v1/teams?name=arsenal" \
  -H "Authorization: Bearer fxk_your_key"
Réponse :
{
  "provider": "Footalytics",
  "teams": [
    {
      "id": "359", "name": "Arsenal", "league": "eng.1", "league_name": "Premier League",
      "rating": 1971, "games": 27, "ratings_updated_at": "2026-10-28T13:00:23Z"
    }
  ]
}

GET /api/v1/results

Le bilan finalisé : scores réels à côté de ce que notre modèle avait prédit, évalué marché par marché — les mêmes lignes que celles du registre public de précision.

ParamètreDescription
teamFiltre par nom d'équipe, ex. team=Chelsea.
leagueClé ESPN ou slug.
fixtureId de match unique.
limitFacultatif, par défaut 10, max. 20.

Au moins l'un de team / league / fixture est requis.

curl "https://footalytics.farvor.com/api/v1/results?team=Chelsea&limit=3" \
  -H "Authorization: Bearer fxk_your_key"
Réponse :
{
  "provider": "Footalytics",
  "results": [
    {
      "fixture": "ESPN-401878764", "home": "Sunderland", "away": "Leeds United",
      "competition": "Premier League", "kickoff_utc": "2026-10-25T16:30:00Z",
      "result": { "home_goals": 0, "away_goals": 0 },
      "our_prediction": {
        "outcome": { "home": 0.398, "draw": 0.277, "away": 0.326, "pick": "home" },
        "confidence": "low", "actual": "draw",
        "hit_1x2": false, "hit_over_2_5": false, "hit_btts": false, "brier": 0.787
      },
      "links": {
        "match_page": "/match/401878764-sunderland-vs-leeds-united",
        "share": "https://footalytics.farvor.com/p/vny7wa2tabh4"
      }
    }
  ]
}

Crédits et limites

L'API a sa propre allocation gratuite : 5 appels sur n'importe quel endpoint — predictions, fixtures, teams, results — accordés une fois par compte. Ensuite, les crédits (les mêmes crédits achetés que ceux utilisés dans le chat du site) facturent chaque appel réussi ; les recherches échouées ne coûtent rien. Les crédits gratuits de prédiction du site sont distincts et ne fonctionnent que dans le chat du site. Chaque réponse inclut x-credits-remaining et x-credits-used pour que les appelants puissent suivre le solde.

Limite de débit : 30 appels par minute par clé. Quand le solde est épuisé, l'API répond 402 en pointant vers la recharge :

{
  "error": {
    "code": "E_INSUFFICIENT_CREDITS",
    "message": "You've used all 5 free API calls and your credits.",
    "get_more": [ { "method": "purchase", "url": "https://footalytics.farvor.com/pricing" } ]
  }
}

Plans & API access by tier

The four prediction endpoints above work on every plan. Subscription tiers widen what the API returns — the same entitlements as in site chat, enforced per call. A call your plan does not cover answers 403 E_UPGRADE_REQUIRED with upgrade_to (the tier that unlocks it), unlocks (one line on what that tier adds) and pricing_url, so clients can route users straight to the right plan.

PlanAPI accessRate limit
FreePredictions for the free leagues (top-5 leagues, Champions League, Europa League and all national-team competitions), fixtures, teams and results.10/min
StandardEvery league, plus full per-match depth data (score matrix, all O/U & BTTS lines, factor breakdown), predicted lineups and player goal probabilities.60/min
ProEverything in Standard, plus hot-match deep analysis, saved filters, high-confidence alerts and ledger CSV export.120/min
UltraEverything in Pro, plus the batch predictions endpoint (POST /api/v1/predictions/batch, up to 20 matches per call), full ledger + own-history export and high-confidence strategy tracking.300/min

See plans & pricing →

Erreurs

HTTPcodeSignification
401E_INVALID_API_KEYClé inconnue ou révoquée.
402E_INSUFFICIENT_CREDITSAllocation gratuite et crédits épuisés — voir get_more.
403E_KEY_SCOPELes clés ne fonctionnent que sur les quatre endpoints de l'API.
403E_UPGRADE_REQUIREDYour plan does not cover this league or feature. The body carries upgrade_to, unlocks and pricing_url — see Plans & API access.
404E_PREDICTION_UNAVAILABLEAucune prédiction officielle pour ce match (voir la couverture ci-dessus).
404E_TEAM_NOT_FOUNDAucune équipe notée ne correspond à la requête.
404E_RESULT_NOT_FOUNDAucun résultat finalisé ne correspond encore — les prédictions officielles sont évaluées après le coup de sifflet final.
422E_AMBIGUOUS_MATCHLes noms d'équipes correspondent à plusieurs matchs — ajoutez date ou fixture.
429E_RATE_LIMITEDLimite de débit atteint — réessayez après la pause indiquée dans Retry-After.

MCP — connecter des assistants IA

Les assistants IA (Claude, ChatGPT, Cursor, …) peuvent appeler les mêmes prédictions via le Model Context Protocol. Pointez n'importe quel client MCP vers :

https://footalytics.farvor.com/mcp
Connectez-vous avec une clé API comme token bearer, ou via une autorisation OAuth en un clic — le client s'enregistre lui-même et demande le consentement dans le navigateur. Outils : get_match_prediction, list_fixtures, get_team, list_results (tous partagent la même allocation) et get_account_credits (gratuit).

Skill — Claude Code et agents

Vous préférez un fichier à un connecteur ? Installez la skill compatible Agent-Skills et votre agent appellera lui-même les mêmes quatre endpoints — même clé, même allocation. Téléchargez-la directement chez nous (GitHub non requis) :

mkdir -p ~/.claude/skills/footalytics && cd ~/.claude/skills/footalytics
for f in SKILL.md README.md README.zh-CN.md; do
  curl -fsSL "https://footalytics.farvor.com/skill/$f" -o "$f"
done
…ou un seul fichier si votre agent n'a besoin que du contrat :
curl -fsSL https://footalytics.farvor.com/skill/SKILL.md -o SKILL.md
Téléchargement en un clic (zip, mêmes fichiers) :footalytics-skill.zip

Laissez votre IA l'installer

Copiez ce prompt et envoyez-le à votre assistant IA — il installera la skill pour vous :

Install the "Footalytics" skill for me.

1. Download these three files from https://footalytics.farvor.com/skill/ and save them in
   ~/.claude/skills/footalytics/ (create the folder if needed):
   - SKILL.md
   - README.md
   - README.zh-CN.md
   Use curl or any fetch tool, e.g.:
   curl -fsSL https://footalytics.farvor.com/skill/SKILL.md -o SKILL.md
2. Read the installed SKILL.md and follow its Setup section: check whether the
   FOOTALYTICS_API_KEY environment variable is set. If it is not, ask me to create
   a free key at https://footalytics.farvor.com/api-keys and help me set it
   (e.g. export FOOTALYTICS_API_KEY="fxk_...").
3. When done, confirm what you installed and ask me for a football match to
   predict as a test. Do NOT invent match probabilities yourself - always use
   the Footalytics API per the skill.

Le prompt demande à votre assistant de récupérer la skill depuis l'hôte de cette page, de la placer dans le bon dossier et de vous demander la clé API. Rien d'autre n'est exécuté.

Attribution

Quand vous partagez ou affichez des résultats, conservez “Predictions by Footalytics” avec un lien vers le site. Les prédictions sont des probabilités statistiques, pas des certitudes.