The fantasy football API for developers
GridIron Data is a REST API for fantasy football and NFL player props. It returns PPR projections, weekly actuals from 2020 through 2026, snap share, injury status, news, matchup history and the NFL schedule for every fantasy-relevant player as JSON. Pro adds prop probabilities, defense vs position and betting lines. Start free with 50 requests a month.
Free plan: 50 requests/month, no credit card • Basic $45/year (or $5/month) • Pro $29/month
Why do developers use GridIron Data?
One dataset, one schema
Projections, real actuals, week-by-week stats, deviation analytics, injuries, and head-to-head matchup history — all under one schema. Not just numbers, but context.
Projections you can trust
PPR-accurate season and weekly projections, refreshed daily in-season and benchmarked against actuals so you can see who beats their number — and who fades.
Built for developers
Clean REST, predictable JSON, one x-api-key header. Search by name, position, team, or ID. You're making your first call in under five minutes.
Production-grade
Serverless on AWS with a global CDN, tiered rate limits and an hourly automated health check. Start on the free plan and upgrade without changing your key.
Everything You Need
Projections & Actuals
Season-long and weekly projections (PPR, half or standard) for every position, plus real game-by-game results from 2020 through 2026.
Deviation Analytics
Track how players perform vs. their projection every week. Surface the consistent over- and under-performers before your league does.
Fresh Data
Stats, projections and roster changes update daily in season, and injury status is checked against ESPN's injury report every 2 minutes from 8:00 am to 1:00 am ET.
Matchup History
See how any player performs against any opponent, with historical head-to-head splits baked into every profile.
Flexible Search
Query by player name, position, team, or ID with partial matching and filters. Find exactly the player you need.
Game-Day Injury Feed (Pro)
Poll /injuries/changes?since= to get only the players whose status changed, or have each batch pushed to a signed webhook. Changes arrive within a few minutes of ESPN posting them.
Player Props & Fair Lines (Pro)
/props turns any stat line into P(over/under) and a fair no-vig price, with the model's backtest. /defense ranks what every defense allows by position. Walkthrough.
Schedule, Byes & Lines
/schedule and /byes on Basic. Pro adds each game's spread, total, moneylines and implied team points, plus per-stat projections (pass yards, receptions, ...).
How do I start?
GridIron Data is a pay-as-you-grow API: you start free with player lookups and this week's projections, and upgrade when you need the full data set or more requests. Getting a key takes about two minutes.
- Create a free account and confirm your email. No credit card is needed.
- Copy your API key from the dashboard.
- Send the key in the x-api-key header with every request.
Simple to Use
Get Player Data
curl -H "x-api-key: YOUR_KEY" \
"https://api.gridirondata.com/api/v1/players?name=Josh%20Allen&position=QB"Weekly Projections
curl -H "x-api-key: YOUR_KEY" \
"https://api.gridirondata.com/api/v1/projections/12?position=RB"Matchup Analysis
curl -H "x-api-key: YOUR_KEY" \
"https://api.gridirondata.com/api/v1/matchups/Josh%20Allen%23QB/KC"See It Live
Real calls to the real API — no signup needed. Change the player and run it yourself.
Tip: type any NFL player, pick their position, and hit Run live.
Loading…
How much does it cost?
Start free with 50 requests a month and no credit card for player lookups and this week's projections. Upgrade for stats, snaps, news and every week: your key stays the same. Full pricing details.
Free
- 50 requests/month
- Player lookups and this week's projections
- No credit card
- Rate limit: 10 req/min
Basic
About $3.75 a month, billed yearly (3 months free). Or $5 month to month.
- 5,000 requests/month
- Every week and season, stats, snaps, news, rest-of-season projections, schedule and byes
- One payment covers 12 months, playoffs and off-season included
- Email support
- Rate limit: 30 req/min
Pro
- 50,000 requests/month
- Everything in Basic
- Prop probabilities and fair lines (
/props) - Defense vs position (
/defense) - Betting lines and per-stat projections
- Injury changes within minutes, plus webhooks
- Priority email support
- Rate limit: 100 req/min
Enterprise
- Custom request volume
- All endpoints
- Priority support
- Custom rate limits
| Plan | Price | Requests | Rate limit | Data | Betting data and injury changes |
|---|---|---|---|---|---|
| Free | $0, no card | 50 per month | 10 per minute | Player profiles and this week's projections | No |
| Basic | $5 per month | 5,000 per month | 30 per minute | Every week and season, stats, snaps, deviations, matchups, news, rest-of-season projections, schedule and byes | No |
| Pro | $29 per month | 50,000 per month | 100 per minute | Everything in Basic | Yes: /props, /defense, betting lines, per-stat projections, /injuries/changes and webhooks |
Frequently Asked Questions
What is GridIron Data?
GridIron Data is a REST API for fantasy football and NFL player-prop data. It returns PPR projections (weekly and rest-of-season), real game-by-game actuals from 2020 through 2026, deviation analytics, snap share, injury status, news, head-to-head matchup history and the NFL schedule for every fantasy-relevant NFL player as JSON. The Pro plan adds the betting data: prop probabilities with fair odds, defense vs position, betting lines, per-stat projections and injury changes within minutes. See what you can build with it.
How much does the GridIron Data API cost?
The Free plan costs $0 and allows 50 requests a month with no credit card. Basic is $5/month (5,000 requests/month), Pro is $29/month or $249/year (50,000 requests/month plus the betting data: /props, /defense, betting lines, per-stat projections, the injury changes feed and webhooks), and Enterprise is custom.
Is there a free fantasy football API plan?
Yes. Sign up, confirm your email and you get a free key with 50 requests a month at 10 a minute. No credit card is needed. The free plan covers player lookups (profile, team, injury status) and projections for the current NFL week; stats, snaps, news, matchups, other weeks and past seasons need Basic at $5 a month. Read more on the free fantasy football API page.
What is the game-day injury changes feed?
A Pro endpoint, GET /api/v1/injuries/changes?since=, that returns every player whose injury status changed since a timestamp. GridIron checks ESPN's injury report every 2 minutes from 8:00 am to 1:00 am ET, so a change shows up within a few minutes. Pro keys can also get each batch of changes pushed to a signed webhook.
Does GridIron Data have player prop and betting data?
Yes, on the Pro plan ($29/month or $249/year). GET /api/v1/props returns the probability a player goes over or under a stat line (passing, rushing and receiving yards, attempts, completions, receptions, touchdowns, interceptions) with fair no-vig American odds and the model's backtest. GET /api/v1/defense shows what each defense allows by position. Pro also adds betting lines on /schedule games (spread, total, moneylines, implied team points) and per-stat projections on /projections. Free and Basic keys get 403 pro_required. Prop probabilities are a model estimate, not betting advice. See Price NFL player props.
What scoring format does GridIron Data use?
Projections default to PPR (point per reception). Add ?scoring=half or ?scoring=standard for half-PPR or standard scoring.
How do I authenticate with the GridIron Data API?
Send your API key in the x-api-key header on every request to https://api.gridirondata.com/api/v1. Sign up for a free key; no credit card is needed.
Should I use an API or build my own scraper?
It depends on what you need. We compare the work, cost and risk honestly in GridIron Data vs building your own scraper.
Build It Yourself — Guides
Step-by-step tutorials that turn the GridIron Data API into working fantasy tools.
Week 3 Usage Report
Snap-share risers and fallers through Week 2, and what they mean for your Week 3 lineup.
Price Player Props with Probabilities
Turn any prop line into P(over) and a fair price, with defense-vs-position ranks and a calibration check.
Track Injury Changes on Game Day
Poll the Pro injury changes feed and alert your league when a starter flips to Out.
Build a Draft Value (VORP) Tool
Rank every player for your draft by Value Over Replacement using live 2026 PPR projections.
Weekly Start/Sit Optimizer
Turn a roster into the optimal weekly lineup from projected points with a few API calls.
Find Breakouts & Busts
Use deviation analytics to surface players who consistently beat or miss their projections.
Stream by Matchup History
Rank weekly streaming DST, QB, and TE candidates by how they've fared against this week's opponent.
Player News & Injury Feed
Pull impact-tagged injury, role, and transaction news for any player and render it as a live feed.
News-Driven Start/Sit Alerts
Scan your roster for breaking injury and role news that flips a lineup call before kickoff.
How the News Pipeline Works
Collection, player matching, three-tier deduplication, and game-aware polling — and what each means for your code.