> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportsapipro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cycling V2 API Overview

> Enhanced cycling data: 94 endpoints for Grand Tours, Classics, UCI WorldTeams, and riders

## Base URL

```
https://v2.cycling.sportsapipro.com
```

## Authentication

All requests require an `x-api-key` header:

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  https://v2.cycling.sportsapipro.com/api/live
```

## Sport Overview

The Cycling V2 API covers professional road cycling — the most popular discipline — with live stage results, General Classification (GC) standings, and rider profiles.

**Key Concepts:**

* Each **stage** of a multi-stage race is treated as an individual "event" (match)
* The overall **race** is the "tournament" (Tour de France, Giro d'Italia, etc.)
* **Rounds** = stages (Stage 1 through Stage 21 for Grand Tours)
* **Standings** = General Classification by cumulative time
* Organized under a single **International** category (ID: 1458)

## Season Calendar

The road cycling season runs from **January to October**, with three Grand Tours as marquee events:

| Race                 | Month   | Stages | Leader's Jersey           |
| -------------------- | ------- | ------ | ------------------------- |
| 🇮🇹 Giro d'Italia   | May     | 21     | 🩷 Pink (Maglia Rosa)     |
| 🇫🇷 Tour de France  | July    | 21     | 🟡 Yellow (Maillot Jaune) |
| 🇪🇸 Vuelta a España | Aug–Sep | 21     | 🔴 Red (Maillot Rojo)     |

## Endpoint Categories

| Category           | Endpoints | Description                                           |
| ------------------ | --------- | ----------------------------------------------------- |
| Live & Schedule    | 7         | Live stages, today's schedule, date-based lookups     |
| Search & Discovery | 7         | Search riders/teams/races, categories, trending, news |
| Tournament / Race  | 22        | Race info, GC standings, stages, season stats         |
| Stage / Event      | 22        | Stage results, rider stats, incidents, odds           |
| Team               | 12        | UCI WorldTeam rosters, form, media                    |
| Rider / Player     | 16        | Rider profiles, career stats, palmares                |
| Manager & Venue    | 8         | Directeur sportif data, stage locations               |

**Total: 94 endpoints**

## Example Requests

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    https://v2.cycling.sportsapipro.com/api/live
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://v2.cycling.sportsapipro.com/api/live',
    { headers: { 'x-api-key': 'YOUR_API_KEY' } }
  );
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://v2.cycling.sportsapipro.com/api/live',
      headers={'x-api-key': 'YOUR_API_KEY'}
  )
  data = response.json()
  ```
</CodeGroup>

## Stage Types

| Type                        | Description                                          |
| --------------------------- | ---------------------------------------------------- |
| Flat stage                  | Suited for sprinters (bunch sprint finish)           |
| Hilly stage                 | Punchy terrain with short climbs                     |
| Mountain stage              | Major climbs, GC battles (Alps, Pyrenees, Dolomites) |
| Individual Time Trial (ITT) | Riders race alone against the clock                  |
| Team Time Trial (TTT)       | Teams race together against the clock                |
| Prologue                    | Short opening time trial (usually under 10 km)       |

## Classification Jerseys

| Classification              | Jersey         | Tour de France | Giro d'Italia | Vuelta a España |
| --------------------------- | -------------- | -------------- | ------------- | --------------- |
| General Classification (GC) | Overall leader | 🟡 Yellow      | 🩷 Pink       | 🔴 Red          |
| Points                      | Best sprinter  | 🟢 Green       | 🟣 Cyclamen   | 🟢 Green        |
| Mountain (KOM)              | Best climber   | 🔴⚪ Polka Dot  | 🔵 Blue       | 🔵⚪ Polka Dot   |
| Young Rider                 | Best under 25  | ⚪ White        | ⚪ White       | ⚪ White         |

## Monuments (One-Day Classics)

| Race                 | Month   | Distance                |
| -------------------- | ------- | ----------------------- |
| Milan-San Remo       | March   | \~290 km                |
| Tour of Flanders     | April   | \~260 km                |
| Paris-Roubaix        | April   | \~260 km (cobblestones) |
| Liège-Bastogne-Liège | April   | \~260 km                |
| Il Lombardia         | October | \~240 km                |

## Key Statistics

| Stat          | Description                                  |
| ------------- | -------------------------------------------- |
| Stage time    | Finish time for the stage                    |
| Time gap      | Time behind the stage winner (e.g., "+0:32") |
| GC time       | Cumulative time across all stages            |
| GC gap        | Time behind the overall leader               |
| Stage wins    | Number of stages won                         |
| Points        | Sprint/intermediate points accumulated       |
| KOM points    | Mountain classification points               |
| Average speed | km/h for the stage                           |

## Key Riders & Teams (for testing)

| Rider                | Team                    |
| -------------------- | ----------------------- |
| Tadej Pogačar        | UAE Team Emirates       |
| Jonas Vingegaard     | Visma-Lease a Bike      |
| Remco Evenepoel      | Soudal-QuickStep        |
| Primož Roglič        | Red Bull-BORA-hansgrohe |
| Wout van Aert        | Visma-Lease a Bike      |
| Mathieu van der Poel | Alpecin-Deceuninck      |

## Sport Comparison — Cycling vs Motorsport

| Feature            | Road Cycling                    | Motorsport (F1)        |
| ------------------ | ------------------------------- | ---------------------- |
| Format             | Multi-stage race (1-21 stages)  | Race-by-race season    |
| Duration per event | 2-7 hours per stage             | 1-2 hours per race     |
| Season length      | Jan – Oct (\~250 race days)     | Mar – Dec (\~23 races) |
| Scoring            | Time-based (lowest total wins)  | Points-based           |
| Team size          | 8 riders per team (Grand Tours) | 2 drivers per team     |
| Key stat           | GC time + stage wins            | Points + wins          |
| Jerseys            | Yellow/Pink/Red (leader)        | Team livery            |
| Distance           | 100-250 km per stage            | 250-350 km per race    |

<Note>Cycling covers 1 category (International) with stage races running January–October. Grand Tours have 21 stages each; one-day Classics are single events.</Note>