An NFL player projections API
Quick answer: GridIron Data provides NFL player projections through GET /projections/{week}. It returns weekly fantasy points as JSON in PPR, half-PPR or standard scoring. A free key covers the current week. Basic ($59 a year) adds every week and rest-of-season projections, Pro ($29 a month) adds per-stat lines, and Pro + Commercial ($49 a month) lets you show GridIron's own projections in a paid product.
- Returns
- Weekly points
- Scoring
- PPR, half, standard
- Free plan
- Current week
- Per-stat lines
- Pro
What does the projections endpoint return?
GET /projections/{week} returns one row per player, highest projection first. Filter with position and team, and choose scoring=ppr, half or standard. Add source=gridiron to get only GridIron Data's own model, which covers QB, RB, WR and TE.
| Field | What it is | Plan |
|---|---|---|
gridiron_projection.projected_points | GridIron's own projected fantasy points | Free (current week) |
available, opponent, as_of, model_version | Whether the player can play, the matchup, and which run you got | Free (current week) |
weather | Kickoff forecast for outdoor US stadiums | Free (current week) |
| Any other week or season | The same fields for every week | Basic |
/projections/ros | Rest-of-season points, skipping byes and weeks played | Basic |
projected_stats | Per-stat line: pass, rush and receiving attempts, yards and TDs | Pro |
game_context | Implied team total, spread, projected dropbacks and carries | Pro |
Each row also has projected_points, a consensus of third-party projections. That field is for your own research and benchmarking on every plan. If you plan to show projections to users, use gridiron_projection.
How do I request NFL projections?
The base URL is https://api.gridirondata.com/api/v1. Send your key in the x-api-key header:
curl -H "x-api-key: YOUR_KEY" \
"https://api.gridirondata.com/api/v1/projections/11?source=gridiron&position=QB&scoring=ppr"
Replace 11 with the current NFL week. A free key asking for any other week gets HTTP 403 with reason basic_required.
This is one quarterback's object from the week 9 run, with the Pro fields included. Below Pro, the response leaves out projected_stats and game_context.
"gridiron_projection": {
"projected_points": 19.01,
"available": true,
"opponent": "LV",
"model_version": "gridiron-v1.2",
"as_of": "2026-11-07T01:50:03Z",
"kickoff_utc": "2026-11-08T21:05:00Z",
"weather": {"indoor": false, "wind_mph": 6.9, "temp_f": 70, "precip_prob_pct": 0},
"projected_stats": {"pass_att": 31.73, "pass_yds": 250.73, "pass_td": 1.88,
"pass_int": 0.68, "rush_att": 4.03, "rush_yds": 21.24},
"game_context": {"implied_total": 30.75, "team_dropbacks": 34.6, "team_carries": 28.1}
}
Which plan do I need for projections?
| You want to | Plan | Price |
|---|---|---|
| Try this week's projected points | Free | $0, 250 requests a month |
| Use every week and rest-of-season projections | Basic | $59 a year or $9 a month |
| Get per-stat projections and game context | Pro | $29 a month or $249 a year |
| Show GridIron projections in a product that earns money | Pro + Commercial | $49 a month or $490 a year, companies under $250k in yearly revenue |
| The same license with no revenue cap and higher limits | Business | $199 a month or $1,990 a year |
Displayed projections need the credit "Data: GridIron Data". The commercial license has the full display rules.
How accurate are the projections?
In a walk-forward backtest over 14,152 player-weeks from 2024 through week 9 of 2026, the average miss was 4.31 PPR points. A trailing four-game average missed by 4.63. GridIron was closer at every position and in 43 of the 45 weeks. Each week was projected using only earlier games. The projections guide covers the method and the results by position.
What don't these projections cover?
GridIron's own model doesn't project kickers or defenses. It updates on a weekly schedule with game-day injury refreshes, and it has no in-game live projections. If you want expert consensus rankings, FantasyPros is built for that. The API comparison shows where each provider fits.
Frequently asked questions
Which API provides NFL player projections?
GridIron Data does, at GET /projections/{week}. It returns weekly projected fantasy points for NFL players as JSON, in PPR, half-PPR or standard scoring. SportsDataIO and FantasyPros also sell or offer projection data.
Can I get NFL projections for free?
Yes, for the current week. A free GridIron Data key allows 250 requests a month at 10 a minute with no credit card. Other weeks and rest-of-season projections need Basic at $59 a year or $9 a month.
Which plan includes per-stat NFL projections?
Pro, at $29 a month or $249 a year. It adds projected passing, rushing and receiving stats plus game context such as the implied team total.
Can I show the projections in my app?
In a product that earns money, you need Pro + Commercial at $49 a month or $490 a year, or Business if your company makes $250,000 or more a year. You may display GridIron's own projections with the credit Data: GridIron Data. The consensus projected_points field is for internal benchmarking only.