OpenF1 API

OpenF1 is a free and open-source API that offers real-time and historical Formula 1 data.<br /> Whether you're a developer, data analyst, or F1 enthusiast, OpenF1 provides comprehensive access to lap timings, car telemetry, driver information, race control messages, and more.

Explore the data through JSON or CSV formats to build dashboards, analyze races, or integrate F1 data into your projects.

For full API documentation, visit openf1.org.

Key Features

• Real-Time Data: Stay updated with live lap times, speeds, and driver positioning.
• Historical Data: Analyze past races, compare performance over seasons, and dive deep into race strategy.
• Car Telemetry: Access in-depth car data, including throttle, brake, DRS, and gear information.
• Driver Information: Get details on F1 drivers, including team affiliations and performance metrics.

Example Usage

Here’s a quick example of how to fetch lap data for a specific driver using the API:

curl "https://api.openf1.org/v1/laps?session_key=9161&driver_number=63&lap_number=8"

For more detailed examples and documentation, visit the API Documentation.

Running the project locally

1. Install and start MongoDB Community Server v7 or v8

2. Install pip>=23 and python>=3.10

3. Install the OpenF1 python package

git clone git@github.com:br-g/openf1.git
pip install -e openf1

4. Configure the MongoDB connection

Set the MONGO_CONNECTION_STRING environment variable to connect to your local MongoDB instance:

export MONGO_CONNECTION_STRING="mongodb://localhost:27017"

5. Run the project

• Fetch and ingest scraped data: services/f1_scraping/
• Fetch and ingest live timing data: services/ingestor_livetiming/
• Start and query the API: services/query_api/

Supporting OpenF1

If you find this project useful, consider supporting its long-term sustainability:

<div> <a href="https://www.buymeacoffee.com/openf1" target="_blank" style="text-decoration:none; border:none;"> <img src="https://storage.googleapis.com/openf1-public/images/bmec_button.png" alt="Buy Me A Coffee" height="32" style="border:none; vertical-align:middle;"> </a> &nbsp; <a href="https://github.com/sponsors/br-g" style="text-decoration:none; border:none;"> <img src="https://img.shields.io/badge/Sponsor-%E2%9D%A4-brightgreen" alt="Sponsor me" height="32" style="border:none; vertical-align:middle;"> </a> </div>

Disclaimer

OpenF1 is an unofficial project and is not affiliated with Formula 1 companies. All F1-related trademarks are owned by Formula One Licensing B.V.