Punting
Enriched punt plays and player and team punting production.
Returns enriched punt plays with gross, return, and net yardage, field position, and punt outcomes.
query Parameters
gameIdGame ID.
yearSeason year. Required unless gameId is specified.
weekWeek number. Either week, a team filter, punterId, or returnerId is required with year.
seasonTypeSeason type.
teamTeam name on either side of the punt.
puntingTeamPunting team name.
receivingTeamReceiving team name.
conferenceConference name or abbreviation on either side of the punt.
punterIdPunter athlete ID.
returnerIdReturner athlete ID.
classificationDivision classification. Defaults to fbs.
Responses
Ok
gameIdplayIddriveIdseasonweekseasonTypepuntingTeamIdpuntingTeampuntingConferencereceivingTeamIdreceivingTeamreceivingConferenceperioddowndistanceplayTypeplayTextpunterIdpunterreceiverIdreceiverreturnerIdreturnerblockerIdblockercountsAsPuntWhether the play counts as a punt; null when unknown.
countsAsReturnWhether the play counts as a punt return; null when unknown.
startYardsToGoalpuntYardsGross punt yards.
returnYardsReturn yards for the receiving team.
returnerYardsReturn yards credited to the returner; null when not credited individually.
netPuntYardsGross punt yards minus return yards, less 20 yards for a touchback.
kickEndYardlineWhere the kick ended, from the punting team's goal line (0) to the receiving team's goal line (100).
endYardlineWhere the play ended, on the same scale as kickEndYardline.
isTouchbackisFairCatchisOutOfBoundsisDownedisBlockedisMuffedisReturnTouchdownisReceivingTeamTurnoverThe receiving team lost possession, such as on a muff or fumble.
hasPenaltyparseStatusReturns individually attributed punting and punt return production by season.
Player totals do not include team-only or unattributed punts and returns, and therefore are not expected to sum to team totals.
query Parameters
yearSeason year. Required.
seasonTypeSeason type.
teamTeam name.
conferenceConference name or abbreviation.
playerIdPlayer athlete ID.
classificationDivision classification. Defaults to fbs.
Responses
Ok
seasonplayerIdplayerteamconferenceProduction on punts kicked by a player.
Production on punts fielded, returned, or blocked by a player.
Returns individually attributed punting and punt return production by game.
Player totals do not include team-only or unattributed punts and returns, and therefore are not expected to sum to team totals.
query Parameters
yearSeason year. Required.
weekWeek number.
seasonTypeSeason type.
teamTeam name.
conferenceConference name or abbreviation.
playerIdPlayer athlete ID.
classificationDivision classification. Defaults to fbs.
Responses
Ok
gameIdseasonweekseasonTypeplayerIdplayerteamconferenceopponentProduction on punts kicked by a player.
Production on punts fielded, returned, or blocked by a player.
Returns team punting and punt return production by season.
Punting describes the team's punts. Returning describes opponent punts and the team's returns.
query Parameters
yearSeason year. Required.
seasonTypeSeason type.
teamTeam name.
conferenceConference name or abbreviation.
classificationDivision classification. Defaults to fbs.
Responses
Ok
seasonteamconferenceProduction on a team's punts. On the returning side, punt and net yards describe opponent punts.
Production on a team's punts. On the returning side, punt and net yards describe opponent punts.
Returns team punting and punt return production by game.
Punting describes the team's punts. Returning describes opponent punts and the team's returns.
query Parameters
yearSeason year. Required.
weekWeek number.
seasonTypeSeason type.
teamTeam name.
conferenceConference name or abbreviation.
classificationDivision classification. Defaults to fbs.
Responses
Ok
gameIdseasonweekseasonTypeteamconferenceopponentProduction on a team's punts. On the returning side, punt and net yards describe opponent punts.
Production on a team's punts. On the returning side, punt and net yards describe opponent punts.