# World Athletics — 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.

> Search for professional athletes and access their competition results, performance records, and complete career history from World Athletics. Track athlete achievements across events, view detailed competition outcomes, and explore career milestones all in one place.

**Category:** Sports | **Website:** [worldathletics.org/](https://worldathletics.org/) | **Docs:** [parse.bot/marketplace/eaafd3d8-d9de-49a0-b800-d27225107e25/worldathletics-org-api](https://parse.bot/marketplace/eaafd3d8-d9de-49a0-b800-d27225107e25/worldathletics-org-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-worldathletics-org-api-eaafd3d8/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_athlete_career

Get major championship results (career history) for an athlete, organized by competition category (Olympic Games, World Championships, Other competitions). Returns all races at major championships throughout the athlete's career.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `athlete_id` | string | Yes | Numeric athlete ID from search_athletes results (e.g. '14208194'). |
| `url_slug` | string | Yes | Athlete URL slug from search_athletes results (e.g. 'jamaica/usain-bolt-14201847'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldathletics-org-api-eaafd3d8/get_athlete_career \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"athlete_id":"<string>","url_slug":"<string>"}'
```

### get_athlete_profile

Get an athlete's full profile including basic biographical data, personal best performances across all disciplines, honours and achievements from major championships (Olympic Games, World Championships, Diamond League, Major Marathons, etc.), and current/best world rankings. Combines identity, career stats, and achievements in a single response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `athlete_id` | string | Yes | Numeric athlete ID from search_athletes results (e.g. '14208194'). |
| `url_slug` | string | Yes | Athlete URL slug from search_athletes results (e.g. 'kenya/eliud-kipchoge-14208194'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldathletics-org-api-eaafd3d8/get_athlete_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"athlete_id":"<string>","url_slug":"<string>"}'
```

### get_athlete_results

Get competition results for an athlete in a specific year, grouped by discipline. Returns all races the athlete competed in during that year with marks, places, venues, and scores. Also returns the list of active years the athlete has results for.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `athlete_id` | string | Yes | Numeric athlete ID from search_athletes results (e.g. '14208194'). |
| `year` | integer | No | Year to retrieve results for (e.g. 2016). When omitted, defaults to the most recent active year. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldathletics-org-api-eaafd3d8/get_athlete_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"athlete_id":"<string>","year":"<integer>"}'
```

### search_athletes

Search for athletes by name. Returns matching athletes with basic profile information including ID, name, disciplines, country, and URL slug. Results include fuzzy matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_code` | string | No | Filter by 3-letter country code (e.g. 'JAM', 'USA', 'GBR'). |
| `discipline_code` | string | No | Filter by discipline code. |
| `gender` | string | No | Filter by gender. The GraphQL API accepts GenderType enum values. |
| `query` | string | Yes | Athlete name or partial name to search for (e.g. 'Bolt', 'Hassan'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldathletics-org-api-eaafd3d8/search_athletes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_code":"<string>","discipline_code":"<string>","gender":"<string>","query":"<string>"}'
```