NFL v3 Stats

Player Game Stats Delta

This method returns all player game stats, but only returns player stats that have changed in the last X minutes as specified in your API call. By definition this is a live endpoint, not final.

get/v3/nfl/stats/{format}/PlayerGameStatsDelta/{minutes}

Request

Path parameters

format'JSON' | 'XML' required

Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.

minutesstring required
      Only returns player statistics that have changed in the last X minutes.  You specify how many minutes in time to go back.  Valid entries are:
      <code>1</code> or <code>2</code>.
    

Response

Success

GameKeystring nullable

A 9 digit unique code identifying the game that this record corresponds to. The GameID is composed of Season; SeasonType; Week and HomeTeam.. Note: This value will be NULL for bye weeks

PlayerIDinteger nullable

The unique PlayerID of the player as assigned by SportsDataIO. Note: this ID will stay with the player throughout their entire career

SeasonTypeinteger

The type of season that this player corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)

Seasoninteger

The NFL season of the game

GameDatestring nullable

The date and time the game is scheduled to start

Weekinteger

The NFL week of the game (regular season: 1 to 18; preseason: 0 to 4; postseason: 1 to 4). Note: seasons after 2021 will have only 3 preseason weeks

Teamstring nullable

The abbreviation [Key] of the team that the player is on. Note: if this player is a free agent; this field is NULL

Opponentstring nullable

The abbreviation [Key] of the opponent team

HomeOrAwaystring nullable

Whether the team is home or away

Numberinteger

Player's jersey number

Namestring nullable

Player's full name

Positionstring nullable

The primary position of the player. Possible Values: C; CB; DB; DE; DL; DT; FB; FS; G; ILB; K; KR; LB; LS; NT; OL; OLB; OT; P; QB; RB; S; SS; T; TE; WR

PositionCategorystring nullable

The category of the player's position (OFF; DEF; ST)

Activatedinteger

Whether or not the player was active for the game

Playedinteger

Whether the player played at least one snap in the game Note: Will return "1" if player played at least one snap and "0" if they did not

Startedinteger

Whether the player started the game (on offensive or defense). Note: Started = 1 / Did Not Start = 0

PassingAttemptsnumber

Total passes thrown by the player in the game

PassingCompletionsnumber

Total passes completed by the player in the game

PassingYardsnumber

Total passing yards by the player in the game

PassingCompletionPercentagenumber

The percentage of passes completed by the player in the game

PassingYardsPerAttemptnumber

Total average passing yards per attempt by the player in the game

PassingYardsPerCompletionnumber

Total average passing yards per completion by the player in the game

PassingTouchdownsnumber

Total passing touchdowns by the player in the game

PassingInterceptionsnumber

Total interceptions thrown by the player in the game

PassingRatingnumber

The passer rating of the player in the game

PassingLongnumber

Total yards of longest completion by the player in the game

PassingSacksnumber

The total number of times the player was sacked in the game

PassingSackYardsnumber

Total yards lost by the player in the game as a result of being sacked

RushingAttemptsnumber

Total rushing attempts by the player in the game

RushingYardsnumber

Total rushing yards by the player in the game

RushingYardsPerAttemptnumber

Total rushing yards per attempt by the player in the game

RushingTouchdownsnumber

Total rushing touchdowns by the player in the game

RushingLongnumber

The longest rush by the player in the game

ReceivingTargetsnumber nullable

Total receiving targets by the player in the game

Receptionsnumber

Total receptions by the player in the game

ReceivingYardsnumber

Total receiving yards by the player in the game

ReceivingYardsPerReceptionnumber

Average receiving yards per reception by the player in the game

ReceivingTouchdownsnumber

Total receiving touchdowns by the player in the game

ReceivingLongnumber

The longest reception by the player in the game

Fumblesnumber

Total fumbles by the player in the game

FumblesLostnumber nullable

Total fumbles lost by the player in the game

PuntReturnsnumber

Total punt returns by the player in the game

PuntReturnYardsnumber

Total punt return yards by the player in the game

PuntReturnYardsPerAttemptnumber

Total average yards gained per punt return by the player in the game

PuntReturnTouchdownsnumber

Total punt return touchdowns by the player in the game

PuntReturnLongnumber

The longest punt return by the player in the game

KickReturnsnumber

Total kickoff returns by the player in the game

KickReturnYardsnumber

Total kickoff return yards by the player in the game

KickReturnYardsPerAttemptnumber

Average yards gained per kick return by the player in the game

KickReturnTouchdownsnumber

Total kickoff return touchdowns by the player in the game

KickReturnLongnumber

Longest kick return by the player in the game

SoloTacklesnumber

Total defensive solo (unassisted) tackles by the player in the game

AssistedTacklesnumber

Total defensive assisted tackles by the player in the game

TacklesForLossnumber nullable

Total tackles for loss by the player in the game. Note: these are tackles behind the line of scrimmage for loss of yards (including sacks)

Sacksnumber

Total defensive sacks by the player in the game

SackYardsnumber

Total defensive sacks yards by the player in the game

QuarterbackHitsnumber nullable

