--- title: "Projected Player Game Stats - by Week" method: GET path: "/v3/nfl/projections/{format}/PlayerGameProjectionStatsByWeek/{season}/{week}" tags: ["NFL v3 Projections"] --- # Projected Player Game Stats - by Week `GET /v3/nfl/projections/{format}/PlayerGameProjectionStatsByWeek/{season}/{week}` ## Request - Base URL: `https://api.sportsdata.io` - URL: `https://api.sportsdata.io/v3/nfl/projections/{format}/PlayerGameProjectionStatsByWeek/{season}/{week}` - Auth: one of: - API key in header `Ocp-Apim-Subscription-Key` - API key in query parameter `key` - TypeScript: (a function with typed inputs; its response is checked against the schema) SportsDataIO's proprietary projections, including DFS salary information and injuries, for fantasy players, called by week. ## Path parameters - `format` 'JSON' | 'XML', required - `season` string, required - `week` string, required ## Response `200` Success - PlayerGameProjection[] - `GameKey` string, 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 - `PlayerID` integer, nullable: The unique PlayerID of the player as assigned by SportsDataIO. Note: this ID will stay with the player throughout their entire career - `SeasonType` integer: The type of season that this player corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star) - `Season` integer: The NFL season of the game - `GameDate` string, nullable: The date and time the game is scheduled to start - `Week` integer: 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 - `Team` string, nullable: The abbreviation [Key] of the team that the player is on. Note: if this player is a free agent; this field is NULL - `Opponent` string, nullable: The abbreviation [Key] of the opponent team - `HomeOrAway` string, nullable: Whether the team is home or away - `Number` integer: Player's jersey number - `Name` string, nullable: Player's full name - `Position` string, 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 - `PositionCategory` string, nullable: The category of the player's position (OFF; DEF; ST) - `Activated` integer: Whether or not the player was active for the game - `Played` integer: 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 - `Started` integer: Whether the player started the game (on offensive or defense). Note: Started = 1 / Did Not Start = 0 - `PassingAttempts` number: Total passes thrown by the player in the game - `PassingCompletions` number: Total passes completed by the player in the game - `PassingYards` number: Total passing yards by the player in the game - `PassingCompletionPercentage` number: The percentage of passes completed by the player in the game - `PassingYardsPerAttempt` number: Total average passing yards per attempt by the player in the game - `PassingYardsPerCompletion` number: Total average passing yards per completion by the player in the game - `PassingTouchdowns` number: Total passing touchdowns by the player in the game - `PassingInterceptions` number: Total interceptions thrown by the player in the game - `PassingRating` number: The passer rating of the player in the game - `PassingLong` number: Total yards of longest completion by the player in the game - `PassingSacks` number: The total number of times the player was sacked in the game - `PassingSackYards` number: Total yards lost by the player in the game as a result of being sacked - `RushingAttempts` number: Total rushing attempts by the player in the game - `RushingYards` number: Total rushing yards by the player in the game - `RushingYardsPerAttempt` number: Total rushing yards per attempt by the player in the game - `RushingTouchdowns` number: Total rushing touchdowns by the player in the game - `RushingLong` number: The longest rush by the player in the game - `ReceivingTargets` number, nullable: Total receiving targets by the player in the game - `Receptions` number: Total receptions by the player in the game - `ReceivingYards` number: Total receiving yards by the player in the game - `ReceivingYardsPerReception` number: Average receiving yards per reception by the player in the game - `ReceivingTouchdowns` number: Total receiving touchdowns by the player in the game - `ReceivingLong` number: The longest reception by the player in the game - `Fumbles` number: Total fumbles by the player in the game - `FumblesLost` number, nullable: Total fumbles lost by the player in the game - `PuntReturns` number: Total punt returns by the player in the game - `PuntReturnYards` number: Total punt return yards by the player in the game - `PuntReturnYardsPerAttempt` number: Total average yards gained per punt return by the player in the game - `PuntReturnTouchdowns` number: Total punt return touchdowns by the player in the game - `PuntReturnLong` number: The longest punt return by the player in the game - `KickReturns` number: Total kickoff returns by the player in the game - `KickReturnYards` number: Total kickoff return yards by the player in the game - `KickReturnYardsPerAttempt` number: Average yards gained per kick return by the player in the game - `KickReturnTouchdowns` number: Total kickoff return touchdowns by the player in the game - `KickReturnLong` number: Longest kick return by the player in the game - `SoloTackles` number: Total defensive solo (unassisted) tackles by the player in the game - `AssistedTackles` number: Total defensive assisted tackles by the player in the game - `TacklesForLoss` number, 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) - `Sacks` number: Total defensive sacks by the player in the game - `SackYards` number: Total defensive sacks yards by the player in the game - `QuarterbackHits` number, nullable: Total quarterback hits by the player in the game. Note: This is a defensive stat that includes sacks - `PassesDefended` number: Total passes defended by the player in the game - `FumblesForced` number: Total fumbles forced on defense by the player in the game - `FumblesRecovered` number: Total defensive fumble recoveries by the player in the game - `FumbleReturnYards` number: Total fumble return yards by the player in the game - `FumbleReturnTouchdowns` number: Total fumble return touchdowns by the player in the game - `Interceptions` number: Total defensive interceptions by the player in the game - `InterceptionReturnYards` number: Total defensive interception return yards by the player in the game - `InterceptionReturnTouchdowns` number: Total defensive interception return touchdowns by the player in the game - `BlockedKicks` number: Total blocked kicks by the player in the game. Note: BlockedKicks include Field Goals and Punts but NOT Extra Points - `SpecialTeamsSoloTackles` number: This field is deprecated - `SpecialTeamsAssistedTackles` number: This field is deprecated - `MiscSoloTackles` number: This field is deprecated - `MiscAssistedTackles` number: This field is deprecated - `Punts` number: Total number of punts by the player in the game - `PuntYards` number: Total punt yards by the player in the game - `PuntAverage` number: The average number of yards per punt by the player in the game - `FieldGoalsAttempted` number: Total field goals attempted by the player in the game - `FieldGoalsMade` number: Total field goals made by the player in game - `FieldGoalsLongestMade` number: Longest field goal made by the player in the game - `ExtraPointsMade` number: Total extra points made by the player in the game - `TwoPointConversionPasses` number: Total successful two point conversion passes by the player in the game - `TwoPointConversionRuns` number: Total successful two point conversion rushes by the player in the game - `TwoPointConversionReceptions` number: Total successful two point conversion receptions by the player in the game - `FantasyPoints` number: Fantasy points scored based on basic fantasy scoring system by the player in the game - `FantasyPointsPPR` number: This field is expected to be NULL - `ReceptionPercentage` number: Total percentage of receiving targets that were receptions by the player in the game - `ReceivingYardsPerTarget` number: Average receiving yards per target by the player in the game - `Tackles` number: Total tackles (solo & assisted) by the player in the game - `OffensiveTouchdowns` number: Total offensive touchdowns scored by the player in the game - `DefensiveTouchdowns` number: Total defensive touchdowns scored by the player in the game - `SpecialTeamsTouchdowns` number: Total special teams touchdowns scored by the player in the game - `Touchdowns` number: Total touchdowns scored by the player in the game (excludes passing touchdowns) - `FantasyPosition` string, nullable: The player's fantasy football position. Possible values: QB; RB; WR; TE; DL; LB; DB; K; P; OL - `FieldGoalPercentage` number: Total field goal attempts made by the player in the game - `PlayerGameID` integer: Unique ID of PlayerGame record (subject to change, although it very rarely does). For a static ID, use a combination of GameKey and PlayerID. - `FumblesOwnRecoveries` number, 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 - `FumblesOutOfBounds` number, nullable: This field is deprecated - `KickReturnFairCatches` number, nullable: This field is deprecated - `PuntReturnFairCatches` number, nullable: This field is deprecated - `PuntTouchbacks` number, nullable: Total punts that resulted in touchbacks by the player in the game - `PuntInside20` number, nullable: Total punts downed inside the 20 yard line by the player in the game - `PuntNetAverage` number, nullable: The average net yards per punt by the player in the game - `ExtraPointsAttempted` number, nullable: Total extra point kicks attempted by the player in the game - `BlockedKickReturnTouchdowns` number, nullable: Total blocked kick recovery return touchdowns for the player in the game - `FieldGoalReturnTouchdowns` number, nullable: Total field goal return touchdowns by the player in the game. Note: This field excludes blocked field goals - `Safeties` number, nullable: Total defensive safeties scored by the player in the game - `FieldGoalsHadBlocked` number, nullable: Total field goals by the player that were blocked in the game - `PuntsHadBlocked` number, nullable: Total punts by the player that were blocked in the game - `ExtraPointsHadBlocked` number, nullable: Total extra point kick attempts by the player that were blocked in the game - `PuntLong` number, nullable: The longest punt by the player in the game - `BlockedKickReturnYards` number, nullable: Total blocked kick recovery return yards for the player in the game - `FieldGoalReturnYards` number, nullable: Total field goal return yards by the player in the game. Note: This field excludes blocked field goals - `PuntNetYards` number, nullable: The net yards of the punts by the player in the game - `SpecialTeamsFumblesForced` number, nullable: This field is deprecated - `SpecialTeamsFumblesRecovered` number, nullable: This field is deprecated - `MiscFumblesForced` number, nullable: This field is deprecated - `MiscFumblesRecovered` number, nullable: This field is deprecated - `ShortName` string, nullable: The first initial and last name of the player (J. Doe) - `PlayingSurface` string, nullable: The playing surface of the stadium - `IsGameOver` boolean, nullable: Whether the game is over (true/false) - `SafetiesAllowed` number, nullable: This field is deprecated - `Stadium` string, nullable: Stadium of the event - `Temperature` integer, nullable: Temperature at game start (Fahrenheit) - `Humidity` integer, nullable: The humidity percentage at the start of the game - `WindSpeed` integer, nullable: The wind speed at the start of the game (in MPH) - `FanDuelSalary` integer, nullable: The player's salary for FanDuel daily fantasy contests. - `DraftKingsSalary` integer, nullable: The player's salary for DraftKings daily fantasy contests. - `FantasyDataSalary` integer, nullable: The player's salary as calculated by SportsDataIO (formerly known as FantasyData). Based on the same salary cap as DraftKings contests ($50,000). - `OffensiveSnapsPlayed` integer, nullable: Total snaps this player played on offense in the game. Note: Snap counts are available the morning after the game. - `DefensiveSnapsPlayed` integer, nullable: Total snaps this player played on defense in the game. Note: Snap counts are available the morning after the game. - `SpecialTeamsSnapsPlayed` integer, nullable: Total snaps this player played on special teams in the game. Note: Snap counts are available the morning after the game. - `OffensiveTeamSnaps` integer, nullable: Total offensive snaps this player's team played in the game. Note: Snap counts are available the morning after the game. - `DefensiveTeamSnaps` integer, nullable: Total defensive snaps this player's team played in the game. Note: Snap counts are available the morning after the game. - `SpecialTeamsTeamSnaps` integer, nullable: Total special teams snaps this player's team played in the game. Note: Snap counts are available the morning after the game. - `VictivSalary` integer, nullable: The player's salary for Victiv daily fantasy contests. - `TwoPointConversionReturns` number, nullable: Total successful two point conversion returns by the player in the game - `FantasyPointsFanDuel` number, nullable: Fantasy points based on FanDuel's scoring system by the player in the game - `FieldGoalsMade0to19` number, nullable: Total field goals of 0 to 19 yards made by the player in game - `FieldGoalsMade20to29` number, nullable: Total field goals of 20 to 29 yards made by the player in game - `FieldGoalsMade30to39` number, nullable: Total field goals of 30 to 39 yards made by the player in game - `FieldGoalsMade40to49` number, nullable: Total field goals of 40 to 49 yards made by the player in game - `FieldGoalsMade50Plus` number, nullable: Total field goals of 50+ yards made by the player in game - `FantasyPointsDraftKings` number, nullable: Fantasy points based on DraftKings' scoring system by the player in the game - `YahooSalary` integer, nullable: The player's salary for Yahoo daily fantasy contests - `FantasyPointsYahoo` number, nullable: Fantasy points based on Yahoo's daily fantasy scoring system by the player in the game - `InjuryStatus` string, nullable: The player's current injury status; in the form of likelihood that player plays (Probable; Questionable; Doubtful; Out) - `InjuryBodyPart` string, nullable: The body part that is injured for the player (Knee; Groin; Calf; Hamstring; etc.) - `InjuryStartDate` string, nullable: The day that the player's injury started or was first discovered - `InjuryNotes` string, nullable: A brief description of the player's injury and expected availability - `FanDuelPosition` string, nullable: The player's eligible position in FanDuel's daily fantasy sports platform. - `DraftKingsPosition` string, nullable: The player's eligible position in DraftKings' daily fantasy sports platform. - `YahooPosition` string, nullable: The player's eligible position in Yahoo's daily fantasy sports platform - `OpponentRank` integer, nullable: The ranking of the player's opponent with regards to fantasy points allowed. - `OpponentPositionRank` integer, nullable: The ranking of the player's opponent by position with regards to fantasy points allowed. - `InjuryPractice` string, nullable: This field is deprecated - `InjuryPracticeDescription` string, nullable: This field is deprecated - `DeclaredInactive` boolean: 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) - `FantasyDraftSalary` integer, nullable: The player's salary for FantasyDraft daily fantasy contests. - `FantasyDraftPosition` string, nullable: The player's eligible position in FantasyDraft's daily fantasy sports platform. - `TeamID` integer, nullable: The unique ID of the team that the player is on. Note: if the player is a free agent; this field is NULL - `OpponentID` integer, nullable: The unique ID of this opponent team - `Day` string, nullable: The date of the game (in US Eastern Time) - `DateTime` string, nullable: The date and time of the game (in US Eastern Time) - `GlobalGameID` integer, nullable: A globally unique ID for this game. This value is guaranteed to be unique across all sports/leagues - `GlobalTeamID` integer, nullable: A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues - `GlobalOpponentID` integer, nullable: A globally unique ID for this opposing team. This value is guaranteed to be unique across all sports/leagues. - `ScoreID` integer: Unique ID of the score/game - `FantasyPointsFantasyDraft` number, nullable: This field is no longer in use and will return null. - `ScoringDetails` ScoringDetail[]: The details of the scoring plays this player recorded in the game - `GameKey` string, 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 - `SeasonType` integer: The type of season that this game corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star) - `PlayerID` integer, nullable: The unique PlayerID of the player as assigned by SportsDataIO tied to this scoring detail. Note: this ID will stay with the player throughout their entire career - `Team` string, nullable: The abbreviation [Key] of the team - `Season` integer: The season during which the score happened - `Week` integer: 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 - `ScoringType` string, nullable: The type of scoring play (e.g. BlockedFieldGoalReturnTouchdown, BlockedPuntReturnTouchdown, FieldGoalMade, FieldGoalReturnTouchdown, FumbleReturnTouchdown, InterceptionReturnTouchdown, KickoffReturnTouchdown, PassingTouchdown, PuntReturnTouchdown, ReceivingTouchdown, RushingTouchdown, Safety) - `Length` integer: The length in yards of the score - `ScoringDetailID` integer: Unique ID of this scoring detail - `PlayerGameID` integer: Unique ID of the PlayerGame record tied to this scoring detail - `ScoreID` integer, nullable: Unique ID of the score/game - `ScoringPlayID` integer, nullable: Unique ID of the scoring play - `OffensiveFumbleRecoveryTouchdowns` number, nullable: This field is deprecated - `SnapCountsConfirmed` boolean, nullable: Whether snap count fields are confirmed (true/false). Note: This takes place the morning after the game. - `Updated` string, nullable: Time of last update (in US Eastern time). Note: this does not indicate that stats changed. ## Other responses - `401`: Unauthorized --- [API](https://skmtc.dev/sportsdata/apis/nfl-api.md) - [All operations](https://skmtc.dev/sportsdata/apis/nfl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sportsdata/apis/nfl-api/revisions/2dca8b6e9675?raw)