FAQ

Ask additional questions using the comments box.

How do the current, last and next shortcuts behave?

For the purposes of the API, a season is assumed to begin when results become available for the first race of the season. This transition will be seen if the <season> field in URLs is set to "current".

In a similar way, the changeover point for the "last" and "next" round shortcuts occurs when a new set of race results become available. After the last race of a season the URL:

http://ergast.com/current/next/...

will refer to the first race of the following season.

Is there any restriction on how qualifiers can be combined?

A query can include any combination of the following qualifiers unless otherwise stated:

/circuits/<circuitId>
/constructors/<constructorId>
/drivers/<driverId>
/grid/<position>
/results/<position>
/fastest/<rank>
/status/<statusId>

For example:

/drivers/alonso/constructors/renault/results/1

The order of the qualifiers has no effect except that the last one determines the result type.

Season, Driver, Constructor and Standings queries can include the following qualifiers, subject to certain restrictions:

/constructorStandings/<position>
/driverStandings/<position>

The last qualifier in a query determines the type of data returned.

What happens if a round is not specified?

For Standings queries and queries which include a standings qualifier the round value defaults to the last round of each season (i.e. the final standings). Otherwise a query covers all rounds of a season.

What is the purpose of the attributes in the table elements?

All responses contain a table of some kind. The attributes of the table element define the scope of the table and reproduce the criteria specified in the original query. If a specific attribute is omitted the scope concerns all entities of that type e.g. if there is no driverId attribute the scope of the table is all drivers who match the specified criteria.

How soon after a race will data become available?

Usually in 2 – 6 hrs.

209 Responses to “FAQ”

  1. Pierre MASSIOT says:

    Hello, I can’t get the “raceid” column when I call the api. Would you have a solution?

    Good day to you

  2. Parul Pandey says:

    Can an article using data from Ergast API be published on medium publications like Towards Data Science(https://towardsdatascience.com/)

  3. Admin says:

    Hi Pierre,
    You shouldn’t use the raceId outside the database – it’s an internal key and may change. Races are identified using the year and round fields.
    Cheers,
    Chris

  4. Admin says:

    Hi Parul,
    That’s fine. The data has been used in books, journals and magazines in the past. Let me know when you publish something so I can put a link in the Application Gallery.
    Cheers,
    Chris

  5. Juan says:

    Hello!
    Is it possible to check the results of the free practices before 2018?

  6. Admin says:

    Hi Juan,
    Unfortunately not. I’m usually working on practice days and don’t have time to ingest the data.
    Chris

  7. Sylvain says:

    Hello Admin!

    First of all I just wanted to thank you a lot, I’ve been using this API since the beginning of this season for a small website I created for me and my friends and I absolutely love the way it works, but now I’m working on a better version with a lot more data shown and cool data charts so I had a question about the sprint races, for now I see that you just add the points of the sprint races to the race results, that’s nice, but as far as I know, next year will have 6 sprint races, so I was wondering if you will keep the way of adding the points to the race results, or maybe you will add a new endpoint for this?

    In any case, thank you again for your work with this API, when I have finished the improved version of the website I will send it to you for the Application Gallery thing, and also I will donate to this project a fair amount because I feel dirty as I have used this API a lot basically for free when it has been very useful for me haha

    Cheers

  8. Admin says:

    Hi Sylvain,
    As it looks like Sprint Races are here to stay, I should provide a new table next year for the sprint race results (and points). Not sure when I’ll get the work done but I’ll announce it on the news feed. BTW there’s no reason to feel uncomfortable about using the API – it’s intended to be a free resource.
    Cheers,
    Chris

  9. Tommy says:

    Does the API makes use of images that can be used when making a JavaScript application using the JSON data.

Add a Comment: