Getting Started

Introduction

RaceHooks is a motorsport webhook delivery platform. Instead of polling a REST API, you register your endpoint URL, subscribe to the feeds you care about, and RaceHooks pushes structured payloads to your server the moment each event fires during a live session. F1 is live now. IndyCar and NASCAR are coming soon.

Quickstart →
First delivery in 5 minutes
Feed catalog →
All 24 real-time F1 feeds
Analytics →
6 ML models in every payload
API Reference →
Full endpoint reference

How it works

1
Register your endpoint
Give RaceHooks a webhook URL. Any publicly reachable HTTPS endpoint works. For local development, localhost URLs are supported during simulate replays.
2
Subscribe to feeds
Choose which data feeds to receive. Each feed represents a specific data stream — lap times, car telemetry, race control messages, weather, and more. Feed availability varies by sport.
3
Receive live payloads
During every live session, RaceHooks delivers payloads to your endpoint the moment each event fires. No polling, no missed updates.

Key concepts

FeedA specific data stream for a sport. Each feed has a unique ID (e.g. timingdata, cardata), a delivery cadence, and a structured JSON payload schema. F1 feeds are available now.
WebhookA registered endpoint URL paired with one or more feed subscriptions. RaceHooks POSTs to this URL for every matching event.
DeliveryA single POST request from RaceHooks to your webhook endpoint. Every delivery is logged with status code, latency, and response body.
SessionA specific on-track activity — practice, qualifying, or race. Deliveries only occur during active sessions.
SimulateA replay of any historical F1 session against your registered webhooks. Runs at 1×, 5×, or 10× speed. Use this to build and test without waiting for race day.

Base URL

https://api.racehooks.io

All API requests are versioned under /v1. The console frontend proxies API calls through /v1 in development.

Quickstart →