Formula 1 Data
# Formula 1 Data API - The Ultimate Motorsport Powerhouse Welcome to the **Formula 1 Data API**, the definitive resource for motorsport data, engineered for developers, F1 enthusiasts, and data analysts. This API delivers real-time and historical Formula 1 insights with unparalleled speed and granularity, empowering you to build cutting-edge applications, visualizations, or analytical tools.…
Formula 1 Data endpoints
| Method | Endpoint | Description |
|---|---|---|
| Circuits | ||
| GET |
get_circuit_by_ref_circuits_ref__circuit_ref__get /circuits/ref/{circuit_ref} |
Returns a single circuit record by its circuitRef string. |
| GET |
advanced_circuit_search_circuits__get /circuits/ |
Advanced search for circuits using all available fields. **Filtering:** - `circuitId`: Exact match for the circuit ID. - `circuitRef`: Exact match for the circuit reference… |
| GET |
get_circuit_by_id_circuits_id__circuit_id__get /circuits/id/{circuit_id} |
Returns a single circuit record by its numeric circuitId. |
| Constructor Results | ||
| GET |
advanced_constructor_results_search_constructor_results__get /constructor_results/ |
Advanced search endpoint for constructor results. **Filtering Options:** - `constructorResultsId`: Exact match. - `raceId`: Exact match. - `constructorId`: Exact match. -… |
| GET |
get_constructor_result_by_id_constructor_results_id__constructorResultsId__get /constructor_results/id/{constructorResultsId} |
Retrieves a single constructor result record by its unique constructorResultsId. **Example:** GET `/constructor_results/id/123` returns the constructor result with… |
| Constructor Standings | ||
| GET |
advanced_constructor_standings_search_constructor_standings__get /constructor_standings/ |
Advanced search endpoint for constructor standings. **Filtering Options:** - `constructorStandingsId`: Exact match for the unique ID. - `raceId`: Exact match. - `constructorId`:… |
| GET |
get_constructor_standings_by_id_constructor_standings_id__constructorStandingsId__get /constructor_standings/id/{constructorStandingsId} |
Retrieve a single constructor standings record by its unique constructorStandingsId. **Example:** GET `/constructor_standings/id/123` returns the standings record with… |
| Constructors | ||
| GET |
get_constructor_by_ref_constructors_ref__constructorRef__get /constructors/ref/{constructorRef} |
Retrieve a single constructor record by its constructorRef string. **Example:** GET `/constructors/ref/ferrari` returns the constructor with constructorRef equal to 'ferrari'. |
| GET |
advanced_constructors_search_constructors__get /constructors/ |
Advanced search endpoint for constructors. **Filtering Options:** - `constructorId`: Filter by exact numeric constructorId. - `constructorRef`: Filter by exact constructorRef… |
| GET |
get_constructor_by_id_constructors_id__constructorId__get /constructors/id/{constructorId} |
Retrieve a single constructor record by its numeric constructorId. **Example:** GET `/constructors/id/5` returns the constructor with constructorId equal to 5. |
| Driver Standings | ||
| GET |
get_driver_standings_by_id_driver_standings_id__driverStandingsId__get /driver_standings/id/{driverStandingsId} |
Retrieve a single driver standings record by its unique driverStandingsId. **Example:** GET `/driver_standings/id/123` returns the driver standings record with driverStandingsId… |
| GET |
advanced_driver_standings_search_driver_standings__get /driver_standings/ |
Advanced search endpoint for driver standings. **Filtering Options:** - `driverStandingsId`: Exact match for the unique driverStandingsId. - `raceId`: Exact match for the race… |
| Drivers | ||
| GET |
advanced_drivers_search_drivers__get /drivers/ |
Advanced search endpoint for drivers. **Filtering Options:** - `driverId`: Exact match for the driver ID. - `driverRef`: Exact match for the driver reference string. - `number`:… |
| GET |
get_driver_by_ref_drivers_ref__driverRef__get /drivers/ref/{driverRef} |
Retrieve a single driver record by its driverRef string. **Example:** GET `/drivers/ref/leclerc` returns the driver with driverRef equal to 'leclerc'. |
| GET |
get_driver_by_id_drivers_id__driverId__get /drivers/id/{driverId} |
Retrieve a single driver record by its numeric driverId. **Example:** GET `/drivers/id/5` returns the driver with driverId equal to 5. |
| Lap Times | ||
| GET |
get_lap_time_by_composite_key_lap_times_race__raceId__driver__driverId__lap__lap__get /lap_times/race/{raceId}/driver/{driverId}/lap/{lap} |
Retrieve a single lap time record using the composite key: raceId, driverId, and lap. **Example:** GET `/lap_times/race/5/driver/23/lap/3` returns the lap time record for race 5,… |
| GET |
advanced_lap_times_search_lap_times__get /lap_times/ |
Advanced search endpoint for lap times. **Filtering Options:** - `raceId`: Filters for an exact race identifier. - `driverId`: Filters for an exact driver identifier. - `lap`:… |
| Pit Stops | ||
| GET |
get_pit_stop_by_composite_key_pit_stops_race__raceId__driver__driverId__stop__stop__lap__lap__get /pit_stops/race/{raceId}/driver/{driverId}/stop/{stop}/lap/{lap} |
Retrieve a single pit stop record identified by the composite key: raceId, driverId, stop, and lap. **Example:** GET `/pit_stops/race/10/driver/23/stop/2/lap/15` returns the pit… |
| GET |
advanced_pit_stops_search_pit_stops__get /pit_stops/ |
Advanced search endpoint for pit stops. **Filtering Options:** - `raceId`: Filter by exact race ID. - `driverId`: Filter by exact driver ID. - `stop`: Filter by the exact pit… |
| Qualifying | ||
| GET |
advanced_qualifying_search_qualifying__get /qualifying/ |
Advanced search endpoint for qualifying records. **Filtering Options:** - `qualifyId`: Exact match for the qualifying record ID. - `raceId`: Exact match for the race ID. -… |
| GET |
get_qualifying_by_id_qualifying_id__qualifyId__get /qualifying/id/{qualifyId} |
Retrieve a single qualifying record by its unique qualifyId. **Example:** GET `/qualifying/id/101` returns the qualifying record with qualifyId equal to 101. |
| Races | ||
| GET |
advanced_races_search_races__get /races/ |
Advanced search endpoint for races. **Filtering Options:** - **Exact Filters:** - `raceId`: Filter for a specific race. - `year`: Filter by the race year. - `round`: Filter by… |
| GET |
get_race_by_id_races_id__raceId__get /races/id/{raceId} |
Retrieve a single race record by its unique raceId. **Example:** GET `/races/id/42` returns the race record with raceId equal to 42. |
| Results | ||
| GET |
get_result_by_id_results_id__resultId__get /results/id/{resultId} |
Retrieve a single race result record by its unique resultId. **Example:** GET `/results/id/101` returns the result record with resultId equal to 101. |
| GET |
advanced_results_search_results__get /results/ |
Advanced search endpoint for race results. **Filtering Options:** - **Exact Matches:** - `resultId`, `raceId`, `driverId`, `constructorId`, `grid`, `position`, `positionOrder`,… |
| Seasons | ||
| GET |
advanced_seasons_search_seasons__get /seasons/ |
Advanced search endpoint for seasons. **Filtering Options:** - `year`: Filter by the exact season year. - `url`: Performs a partial, case-insensitive match on the season URL.… |
| GET |
get_season_by_year_seasons__year__get /seasons/{year} |
Retrieve a single season record by its unique year. **Example:** GET `/seasons/2021` returns the season record for the year 2021. |
| Sprint Results | ||
| GET |
get_sprint_result_by_id_sprint_results_id__resultId__get /sprint_results/id/{resultId} |
Retrieve a single sprint result record by its unique resultId. **Example:** GET `/sprint_results/id/101` returns the sprint result record with resultId equal to 101. |
| GET |
advanced_sprint_results_search_sprint_results__get /sprint_results/ |
Advanced search endpoint for sprint results. **Filtering Options:** - **Exact Matches:** `resultId`, `raceId`, `driverId`, `constructorId`, `grid`, `position`, `positionOrder`,… |
| Status | ||
| GET |
get_status_by_id_status_id__statusId__get /status/id/{statusId} |
Retrieve a single status record by its unique statusId. **Example:** GET `/status/id/3` returns the status record with statusId equal to 3. |
| GET |
advanced_status_search_status__get /status/ |
Advanced search endpoint for status records. **Filtering Options:** - `statusId`: Filter by the exact statusId. - `status`: Perform a partial, case-insensitive match on the… |
| Other endpoints | ||
| GET |
read_root__get / |
|
Formula 1 Data pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $5 / month | 50 / minute |
|
| ULTRA | $15 / month | 450 / minute |
|