Fantasy football API guides and weekly data
Quick answer: this is where GridIron Data publishes two things. The first is guides: copy-paste code for real tools (start/sit, draft value, injury alerts, snap-share trackers). The second is a weekly usage report built on our own data. Every example runs against the live API; most need a Basic key ($5/month), and a free key covers player lookups and this week's projections.
New here? Grab a free key (50 requests/month, no card), skim the API reference, and follow new posts in the Atom feed.
What's new, and which guide should you start with?
Newest first. In season, start with the latest weekly usage report. If you're building, start with the start/sit optimizer or the injury-changes guide.
GridIron Projections You Can Display
Our own weekly QB/RB/WR/TE projections, built from open data: fetch them in Python, see how they did against actuals, and show them in your app.
Week 9 Player Prop Notes: Usage Trends Before You Bet
59 players trending up and 34 down in snap share over the last 3 games, the Week 9 roles that open up when a teammate is out, and projection gaps. Data, not picks.
Week 9 Usage Report: Snap-Share Risers and Fallers
Chimere Dike 13% to 82%, Kyle Williams 30% to 83%, Lamar Jackson 88% to 2%. Who gained and lost roles in Week 8, and what it means for Week 9 lineups.
Build a Discord Bot for NFL Injury Alerts
A 70-line Python bot that posts to a Discord webhook when a rostered player's injury status flips. Pro changes feed, with a free-plan fallback.
Week 8 Inactives Watch: Injury Report Before Kickoff
5 key players Questionable, 0 Doubtful, 7 Out: Christian McCaffrey, George Pickens and Breece Hall top the list. Who played the last time each one sat.
Week 8 Player Prop Notes: Usage Trends Before You Bet
58 players trending up and 24 down in snap share over the last 3 games, the Week 8 roles that open up when a teammate is out, and projection gaps. Data, not picks.
Week 8 Usage Report: Snap-Share Risers and Fallers
J.J. McCarthy 23% to 92%, Jalen Brooks 21% to 64%, Jameis Winston 88% to 8%. Who gained and lost roles in Week 7, and what it means for Week 8 lineups.
Offensive Line Injury Data: Every Center, Guard and Tackle
Injury status, team and jersey for every NFL center, guard and tackle on Pro. Pull all 356 in 6 requests and follow changes in the injury feed.
NFL Data API Pricing Compared
GridIron Data, SportsDataIO, MySportsFeeds, Sportradar and the free nflverse data: what each costs and what you get. Prices checked October 2026.
Fantasy Football Projections in Google Sheets and Excel
A copy-paste Apps Script custom function and an Excel Power Query that pull this week's projections into a spreadsheet, with the key in the header.
Sleeper, ESPN and Yahoo Fantasy APIs: What They Don't Include
What each platform API documents, what's missing, and how to join GridIron projections to a Sleeper league by ESPN id.
NFL Player Props API
P(over/under) and fair odds for any stat line, defense vs position, and spreads, totals and implied team points on the schedule. Data, not picks.
Fantasy Football API for Python
Projections with requests, readable plan and rate-limit errors, stats and snap share, and pandas, in a few short scripts.
Set Up a Class with Free Basic API Keys
For instructors: request a class, share the student link and check seats. For students: sign up without a card, find your Basic key and make a first call in curl and Python.
Affiliate Guide: Links, Codes and Payouts
Get a code, add ?ref= to any page, use a promotion code, read your private stats page, and how the 30% first-year commission is held and paid.
Week 7 Inactives Watch: Injury Report Before Kickoff
6 key players Questionable, 0 Doubtful, 10 Out: Puka Nacua, Saquon Barkley and Breece Hall top the list. Who played the last time each one sat.
Price NFL Player Props with a Probability API
Turn any player prop line into P(over) and a fair price with /props, add matchup context from /defense, and check the model's 2025-26 calibration. Data, not picks.
Week 7 Player Prop Notes: Usage Trends Before You Bet
69 players trending up and 31 down in snap share over the last 3 games, the Week 7 roles that open up when a teammate is out, and projection gaps. Data, not picks.
Week 7 Usage Report: Snap-Share Risers and Fallers
Omar Cooper Jr. 7% to 82%, Jaleel McLaughlin 11% to 62%, Romeo Doubs 69% to 3%. Who gained and lost roles in Week 6, and what it means for Week 7 lineups.
Backtest Fantasy Projections Against Actuals
Grade every 2025 weekly projection against real results with one /players sweep: average miss by position, a trailing-average baseline, and how often the favorite won.
Week 6 Inactives Watch: Injury Report Before Kickoff
9 key players Questionable, 0 Doubtful, 9 Out: Chris Olave, Tyler Warren and Quinshon Judkins top the list. Who played the last time each one sat.
Week 6 Player Prop Notes: Usage Trends Before You Bet
61 players trending up and 37 down in snap share over the last 3 games, the Week 6 roles that open up when a teammate is out, and projection gaps. Data, not picks.
Week 6 Usage Report: Snap-Share Risers and Fallers
Isaiah Bond 10% to 72%, Marquez Valdes-Scantling 20% to 75%. Who gained and lost roles in Week 5, and what it means for Week 6 lineups.
Build a Fantasy Trade Analyzer
Raw points make every 2-for-1 look good. Score both sides of a trade by rest-of-season value over replacement, with snap-share and injury flags.
Week 5 Inactives Watch: Injury Report Before Kickoff
14 key players Questionable, 0 Doubtful, 5 Out: Ja'Marr Chase, Justin Jefferson and Ashton Jeanty top the list. Who played the last time each one sat.
Week 5 Usage Report: Snap-Share Risers and Fallers
Jalon Daniels 6% to 100%, Tyson Bagent 14% to 100%, Case Keenum 100% to 1%. Who gained and lost roles in Week 4, and what it means for Week 5 lineups.
Build a Start/Sit Model with Snap Share
Close projections are coin flips (52% in 2025). Build a Python start/sit model that uses snap share to price each player's floor.
Week 4 Inactives Watch: Injury Report Before Kickoff
4 key players Questionable, 1 Doubtful, 9 Out: Zay Flowers, Ladd McConkey and Mike Evans top the list. Who played the last time each one sat.
Week 4 Usage Report: Snap-Share Risers and Fallers
Sam Darnold 10% to 100%, Kyler Murray 17% to 100%, Justin Jefferson 96% to 12%. Who gained and lost roles in Week 3, and what it means for Week 4 lineups.
Week 3 Inactives Watch: Injury Report Before Kickoff
14 key players Questionable, 1 Doubtful, 11 Out: Brock Bowers, DeVonta Smith and Zay Flowers top the list. Who played the last time each one sat.
Week 3 Usage Report: Snap-Share Risers and Fallers
Aaron Jones 46% to 81%, Rome Odunze 48% to 84%, Saquon Barkley 71% to 16%. Who gained and lost roles in Week 2, and what it means for Week 3 lineups.
Track NFL Injury Changes on Game Day
Poll the Pro injury changes feed in Python or JavaScript, line it up with the Sunday refresh windows, and alert Discord or Slack when a starter flips to Out.
A Free Tier, and Game-Day Injury Changes for Pro
50 requests a month with no credit card, and a Pro feed that returns only the players whose injury status changed since your last call.
API Changelog
Every change to the API, newest first: the free plan and its October changes, the injury feed, keys that don't expire while subscribed, and this week's fixes.
How the News Pipeline Works
A technical walkthrough of collection, player matching, three-tier deduplication, game-aware polling, and retention — and what each means for code you write against the feed.
Player News & Injury Feed
Pull impact-tagged injury, role, and transaction news for any player and render a live feed — with on-demand scraping to seed coverage as you go.
News-Driven Start/Sit Alerts
Scan your roster for breaking injury and role news that flips a lineup call — and auto-request a scrape for any player the dataset hasn't covered yet.
Snap Share Is Now in the API
Amon-Ra St. Brown hit 98% of snaps two weeks before his 2021 breakout reached the box score. Per-week snap share back to 2020 — the earliest honest signal of a role change.
Use GridIron Data in ChatGPT, Claude and Cursor
Add one URL, sign in, and ask for projections, stats, news and props in plain English — your assistant calls the API on your plan.
Build a Draft Value (VORP) Tool
Rank every player for your draft by Value Over Replacement using live 2026 PPR projections — the same method a pro cheat sheet uses.
Weekly Start/Sit Optimizer
Turn your roster into an optimal lineup each week from projected points, slot by slot, including FLEX.
Find Breakouts & Busts
Use deviation analytics to surface players who consistently beat — or miss — their projections before your league notices.
Stream by Matchup History
Pick the best weekly streamer (DST, QB, TE) by ranking candidates on how they've historically performed against this week's opponent.
Frequently asked questions
How often are new posts published?
Two a week during the season: an injury and inactives roundup every Sunday morning, and a data report every Wednesday (snap-share risers and fallers, projections vs actuals, waiver takeaways). A developer guide lands every other Wednesday.
Do the guides work on the free plan?
Partly. The free plan covers player lookups and the current week's projections, so you can run the steps of a guide that use those. Most guides also read stats, snaps, deviations, matchups, news or past weeks, which take Basic ($5/month, 5,000 requests a month). The injury changes feed needs a Pro key.
Where do the numbers in the weekly posts come from?
From the GridIron Data API itself: snap share, actual PPR points, injury status changes and projection-vs-actual deltas. You can pull every table yourself with a Basic key.