The fantasy football API for developers
GridIron Data is a REST API for fantasy football. It returns PPR projections, weekly actuals from 2020 through 2026, snap share, injury status, news and matchup history for every fantasy-relevant player as JSON. Start free with 100 requests a day.
Free plan: 100 requests/day, no credit card β’ Basic $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.
Daily-Fresh Data
Stats, projections, injuries, and roster changes update daily in season. Injury status refreshes again before Sunday, Thursday and Monday kickoffs.
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 after each game-day refresh.
How do I start?
GridIron Data is a pay-as-you-grow API: you start free and upgrade only when you need 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 100 requests a day and no credit card. Upgrade when you need more: your key stays the same. Full pricing details.
Free
- 100 requests/day
- All standard endpoints
- No credit card
- Rate limit: 10 req/min
Basic
- 5,000 requests/month
- All standard endpoints
- Email support
- Rate limit: 30 req/min
Pro
- 50,000 requests/month
- Game-day injury changes feed
- Priority email support
- Rate limit: 100 req/min
Enterprise
- Custom request volume
- All endpoints
- Priority support
- Custom rate limits
| Plan | Price | Requests | Rate limit | Injury changes feed |
|---|---|---|---|---|
| Free | $0, no card | 100 per day | 10 per minute | No |
| Basic | $5 per month | 5,000 per month | 30 per minute | No |
| Pro | $29 per month | 50,000 per month | 100 per minute | Yes |
Frequently Asked Questions
What is GridIron Data?
GridIron Data is a REST API for fantasy football data. It returns PPR projections (season and weekly), real game-by-game actuals from 2020 through 2026, deviation analytics, snap share, injury status, news and head-to-head matchup history for every fantasy-relevant NFL player as JSON. See what you can build with it.
How much does the GridIron Data API cost?
The Free plan costs $0 and allows 100 requests a day with no credit card. Basic is $5/month (5,000 requests/month), Pro is $29/month (50,000 requests/month plus the game-day injury changes feed), 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 100 requests a day at 10 a minute. No credit card is needed, and every standard endpoint is included. 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 refreshes injury status daily and again after inactives on Sundays and before Thursday and Monday night games.
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.
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.