Getting Started

Introduction

RaceHooks provides 50+ live F1 feeds, ML model outputs for eligible sessions, and historical data, plus an IndyCar data API. Receive subscribed feed updates as JSON payloads through webhooks or server-sent events. Webhook deliveries are signed and retried on failure. Model and analytics outputs are delivered through feeds on the Custom plan. Next step: the quickstart creates a webhook, verifies deliveries and replays the Canadian Grand Prix demo.

Quickstart →
Create a webhook, verify deliveries, replay the Canadian GP demo
Feed catalog →
All real-time motorsport feeds
Analytics →
14 ML models on supported analytics feeds (Custom)
Fantasy →
Scoring API + open-source scorer (Developer)
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, such as 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 for the feeds you subscribed to. Signed webhook delivery with documented retry behavior.

Key concepts

FeedA specific data stream for a sport. Each feed has a unique ID (e.g. timing.data, race-control.messages), a delivery cadence, and a structured JSON payload schema. Motorsport 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 a current-season F1 session against your registered webhooks. Runs at any speed from 0.1× to 120× (console presets 1×, 5×, 10×, 30×, Instant). 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 →