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, déclarez dans votre espace développeur le domaine du site qui exploite les données, puis générez une clé th_live_… rattachée à ce domaine. Gardez-la côté serveur.
Lire « Domaines autorisés »Envoyez votre clé dans l’en-tête Authorization et votre domaine dans l’en-tête X-TrailHorizon-Origin, puis 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
1 domaine autorisé
Usage non commercial
27 champs accessibles
10 000 requêtes par jour
5 domaines autorisés
Usage commercial
41 champs accessibles
Quotas, champs et domaines autorisés sur mesure
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 | — | — |
| Historique des éditions | — | — |
| Webhooks | — | Oui |
| Clés API de production | 2 | 5 |
| Domaines autorisés | 1 | 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, export complet, 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 inclut les webhooks), 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, une taille de page maximale et un nombre de domaines autorisés, 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 (sauf un refus d'origine, qui ne consomme pas de quota), et vos statistiques sont disponibles dans votre espace développeur. Les clés de test, réservées au développement local, ont leur propre quota, séparé de celui de la production.
Chaque appel de l'API doit indiquer le site qui exploite les données dans l'en-tête X-TrailHorizon-Origin. Ce site est l'un des domaines autorisés que vous déclarez dans votre espace développeur : leur nombre dépend de la formule (voir le tableau comparatif) et un domaine couvre ses sous-domaines. Cet en-tête est déclaratif : ce n'est pas une barrière de sécurité mais un engagement de votre part, et une fausse déclaration contrevient aux conditions d'utilisation de l'API. Pour développer en local, utilisez une clé de test (th_test_…) : elle n'accepte que des origines locales (localhost, 127.0.0.1, ::1), ne demande aucun domaine, a son propre quota et ne donne pas accès à l'export.
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 3 novembre 2026.
Oui, avec les formules Pro et Partner : un webhook est envoyé à chaque création, modification ou dépublication d'une course. Vous créez et activez vous-même vos endpoints depuis votre espace développeur (HTTPS, port 443), sans demande à l'équipe, et vous consultez les livraisons au même endroit. Les changements sont envoyés par un traitement planifié toutes les 5 minutes : comptez jusqu'à environ 5 minutes de délai. Les webhooks ne sont pas inclus dans la formule Free.
Contactez-nous en précisant votre activité et votre besoin (champs complémentaires, volumétrie, export, historique des éditions). Nous définissons ensemble un accès sur mesure encadré par un contrat.
Le catalogue compte actuellement 2 324 courses publiées dans 8 pays, avec 6 679 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.