# Driverdb — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access driver performance data, detailed career statistics, and race results across all major motorsports series. Retrieve championship standings, team information, and head-to-head driver comparisons, and browse comprehensive profiles, race calendars, and circuit details.

**Category:** Sports | **Website:** [driverdb.com/](https://driverdb.com/) | **Docs:** [parse.bot/marketplace/04a4c464-317e-4d0a-a224-83f2173b697a/driverdb-com-api](https://parse.bot/marketplace/04a4c464-317e-4d0a-a224-83f2173b697a/driverdb-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-driverdb-com-api-04a4c464/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_championship_calendar

Retrieve the full race calendar for a specific championship and season. Returns all rounds with track info, dates, round number, and official event name.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Championship slug (e.g., 'formula-1') |
| `year` | string | No | Season year as string (e.g., '2025') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-driverdb-com-api-04a4c464/get_championship_calendar \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>","year":"<string>"}'
```

### get_championship_results

Get race results for a specific championship season. Returns completed rounds with podium positions, pole sitter, and fastest lap information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Championship slug (e.g., 'formula-1') |
| `year` | string | No | Season year as string (e.g., '2025') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-driverdb-com-api-04a4c464/get_championship_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>","year":"<string>"}'
```

### get_championship_standings

Get driver standings for a specific championship and season year. Returns the full classification with positions, points, team name, and driver information. Data is parsed from the championship standings page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Championship slug (e.g., 'formula-1', 'dtm', 'indycar-series') |
| `year` | string | No | Season year as string (e.g., '2025', '2024') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-driverdb-com-api-04a4c464/get_championship_standings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>","year":"<string>"}'
```

### get_driver_career_stats

Retrieve detailed career season-by-season statistics for a driver. Returns every season the driver competed in with championship name, team, year, finishing position, races, wins, poles, podiums, and points.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Driver slug identifier (e.g., 'max-verstappen') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-driverdb-com-api-04a4c464/get_driver_career_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_driver_head_to_head

Compare two drivers head-to-head across all shared championships. Returns both driver profiles with stats, common championships they competed in, and detailed comparison data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug1` | string | Yes | First driver slug (e.g., 'max-verstappen') |
| `slug2` | string | Yes | Second driver slug (e.g., 'lewis-hamilton') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-driverdb-com-api-04a4c464/get_driver_head_to_head \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug1":"<string>","slug2":"<string>"}'
```

### get_driver_profile

Get comprehensive profile data for a specific driver including biographical information, nationality, current championship, and aggregate race statistics such as wins, poles, podiums, and Sharp ELO rating.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Driver slug identifier (e.g., 'max-verstappen', 'lewis-hamilton', 'lando-norris') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-driverdb-com-api-04a4c464/get_driver_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_driver_race_results

Get recent individual race results for a specific driver. Returns a list of recent races with finish position, grid position, team, laps, championship points, and session/event details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Driver slug identifier (e.g., 'max-verstappen') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-driverdb-com-api-04a4c464/get_driver_race_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_driverdb_top100

Retrieve the DriverDB top-rated driver ranking based on Sharp ELO-style ratings. Returns up to 100 drivers sorted by rating descending, with full profile and statistics.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-driverdb-com-api-04a4c464/get_driverdb_top100 \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_homepage_featured

Retrieve the homepage featured content including top-rated drivers, latest news headlines from motorsport sources, and latest race results across all championships.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-driverdb-com-api-04a4c464/get_homepage_featured \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_news_article

Retrieve content for a specific news article page on DriverDB. Returns article data and trending articles. Note: most news items on DriverDB are aggregated from external sources; this endpoint works for articles that have an internal DriverDB page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Article slug from the news page URL path (e.g., 'hill-back-at-williams-f1-30-years-after-leaving') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-driverdb-com-api-04a4c464/get_news_article \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_race_result_detail

Get the results listing page for a specific event. Returns recent race results with event info, championship, track, and winners. The result_id corresponds to an event_id from championship calendar data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `result_id` | string | Yes | Event ID from championship calendar/results data (e.g., '59209') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-driverdb-com-api-04a4c464/get_race_result_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"result_id":"<string>"}'
```

### get_rising_stars

Retrieve a list of top-rated young drivers (age 25 and under) from the DriverDB rankings. Filters active drivers by age to identify rising talent across all championships.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-driverdb-com-api-04a4c464/get_rising_stars \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_team_profile

Get detailed profile for a specific team including current drivers, season stats, team principal, headquarters, and colour scheme. Returns data for the team's most recent season in their primary championship.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Team slug (e.g., 'mclaren', 'red-bull', 'ferrari') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-driverdb-com-api-04a4c464/get_team_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_track_detail

Get detailed information about a specific circuit/track including official name, country, and all track layout configurations with lengths and active periods.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Track slug (e.g., 'albert-park', 'silverstone', 'monza') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-driverdb-com-api-04a4c464/get_track_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### list_championships

List all motorsport championships available in the database. Returns up to 100 championships with name, country, and identifier.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-driverdb-com-api-04a4c464/list_championships \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_news

Retrieve the latest motorsport news article summaries. Returns recent news items from external motorsport publications aggregated by DriverDB, including headline, introduction, source, date, and external link URL.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-driverdb-com-api-04a4c464/list_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_teams

List motorsport teams available in the database. Returns up to 100 teams with name, country, and identifier.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-driverdb-com-api-04a4c464/list_teams \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_tracks

List all race tracks and circuits available in the database. Returns up to 100 tracks with name, country, and layout information.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-driverdb-com-api-04a4c464/list_tracks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_drivers

Search for drivers by name. Returns matching drivers with full profile information and career statistics from the DriverDB API.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to filter driver names (e.g., 'verstappen', 'hamilton', 'norris') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-driverdb-com-api-04a4c464/search_drivers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```