Chiffres calculés sur le catalogue en ligne, actualisés toutes les heures.
Construire un produit sur des données de courses demande de la fiabilité et de la clarté. Voici ce que vous trouvez dans l'API.
Proposez à vos athlètes des objectifs de saison avec distances, dénivelés et dates fiables.
Alimentez un calendrier ou un comparateur de courses avec un catalogue structuré et filtrable.
Illustrez vos articles et sélections de courses avec des informations à jour, sourcées et citées.
Suivez les courses de votre territoire ou de votre discipline et partagez-les avec vos licenciés.
Chronométrage, voyage, hébergement, assurance : enrichissez votre offre avec le calendrier des courses.
Les comptes sont créés par notre équipe. Écrivez-nous en précisant votre projet : la formule Free est gratuite pour un usage non commercial, et vous recevez une invitation par email.
Demander un accèsUne fois l’invitation acceptée, générez une clé th_live_… depuis votre espace développeur et gardez-la côté serveur.
Lire l’introductionEnvoyez votre clé dans l’en-tête Authorization et récupérez vos premières courses en JSON.
Documentation GET /racesLa formule Free est gratuite et réservée à un usage non commercial. La formule Pro ouvre l'usage commercial, plus de champs et davantage de quotas. Les partenaires bénéficient d'un accès sur mesure par contrat.
500 requêtes par jour
Usage non commercial
27 champs accessibles
10 000 requêtes par jour
Usage commercial
41 champs accessibles
Quotas et champs adaptés à votre besoin
Webhooks et historique des éditions
Licence par contrat
| Free | ProListe d'attente | |
|---|---|---|
| Licence | Non commerciale | Commerciale |
| Requêtes par jour | 500 | 10 000 |
| Requêtes par minute | 20 | 60 |
| Taille de page maximale | 100 | 100 |
| Export complet | — | 1 par jour |
| Historique des éditions | — | — |
| Webhooks | — | — |
| Clés API | 2 | 5 |
| Membres | 1 | 5 |
| Rétention des logs | 7 jours | 30 jours |
| Statistiques | Consommation du quota | Détaillées |
| Champ | Free | Pro |
|---|---|---|
core.statusStatut : ACTIVE, CANCELLED ou DISCONTINUED. | ||
core.verifiedAtDate de dernière vérification des données. | ||
formats.startAtDate de départ de l'édition affichée (midi UTC si l'heure est inconnue). | ||
formats.hasStartTimeIndique si l'heure de `startAt` est connue. | ||
formats.timezoneFuseau IANA du départ. | ||
formats.durationDurée en minutes (formats à temps fixe). | ||
formats.registrationStatusÉtat des inscriptions : OPEN, FULL, CLOSED, NOT_YET_OPEN. | ||
formats.registrationOpensAtDate d'ouverture des inscriptions. | ||
formats.maxParticipantsNombre maximal de participants. | ||
formats.pricePrix de l'inscription. | ||
formats.currencyDevise ISO 4217 (EUR par défaut). | ||
formats.traceUrlLien vers la trace du parcours. | ||
formats.practicalInfoStructured.requiredGearMatériel obligatoire structuré (sous-ensemble de `practicalInfoStructured`). | ||
rating.averageRatingNote moyenne des coureurs, arrondie à 0,1. |
27 autre(s) champ(s) sont inclus dans toutes les formules. Le détail figure dans le catalogue des champs.
Toute utilisation est soumise aux conditions d'utilisation de l'API : citation « Données : Trail Horizon » avec lien vers la course, pas de revente des données.
La formule Pro n'est pas encore ouverte à la souscription. Inscris-toi pour être prévenu(e) de son ouverture.
Volumétrie dédiée, champs complémentaires, webhooks, historique des éditions : l'accès partenaire est défini ensemble et encadré par un contrat.
La formule Free est gratuite et réservée à un usage non commercial. La formule Pro ouvre l'usage commercial, et les partenaires disposent d'un accès sur mesure par contrat. Dans tous les cas, l'utilisation est encadrée par les conditions d'utilisation de l'API.
Oui. Chaque utilisation des données doit afficher la mention « Données : Trail Horizon » avec un lien vers la page de la course concernée. Les données ne peuvent pas être revendues en l'état. Le détail figure dans les conditions d'utilisation de l'API.
Chaque formule définit un quota journalier, un quota par minute et une taille de page maximale, visibles dans le tableau comparatif de cette page. Chaque réponse contient les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset pour suivre votre consommation, et vos statistiques sont disponibles dans votre espace développeur.
Les champs exposés dépendent de votre formule : la formule Free donne accès aux informations essentielles d'une course, les formules supérieures ajoutent des champs complémentaires. Le catalogue des champs de la documentation indique, pour chaque champ, la formule minimale requise.
Les informations sont rapprochées des sources officielles des organisateurs (sites des courses, plateformes d'inscription, fédérations). Chaque course expose la date de sa dernière vérification dans le champ verifiedAt, et updatedAt indique la dernière modification publiée. La vérification la plus récente date du 25 octobre 2026.
Oui, pour les partenaires : un webhook est envoyé à chaque création, modification ou dépublication d'une course. Les livraisons sont consultables dans votre espace développeur. Les webhooks ne sont pas inclus dans la formule Free.
Contactez-nous en précisant votre activité et votre besoin (champs, volumétrie, webhooks, historique des éditions). Nous définissons ensemble un accès sur mesure encadré par un contrat.
Le catalogue compte actuellement 2 327 courses publiées dans 8 pays, avec 6 685 formats actifs. La couverture est détaillée par pays et région : filtrez avec les paramètres country et region de l'endpoint GET /races.
Les dates sont au format ISO 8601, accompagnées du fuseau horaire de la course et d'un indicateur précisant si l'heure de départ est connue. Les prix sont des nombres associés à un code devise ISO 4217 (par exemple EUR). Les distances sont en kilomètres et les dénivelés en mètres.
Le cadre d'utilisation complet est détaillé dans les conditions d'utilisation de l'API.
Lisez la documentation, choisissez votre formule et lancez votre première requête.