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

> Esports V2 live scores, schedules, search, and discovery

## Live & Schedule Endpoints (7)

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

```bash theme={null}
GET /api/live                           # Curated live matches
GET /api/live/all                       # Raw live data
GET /api/today                          # Today's scheduled matches
GET /api/schedule/:date                 # Schedule by date (YYYY-MM-DD)
GET /api/live-tournaments               # Tournaments with live matches
GET /api/scheduled-tournaments/:date    # Tournaments with matches on date
GET /api/newly-added-events             # Recently added matches
```

### Response Example — `/api/live`

```json theme={null}
{
  "events": [
    {
      "id": 12345678,
      "homeTeam": { "id": 3601, "name": "Natus Vincere" },
      "awayTeam": { "id": 3602, "name": "FaZe Clan" },
      "homeScore": {
        "current": 1,
        "display": 1,
        "period1": 16,
        "period2": 10,
        "period3": 0
      },
      "awayScore": {
        "current": 1,
        "display": 1,
        "period1": 13,
        "period2": 16,
        "period3": 0
      },
      "status": { "code": 13, "description": "3rd Map", "type": "inprogress" },
      "tournament": { "name": "BLAST Premier", "id": 1580 },
      "startTimestamp": 1737331200
    }
  ]
}
```

### Score Fields

| Field      | Description                                                          |
| ---------- | -------------------------------------------------------------------- |
| `period1`+ | Score per map/game (e.g., CS2: rounds won per map, LoL: game result) |
| `current`  | Maps/games won                                                       |

### Status Codes

| Code | Description    |
| ---- | -------------- |
| 0    | Not started    |
| 11   | Map 1 / Game 1 |
| 12   | Map 2 / Game 2 |
| 13   | Map 3 / Game 3 |
| 14   | Map 4 / Game 4 |
| 15   | Map 5 / Game 5 |
| 31   | Map Break      |
| 100  | Ended          |

<Note>Esports covers CS2, LoL, Dota 2, Valorant, and more. Best-of format varies: Bo1, Bo3 (most common), Bo5 (grand finals). Each "period" represents one map or game.</Note>

## Search & Discovery Endpoints (7)

```bash theme={null}
GET /api/search?q=navi                  # Search teams, players, tournaments
GET /api/countries                      # Game categories (CS2, LoL, Dota 2)
GET /api/countries/all                  # Extended categories
GET /api/categories/:categoryId/tournaments  # Tournaments for a game
GET /api/trending-players               # Trending esports players
GET /api/news?lang=en                   # Esports news
GET /api/country/:code/flag             # Country flag URL
```

### Example: Find Live Matches

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

### Example: Browse CS2 Tournaments

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  "https://v2.esports.sportsapipro.com/api/categories/1572/tournaments"
```