GridIron Data

Returns every team's bye week for a season, and the teams on bye each week. Use it to plan lineups and spot bye-week holes on a roster. Basic plan and above.

Returns what each NFL defense allows per game to QBs, RBs, WRs or TEs: fantasy points plus yards, TDs, receptions and targets, from ESPN box scores, ranked so rank 1 allows the most (the best matchup). Use it for matchup-based start/sit and streaming, optionally over the last N weeks. Pro plan (Free and Basic keys get 403 pro_required).

Returns NFL depth charts as of the daily nflverse refresh (as_of), for one team or all 32, optionally one position or group (CB, LB, EDGE, ...) or starters only. Each entry has the player, ids, position, formation, slot, depth within the slot (1 = starter), a starter flag, and the player's current injury_status and available, so an OUT or IR starter is flagged rather than moved. Use it for "who are the Bears' starting WRs?" or the next man up behind an injured player. Built from ESPN's public depth charts via nflverse, not official team depth charts. Pro plan (Free and Basic keys get 403 pro_required).

Returns how a player's actual fantasy points compared with his projections: the average deviation and each week's projected vs actual. Use it to judge boom/bust tendencies or whether a player keeps beating (or missing) his projection. Basic plan and above.

Returns the NFL's official game-day inactives for a week (default the newest week published), by team, with gsis, espn, sleeper and pfr ids. Published after the games, usually days later. Use it for audits and backtesting, not as a pre-kickoff list (teams_published vs teams_played shows how complete the week is). Pro plan (Free and Basic keys get 403 pro_required).

Returns players whose injury status changed since a time (default the last 24 hours, up to 14 days back), with previous_status, status and detected_at. Statuses are checked against ESPN every 2 minutes from 8am to 1am ET. Use it for "who got hurt or cleared today?" and game-day checks; pass next_since back as since to get only newer changes. Pro plan (Free and Basic keys get 403 pro_required).

Returns the league-wide NFL news feed across every tracked player, newest first: signings, trades, cuts, injuries and depth-chart moves, filterable by time, impact, position and team, paged with next_cursor. Use it for "what happened today/this week" or a team's or position's latest news. Basic plan and above.

Returns a player's past games and fantasy points against one opponent. Use it for matchup questions like "how does he do against KC?". Basic plan and above.

Returns one player's profile by id: name, team, position, injury status, jersey and cross-system ids, plus per-season data on Basic and above. Use it to check a player's current team or injury status. Free plan (profile fields only; season data needs Basic).

Returns the player whose ESPN athlete id this is (the numeric id ESPN and many sportsbook feeds use), as the same record get_player returns. Use it to join ESPN or sportsbook data to GridIron player ids. Free plan.

Returns the player with this NFL GSIS id (e.g. "00-0034857", the key nflverse and NFL data use), as the same record get_player returns, with an ids map (gsis, pfr, pff, nfl, espn, sleeper) from the daily nflverse crosswalk. Use it to join nflverse or NFL data to GridIron. Free plan.

Returns recent news headlines for one player, newest first, each tagged by impact (injury, role, transaction or general). Use it for "any news on X?" and injury or role questions about a specific player; for the whole league use get_latest_news. Basic plan and above.

Returns a player's actual stats for one season (2020 to now): fantasy points week by week and in total in the chosen scoring, plus the raw stat line and snap share each week. Use it for "how did X do" questions, game logs and comparisons with projections. Basic plan and above.

Returns projected fantasy points for every player in an NFL week (1-18), in PPR, half-PPR or standard scoring, optionally for one position or team. Use it for start/sit, rankings and "top N at a position this week". Each row also has gridiron_projection, GridIron Data's own model (with model_version and as_of; null when none), which unlike projected_points may be displayed under Pro + Commercial. Players who can't play project 0 with available=false. Free plan: the current week of the current season; other weeks and seasons need Basic; Pro adds projected_stats per row (pass_yds, rec, rush_yds, ...).

Returns the probability a player goes over or under a stat line (passing, rushing or receiving yards, TDs, attempts, completions, interceptions, receptions), with fair no-vig American odds for each side, the projected mean and spread, the week's game and betting line, and the model's backtest. Use it to price a player prop or compare a sportsbook line with a fair price. Players on bye or OUT/IR get p_over 0. Model estimate, not betting advice. Pro plan (Free and Basic keys get 403 pro_required).

Returns each player's projected fantasy points for the rest of the current season (weeks already played and his bye are skipped), with games_remaining and points_per_game. Use it for trades, waiver pickups and dynasty or keeper decisions. Filter by position, team or one player. Basic plan and above.

Returns the NFL regular-season schedule: week, home and away teams, kickoff time (UTC), status and final score, for a season, one week or one team (with that team's bye week). Use it for "who plays whom", kickoff times and results. Basic plan and above; Pro keys also get each game's betting line (spread_home, over_under, moneylines, implied team points).

Returns a player's offensive snap share each week (the % of his team's offensive plays he was on the field for), the season average, and a trailing average with its change vs the season. Use it to spot role changes before they show in the box score (a committee back taking over, a rookie WR passing a veteran). Seasons 2020-2026, current season updated weekly. Basic plan and above.

Returns a page of NFL players (player_id, name, position, team), optionally for one position, paged with next_cursor. Use it to browse a position group; to find a specific player, search_players is faster. Free plan.

Queues an on-demand news pull for a player who has no news coverage yet and returns at once (202); the headlines appear in get_player_news shortly after. Use it only when get_player_news comes back empty. Asking twice is harmless. Basic plan and above.

Finds players by full or partial name (case-insensitive) and returns each match's exact player_id ("First Last#POS"), team and position. Use it first whenever you have a name but not the id the other tools need. Defenses match by team code or nickname too ("TB", "Bucs", "Tampa Bay DST"). Free plan.