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?

DataEndpointCoveragePlan
Last completed week's line/stats/{player_id}/{season}Current seasonFree
Game-by-game fantasy points and season totals/stats/{player_id}/{season}2020–2026Basic
Box scores: passing, rushing, receiving, targetsbox_score on each week2025 onBasic
Snap share/snaps/{player_id}2020–2026Basic
Actual vs projected/deviations/{player_id}2025 onBasic
Results against one opponent/matchups/{player_id}/{opponent}By opponentBasic
Schedule and bye weeks/schedule, /byesKickoffs, scores, byesBasic
Defense vs position/defensePer game, from box scoresPro
Target share and carry share/usageWeeklyPro

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.

PlanStats accessRequestsPrice
FreeLast completed week250 a month$0
BasicEvery week, 2020–20265,000 a month$59 a year or $9 a month
ProBasic plus defense vs position and usage50,000 a month$29 a month or $249 a year
Pro + CommercialPro, licensed for a product that earns money50,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.