Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Winter Sports Overview

Introduction

The Winter Sports API covers the following sports for Men's and Women's competitions:

  • Alpine Skiing
  • Biathlon
  • Cross Country
  • Figure Skating
  • Nordic Combined
  • Ski Jumping
  • Bobsleigh, Luge, Snowboard & Speed Skating (Winter Olympics only)

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 complementary stats, including basic team/competitor profiles and historical results.


🗝️

Authentication is required for all API calls.



API Map

To best utilize the Winter Sports 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 Seasons feed requires only a human-readable parameter to call the endpoint. This feed provides season Stage Ids, which can be used to generate descending Sport Event Summary feeds to include more detailed event info. These feeds can then be used to generate profile feeds.


Endpoint Descriptions

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

Competitor Profile – Provides information regarding a given competitor.

Season Schedule – Provides an event schedule for all events taking place during a given season.

Seasons – Provides a list of all available seasons.

Sport Event Summary (Discipline) – Provides summary details of a given discipline.

Sport Event Summary (Event) – Provides summary details of a given event.

Sport Event Summary (Run) – Provides summary details of a given run.

Sport Event Summary (Season) – Provides summary details of a given season.

Team Profile – Provides information regarding a given team.


Data Retrieval Sample

To find the summary for a given event:

  1. Call the Seasons endpoint and find the Stage Id for the current season
  2. Call the Sport Event Summary (Schedule) using the 'season' Stage Id
  3. Locate the Stage Id for the upcoming event
  4. Call the Sport Event Summary (Event) using the 'event' Stage Id

The summary info for this race is displayed.



Integration Links

Postman Workspace

Our entire Media APIs are available on Postman. Click the link above to be taken directly to our Winter Sports 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 Winter Sports API XSD schema.

Winter Sports v1 Schema