> ## 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 rugby scores, schedules, search, and discovery

## Live & Schedule (7)

### Live Matches (Curated)

```
GET /api/live
```

### Live Matches (Raw)

```
GET /api/live/all
```

### Today's Matches

```
GET /api/today
```

### Schedule by Date

```
GET /api/schedule/:date
```

Date format: `YYYY-MM-DD`

### Live Tournaments

```
GET /api/live-tournaments
```

### Scheduled Tournaments by Date

```
GET /api/scheduled-tournaments/:date
```

### Newly Added Events

```
GET /api/newly-added-events
```

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

```json theme={null}
{
  "events": [
    {
      "id": 12345678,
      "homeTeam": { "id": 6201, "name": "New Zealand" },
      "awayTeam": { "id": 6202, "name": "South Africa" },
      "homeScore": {
        "current": 21,
        "display": 21,
        "period1": 14,
        "period2": 7
      },
      "awayScore": {
        "current": 18,
        "display": 18,
        "period1": 6,
        "period2": 12
      },
      "status": { "code": 7, "description": "2nd Half", "type": "inprogress" },
      "tournament": { "name": "Rugby Championship", "id": 88 },
      "startTimestamp": 1737331200
    }
  ]
}
```

### Score Fields

| Field      | Description                          |
| ---------- | ------------------------------------ |
| `period1`  | 1st half points                      |
| `period2`  | 2nd half points                      |
| `overtime` | Extra time points (knockout matches) |
| `current`  | Total points                         |

<Note>Rugby scoring: try = 5pts, conversion = 2pts, penalty/drop goal = 3pts. Typical scores range 10–40 per team.</Note>

***

## Search & Discovery (7)

### Search

```
GET /api/search?q=crusaders
```

Search teams, players, and tournaments.

### Categories

```
GET /api/countries
```

### Extended Categories

```
GET /api/countries/all
```

### Tournaments in Category

```
GET /api/categories/:categoryId/tournaments
```

### Trending Players

```
GET /api/trending-players
```

### Rugby News

```
GET /api/news?lang=en
```

### Country Flag

```
GET /api/country/:code/flag
```