The American Football V2 API provides comprehensive coverage of American football leagues worldwide, including the NFL, NCAA FBS, and CFL.
Base URL
https://v2.american-football.sportsapipro.com
Authentication
Include your API key in the x-api-key header:
curl -H "x-api-key: YOUR_API_KEY" \
https://v2.american-football.sportsapipro.com/api/live
Test IDs
| Entity | Name | ID |
|---|
| Tournament | NFL | 9464 |
| Tournament | NCAA FBS | 9465 |
Use /tournament/9464/seasons to get the latest NFL season ID, which changes each year.
- 4 quarters × 15 minutes — score fields
period1 through period4, plus OT
- Scoring: Touchdown (6pts), Field Goal (3pts), Safety (2pts), PAT (1 or 2pts)
- Positions: QB, RB, WR, TE, OL, DL, LB, DB, K, P
- Key stats: Passing yards, rushing yards, touchdowns, turnovers, sacks
- Odds: Spread, Over/Under, and Moneyline are the primary betting formats
- Off-season note: NFL runs September–February. During the off-season (March–August), live/today endpoints return 0 events. Use search and tournament endpoints for year-round testing.
Endpoint Categories
| Category | Count | Description |
|---|
| Live & Schedule | 7 | Real-time scores, today’s games, scheduling |
| Search & Discovery | 7 | Search, countries, trending players, news |
| Tournament | 27 | League info, standings, stats, brackets |
| Match | 26 | Game details, stats, incidents, odds |
| Team | 15 | Roster, recent/upcoming games, transfers |
| Player | 18 | Career stats, game log, transfers |
| Manager/Referee/Venue | 15 | Coaches, officials, stadiums |
| Total | 115 | |
Example Requests
curl -X GET "https://v2.american-football.sportsapipro.com/api/live" \
-H "x-api-key: YOUR_API_KEY"
UI Design Ideas
- Score display: Show quarter-by-quarter (Q1: 7, Q2: 10, Q3: 3, Q4: 14 = 34)
- Key stats: Passing yards + TDs, rushing yards + TDs, turnovers (INT, fumbles)
- Spread/O-U focus: American football fans care most about point spread and over/under
- Weekly schedule: NFL plays Thursday/Sunday/Monday — use
events/round/{week} for weekly view
- Injury report:
/missing-players is critical — NFL injury reports drive betting lines
- Seasonal: NFL runs Sep-Feb. Off-season (Mar-Aug) will have 0 live games
| Feature | American Football | Football (Soccer) | Basketball |
|---|
| Scoring | 4 quarters (60 min) | 2 halves (90 min) | 4 quarters (48 min) |
| Score range | 14-35 per team typical | 0-5 typical | 80-120 typical |
| Score fields | period1-period4 (quarters) + OT | period1-period2 | period1-period4 |
| Scoring plays | TD (6), FG (3), Safety (2), PAT (1/2) | Goals | FG, FT, 3PT |
| Key stats | Passing yards, rushing yards, TDs, turnovers | Possession, shots | FG%, rebounds |
| Positions | QB, RB, WR, TE, OL, DL, LB, DB, K, P | GK, D, M, F | G, F, C |
| Season | Sep-Feb (17 weeks + playoffs) | Aug-May | Oct-Jun |
| Odds | Spread, Over/Under, Moneyline | 1X2 | ML, spread |
