# Cyclocross24 — 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.

> Track cyclocross races and riders with access to current race calendars, detailed results, athlete profiles, and UCI rankings all in one place. Search for specific riders, monitor live standings, and stay updated on competitive rankings throughout the season.

**Category:** Sports | **Website:** [cyclocross24.com/](https://cyclocross24.com/) | **Docs:** [parse.bot/marketplace/d8562cc5-0401-471c-8dac-d99d8e381af2/cyclocross24-com-api](https://parse.bot/marketplace/d8562cc5-0401-471c-8dac-d99d8e381af2/cyclocross24-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-cyclocross24-com-api-d8562cc5/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_race_calendar

Retrieve a list of cyclocross race events from the calendar. Supports filtering by category, season, country, and class. Returns all races for the given filters. Season and category are path-based; country and class are query parameters.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category code. |
| `class` | string | No | Race class filter. |
| `country` | string | No | Full country name as used on the site (e.g. 'Belgium', 'Netherlands', 'France', 'United States'). |
| `hide_cancelled` | boolean | No | Whether to hide cancelled races from the results. |
| `season` | string | No | Season string in the format 'YYYY-YYYY' (e.g. '2024-2025'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cyclocross24-com-api-d8562cc5/get_race_calendar \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","class":"<string>","country":"<string>","hide_cancelled":"<boolean>","season":"<string>"}'
```

### get_race_results

Retrieve full race results for a specific race event across all categories. Returns rider placements, times, and team information for each category in the event. The event_id is a numeric ID extracted from race URLs in get_race_calendar.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | Numeric race event ID (e.g. '16718'). Found in the results_url field from get_race_calendar. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cyclocross24-com-api-d8562cc5/get_race_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<string>"}'
```

### get_rider_profile

Retrieve a rider's full profile including personal details, team, UCI ranking, and physical stats. The slug identifier can be found in rider_url fields from search_riders or race results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Rider slug identifier (e.g. 'wout-van-aert'). Found in rider_url fields from search_riders or race results. |

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

### get_standings

Retrieve series standings for cyclocross race series. Returns ranked riders with accumulated points across series rounds. Season, series, and category form the path-based URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category code. |
| `season` | string | No | Season string in the format 'YYYY-YYYY' (e.g. '2024-2025'). |
| `series` | string | No | Series slug. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cyclocross24-com-api-d8562cc5/get_standings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","season":"<string>","series":"<string>"}'
```

### get_uci_ranking

Retrieve the UCI cyclocross ranking list. Returns ranked riders with points, team, and previous rank. Season and category form the path-based URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category code. |
| `season` | string | No | Season string in the format 'YYYY-YYYY' (e.g. '2024-2025'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cyclocross24-com-api-d8562cc5/get_uci_ranking \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","season":"<string>"}'
```

### search_riders

Search for rider profiles by name. Returns matching riders along with popular/featured riders displayed on the search page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Rider name search term (e.g. 'Van Aert'). |

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