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.
Démarrage rapide
- Créez une clé gratuite sur la page des clés API — chaque nouveau compte démarre avec 5 appels API gratuits.
- 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" - 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ètre | Description |
|---|---|
home + away | La 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. |
fixture | La 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. |
date | Facultatif, 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ètre | Description |
|---|---|
team | Sous-chaîne du nom d'équipe, ex. team=Arsenal — correspond à domicile ou extérieur. |
league | Clé ESPN (eng.1) ou slug de ligue (premier-league). |
date | Facultatif, YYYY-MM-DD (UTC). |
limit | Facultatif, 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ètre | Description |
|---|---|
name | Sous-chaîne du nom d'équipe, min. 2 caractères, ex. name=arsenal. |
league | Filtre facultatif, clé ESPN ou slug. |
limit | Facultatif, 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ètre | Description |
|---|---|
team | Filtre par nom d'équipe, ex. team=Chelsea. |
league | Clé ESPN ou slug. |
fixture | Id de match unique. |
limit | Facultatif, 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.
| Plan | API access | Rate limit |
|---|---|---|
| Free | Predictions for the free leagues (top-5 leagues, Champions League, Europa League and all national-team competitions), fixtures, teams and results. | 10/min |
| Standard | Every league, plus full per-match depth data (score matrix, all O/U & BTTS lines, factor breakdown), predicted lineups and player goal probabilities. | 60/min |
| Pro | Everything in Standard, plus hot-match deep analysis, saved filters, high-confidence alerts and ledger CSV export. | 120/min |
| Ultra | Everything 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 |
Erreurs
| HTTP | code | Signification |
|---|---|---|
| 401 | E_INVALID_API_KEY | Clé inconnue ou révoquée. |
| 402 | E_INSUFFICIENT_CREDITS | Allocation gratuite et crédits épuisés — voir get_more. |
| 403 | E_KEY_SCOPE | Les clés ne fonctionnent que sur les quatre endpoints de l'API. |
| 403 | E_UPGRADE_REQUIRED | Your plan does not cover this league or feature. The body carries upgrade_to, unlocks and pricing_url — see Plans & API access. |
| 404 | E_PREDICTION_UNAVAILABLE | Aucune prédiction officielle pour ce match (voir la couverture ci-dessus). |
| 404 | E_TEAM_NOT_FOUND | Aucune équipe notée ne correspond à la requête. |
| 404 | E_RESULT_NOT_FOUND | Aucun résultat finalisé ne correspond encore — les prédictions officielles sont évaluées après le coup de sifflet final. |
| 422 | E_AMBIGUOUS_MATCH | Les noms d'équipes correspondent à plusieurs matchs — ajoutez date ou fixture. |
| 429 | E_RATE_LIMITED | Limite 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.