> ## 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.

# Live, Schedule & Search Endpoints

> 14 endpoints for live cycling stages, schedules, and search

## Live & Schedule (7)

All endpoints use base URL `https://v2.cycling.sportsapipro.com`.

```bash theme={null}
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`

```json theme={null}
{
  "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
    }
  ]
}
```

<Note>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.</Note>

## Search & Discovery (7)

```bash theme={null}
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
```