An NFL stats API for developers
Quick answer: GridIron Data is an NFL stats API that returns player stats as JSON from GET /stats/{player_id}/{season}. It covers game-by-game fantasy points from 2020 through 2026, box scores from 2025 on, snap share, matchups and the schedule. Full stats need Basic, at $59 a year or $9 a month. A free key returns the last completed week only.
- Returns
- Game logs
- Seasons
- 2020–2026
- Full stats
- Basic, $59/year
- Free key
- Last completed week
What NFL stats does the API return?
| Data | Endpoint | Coverage | Plan |
|---|---|---|---|
| Last completed week's line | /stats/{player_id}/{season} | Current season | Free |
| Game-by-game fantasy points and season totals | /stats/{player_id}/{season} | 2020–2026 | Basic |
| Box scores: passing, rushing, receiving, targets | box_score on each week | 2025 on | Basic |
| Snap share | /snaps/{player_id} | 2020–2026 | Basic |
| Actual vs projected | /deviations/{player_id} | 2025 on | Basic |
| Results against one opponent | /matchups/{player_id}/{opponent} | By opponent | Basic |
| Schedule and bye weeks | /schedule, /byes | Kickoffs, scores, byes | Basic |
| Defense vs position | /defense | Per game, from box scores | Pro |
| Target share and carry share | /usage | Weekly | Pro |
Stats for the current season land the day after games, at about 11:00 ET, and refresh for 10 days to pick up NFL stat corrections.
How do I request NFL player stats?
The base URL is https://api.gridirondata.com/api/v1. Player IDs use the form First Last#POS, so URL-encode the space and the #:
curl -H "x-api-key: YOUR_KEY" \
"https://api.gridirondata.com/api/v1/stats/Justin%20Jefferson%23WR/2024?scoring=ppr"
On Basic, the response has every week and the season totals. This sample is shortened to week 1:
{
"player_id": "Justin Jefferson#WR",
"season": "2024",
"scoring": "ppr",
"season_points": 227.9,
"weekly_stats": {
"1": {
"opponent": "NYG",
"fantasy_points": 11.9,
"fantasy_points_ppr": 15.9,
"fantasy_points_half": 13.9,
"points": 15.9
}
},
"season_totals": {
"MISC_FPTS": 149.9,
"MISC_FPTS_PPR": 227.9,
"MISC_FPTS_HALF": 188.9,
"Rank": 8, "Rank_PPR": 3, "Rank_HALF": 5
}
}
With a free key, the same endpoint answers for the last completed week of the current season. Other weeks and past seasons return HTTP 403 with reason basic_required, and season totals are left out. Here is a shortened free response for week 10:
{
"player_id": "Justin Jefferson#WR",
"season": "2026",
"scoring": "ppr",
"week": 10,
"weekly_stats": {
"10": {
"opponent": "GB",
"points": 16.4,
"box_score": {"rec": 9, "targets": 13, "rec_yds": 74}
}
},
"free_plan": "Last completed week only on the free plan. ..."
}
Which plan do I need for stats?
Basic is the stats plan. It costs $59 a year or $9 a month and includes 5,000 requests a month at 30 a minute. You get every week and season from 2020 on, snap share, deviations, matchups, the schedule and bye weeks.
| Plan | Stats access | Requests | Price |
|---|---|---|---|
| Free | Last completed week | 250 a month | $0 |
| Basic | Every week, 2020–2026 | 5,000 a month | $59 a year or $9 a month |
| Pro | Basic plus defense vs position and usage | 50,000 a month | $29 a month or $249 a year |
| Pro + Commercial | Pro, licensed for a product that earns money | 50,000 a month | $49 a month or $490 a year |
Pro + Commercial is for companies under $250k in yearly revenue. The commercial license explains what you may display.
What doesn't the stats API cover?
GridIron has no live in-game stats, no play-by-play and no seasons before 2020. For free play-by-play and deeper history, use nflverse. For live scores and in-play data, look at SportsDataIO. The API comparison shows where each provider fits.
Frequently asked questions
What NFL stats API should a developer use?
It depends on the job. GridIron Data fits apps that need player stats, snap share and projections from one keyed REST API. nflverse is free and best for play-by-play and bulk analysis. SportsDataIO covers live scores and in-play data under a commercial license.
Which plan includes NFL stats?
Basic, at $59 a year or $9 a month, includes every week and season from 2020 on. A free key gets the last completed week of the current season.
How quickly do stats update after a game?
Current-season stats land the day after games at about 11:00 ET and refresh for 10 days to pick up stat corrections. GridIron has no live in-game stats.
Does the API include play-by-play?
No. GridIron Data returns player-game lines and box scores. nflverse publishes free play-by-play data for R and Python.