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

> Aussie Rules V2 live scores, schedules, search, and discovery

## Live & Schedule Endpoints (7)

All endpoints use base URL `https://v2.aussie-rules.sportsapipro.com`.

```bash theme={null}
GET /api/live                           # Curated live matches (teams, scores, quarter status)
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": 8401, "name": "Collingwood Magpies" },
      "awayTeam": { "id": 8402, "name": "Richmond Tigers" },
      "homeScore": {
        "current": 78,
        "display": 78,
        "period1": 24,
        "period2": 18,
        "period3": 21,
        "period4": 15
      },
      "awayScore": {
        "current": 63,
        "display": 63,
        "period1": 15,
        "period2": 21,
        "period3": 12,
        "period4": 15
      },
      "status": { "code": 14, "description": "4th Quarter", "type": "inprogress" },
      "tournament": { "name": "AFL", "id": 271 },
      "startTimestamp": 1737331200
    }
  ]
}
```

### Score Fields

| Field                 | Description                        |
| --------------------- | ---------------------------------- |
| `period1` – `period4` | Points scored in Q1–Q4             |
| `overtime`            | Extra time (if applicable)         |
| `current`             | Total points (goals × 6 + behinds) |

<Note>AFL scoring: goal = 6 points, behind = 1 point. Quarter scores show cumulative points. Aussie Rules uses a single Australia category (ID: 87).</Note>

## Search & Discovery Endpoints (7)

```bash theme={null}
GET /api/search?q=collingwood           # Search teams, players, tournaments
GET /api/countries                      # Categories (Australia)
GET /api/countries/all                  # Extended categories
GET /api/categories/:categoryId/tournaments  # Tournaments in category
GET /api/trending-players               # Trending AFL players
GET /api/news?lang=en                   # Aussie rules 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.aussie-rules.sportsapipro.com/api/live
```

### Example: Browse AFL Tournaments

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