Total quarterback hits by the player in the game. Note: This is a defensive stat that includes sacks

PassesDefendednumber

Total passes defended by the player in the game

FumblesForcednumber

Total fumbles forced on defense by the player in the game

FumblesRecoverednumber

Total defensive fumble recoveries by the player in the game

FumbleReturnYardsnumber

Total fumble return yards by the player in the game

FumbleReturnTouchdownsnumber

Total fumble return touchdowns by the player in the game

Interceptionsnumber

Total defensive interceptions by the player in the game

InterceptionReturnYardsnumber

Total defensive interception return yards by the player in the game

InterceptionReturnTouchdownsnumber

Total defensive interception return touchdowns by the player in the game

BlockedKicksnumber

Total blocked kicks by the player in the game. Note: BlockedKicks include Field Goals and Punts but NOT Extra Points

SpecialTeamsSoloTacklesnumber

This field is deprecated

SpecialTeamsAssistedTacklesnumber

This field is deprecated

MiscSoloTacklesnumber

This field is deprecated

MiscAssistedTacklesnumber

This field is deprecated

Puntsnumber

Total number of punts by the player in the game

PuntYardsnumber

Total punt yards by the player in the game

PuntAveragenumber

The average number of yards per punt by the player in the game

FieldGoalsAttemptednumber

Total field goals attempted by the player in the game

FieldGoalsMadenumber

Total field goals made by the player in game

FieldGoalsLongestMadenumber

Longest field goal made by the player in the game

ExtraPointsMadenumber

Total extra points made by the player in the game

TwoPointConversionPassesnumber

Total successful two point conversion passes by the player in the game

TwoPointConversionRunsnumber

Total successful two point conversion rushes by the player in the game

TwoPointConversionReceptionsnumber

Total successful two point conversion receptions by the player in the game

FantasyPointsnumber

Fantasy points scored based on basic fantasy scoring system by the player in the game

FantasyPointsPPRnumber

This field is expected to be NULL

ReceptionPercentagenumber

Total percentage of receiving targets that were receptions by the player in the game

ReceivingYardsPerTargetnumber

Average receiving yards per target by the player in the game

Tacklesnumber

Total tackles (solo & assisted) by the player in the game

OffensiveTouchdownsnumber

Total offensive touchdowns scored by the player in the game

DefensiveTouchdownsnumber

Total defensive touchdowns scored by the player in the game

SpecialTeamsTouchdownsnumber

Total special teams touchdowns scored by the player in the game

Touchdownsnumber

Total touchdowns scored by the player in the game (excludes passing touchdowns)

FantasyPositionstring nullable

The player's fantasy football position. Possible values: QB; RB; WR; TE; DL; LB; DB; K; P; OL

FieldGoalPercentagenumber

Total field goal attempts made by the player in the game

PlayerGameIDinteger

Unique ID of PlayerGame record (subject to change, although it very rarely does). For a static ID, use a combination of GameKey and PlayerID.

FumblesOwnRecoveriesnumber nullable

Total own fumble recoveries by the player in the game. Note: this fumble doesn't result in a turnover - the fumbling team recovers the fumble

FumblesOutOfBoundsnumber nullable

This field is deprecated

KickReturnFairCatchesnumber nullable

This field is deprecated

PuntReturnFairCatchesnumber nullable

This field is deprecated

PuntTouchbacksnumber nullable

Total punts that resulted in touchbacks by the player in the game

PuntInside20number nullable

Total punts downed inside the 20 yard line by the player in the game

PuntNetAveragenumber nullable

The average net yards per punt by the player in the game

ExtraPointsAttemptednumber nullable

Total extra point kicks attempted by the player in the game

BlockedKickReturnTouchdownsnumber nullable

Total blocked kick recovery return touchdowns for the player in the game

FieldGoalReturnTouchdownsnumber nullable

Total field goal return touchdowns by the player in the game. Note: This field excludes blocked field goals

Safetiesnumber nullable

Total defensive safeties scored by the player in the game

FieldGoalsHadBlockednumber nullable

Total field goals by the player that were blocked in the game

PuntsHadBlockednumber nullable

Total punts by the player that were blocked in the game

ExtraPointsHadBlockednumber nullable

Total extra point kick attempts by the player that were blocked in the game

PuntLongnumber nullable

The longest punt by the player in the game

BlockedKickReturnYardsnumber nullable

Total blocked kick recovery return yards for the player in the game

FieldGoalReturnYardsnumber nullable

Total field goal return yards by the player in the game. Note: This field excludes blocked field goals

PuntNetYardsnumber nullable

The net yards of the punts by the player in the game

SpecialTeamsFumblesForcednumber nullable

This field is deprecated

SpecialTeamsFumblesRecoverednumber nullable

This field is deprecated

MiscFumblesForcednumber nullable

This field is deprecated

MiscFumblesRecoverednumber nullable

This field is deprecated

ShortNamestring nullable

The first initial and last name of the player (J. Doe)

PlayingSurfacestring nullable

The playing surface of the stadium

IsGameOverboolean nullable

Whether the game is over (true/false)

SafetiesAllowednumber nullable

This field is deprecated

Stadiumstring nullable

