Nos données arrivent enfin chez vous
Vous nous l'avez demandé depuis longtemps : pouvoir récupérer nos données ailleurs que sur le site. C'est fait ! Le programme du jour, les cotes en direct, nos indicateurs Premium et même ChatBZH peuvent désormais arriver directement dans votre tableur, sur votre téléphone ou dans vos propres outils. Et rassurez-vous tout de suite : dans la grande majorité des cas, vous n'aurez pas une seule ligne de code à écrire.
Sommaire
- C'est quoi une API, en une minute et sans jargon
- Pour qui c'est fait, et pour qui ça ne l'est pas
- Ce que vous pouvez en sortir
- Trois façons de démarrer sans écrire une ligne de code
- Et si je ne suis pas à l'aise du tout avec tout ça ?
- Combien ça coûte, et pourquoi ce prix
- Comment on démarre, concrètement
- Ce que l'API ne fera pas pour vous
C'est quoi une API, en une minute et sans jargon
Imaginez le guichet d'une administration. Vous vous présentez, vous montrez votre carte, vous demandez un document précis, on vous le remet. Vous n'entrez pas dans les bureaux, vous ne fouillez pas dans les archives : vous demandez, on vous donne.
Une API, c'est exactement ça, en version informatique. Un guichet où votre ordinateur, votre tableur ou votre téléphone se présente avec une clé personnelle, demande une information précise, et la reçoit immédiatement dans un format que les machines savent lire.
Jusqu'ici, pour récupérer les partants d'une course avec nos indicateurs, vous deviez ouvrir le site, aller sur la bonne page, télécharger le fichier correspondant et l'adapter ensuite. Avec l'API, vous demandez « donne-moi la R1C4 du jour » et tout arrive d'un coup, prêt à être collé, trié, filtré, croisé avec vos propres notes.
Pour qui c'est fait, et pour qui ça ne l'est pas
Important : l'API n'est pas indispensable. Le site fonctionne très bien sans elle, et la grande majorité de nos membres n'en aura jamais besoin. Elle s'adresse à trois profils bien précis.
Ce que vous pouvez en sortir
Tout ce que vous voyez sur le site, à quelques exceptions près, et parfois davantage. Voici les grandes familles, traduites en langage de turfiste.
| Ce que vous demandez | Ce que vous recevez |
|---|---|
| Le programme du jour | Toutes les réunions et toutes les courses, avec l'hippodrome, la discipline, l'heure, le nombre de partants et le drapeau Quinté+ |
| Une course précise | La liste exacte des partants avec le driver, l'entraîneur, la ferrure, la musique, la Cote BZH, le classement ELO, la Note IA, la popularité. Fonctionne aussi sur l'historique |
| Les cotes en direct | La cote actuelle, celle d'il y a cinq minutes, l'évolution, et la fraîcheur de la mesure. Plus le départ approche, plus le rafraîchissement est rapide |
| Les mouvements de cote | Les plus gros écarts sur une fenêtre que vous choisissez, de deux à soixante minutes |
| Les arrivées | L'arrivée officielle en quasi temps réel le jour même, avec les rapports dès qu'ils sont publiés |
| Les indicateurs Premium | Tendances ELO sur 30 et 90 jours, forme récente, écarts, affinité distance et hippodrome, synergie jockey-cheval, incidents |
| Les tops et les value bets | Le classement du jour sur 34 indicateurs au choix, et notre composite maison de value bets |
| Un cheval, un jockey, un entraîneur | L'historique des courses, les statistiques agrégées sur la période de votre choix, les lectures expertes du jour |
| Le carnet du Renifleur | Le résumé rédigé après chaque course et les chevaux qui étaient passés sous son nez à leur dernière sortie. Du contenu écrit, exclusif, que vous ne trouverez nulle part ailleurs |
| ChatBZH | Une question posée depuis votre outil, une réponse complète en retour, exactement comme sur le site |
La liste complète et le détail de chaque point d'accès sont dans la documentation. Plusieurs d'entre eux acceptent aussi une sortie en CSV, directement ouvrable dans Excel ou LibreOffice, avec le point-virgule comme séparateur.
Quand vous demandez une course qui se court aujourd'hui, la colonne Cote est volontairement absente de la fiche : celle stockée en base n'est plus à jour à ce moment-là. Vous utilisez le point d'accès dédié aux cotes, qui interroge la cote en direct. C'est un choix assumé : mieux vaut une absence claire qu'un chiffre périmé qui vous ferait prendre une mauvaise décision.
Trois façons de démarrer sans écrire une ligne de code
C'est le point sur lequel nous avons le plus travaillé. Une API réservée aux développeurs n'aurait aucun intérêt pour la plupart d'entre vous. Nous avons donc préparé trois modèles prêts à l'emploi. Vous les téléchargez, vous collez votre clé, ça fonctionne.
Le pack Excel
C'est le plus simple, et probablement celui qui vous concerne. Un classeur déjà construit, où le programme du jour, le Quinté, les cotes d'une course et les value bets arrivent tout seuls. Vous collez votre clé dans une cellule prévue pour ça, vous cliquez sur Actualiser, et le classeur se remplit. Un onglet de suivi de bankroll est inclus.
Aucune connaissance technique n'est requise. Si vous savez ouvrir un fichier Excel, vous savez utiliser le pack.
Le bot Telegram
Pour ceux qui veulent consulter depuis leur téléphone, sans ouvrir de navigateur. Vous écrivez /course R1C4 dans une conversation Telegram, et les partants arrivent. Les commandes disponibles couvrent la course, les cotes, les tops, les value bets et l'analyse.
Le bot tourne sur votre propre ordinateur et lit l'API avec votre clé. Rien n'est publié sur internet, rien ne transite par un service tiers. Le mode d'emploi détaille l'installation pas à pas.
La collection Postman
Celui-ci est destiné aux plus curieux. Postman est un outil gratuit qui permet d'interroger une API en cliquant, sans écrire de code. Notre collection range tous les points d'accès par thème : vous renseignez votre clé une seule fois, puis vous explorez en cliquant pour voir à quoi ressemblent les réponses.
C'est la meilleure façon de comprendre ce que l'API sait faire avant de construire quoi que ce soit.
Et si je ne suis pas à l'aise du tout avec tout ça ?
C'est une question légitime, et elle mérite une réponse claire.
Si vous ne vous sentez pas du tout à l'aise avec l'API, n'hésitez pas à solliciter une intelligence artificielle de code, comme Claude, Gemini ou ChatGPT. Communiquez-lui simplement notre page de documentation, et elle saura vous aiguiller avec brio vers une utilisation entièrement personnalisée à vos besoins.
Concrètement, vous ouvrez la conversation, vous collez le lien de notre documentation, et vous décrivez ce que vous voulez obtenir avec vos propres mots. Par exemple : « voici la documentation de l'API turf.bzh, j'ai une licence et une clé, je voudrais un petit programme qui m'envoie un message quand la cote d'un cheval baisse de plus de 30 % dans les vingt minutes avant le départ ». L'assistant vous écrira le code, vous expliquera où le coller et comment le lancer.
La documentation complète se trouve à l'adresse https://www.turf.bzh/api-docs.php. Il existe aussi une version destinée aux machines, la spécification OpenAPI, à l'adresse https://www.turf.bzh/api/openapi.json. Les assistants de code la comprennent parfaitement et savent en tirer un programme fonctionnel.
Deux conseils. Ne communiquez jamais votre clé personnelle dans une conversation avec un assistant : demandez-lui de prévoir un emplacement où vous la collerez vous-même ensuite. Et relisez ce qu'il vous propose avant de le lancer, comme vous relirez n'importe quel conseil.
Cette approche fonctionne remarquablement bien, et elle change tout pour ceux qui avaient une idée précise en tête sans savoir par quel bout la prendre. La documentation a d'ailleurs été écrite en pensant à ce cas de figure : elle est structurée, complète, et donne des exemples dans plusieurs langages.
Combien ça coûte, et pourquoi ce prix
La Licence API coûte 19,90 euros, une seule fois, à vie. Il n'y a pas d'abonnement supplémentaire, pas de reconduction, pas de palier caché.
Deux conditions à connaître. D'abord, la licence est réservée aux abonnés turf.bzh : elle ne s'active qu'avec un abonnement actif, et fonctionne tant que cet abonnement l'est. Ensuite, elle vous reste acquise définitivement : si votre abonnement s'interrompt puis reprend, vous n'avez rien à racheter, l'accès se rétablit.
| Ce que vous consommez | Comment c'est facturé |
|---|---|
| Toutes les données : programme, partants, cotes, arrivées, indicateurs, historique | Illimité. Une seule limite technique pour protéger le serveur : 60 requêtes par minute et 10 000 par jour, ce qui est très large pour un usage personnel |
| Les questions posées à ChatBZH par l'API | Sur vos crédits IA, exactement comme sur le site. Les mêmes règles s'appliquent, aucun surcoût lié à l'API |
Le raisonnement derrière ce modèle est simple. Servir des données sous cette forme nécessite une infrastructure technique plus complexe et couteuse afin de garantir les meilleures performances en termes d'expérience de navigation et de confort. Concernant ChatBZH, chaque question posée mobilise un modèle de langage qui, lui, a un coût réel : elle est donc décomptée sur vos crédits IA, ni plus ni moins que si vous l'aviez posée sur le site.
Comment on démarre, concrètement
Trois étapes, et vous pouvez faire les deux premières dans les cinq minutes.
- Vous prenez la licence. Un paiement unique, depuis votre compte, en quelques clics.
- Vous générez votre clé. Rendez-vous sur votre espace clé API, vous la copiez. C'est elle qui vous identifie auprès du guichet. Gardez-la pour vous, comme un mot de passe.
- Vous choisissez votre point de départ. Le pack Excel si vous voulez du concret tout de suite, la documentation si vous voulez comprendre, ou un assistant de code si vous avez une idée précise en tête.
Prêt à récupérer nos données chez vous ?
La licence est un paiement unique de 19,90 euros, à vie, réservé aux abonnés actifs. Vous générez votre clé juste après, et vous démarrez avec le modèle de votre choix.
Ce que l'API ne fera pas pour vous
Nous terminons par là, parce que c'est important et que peu de monde le dit.
L'API vous donne des données, pas des certitudes. Elle vous fera gagner du temps, elle vous permettra de tester vos idées sur des milliers de courses au lieu de trois, elle vous évitera de recopier des chiffres à la main. Elle ne vous dira pas quel cheval va gagner, et aucun de nos indicateurs ne garantit un gain.
Nous publions d'ailleurs les limites de nos propres outils quand nous les mesurons. Vous en trouverez un exemple dans notre bilan des infos Premium, où nous montrons aussi bien les mois positifs que les mois négatifs, et dans la documentation de l'API elle-même, où le carnet du Renifleur est accompagné des chiffres qui disent précisément ce qu'il vaut et ce qu'il ne vaut pas.
Un avantage se construit dans la durée, avec de la méthode et de la discipline sur la mise. Les données sont la matière première ; le reste vous appartient.
