Base URL
https://v2.cycling.sportsapipro.com
Authentication
All requests require an x-api-key header:
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 |
Example Requests
curl -H "x-api-key: YOUR_API_KEY" \
https://v2.cycling.sportsapipro.com/api/live
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 |
Cycling covers 1 category (International) with stage races running January–October. Grand Tours have 21 stages each; one-day Classics are single events.
