# Olympics — 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 Olympic Games results, medal tables, and athlete profiles to track performances across disciplines and events. Search featured athletes, view competition outcomes, and stay updated on medal standings from the official Olympics source.

**Category:** Sports | **Website:** [olympics.com/](https://olympics.com/) | **Docs:** [parse.bot/marketplace/7d5fca40-aeac-47f6-b752-aaa7b472e57d/olympics-com-api](https://parse.bot/marketplace/7d5fca40-aeac-47f6-b752-aaa7b472e57d/olympics-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-olympics-com-api-7d5fca40/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_athlete_profile

Get detailed profile of a specific Olympic athlete including biography, medal counts by type, disciplines, social media links, and full Olympic results history with placements per event.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `athlete_slug` | string | Yes | Athlete slug identifier (e.g. 'usain-bolt', 'simone-biles', 'leon-marchand'). Obtain from search_featured_athletes endpoint. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-olympics-com-api-7d5fca40/get_athlete_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"athlete_slug":"<string>"}'
```

### get_event_results

Get medal winners for all events in a discipline at a specific completed Olympic Games. Returns gold, silver, and bronze medalists with athlete names, countries, and rankings for each event.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `discipline_slug` | string | Yes | Discipline slug (e.g. 'athletics', 'swimming'). Obtain from list_disciplines endpoint. |
| `games_slug` | string | Yes | Olympic Games slug (e.g. 'paris-2024', 'tokyo-2020') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-olympics-com-api-7d5fca40/get_event_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"discipline_slug":"<string>","games_slug":"<string>"}'
```

### get_medal_table

Get the medal standings (country rankings) for a specific completed Olympic Games edition. Returns countries ranked by gold, silver, and bronze medal counts with totals.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `games_slug` | string | Yes | Olympic Games slug (e.g. 'paris-2024', 'tokyo-2020') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-olympics-com-api-7d5fca40/get_medal_table \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"games_slug":"<string>"}'
```

### list_disciplines

List all disciplines (sports) for a specific completed Olympic Games edition. Returns discipline slugs and titles that can be used to fetch events or results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `games_slug` | string | No | Olympic Games slug identifier (e.g. 'paris-2024', 'tokyo-2020', 'beijing-2022'). Must be a completed games edition with medal data. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-olympics-com-api-7d5fca40/list_disciplines \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"games_slug":"<string>"}'
```

### list_events

List all events for a specific discipline in a completed Olympic Games edition. Returns event titles, slugs, and gender categories. Requires both the games slug and discipline slug.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `discipline_slug` | string | Yes | Discipline slug (e.g. 'athletics', 'swimming'). Obtain from list_disciplines endpoint. |
| `games_slug` | string | Yes | Olympic Games slug (e.g. 'paris-2024', 'tokyo-2020') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-olympics-com-api-7d5fca40/list_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"discipline_slug":"<string>","games_slug":"<string>"}'
```

### list_olympic_games

List all Olympic Games editions (Summer, Winter, Youth) with their slug identifiers, years, and seasons. Returns both upcoming and past games. Use the slug to construct a Game and access its disciplines or medal table.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-olympics-com-api-7d5fca40/list_olympic_games \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_featured_athletes

Get the curated list of featured/highlighted Olympic athletes as displayed on the Olympics athletes page. Returns notable athletes with basic info including name, country, discipline, and slug for profile lookup.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-olympics-com-api-7d5fca40/search_featured_athletes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```