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

# American Football V2 API Overview

> Enhanced American Football API with 115 endpoints: NFL, NCAA, CFL and international coverage

# American Football V2 (Enhanced) API

The American Football V2 API provides comprehensive coverage of American football leagues worldwide, including the NFL, NCAA FBS, and CFL.

## Base URL

```
https://api.sportsapipro.com/v2/american-football
```

## Authentication

Include your API key in the `x-api-key` header:

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v2/american-football/live
```

## Test IDs

| Entity     | Name     | ID     |
| ---------- | -------- | ------ |
| Tournament | NFL      | `9464` |
| Tournament | NCAA FBS | `9465` |

<Note>
  Use `/tournament/9464/seasons` to get the latest NFL season ID, which changes each year.
</Note>

## American Football Data Notes

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

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.sportsapipro.com/v2/american-football/live" \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.sportsapipro.com/v2/american-football/live',
    { headers: { 'x-api-key': 'YOUR_API_KEY' } }
  );
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.sportsapipro.com/v2/american-football/live',
      headers={'x-api-key': 'YOUR_API_KEY'}
  )
  data = response.json()
  ```
</CodeGroup>

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

## Sport Comparison — American Football vs Football vs Basketball

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