Intégrez des probabilités football, des marchés essentiels et des données pré-match structurées avec Developer gratuit ou Starter.
Aperçu des données avancées, avec certaines variables réservées à Starter.
Core Analytics complets pour les intégrations qui nécessitent davantage de compétitions, d’historique et de volume.
Comparez Developer et Starter sur la page des offres API, puis utilisez la documentation technique comme référence d’intégration.
Les deux plans utilisent ces routes. Les droits du contrat et le périmètre sélectionné restent autoritaires côté serveur.
| Méthode | Route |
|---|---|
| GET | /v1/leagues |
| GET | /v1/leagues/{league_code}/matches |
| GET | /v1/matches/{match_id} |
| GET | /v1/matches/today |
| GET | /v1/picks/today |
| POST | /v1/matches/bulk |
GET /v1/health · GET /v1/me · GET /v1/me/usage
Les réponses peuvent inclure availability. Une entrée starter_required indique qu’une variable existe dans le contrat Starter mais n’est pas exposée pour Developer. Les réponses de liste restent compactes : elles n’inventent pas les champs réservés au détail analytique. elo_difference n’est présent que dans le payload de détail concerné lorsqu’il est réellement disponible.
Developer donne accès à 7 jours d’historique vérifié et Starter jusqu’à 90 jours. Une requête couvre au maximum 31 jours. history_available_from indique la profondeur réellement publiée. Utilisez include=past ou include=all et suivez next_cursor sans modifier les autres paramètres.
Envoyez la clé uniquement côté serveur avec l’en-tête X-API-Key. Developer accepte jusqu’à 5 matchs par requête groupée ; Starter jusqu’à 100. Un dépassement de quota renvoie 429 avec les informations de limite disponibles. Ne placez jamais une clé dans du JavaScript public.
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.foresportia.com/v1/leagues/FIN/matches?include=all&days=7"2/min · 30/h · 50/day · 5 matchs/requête groupée · 100 rows/day
15/min · 500/h · 3000/day · 100 matchs/requête groupée · 10000 rows/day
Le package foresportia gère l’authentification, les réponses typées, les ETags, les erreurs, la pagination par curseur et availability. Les anciennes clés bêta restent compatibles ; le SDK ne déduit jamais le plan depuis le préfixe d’une clé.
pip install foresportia400/422 pour une requête invalide, 401 pour une clé absente ou invalide, 403 pour un droit ou une compétition non autorisés, 404 pour une ressource inconnue, 409 pour un conflit métier, 429 pour un quota et 5xx pour une indisponibilité temporaire.
Pour générer une intégration, utilisez la documentation technique et ses versions texte destinées aux LLM. Cette page est une synthèse indexable ; les schémas détaillés et exemples de payload restent canoniques dans /api/docs/.
Oui. Developer est un plan gratuit actif, provisionné explicitement après connexion au Compte Foresportia.
Non. Ils partagent les mêmes routes et la même authentification ; les droits, limites et champs disponibles dépendent du plan.
Non dans Developer ou Starter. Les plans standard couvrent les données pré-match et les résultats historiques vérifiés disponibles.
La clé doit rester côté serveur, dans un backend, un script, un bot ou une variable d’environnement privée.