NFL Stats Lookup

Type a player's name and get their season stats plus a box score from their last game. Or pick a position and see the league leaders in every stat that matters for it. Data updates every week during the season.

What it does

1. Player lookup. Enter any NFL player's name to get:

• Regular-season totals, with games played (GP)
• Rate stats calculated from those totals: passer rating, completion %, yards per carry, yards per reception, catch %, FG %, punting average
• A box score from the player's most recent game, with the opponent, home or away, the final score and the date
• Fantasy points in PPR and standard scoring (QB, RB, WR, TE)

2. Position leaders. Pick a position and get the top 10 in each of its key stat categories, ranked the way ESPN and NFL.com do it, with minimums for rate stats.

Input

Example commands

python3 nfl_player.py "Caleb Williams"
python3 nfl_player.py "Saquon Barkley" --season 2024
python3 nfl_player.py "Josh Allen" --team BUF
python3 nfl_player.py --top qb
python3 nfl_player.py --top lb --limit 5

Output

The output is plain-text tables in Markdown, so it reads well in a terminal and pastes cleanly into Discord, Reddit, Notion, GitHub or anything else that renders Markdown.

Player lookup

## Caleb Williams · QB · CHI

### 2026 Regular Season · 6 GP
| CMP | ATT | PASS YDS | PASS TD | INT | SACKS | CAR | RUSH YDS | RUSH TD | FPTS (PPR) | FPTS (STD) |
|---|---|---|---|---|---|---|---|---|---|---|
| 134 | 195 | 1,546 | 8 | 5 | 14 | 31 | 145 | 2 | 110.3 | 110.3 |

| CMP% | YDS/ATT | RATING | YDS/CAR |
|---|---|---|---|
| 68.7 | 7.9 | 95.4 | 4.7 |

### Last Game: Week 9 vs. TB, W 27-24 (Sun, Nov 8)
| CMP | ATT | PASS YDS | PASS TD | INT | SACKS | CAR | RUSH YDS | RUSH TD | FPTS (PPR) | FPTS (STD) |
|---|---|---|---|---|---|---|---|---|---|---|
| 22 | 37 | 279 | 2 | 4 | 1 | 5 | 16 | 0 | 12.8 | 12.8 |

| CMP% | YDS/ATT | RATING | YDS/CAR |
|---|---|---|---|
| 59.5 | 7.5 | 61.5 | 3.2 |

Stats through Week 9 of the 2026 season. Source: nflverse.

Each position gets its own box-score columns:

Details:

• Home or away is shown as vs. or @. Neutral-site games like the Super Bowl show vs.
• Playoff games are named by round: Wild Card, Divisional Round, Conference Championship, Super Bowl
• Players traded mid-season show every team they played for, e.g. · ARI/HOU

Position leaders

## 2026 Defensive Line Leaders · Top 3

### Sacks
| RK | PLAYER | TEAM | POS | GP | SACKS |
|---|---|---|---|---|---|
| 1 | Will Anderson Jr. | HOU | DE | 8 | 9.5 |
| 2 | Chase Young | NO | DE | 8 | 8.0 |
| 3 | Carl Granderson | NO | DE | 7 | 7.5 |

### Tackles for Loss
...

Categories by position:

* Rate stats require a minimum, following NFL.com, so a player with a handful of attempts can't top the list: 14 pass attempts, 6.25 carries, 1.875 receptions, 1 field goal attempt or 2.5 punts per team game. The minimum is printed next to the category name.

Ties are marked T-1, T-2 and so on.

When a name can't be matched

Requirements

• Python 3 (tested on 3.13 and 3.14)
• One package, installed once: pip3 install nflreadpy
• An internet connection. Stats are downloaded fresh from nflverse on every run.
• Commands run in a terminal (Terminal on macOS, Command Prompt or PowerShell on Windows), not inside the Python shell or IDLE.

Data notes

• Stats come from nflverse, the open-source NFL data project. nflverse updates during the season, usually within a day after games.
• Season totals cover the regular season only, matching NFL.com and ESPN season pages. The "Last Game" box score can be a playoff game.
• Positions follow the nflverse roster labels. Some edge rushers, such as 3-4 outside linebackers, are listed as LB rather than DL.
• Supported seasons depend on nflverse coverage. Recent seasons are fully supported.