March 7th, 2014
Drivers participating in the 2014 season onwards now have a permanent driver number. For these drivers there is a new PermanentNumber field in the Driver element. However, the value may sometimes differ from the value of the existing position attribute in the Result and QualifyingResult elements. This will occur in earlier seasons or where the reigning champion has chosen to use “1″ rather than his permanent driver number, as Sebastian Vettel has done this year.
To accommodate this change the schema has been updated to: mrd-1.4.xsd
January 20th, 2014
The 2013 end of season MySQL database dump has been updated to take account of some recent corrections. There is also now an ANSI compatible version, which may be helpful for converting to other SQL formats such as SQLite. Both of these are available here: http://ergast.com/mrd/db
December 7th, 2013
Now the season has ended, we’ve taken the opportunity to move the site onto a VPS which we’ve been preparing throughout the autumn. As far as we can tell, the transition has happened smoothly but if you spot any problems please let us know. The move has been motivated by a growth in traffic which occasionally caused problems in the previous shared hosting service. The new VPS should provide more headroom and maintain responsiveness, which is important for your sites and apps. However, to achieve the best results, it’s important to cache queries at your server and in your clients.
November 25th, 2013
A new database image is available covering all seasons up to and including 2013: http://ergast.com/mrd/db
September 22nd, 2013
I’m usually very reluctant to make any mid-season changes to the API but recent events have required a change to keep the API running. There was an increasing number of very large queries (some attempting to download all results since 1950!) which have put a heavy load on the server, in terms of memory and processor time. Since the API currently uses shared hosting this has caused problems for other websites and I was asked to take action to avoid the API being suspended.
The on-going change is a new maximum value of 1000 for the ‘limit’ query parameter. This will let you download a full season of results or a full list of all drivers, constructors, circuits etc. However, please use the smallest value that your applications requires, preferably only requesting the information you need to present in the current view. Please also implement caching as much as possible, either (or both) on your server and in your applications. This will improve the performance of your applications and for other API users. If you require large amounts of historical data please consider downloading the database image rather than polling the API.
Meanwhile, the Ergast site will be moving to a Virtual Private Server to improve performance and reduce the impact of heavy traffic on other websites.
February 26th, 2013
Pressure of work and the disappointing absence of any reliable source of tyre data means that there are few changes to the API for the 2013 season.
The only new feature is the introduction of the official three letter codes for each driver. Wherever the Driver element appears (i.e. in the Driver, Race and Standings tables) there is a new “code” attribute for all drivers from the 2005 season onwards.
The only significant change to the API is that the Result element now has both a “position” attribute (which is always an integer) and a “positionText” attribute (which is an integer when the driver is classified or a letter to signal their finishing status).
Looking forward to the first race of the season, and checking-in the first set of results to the API database!
December 7th, 2012
This post is to confirm that the Ergast API will continue to provide F1 results throughout the 2013 season and beyond. There have been a number of requests for enhancements:
- three letter codes for drivers
- driver photos
- drivers and teams listed before the first race
- explicit position / unclassified status
- tyre data (dependent on finding a data source)
If you have any other suggestions please let me know although I can’t promise to implement all of them.
Looking forward to seeing your new apps for the 2013 season!
November 28th, 2012
A new database image is available covering all seasons up to and including 2012: http://ergast.com/mrd/db
April 24th, 2012
Ergast is pleased to announce the publication of a complete image of the Ergast database. This is made available under the Attribution-NonCommercial-ShareAlike 3.0 Unported Licence and will be updated at the end of each season. The image allows you to create an exact copy of the MySQL database for your own purposes. Let us know what you do with it.
March 3rd, 2012
Ergast is pleased to announce that Lap Time and Pit Stop data will be available throughout the 2012 season on an experimental basis – this means the data may not be available as quickly as race results and will not be subject to the same degree of manual checking due to the volume of information. See the new Lap Times and Pit Stops documentation pages for more details. The API also provides a complete set of this data for the 2011 season. Feedback on the new API methods and data validity would be very much appreciated.
August 4th, 2011
Following a number of requests I’ve added JSONP as an alternative response format. This allows client-side applications to access the API without the restrictions of the same origin policy imposed by browsers.
JSONP is obtained by appending "
.json" to URLs and a query parameter named "
Let me know if you find any problems or build something interesting with it!
February 27th, 2011
One other change this year which has not been documented is the removal of the “dob” attribute from the Driver element in the results and driver standings XML responses. The attribute is unnecessary because there is a DateOfBirth sub-element.
February 18th, 2011
It’s probably worth pointing out that, in addition to appearing in race results, fastest lap rankings can now be used as a parameter in all queries except Standings queries. For example, you can list all the drivers who achieved the fastest lap in a season using the following URL:
Or all races where a particular driver achieved the fastest lap:
Fastest lap timings have now been added from the 2004 season onwards.
February 15th, 2011
The changes for the 2011 season described earlier have been implemented and were introduced this evening. If you spot any problems please let me know. Barring any problems the API will now remain unchanged for the remainder of the year. Happy coding!
February 12th, 2011
This post is to confirm that the Ergast API will continue to provide F1 results throughout the 2011 season. The only technical change will be an updated schema that provides fastest lap times in race results. In addition, whitespace has been removed from JSON responses. These changes will be introduced in the API on 15th February. Initially, fastest lap times will only be available for the 2010 season but will then be introduced progressively for earlier years over the next month or so.
Hope to see some new apps ready for the 2011 season!
January 20th, 2011
Some proposed changes to the API for 2011:
1) The race results response will be extended to include the fastest laps times for all drivers. The provisional documentation is here: http://ergast.com/mrd/results
2) The indentation and whitespace will be removed from JSON responses for efficiency reasons.
I’m about to start implementing these changes so any comments or suggestions you have would be very welcome.
December 22nd, 2009
This post is to confirm that the Ergast API will continue to provide F1 results throughout the 2010 season. The only technical change will be a move to an updated XML schema that allows multiple drivers per car. This will allow the API to cover the 1950s accurately, where car sharing was common. The change will come into effect on 1st January.
March 14th, 2009
Added an Application Gallery to showcase applications using the Ergast Developer API. If you would like to add your application or mashup to the gallery please contact us with details.
February 11th, 2009
Added a Query Page with forms which generate URLs and query the database.
February 4th, 2009
Added optional JSON response format. Needs further testing.
February 1st, 2009
First release of the API provides data for the Formula 1 series from the 2000 season onwards. The eventual goal is to add data back to the 1950s.
The first supported response format is XML but JSON is under development.
Not much thought has gone into error conditions and responses so I guess that may need more attention.