🏎️ F1 Companion API

A high-performance FastAPI middleware that aggregates and serves Formula 1 data — including schedules, standings, driver/constructor stats, live race countdowns with weather, and the latest F1 news.

Built to power the F1 Companion Flutter app.

---

🚀 Features

• 📅 Season Schedule — Full race calendar with all session times
• ⏱️ Next Race Countdown — Live countdown to the next session with real-time track weather
• 🧑‍✈️ Drivers & Constructors — Current 2026 season lineup
• 🏆 Live Standings — WDC (Driver) and WCC (Constructor) championship standings
• 🏟️ Circuits — Info on all 2026 circuits including track layout images
• 📊 Race Results — Results for any race by round and year
• 📈 Deep Driver Stats — Career wins, podiums, poles, points, championships, and full race history
• 🔧 Constructor Stats — All-time win/podium rates for any team
• 📰 F1 News — Latest headlines sourced from Sky Sports F1 RSS feed

---

🛠️ Tech Stack

Layer	Technology
Framework	FastAPI
Server	Uvicorn
F1 Data	Jolpica Ergast API
Weather	Open-Meteo
News	Sky Sports F1 RSS Feed via feedparser

---

📦 Installation

1. Clone the repository

git clone https://github.com/JenilMacwan/f1companion-api.git
cd f1companion-api

2. Create and activate a virtual environment

python -m venv venv
# Windows
venv\Scripts\activate
# macOS/Linux
source venv/bin/activate

3. Install dependencies

pip install -r requirements.txt

---

▶️ Running the API

python main.py

The server starts at http://127.0.0.1:5000. Visit the root endpoint to see all available routes.

---

📡 API Endpoints

Method	Endpoint	Description
GET	/	API index & endpoint list
GET	/schedule	Full 2026 season calendar
GET	/next_race	Countdown, weather & next session info
GET	/drivers	All 2026 drivers
GET	/constructors	All 2026 constructors (teams)
GET	/driver_standings	Live WDC standings
GET	/constructor_standings	Live WCC standings
GET	/circuits	All 2026 circuit details
GET	/race_results/{round}/{year}	Results for a specific race
GET	/driver_stats/{driver_id}	Full career stats for a driver
GET	/constructor_stats/{constructor_id}	All-time stats for a constructor
GET	/news	Latest F1 news (top 10 articles)

Example Requests

GET /race_results/1/2025        → Results for Round 1 of 2025
GET /driver_stats/hamilton      → Lewis Hamilton's career stats
GET /constructor_stats/ferrari  → Ferrari's all-time win/podium rates

---

🌦️ Weather Integration

The /next_race endpoint fetches live weather at the circuit location using the Open-Meteo API, returning the current temperature and condition (e.g., "Clear Sky", "Moderate Rain").

---

📁 Project Structure

f1companion-api/
├── main.py            # All API routes and logic
├── requirements.txt   # Python dependencies
└── assets/
    └── track/         # Track layout images (.webp)

---

📄 Dependencies

fastapi
uvicorn
requests
flag
feedparser

Install all with:

pip install -r requirements.txt

---

📝 License

This project is open-source. Data is sourced from Jolpica Ergast and Open-Meteo — please respect their respective usage policies.