Comment accéder à l'API FFBB en Python ?

Il suffit d'installer la bibliothèque officielle avec `pip install ffbb-data-client`. Le client gère automatiquement la résolution des accès et permet d'effectuer des recherches de clubs, de consulter les classements de poules et de suivre les scores en direct.

Quelle est la différence entre ffbb-data-client et l'ancien ffbb-api-client ?

ffbb-data-client est la réécriture moderne 2026 : elle supporte async/await, utilise des modèles Pydantic v2 validés, offre un cache HTTP SQLite performant (Hishel), gère les scores en direct (Lives) et intègre la recherche multi-index Meilisearch sur les 4 500+ clubs de France.

Quelles données de la FFBB sont disponibles via cette API ?

Vous avez accès à l'ensemble des données publiques de la Fédération : fiches détaillées des clubs, compositions de poules, calendriers de toutes les divisions (Départemental, Régional, National), classements officiels actualisés, coordonnées des gymnases, terrains 3x3 et scores en direct du week-end.

Comment interroger l'API FFBB avec un assistant IA (Claude, Cursor, Copilot) ?

Grâce au FFBB MCP Server connecté à ce SDK (accessible sur https://ffbb.desimone.fr/mcp), vous pouvez poser vos questions en langage naturel pour obtenir le bilan de votre équipe, le prochain match ou les scores live.

🏀 API FFBB & OPEN DATA SCORES EN DIRECT ⚡ ASYNC & TYPÉ

L'API FFBB moderne & Open Data du Basket Français.

Résultats, calendriers des matchs, classements complets, fiches de clubs et scores live : explorez et intégrez facilement l'API officielle de la FFBB dans vos sites, applications ou assistants IA avec le SDK Python de référence.

📦 Intégrer l'API Python 🤖 Poser des questions à l'IA

4 500+ Clubs Référencés

Toutes Poules Du Dépt à l'Élite

Live & 3x3 Salles & Matchs

🏀 NATIONALE MASCULINE 1 — POULE B 4e QUART-TEMPS

Pau Nord Est 78

Stade Montois 74

⏱️ Actualisation des scores et temps forts en direct sur toutes les rencontres officielles de l'API FFBB.

Élan Béarnais Pau-Lacq-Orthez

Club affilié FFBB • 64000 Pau

3e au Classement

14 Victoires

4 Défaites

32 Points

📅 Prochain match : Samedi 20h00 vs Tours Basket Métropole (Palais des Sports).

Gymnase Jean Bouin

2 Terrains parquet • 1 Terrain 3x3 extérieur

📍 1.2 km

🔍 Géolocalisation instantanée des salles de match et spots de basket autour de vous via l'API Meilisearch.

CAS D'USAGE API

Que pouvez-vous construire avec l'API FFBB ?

Que vous soyez un club amateur, un comité départemental, un entraîneur, un créateur de bot ou un développeur, exploitez les données officielles sans complexité.

🏟️

Sites Web de Clubs & Comités

Alimentez automatiquement votre site WordPress, React ou Next.js avec les classements à jour de chaque équipe, les calendriers du week-end et les derniers résultats sans saisie manuelle.

🤖

Bots Discord & Alertes Matchs

Créez des bots interactifs pour vos supporters : notification de début de rencontre, alertes scores en direct à la mi-temps et récapitulatif des feuilles de match dès publication.

📊

Statistiques & Analyse Sportive

Analysez les dynamiques d'équipes adverses, les séries de victoires/défaites domicile/extérieur, les écarts de points et l'historique des confrontations sur plusieurs saisons.

📍

Guide des Gymnases & Terrains 3x3

Trouvez rapidement l'adresse d'une salle pour les déplacements du week-end, les terrains extérieurs homologués FFBB et les tournois 3x3 organisés à proximité.

📱

Applications Mobiles & Widgets

Construisez des applications de suivi pour les parents, des widgets iOS / Android ou des écrans d'affichage dynamique pour le club-house de votre association sportive.

💬

Assistants Vocaux & IA Générative

Interrogez les résultats et classements en parlant naturellement grâce au connecteur FFBB MCP Server officiel pour Claude, Cursor, ChatGPT et GitHub Copilot.

DONNÉES OFFICIELLES

Une couverture intégrale de l'API FFBB

Toutes les divisions, championnats et catégories sont accessibles en temps réel avec des modèles Pydantic v2 validés.

🏆 Compétitions & Poules

Départemental, Régional, Championnats Nationaux (NM1, NF1, Espoirs, Pro B, etc.), Coupes de France et tournois.

📅 Calendriers & Résultats

Dates des matchs, horaires, scores finaux, feuilles de match officielles, arbitres désignés et bilans par phase.

🏀 Clubs & Organismes

Fiches des 4 500+ clubs de France, coordonnées, couleurs, liste des équipes engagées par catégorie d'âge.

🔴 Matchs & Scores Live

Scores en direct actualisés en continu pour les rencontres du week-end sur tous les parquets français.

COMPARATIF & MIGRATION

Pourquoi choisir ffbb-data-client ?

Le SDK moderne conçu pour remplacer définitivement les anciens packages non maintenus (ffbb-api-client, ffbb-api-client-v2).

Fonctionnalité	ffbb-data-client (Recommandé)	Anciens wrappers (v1, v2)
⚡ Support Asynchrone (async/await)	✅ Oui (httpx & asyncio natif)	❌ Non (synchrone bloquant)
🛡️ Modèles Typés & Validation	✅ Pydantic v2 complet	❌ Dictionnaires bruts non typés
🔴 Scores en Direct (Lives du week-end)	✅ Oui (Endpoint get_lives)	❌ Non disponible
🔍 Recherche Meilisearch Multi-Index	✅ 9 index officiels instantanés	❌ Scraping ou recherche lente
💾 Cache HTTP Intelligent	✅ Hishel SQLite configurable	❌ Aucun cache ou basique
🤖 Connecteur IA / MCP Server	✅ Compatible MCP natif	❌ Incompatible

ASSISTANT IA

Posez vos questions sur le basket en langage naturel

Grâce au Serveur FFBB MCP propulsé par ffbb-data-client, vos assistants IA (Claude, GitHub Copilot, Cursor, ChatGPT) comprennent directement vos questions sur le basket français.

🌐 Découvrir le Serveur MCP ⭐ Voir le projet MCP

👤 « Quel est le prochain match de l'équipe 1 de mon club et leur classement actuel ? »

🏀 Réponse instantanée : Votre équipe est actuellement 2e de la poule avec 12 victoires. Leur prochain match aura lieu ce samedi à 20h30 à domicile contre le BC Layrac !

ESPACE DÉVELOPPEURS

Intégrez l'API FFBB en quelques secondes

Une bibliothèque Python moderne, légère et intuitive pour construire vos projets basketball.

# Installation du SDK API FFBB officiel (Python 3.10+)
$ pip install ffbb-data-client

from ffbb_data_client import FFBBDataClient

client = FFBBDataClient.create()

# Recherche instantanée de clubs, compétitions et salles FFBB
resultats = client.multi_search("Clermont")

from ffbb_data_client import FFBBDataClient

client = FFBBDataClient.create()

# Récupérer la fiche club et le classement officiel
club = client.get_organisme(id="12345")
classement = client.get_classement(id_poule="98765")

from ffbb_data_client import FFBBDataClient

client = FFBBDataClient.create()

# Scores en direct des rencontres en cours (Lives)
matchs_en_direct = client.get_lives()

import asyncio
from ffbb_data_client import FFBBDataClient

async def main():
    client = FFBBDataClient.create()
    lives = await client.get_lives_async()
    print(lives)

asyncio.run(main())

FAQ API FFBB

Questions fréquentes sur l'API FFBB

Tout ce que vous devez savoir pour démarrer et utiliser les données officielles de la Fédération.

Comment utiliser l'API FFBB en Python ? +

Il vous suffit d'installer le paquet via pip install ffbb-data-client. Vous pouvez alors instancier le client avec FFBBDataClient.create() sans aucune clé d'API requise pour interroger clubs, poules, classements et scores live.

Quelle différence avec ffbb-api-client ou ffbb-api-client-v2 ? +

Les anciennes bibliothèques ne sont plus maintenues et utilisent d'anciennes structures bloquantes. ffbb-data-client est la solution de référence 2026 : asynchrone, modèles Pydantic v2 validés, support des scores en direct et intégration avec les agents IA via MCP.

Puis-je l'utiliser pour le site internet de mon club ? +

Oui, absolument ! C'est l'un des usages principaux : alimenter les pages résultats, classements et calendriers de votre club ou de votre comité en temps réel sans aucune saisie manuelle.

Comment poser des questions en langage naturel via l'IA ? +

Grâce au FFBB MCP Server (endpoint https://ffbb.desimone.fr/mcp), vous pouvez connecter directement votre assistant IA (Claude, Copilot, Cursor) pour obtenir des réponses immédiates sur n'importe quelle équipe ou compétition.