Stadium of the event

Temperatureinteger nullable

Temperature at game start (Fahrenheit)

Humidityinteger nullable

The humidity percentage at the start of the game

WindSpeedinteger nullable

The wind speed at the start of the game (in MPH)

FanDuelSalaryinteger nullable

The player's salary for FanDuel daily fantasy contests.

DraftKingsSalaryinteger nullable

The player's salary for DraftKings daily fantasy contests.

FantasyDataSalaryinteger nullable

The player's salary as calculated by SportsDataIO (formerly known as FantasyData).  Based on the same salary cap as DraftKings contests ($50,000).

OffensiveSnapsPlayedinteger nullable

Total snaps this player played on offense in the game. Note: Snap counts are available the morning after the game.

DefensiveSnapsPlayedinteger nullable

Total snaps this player played on defense in the game. Note: Snap counts are available the morning after the game.

SpecialTeamsSnapsPlayedinteger nullable

Total snaps this player played on special teams in the game. Note: Snap counts are available the morning after the game.

OffensiveTeamSnapsinteger nullable

Total offensive snaps this player's team played in the game. Note: Snap counts are available the morning after the game.

DefensiveTeamSnapsinteger nullable

Total defensive snaps this player's team played in the game. Note: Snap counts are available the morning after the game.

SpecialTeamsTeamSnapsinteger nullable

Total special teams snaps this player's team played in the game. Note: Snap counts are available the morning after the game.

VictivSalaryinteger nullable

The player's salary for Victiv daily fantasy contests.

TwoPointConversionReturnsnumber nullable

Total successful two point conversion returns by the player in the game

FantasyPointsFanDuelnumber nullable

Fantasy points based on FanDuel's scoring system by the player in the game

FieldGoalsMade0to19number nullable

Total field goals of 0 to 19 yards made by the player in game

FieldGoalsMade20to29number nullable

Total field goals of 20 to 29 yards made by the player in game

FieldGoalsMade30to39number nullable

Total field goals of 30 to 39 yards made by the player in game

FieldGoalsMade40to49number nullable

Total field goals of 40 to 49 yards made by the player in game

FieldGoalsMade50Plusnumber nullable

Total field goals of 50+ yards made by the player in game

FantasyPointsDraftKingsnumber nullable

Fantasy points based on DraftKings' scoring system by the player in the game

YahooSalaryinteger nullable

The player's salary for Yahoo daily fantasy contests

FantasyPointsYahoonumber nullable

Fantasy points based on Yahoo's daily fantasy scoring system by the player in the game

InjuryStatusstring nullable

The player's current injury status; in the form of likelihood that player plays (Probable; Questionable; Doubtful; Out)

InjuryBodyPartstring nullable

The body part that is injured for the player (Knee; Groin; Calf; Hamstring; etc.)

InjuryStartDatestring nullable

The day that the player's injury started or was first discovered

InjuryNotesstring nullable

A brief description of the player's injury and expected availability

FanDuelPositionstring nullable

The player's eligible position in FanDuel's daily fantasy sports platform.

DraftKingsPositionstring nullable

The player's eligible position in DraftKings' daily fantasy sports platform.

YahooPositionstring nullable

The player's eligible position in Yahoo's daily fantasy sports platform

OpponentRankinteger nullable

The ranking of the player's opponent with regards to fantasy points allowed.

OpponentPositionRankinteger nullable

The ranking of the player's opponent by position with regards to fantasy points allowed.

InjuryPracticestring nullable

This field is deprecated

InjuryPracticeDescriptionstring nullable

This field is deprecated

DeclaredInactiveboolean

Whether the player has been declared inactive. This value is updated in the hours leading up to game start time; as teams announce their inactive players. Note: This is only updated for offensive skill position players (QB; RB; WR; TE)

FantasyDraftSalaryinteger nullable

The player's salary for FantasyDraft daily fantasy contests.

FantasyDraftPositionstring nullable

The player's eligible position in FantasyDraft's daily fantasy sports platform.

TeamIDinteger nullable

The unique ID of the team that the player is on. Note: if the player is a free agent; this field is NULL

OpponentIDinteger nullable

The unique ID of this opponent team

Daystring nullable

The date of the game (in US Eastern Time)

DateTimestring nullable

The date and time of the game (in US Eastern Time)

GlobalGameIDinteger nullable

A globally unique ID for this game. This value is guaranteed to be unique across all sports/leagues

GlobalTeamIDinteger nullable

A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues

GlobalOpponentIDinteger nullable

A globally unique ID for this opposing team. This value is guaranteed to be unique across all sports/leagues.

ScoreIDinteger

Unique ID of the score/game

FantasyPointsFantasyDraftnumber nullable

This field is no longer in use and will return null.

OffensiveFumbleRecoveryTouchdownsnumber nullable

This field is deprecated

SnapCountsConfirmedboolean nullable

Whether snap count fields are confirmed (true/false). Note: This takes place the morning after the game.

Updatedstring nullable

Time of last update (in US Eastern time). Note: this does not indicate that stats changed.

Changes

No recorded changes to this operation across all 2 revisions of this API.