Cyclocross24 APIcyclocross24.com ↗
Access cyclocross race calendars, full event results, rider profiles, UCI rankings, and series standings from Cyclocross24.com via a structured JSON API.
What is the Cyclocross24 API?
The Cyclocross24 API exposes 6 endpoints covering race calendars, event results, rider profiles, UCI rankings, and series standings from cyclocross24.com. The get_race_results endpoint returns full rider placements, finishing times, and team data for every category in a single event, while get_uci_ranking delivers the current ranked list with points and previous rank, filterable by season and category.
curl -X GET 'https://api.parse.bot/scraper/31aec839-d780-4a89-ab8a-6c1a43896042/get_race_calendar?class=C1&season=2024-2025&country=Belgium&category=ME&hide_cancelled=false' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace cyclocross24-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Cyclocross24 SDK — browse races, rankings, and rider profiles."""
from parse_apis.Cyclocross24_API import Cyclocross24, Category, Series, RaceClass, RiderNotFound
client = Cyclocross24()
# List Belgian C1 races from the 2024-2025 season
for race in client.races.list(season="2024-2025", country="Belgium", class_=RaceClass.C1, limit=5):
print(race.date, race.race, race.class_)
# Search for a rider and drill into their full profile
rider_summary = client.rider_summaries.search(query="Van Aert", limit=1).first()
if rider_summary:
rider = rider_summary.details()
print(rider.name, rider.details.team, rider.details.nationality)
# Get race results for a specific event
event = client.race_events.get(event_id="16718")
for cat in event.categories:
print(cat.category, len(cat.results), "finishers")
# UCI rankings for Women Elite
for entry in client.ranking_entries.list(category=Category.WE, limit=5):
print(entry.rank, entry.rider, entry.points)
# Series standings — Superprestige Men Elite
for standing in client.standings_entries.list(series=Series.SUPERPRESTIGE, category=Category.ME, limit=3):
print(standing.rank, standing.rider, standing.points)
# Typed error handling
try:
client.riders.get(slug="nonexistent-rider-xyz")
except RiderNotFound as exc:
print(f"Rider not found: {exc.slug}")
print("exercised: races.list / rider_summaries.search / details / race_events.get / ranking_entries.list / standings_entries.list / riders.get")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.
| Param | Type | Description |
|---|---|---|
| class | string | Race class filter. |
| season | string | Season string in the format 'YYYY-YYYY' (e.g. '2024-2025'). |
| country | string | Full country name as used on the site (e.g. 'Belgium', 'Netherlands', 'France', 'United States'). |
| category | string | Category code. |
| hide_cancelled | boolean | Whether to hide cancelled races from the results. |
{
"type": "object",
"fields": {
"races": "array of race event objects with date, race name, race_url, class, results winner, results_url, video/web links"
},
"sample": {
"data": {
"races": [
{
"web": "",
"date": "12-10-2024",
"race": "Exact Cross Beringen - Be-Mine Cross",
"class": "C2",
"video": "",
"results": "VAN DER HAAR Lars",
"web_url": "https://exactcross.be/beringen/",
"race_url": "https://cyclocross24.com/race/16718/",
"web_info": "Race Website",
"race_info": "Belgium",
"results_url": "https://cyclocross24.com/race/16718/"
}
]
},
"status": "success"
}
}About the Cyclocross24 API
Race Calendar and Event Results
The get_race_calendar endpoint returns a list of race events filterable by class (C1, C2, CDM, CM, CN, CC), season (formatted as YYYY-YYYY), country (ISO code), and category (ME, WE, MU, WU, MJ). Each event object includes the date, race name, class designation, results winner, and relevant URLs. The event_id embedded in the results_url field can be passed directly to get_race_results, which returns an object with event title and a categories array — each entry containing rider placements, finishing times, and team affiliations for that category.
Rider Search and Profiles
search_riders accepts a name query string and returns matching rider objects with name, slug, and profile URL. The slug from that response feeds into get_rider_profile, which returns a detailed profile including nationality, current team, age, UCI ranking position, and physical stats. These two endpoints together support building rider lookup flows without needing to know slugs in advance.
Rankings and Series Standings
get_uci_ranking returns the full UCI cyclocross ranking list for a given season and category, with each entry showing rank, rider name, team, current points, and previous rank position. get_standings covers the three major cyclocross series — superprestige, uci-world-cup, and x2o-trofee — returning total accumulated points alongside per-round scores for each ranked rider. Both endpoints accept the same season and category parameters for consistent filtering across the API.
The Cyclocross24 API is a managed, monitored endpoint for cyclocross24.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when cyclocross24.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official cyclocross24.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a cyclocross race tracker that aggregates upcoming events by country and class using
get_race_calendar. - Display live series leaderboards for Superprestige or UCI World Cup rounds using
get_standingswith per-round point breakdowns. - Populate rider profile pages with nationality, team, age, and UCI rank via
get_rider_profile. - Compare a rider's UCI ranking position across consecutive seasons using the
previous_rankfield fromget_uci_ranking. - Create alerts for specific event categories (e.g., Women Elite) by filtering
get_race_calendarwith thecategoryparameter. - Retrieve full podium and finisher lists for any race event to power historical results archives using
get_race_results. - Enable athlete search and autocomplete features using
search_riderswith partial name queries.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Cyclocross24.com have an official developer API?+
What does `get_race_results` return, and how do I find the right event ID?+
categories array. Each category entry includes rider placements, finishing times, and team information. The event_id parameter is a numeric string that you can extract from the results_url field returned by get_race_calendar.Which race series are covered by `get_standings`?+
series parameter accepts three values: superprestige, uci-world-cup, and x2o-trofee. Each returns ranked riders with total points and individual round scores for the specified season and category. Other regional or national series are not currently covered. You can fork the API on Parse and revise it to add endpoints for additional series.Does the API include live or in-progress race timing data?+
get_race_results, and ranked standings via get_standings. Live timing or intermediate splits during an ongoing race are not exposed. You can fork the API on Parse and revise it to add a live timing endpoint if that data becomes available on the source.Can I filter the race calendar to exclude cancelled events?+
get_race_calendar endpoint accepts a hide_cancelled boolean parameter. When set to true, cancelled races are omitted from the returned array of event objects.