Live & Schedule (7)
All endpoints use base URL https://v2.cycling.sportsapipro.com.
GET /api/live # Curated live stages/races
GET /api/live/all # Raw live data
GET /api/today # Today's stages
GET /api/schedule/:date # Schedule by date (YYYY-MM-DD)
GET /api/live-tournaments # Races with live stages now
GET /api/scheduled-tournaments/:date # Races with stages on date
GET /api/newly-added-events # Recently added stages
Response Example — /api/live
{
"events": [
{
"id": 12345678,
"homeTeam": { "id": 0, "name": "Stage 15" },
"awayTeam": { "id": 0, "name": "" },
"homeScore": {
"current": 0,
"display": 0
},
"status": { "code": 6, "description": "In Progress", "type": "inprogress" },
"tournament": { "name": "Tour de France", "id": 450 },
"season": { "name": "Stage 15: Rodez → Carcassonne" },
"startTimestamp": 1737331200
}
]
}
Cycling stages don’t have traditional home/away scoring. Use /match/:matchId/scores for stage results (finishing times, gaps). Each stage is treated as an individual event. Cycling is organized under a single International category (ID: 1458). The season runs January–October, with the three Grand Tours as the marquee events.
Search & Discovery (7)
GET /api/search?q=pogacar # Search riders, teams, races
GET /api/countries # Categories (International)
GET /api/countries/all # Extended categories
GET /api/categories/:categoryId/tournaments # Races in a category
GET /api/trending-players # Trending riders
GET /api/news?lang=en # Cycling news
GET /api/country/:code/flag # Country flag URL
