Bienvenue

Documentation Paddock API

L'API Paddock vous donne accès aux données des courses hippiques françaises en temps réel — grilles de départ, résultats, cotes et rapports du Quinté+. Conçue pour les développeurs, elle est simple à intégrer et disponible dès aujourd'hui.

Toutes les réponses sont au format JSON. Aucune installation de SDK n'est requise.

Format

JSON / REST

Authentification

API Key

Données

PMU / PMH

Mise à jour

Temps réel

Pour commencer : Inscrivez-vous sur la page tarifs pour obtenir votre clé API. Les comptes Free sont disponibles sans carte bancaire.

Sécurité

Authentification

Chaque requête doit inclure votre clé API via le paramètre de requête api_key. La clé est envoyée en clair dans l'URL — utilisez toujours HTTPS.

Format

GET https://paddock.nanocorp.app/api/v1/{endpoint}?api_key=YOUR_KEY

Exemple avec paramètres

GET /api/v1/races?date=2026-04-15&api_key=pk_live_abc123xyz789

Note : Ne partagez jamais votre clé API dans du code client-side exposé publiquement. Effectuez toujours les appels depuis votre serveur backend.

Abonnements

Plans & limites

Les quotas sont réinitialisés chaque jour à minuit (UTC). Les dépassements de quota retournent une erreur 429.

Plan	Prix	Req / jour	Grilles de départ	Résultats
Free	Gratuit	5	✓	—
Starter+	1,99 € / mois	10	✓	✓
Pro	9,99 € / mois	Illimité	✓	✓

* L'endpoint /results est exclusivement disponible pour les plans Starter et Pro.

Référence

Endpoints

Cliquez sur un endpoint pour afficher les exemples de requête et de réponse.

Paramètres

datestringFormat YYYY-MM-DD. Défaut : aujourd'hui.

idstringIdentifiant de course, ex: 20260415-R1-C4

api_keystringObligatoire. Votre clé API personnelle.

Gestion d'erreurs

Codes d'erreur

Toutes les erreurs retournent un objet JSON avec les champs error et message.

Code HTTP	Statut	Description
401	unauthorized	Clé API absente ou invalide. Vérifiez que ?api_key= est bien présent.
403	forbidden	Plan insuffisant pour cet endpoint. Passez au plan Starter ou Pro.
429	rate_limited	Quota journalier dépassé. Réinitialisé chaque jour à minuit UTC.

Exemple de réponse d'erreur

{
  "error": "rate_limited",
  "message": "Quota journalier dépassé (5 req/jour sur le plan Free).",
  "reset_at": "2026-04-16T00: 00: 00Z"
}

Prêt à construire avec Paddock ?

Obtenez votre clé API en quelques secondes. Gratuit, sans carte bancaire.

Obtenir ma clé API gratuite