Search with a q parameter for a driver or a list of drivers. Based on his name or surname.
{
"api": "https://f1api.dev",
"url": "https://f1api.dev/api/drivers/search?q=verstappen",
"query": "verstappen",
"limit": 30,
"offset": 0,
"total": 2,
"drivers": [
{
"driverId": "max_verstappen",
"name": "Max",
"surname": "Verstappen",
"nationality": "Netherlands",
"birthday": "30/09/1997",
"number": 33,
"shortName": "VER",
"url": "https://en.wikipedia.org/wiki/Max_Verstappen"
},
{
"driverId": "verstappen",
"name": "Jos",
"surname": "Verstappen",
"nationality": "Dutch",
"birthday": "1972-03-04",
"number": null,
"shortName": null,
"url": "http://en.wikipedia.org/wiki/Jos_Verstappen"
}
]
}| Field | Type | Description |
|---|---|---|
| api | string | The base API URL for the F1 Connect service. |
| url | string | The URL used to fetch the drivers data with query parameters for limit and offset. |
| limit | number | The number of results returned per request. |
| offset | number | The offset used for pagination, i.e., the starting point for the result set. |
| total | number | The total number of drivers available in the dataset. |
| drivers | array | A list of driver objects returned from the API. |
| driverId | string | A unique identifier for the driver. |
| name | string | The driver's first name. |
| surname | string | The driver's surname. |
| nationality | string | The driver's nationality. |
| birthday | string | The driver's birthdate in DD/MM/YYYY format. |
| number | number | The driver's racing number. |
| shortName | string | The driver's abbreviated name, often used in standings or graphics. |
| url | string | A URL to the Wikipedia page of the driver. |
| Param | Default | Data |
|---|---|---|
| limit | 30 | Number of records returned per request. |
| offset | 0 | Number of records skipped before starting to fetch. |
| q | Search query, can be a driver name or surname. |
| Status | Description |
|---|---|
| 200 | Successful request |
| 404 | Resource not found |
| 500 | Internal server error |