API publique Derbio

Les données publiques du football amateur pour les mairies, ligues, médias locaux et sites de clubs. Lecture seule, gratuite, 120 requêtes par minute.

Démarrer

  1. Crée une clé d'API ci-dessous (compte Derbio requis).
  2. Envoie-la dans l'en-tête Authorization de chaque requête.
  3. Les réponses sont en JSON : { data } ou { error: { code, message } }.
curl -H "Authorization: Bearer ffa_live_…" \
  "/api/v1/clubs?q=montreuil"

Spécification OpenAPI : /api/v1/openapi.json

Les données personnelles restent protégées : pas d'e-mails, pas de joueurs mineurs sans consentement parental, pas de matchs privés.

Points d'accès

  • GET /clubs?q=&lat=&lng=&radiusKm=Rechercher des clubs par nom, ville ou autour d'un point
  • GET /clubs/{slug}Fiche publique : équipes, terrains, bilan, saisons, palmarès, partenaires
  • GET /clubs/{slug}/matches?scope=UPCOMINGCalendrier et résultats publics d'un club
  • GET /matches?lat=&lng=&radiusKm=&finished=trueMatchs à venir (et résultats récents) autour d'un point
  • GET /matches/{id}Détail d'un match : score, événements, résumé automatique, diffusions
  • GET /tournaments?lat=&lng=Tournois à venir
  • GET /tournaments/{slug}Équipes, poules, tableau, matchs et classements
  • GET /rankings?country=FR&format=ELEVENClassement Derbio Rating
  • GET /requests?lat=&lng=Annonces de clubs qui cherchent un adversaire
Connecte-toi pour créer une clé d'API et des webhooks.