Live & Schedule Endpoints (7)
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/live | Curated live games (with teams, scores, quarter info) |
| GET | /api/live/all | Raw live data |
| GET | /api/today | Today’s scheduled games |
| GET | /api/schedule/:date | Schedule by date (YYYY-MM-DD) |
| GET | /api/live-tournaments | Leagues with live games now |
| GET | /api/scheduled-tournaments/:date | Leagues with games on a date |
| GET | /api/newly-added-events | Recently added games |
NFL runs September–February. During the off-season (March–August), live and today endpoints return 0 events.
Response Example — /api/live
{
"events": [
{
"id": 12345678,
"homeTeam": { "id": 4388, "name": "Kansas City Chiefs" },
"awayTeam": { "id": 4389, "name": "Philadelphia Eagles" },
"homeScore": {
"current": 24,
"display": 24,
"period1": 7,
"period2": 10,
"period3": 7,
"period4": 0
},
"awayScore": {
"current": 17,
"display": 17,
"period1": 3,
"period2": 7,
"period3": 0,
"period4": 7
},
"status": { "code": 14, "description": "4th Quarter", "type": "inprogress" },
"tournament": { "name": "NFL", "id": 9464 },
"season": { "id": 58032 },
"startTimestamp": 1737331200
}
]
}
Score Fields
| Field | Description |
|---|---|
period1 – period4 | Points scored in Q1–Q4 |
overtime | Overtime points (if applicable) |
current | Total points so far |
display | Display score (same as current) |
Status Codes
| Code | Description |
|---|---|
| 0 | Not started |
| 11 | 1st Quarter |
| 12 | 2nd Quarter |
| 13 | Halftime |
| 14 | 3rd Quarter |
| 15 | 4th Quarter |
| 31 | Halftime |
| 40 | Overtime |
| 100 | Ended |
| 110 | Ended (after overtime) |
Search & Discovery Endpoints (7)
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/search?q=chiefs | Search teams, players, tournaments |
| GET | /api/countries | Categories (USA, Canada, etc.) |
| GET | /api/countries/all | Extended categories |
| GET | /api/categories/:categoryId/tournaments | Leagues in a category |
| GET | /api/trending-players | Trending players |
| GET | /api/news?lang=en | American football news |
| GET | /api/country/:code/flag | Country flag URL |