Docs
Coverage MatrixDocumentationRelease LogLog In

Cycling Overview

Introduction

The Cycling API provides schedules and results for top competitions. Data is collected via Sportradar operators and is available post-event. Select the Cycling package in our Coverage Matrix for competitions and data offered.

This API uses a descending, stage-based structure. By changing the stage ID, you can retrieve information on a sport, season, discipline, or event.

Additional feeds provide a host of complementary stats, including:

  • Rankings
  • Team and competitor profiles
  • Historical results

🗝️

Authentication is required for all API calls.

Stage Format

The Cycling API uses generic stage implementation. The core of the API is built around the concept of stages. Each stage type (season, discipline, event, stage) will include sub-stages, usable in the same URL path to request information about that particular stage.

The best way to start the navigation with the Cycling API is using the Seasons endpoint. From there one can obtain the stage ID for the season required and use that as a parameter in the Stage Summary endpoint.

Stage TypeInformation IncludedSub-stages
SportInformation about the seasons included.Cycling seasons
SeasonContains the season schedule for men's or women's cycling.Disciplines on the Cycling calendar for that season (eg: UCI World Tour).
DisciplineScheduling information for all events within a given discipline.Events (eg. Tour de France)
EventInformation about a single event, the stages, the competitors, the teams, and the results.Stages within an event (eg. Stage 1, Stage 2, etc.)
StageCompetitors and results of a stage.None

API Map

To best utilize the Cycling API, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need.

The primary feeds require only a human-readable parameter to call the endpoints. Those feeds provide Stage Ids and Competitor Ids which can be used to generate the profile, summary, and schedule feeds.


Endpoint Descriptions

Competitor Merge Mappings - Provides the valid Sportradar Id in cases when two competitors have been merged into one.

Competitor Profile - Returns biographical information for a given competitor.

Rankings - Returns competitor rankings for the current week.

Season Schedule - Returns a list of scheduled races for a given season.

Seasons – Returns a list of available seasons.

Sport Event Summary - Returns competitor, team, and results information for a given sport event.
Team Profile - Returns information for a team.


Data Retrieval Sample

To find the results for a given race:

  1. Call the Seasons resource for a list of seasons, making note of the Stage Id for your desired season
  2. Call the Season Schedule using the Stage Id and locate your desired race
  3. Call the Sport Event Summary using your race Stage Id

The summary for your race is displayed.


Integration Links

OpenAPI Spec

Our Cycling API is available via OpenAPI. Click below to view and/or download the specs.

Cycling v2 OpenAPI

Postman Workspace

Our entire Media APIs are available on Postman. Click the link above to be taken directly to our Cycling API collection.

Feel free to follow and/or fork any collections to receive updates.

Schema Download

Open the zip file below to access our entire Cycling API XSD schema.

Cycling v2 Schema