STAT-API

NFL projected_player_snaps API

projected_player_snapsnfl.projected_player_snaps
Pre-kickoff projected and post-game realized offensive snaps, snap shares, touch rates, and volume opportunities for NFL players.
Full field reference (35 columns) → Data DictionaryQuery in GraphQL →
GET/api/v1/nfl/projected_player_snaps
Requires one of: game_id or player_id or season_id + week or season_id + team_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
player_idquerybigintoptional
Filter to a single player.
team_idquerybigintoptional
Filter by team.
season_idquerybigintoptional
Filter to a season by year (e.g., 2025). Defaults to current season.
weekqueryintegeroptional
Filter by NFL week number.
positionquerystringoptional
Filter by position (QB, RB, WR, TE, DST).
modequerystringoptionaldefault pre
Time wall. `pre` (default): each value as it stood at its game's kickoff; post-game fields are null. `full`: the latest value before week end (the first Tuesday 04:00 ET after the game), post-game fields included. See the Data timing guide. Values: pre, full.
limitqueryintegeroptionaldefault 100
Page size. Defaults to 100; max 5000.
from_idquerybigintoptional
Return rows with id strictly greater than this value; page using the previous response's `next_from_id`. Omit on the first page.
Restores the documented defaults (trial keys only accept the unchanged defaults).
Request
curl -sS --compressed \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://api.stat-api.com/api/v1/nfl/projected_player_snaps?game_id=1'
Responses
200projected_player_snaps rows matching the declared filter set, wrapped in { projected_player_snaps, limit, next_from_id }. next_from_id is the last row's id on a full page — pass it back via ?from_id= to walk the full result; null marks the terminal page.application/jsonshow example ▸
400No declared filter set was satisfied — response body matches MissingRequiredFiltersError; pick one combo from the accepted-sets hint and resend.application/json
Response Schema(35 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 56
player_id
bigint—
e.g. 1505
season_id
bigint—
e.g. 2024
team_id
bigint—
e.g. 3
actual_pass_attempts
integernullable—Realized post-game actual pass attempts.
e.g. 0
actual_pass_completions
integernullable—Realized post-game actual pass completions.
e.g. 0
actual_receptions
integernullable—Realized post-game actual pass receptions.
e.g. 0
actual_rush_attempts
integernullable—Realized post-game actual rushing attempts.
e.g. 0
actual_snap_share
decimalnullable—Realized post-game actual snap share percentage.
e.g. 0.0000
actual_snaps
integernullable—Realized post-game actual offensive snaps played.
e.g. 0
actual_targets
integernullable—Realized post-game actual receiving targets.
e.g. 0
actual_team_snaps
integernullable—Realized post-game actual total team offensive snaps.
e.g. 56
as_of
timestamptz—Point in time the projection reflects (UTC). Set when the projection is published; a backfilled row is never later than its write time.
e.g. 2026-09-19T21:45:25.265Z
depth_order
integernullable—Official pre-game depth chart order (1 = starter, 2 = primary backup).
e.g. 1
is_inactive
boolean—True if player was declared inactive prior to kickoff.
Values:falsetrue
is_starter
boolean—True if player is designated as the starter at kickoff.
Values:truefalse
position
string—Player position for this matchup (QB, RB, WR, TE, FB, DST).
Values:WRRBTEQBDSTFB
projected_pass_attempts
decimalnullable—Pre-kickoff projected pass attempts (QB only).
e.g. 0.00
projected_pass_completions
decimalnullable—Pre-kickoff projected pass completions (QB only).
e.g. 0.00
projected_receptions
decimalnullable—Pre-kickoff projected pass receptions.
e.g. 0.00
projected_rush_attempts
decimalnullable—Pre-kickoff projected rushing attempts.
e.g. 0.00
projected_rush_share
decimalnullable—Pre-kickoff projected percentage of team rushing attempts.
e.g. 0.0101
projected_snap_share
decimal—Pre-kickoff projected percentage of team offensive snaps (0.0000 - 1.0000).
e.g. 0.0000
projected_snaps
decimal—Pre-kickoff projected offensive snaps.
e.g. 0.00
projected_target_share
decimalnullable—Pre-kickoff projected percentage of team targets.
e.g. 0.1200
projected_targets
decimalnullable—Pre-kickoff projected receiving targets.
e.g. 0.00
projected_team_snaps
decimal—Pre-kickoff projected total offensive snaps for the player's team.
e.g. 62.00
rush_attempts_error
decimalnullable—Calibration error: actual_rush_attempts minus projected_rush_attempts.
e.g. 0.00
snap_error
decimalnullable—Calibration error: actual_snaps minus projected_snaps.
e.g. 0.00
snap_share_error
decimalnullable—Calibration error: actual_snap_share minus projected_snap_share.
e.g. 0.0000
source
string—SOTA model source version (e.g. STAT_API_SOTA).
e.g. STAT_API_SOTA
targets_error
decimalnullable—Calibration error: actual_targets minus projected_targets.
e.g. 0.00
touch_rate_per_snap
decimalnullable—Pre-kickoff projected touches (rushes + receptions) per offensive snap.
e.g. 0.2800
week
integer—NFL regular season week number.
e.g. 1
GET/api/v1/nfl/projected_player_snaps/{id}
Parameters
idpathbigintrequired
Primary key (id) of the projected_player_snap row.
modequerystringoptionaldefault pre
Time wall. `pre` (default): each value as it stood at its game's kickoff; post-game fields are null. `full`: the latest value before week end (the first Tuesday 04:00 ET after the game), post-game fields included. See the Data timing guide. Values: pre, full.
Restores the documented defaults (trial keys only accept the unchanged defaults).
Request
curl -sS --compressed \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://api.stat-api.com/api/v1/nfl/projected_player_snaps/{pk_value}'
Responses
200Single projected_player_snap row.application/jsonshow example ▸
404Row not found.
Response Schema(35 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 56
player_id
bigint—
e.g. 1505
season_id
bigint—
e.g. 2024
team_id
bigint—
e.g. 3
actual_pass_attempts
integernullable—Realized post-game actual pass attempts.
e.g. 0
actual_pass_completions
integernullable—Realized post-game actual pass completions.
e.g. 0
actual_receptions
integernullable—Realized post-game actual pass receptions.
e.g. 0
actual_rush_attempts
integernullable—Realized post-game actual rushing attempts.
e.g. 0
actual_snap_share
decimalnullable—Realized post-game actual snap share percentage.
e.g. 0.0000
actual_snaps
integernullable—Realized post-game actual offensive snaps played.
e.g. 0
actual_targets
integernullable—Realized post-game actual receiving targets.
e.g. 0
actual_team_snaps
integernullable—Realized post-game actual total team offensive snaps.
e.g. 56
as_of
timestamptz—Point in time the projection reflects (UTC). Set when the projection is published; a backfilled row is never later than its write time.
e.g. 2026-09-19T21:45:25.265Z
depth_order
integernullable—Official pre-game depth chart order (1 = starter, 2 = primary backup).
e.g. 1
is_inactive
boolean—True if player was declared inactive prior to kickoff.
Values:falsetrue
is_starter
boolean—True if player is designated as the starter at kickoff.
Values:truefalse
position
string—Player position for this matchup (QB, RB, WR, TE, FB, DST).
Values:WRRBTEQBDSTFB
projected_pass_attempts
decimalnullable—Pre-kickoff projected pass attempts (QB only).
e.g. 0.00
projected_pass_completions
decimalnullable—Pre-kickoff projected pass completions (QB only).
e.g. 0.00
projected_receptions
decimalnullable—Pre-kickoff projected pass receptions.
e.g. 0.00
projected_rush_attempts
decimalnullable—Pre-kickoff projected rushing attempts.
e.g. 0.00
projected_rush_share
decimalnullable—Pre-kickoff projected percentage of team rushing attempts.
e.g. 0.0101
projected_snap_share
decimal—Pre-kickoff projected percentage of team offensive snaps (0.0000 - 1.0000).
e.g. 0.0000
projected_snaps
decimal—Pre-kickoff projected offensive snaps.
e.g. 0.00
projected_target_share
decimalnullable—Pre-kickoff projected percentage of team targets.
e.g. 0.1200
projected_targets
decimalnullable—Pre-kickoff projected receiving targets.
e.g. 0.00
projected_team_snaps
decimal—Pre-kickoff projected total offensive snaps for the player's team.
e.g. 62.00
rush_attempts_error
decimalnullable—Calibration error: actual_rush_attempts minus projected_rush_attempts.
e.g. 0.00
snap_error
decimalnullable—Calibration error: actual_snaps minus projected_snaps.
e.g. 0.00
snap_share_error
decimalnullable—Calibration error: actual_snap_share minus projected_snap_share.
e.g. 0.0000
source
string—SOTA model source version (e.g. STAT_API_SOTA).
e.g. STAT_API_SOTA
targets_error
decimalnullable—Calibration error: actual_targets minus projected_targets.
e.g. 0.00
touch_rate_per_snap
decimalnullable—Pre-kickoff projected touches (rushes + receptions) per offensive snap.
e.g. 0.2800
week
integer—NFL regular season week number.
e.g. 1