Circuit Information
To obtain a list of the circuits used within a series, year or round use the following URLs:
http://ergast.com/api/f1/circuits
http://ergast.com/api/f1/2010/circuits
http://ergast.com/api/f1/2010/2/circuits
Each circuit listed in the response is identified by a unique circuitId which is used to identify the circuit throughout the API. To obtain information about a particular circuit append the circuitId e.g:
http://ergast.com/api/f1/circuits/monza
Circuit lists can be refined by adding one or more of the following criteria:
/constructors/<constructorId>
/drivers/<driverId>
/grid/<position>
/results/<position>
/fastest/<rank>
/status/<statusId>
For example, to list all circuits at which a specific driver has driven for a particular constructor:
http://ergast.com/api/f1/drivers/alonso/constructors/mclaren/circuits
XML Example Response
<?xml version="1.0" encoding="utf-8"?>
<MRData xmlns="http://ergast.com/mrd-1.0" series="f1" limit="30" offset="0" total="17">
<CircuitTable driverId="alonso" constructorId="mclaren">
<Circuit circuitId="albert_park" url="http://en.wikipedia.org/wiki/Melbourne_Gr...">
<CircuitName>Albert Park Grand Prix Circuit</CircuitName>
<Location lat="-37.8497" long="144.968">
<Locality>Melbourne</Locality>
<Country>Australia</Country>
</Location>
</Circuit>
<Circuit circuitId="bahrain" url="http://en.wikipedia.org/wiki/Bahrain_Internat...">
<CircuitName>Bahrain International Circuit</CircuitName>
<Location lat="26.0325" long="50.5106">
<Locality>Sakhir</Locality>
<Country>Bahrain</Country>
</Location>
</Circuit>
<Circuit circuitId="catalunya" url="http://en.wikipedia.org/wiki/Circuit_de_Cat...">
<CircuitName>Circuit de Catalunya</CircuitName>
<Location lat="41.57" long="2.26111">
<Locality>Montmeló</Locality>
<Country>Spain</Country>
</Location>
</Circuit>
.
.
.
</CircuitTable>
</MRData>
JSON Example Response
{
"MRData": {
"xmlns": "http://ergast.com/mrd/1.0",
"series": "f1",
"limit": "30",
"offset": "0",
"total": "17",
"CircuitTable": {
"constructorId": "mclaren",
"driverId": "alonso",
"Circuits": [
{
"circuitId": "albert_park",
"url": "http://en.wikipedia.org/wiki/Melbourne_Grand_Prix_Circuit",
"circuitName": "Albert Park Grand Prix Circuit",
"location": {
"lat": "-37.8497",
"long": "144.968",
"locality": "Melbourne",
"country": "Australia"
}
},
{
"circuitId": "bahrain",
"url": "http://en.wikipedia.org/wiki/Bahrain_International_Circuit",
"circuitName": "Bahrain International Circuit",
"Location": {
"lat": "26.0325",
"long": "50.5106",
"locality": "Sakhir",
"country": "Bahrain"
}
},
{
"circuitId": "catalunya",
"url": "http://en.wikipedia.org/wiki/Circuit_de_Catalunya",
"circuitName": "Circuit de Catalunya",
"Location": {
"lat": "41.57",
"long": "2.26111",
"locality": "Montmeló",
"country": "Spain"
}
},
.
.
.
]
}
}
}