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

## Live & Schedule (7)

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

```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               # Leagues with live matches
GET /api/scheduled-tournaments/:date    # Leagues with matches on date
GET /api/newly-added-events             # Recently added matches
```

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

```json theme={null}
{
  "events": [
    {
      "id": 12345678,
      "homeTeam": { "id": 2301, "name": "FC Barcelona" },
      "awayTeam": { "id": 2302, "name": "Sporting CP" },
      "homeScore": {
        "current": 3,
        "display": 3,
        "period1": 2,
        "period2": 1
      },
      "awayScore": {
        "current": 2,
        "display": 2,
        "period1": 1,
        "period2": 1
      },
      "status": { "code": 7, "description": "2nd Half", "type": "inprogress" },
      "tournament": { "name": "UEFA Futsal Champions League", "id": 680 },
      "startTimestamp": 1737331200
    }
  ]
}
```

### Score Fields

| Field       | Description                      |
| ----------- | -------------------------------- |
| `period1`   | 1st half goals (20 min)          |
| `period2`   | 2nd half goals (20 min)          |
| `overtime`  | Extra time goals (if applicable) |
| `penalties` | Penalty shootout result          |
| `current`   | Total goals                      |

<Note>Futsal covers 49 countries/categories with \~181 matches daily, comparable to football and basketball in volume.</Note>

## Search & Discovery (7)

```bash theme={null}
GET /api/search?q=barcelona             # Search teams, players, tournaments
GET /api/countries                      # Categories (countries with futsal leagues)
GET /api/countries/all                  # Extended categories
GET /api/categories/:categoryId/tournaments # Leagues in a country
GET /api/trending-players               # Trending futsal players
GET /api/news?lang=en                   # Futsal news
GET /api/country/:code/flag             # Country flag URL
```