Skip to content

PFR Models

models

PFRBaseModel

Bases: BaseModel

Base model for all PFR entity models.

Provides a before model validator that converts empty dict values to None for any Optional field whose annotation includes a model (i.e. nested object) type. This handles the common HTML-scraping artifact where a missing nested object is parsed as {} rather than None.

AwardHistory

Bases: PFRBaseModel

Top-level result for a PFR award history page.

AwardWinner

Bases: PFRBaseModel

A single award winner row from an award history page.

HallOfFame

Bases: PFRBaseModel

Top-level result for the PFR Hall of Fame page.

HofPlayer

Bases: PFRBaseModel

A single Hall of Fame inductee with career statistics.

ProBowlPlayer

Bases: PFRBaseModel

A single Pro Bowl roster entry with season statistics.

ProBowlRoster

Bases: PFRBaseModel

Top-level result for a PFR Pro Bowl roster page.

BirthdayPlayer

Bases: PFRBaseModel

A single player entry from the birthdays table.

Birthdays

Bases: PFRBaseModel

Top-level result for the PFR birthdays page.

BirthplaceFiltered

Bases: PFRBaseModel

Top-level result for a filtered birthplaces page.

BirthplaceLanding

Bases: PFRBaseModel

Top-level result for the birthplaces landing page.

BirthplaceLocation

Bases: PFRBaseModel

A country/state row from the birthplaces landing page.

BirthplacePlayer

Bases: PFRBaseModel

A player born in the filtered location with career statistics.

ChallengeResult

Bases: PFRBaseModel

A single challenge result from the challenge_results table.

CoachBio

Bases: PFRBaseModel

Biographical info from the coach profile meta panel.

CoachingHistoryEntry

Bases: PFRBaseModel

A single row from the coaching_history table.

CoachingRank

Bases: PFRBaseModel

A single season row from the coaching_ranks table.

CoachingResult

Bases: PFRBaseModel

A single season row from the coaching_results table.

CoachingResultTotal

Bases: PFRBaseModel

A summary total row from the coaching_results table footer.

CoachingTreeEntry

Bases: PFRBaseModel

A coaching tree entry (worked-for or employed relationship).

CoachProfile

Bases: PFRBaseModel

Top-level model for a PFR coach profile page.

CoffeeEntry

Bases: PFRBaseModel

A single player who played only one NFL game.

CupsOfCoffee

Bases: PFRBaseModel

Parsed result of the PFR 'Cups of Coffee' page.

CombineEntry

Bases: PFRBaseModel

A single player row from the NFL Combine results page.

CombineResults

Bases: PFRBaseModel

Top-level result for a PFR NFL Combine page.

DraftPick

Bases: PFRBaseModel

A single draft pick row from a year draft page.

TeamDraft

Bases: PFRBaseModel

Top-level result for a PFR team draft history page.

TeamDraftPick

Bases: PFRBaseModel

A single draft pick row from a team draft history page.

YearDraft

Bases: PFRBaseModel

Top-level result for a PFR annual draft page.

ExecutiveBio

Bases: PFRBaseModel

Biographical info from the executive profile meta panel.

ExecutiveProfile

Bases: PFRBaseModel

Top-level model for a PFR executive profile page.

ExecutiveResult

Bases: PFRBaseModel

A single season row from the exec_results table.

ExecutiveResultsTotal

Bases: PFRBaseModel

A summary total row from the exec_results table footer.

FantasyMatchupPlayer

Bases: PFRBaseModel

A single player row from a fantasy matchups page.

FantasyMatchups

Bases: PFRBaseModel

Top-level result for a PFR fantasy matchups page.

FantasyPlayer

Bases: PFRBaseModel

A single player row from the top fantasy players table.

FantasyPointsAllowed

Bases: PFRBaseModel

Top-level result for a PFR fantasy points allowed page.

FantasyPointsAllowedTeam

Bases: PFRBaseModel

A single team row from the fantasy points allowed page.

RedZonePassing

Bases: PFRBaseModel

Top-level result for the PFR red zone passing page.

RedZonePassingPlayer

Bases: PFRBaseModel

A single player row from the red zone passing stats page.

RedZoneReceiving

Bases: PFRBaseModel

Top-level result for the PFR red zone receiving page.

RedZoneReceivingPlayer

Bases: PFRBaseModel

A single player row from the red zone receiving stats page.

RedZoneRushing

Bases: PFRBaseModel

Top-level result for the PFR red zone rushing page.

RedZoneRushingPlayer

Bases: PFRBaseModel

A single player row from the red zone rushing stats page.

TopFantasyPlayers

Bases: PFRBaseModel

Top-level result for the PFR top fantasy players page.

Drive

Bases: PFRBaseModel

A single drive summary with start time, plays, yards, and result.

ExpectedPoints

Bases: PFRBaseModel

Expected points added breakdown for a team in a game.

GameDetails

Bases: PFRBaseModel

Top-level model for a full PFR game boxscore page.

LinescoreEntry

Bases: PFRBaseModel

A single team's quarter-by-quarter scoring line.

PlayerDefense

Bases: PFRBaseModel

Individual player defensive stats from a game boxscore.

PlayerKicking

Bases: PFRBaseModel

Individual player kicking and punting stats from a game boxscore.

PlayerOffense

Bases: PFRBaseModel

Individual player offensive stats from a game boxscore.

PlayerReturn

Bases: PFRBaseModel

Individual player kick and punt return stats from a game boxscore.

Scorebox

Bases: PFRBaseModel

Combined scorebox with away team, home team, and game metadata.

ScoreboxMeta

Bases: PFRBaseModel

Game metadata from the scorebox (date, stadium, attendance, duration).

ScoreboxTeam

Bases: PFRBaseModel

Team info within the scorebox header (name, score, record, coach).

ScoringPlay

Bases: PFRBaseModel

A single scoring play with quarter, time, and description.

SnapCount

Bases: PFRBaseModel

Snap count totals and percentages for a player by phase of play.

Starter

Bases: PFRBaseModel

A starting player entry with position.

LastUndefeated

Bases: PFRBaseModel

Parsed result of the PFR last-undefeated-team page.

LastUndefeatedEntry

Bases: PFRBaseModel

A single last-undefeated-team row.

Leaderboard

Bases: PFRBaseModel

Top-level result for a PFR leaderboard page.

LeaderEntry

Bases: PFRBaseModel

A single player row from a career/season/game leaders table.

MultiSportPlayer

Bases: PFRBaseModel

A single athlete who played multiple sports professionally.

MultiSportPlayers

Bases: PFRBaseModel

Parsed result of the PFR 'Multisport Athletes' page.

Bases: PFRBaseModel

A link to another sports reference site for a multi-sport athlete.

MultiTeamPlayers

Bases: PFRBaseModel

Top-level result for the PFR multi-team players page.

MultiTeamPlayerStats

Bases: PFRBaseModel

A player row in a multi-team stats table with arbitrary stat columns.

StatsTable

Bases: PFRBaseModel

A single stat-category table of multi-team players.

TopPlayerSummary

Bases: PFRBaseModel

Brief summary of a notable multi-team player.

NonQBPasserEntry

Bases: PFRBaseModel

A single non-QB passer entry with passing statistics.

NonQBPassers

Bases: PFRBaseModel

Parsed result of the PFR non-QB passers page.

NonSkillPosTdEntry

Bases: PFRBaseModel

A single game instance of a non-skill position player scoring a TD.

NonSkillPosTdScorers

Bases: PFRBaseModel

Parsed result of the PFR non-skill position TD scorers page.

OctopusEntry

Bases: PFRBaseModel

A single game instance of an octopus (TD + 2pt conversion).

OctopusTracker

Bases: PFRBaseModel

Parsed result of the PFR octopus tracker page.

OfficialBio

Bases: PFRBaseModel

Biographical info from the official profile meta panel.

OfficialGame

Bases: PFRBaseModel

A single game row from the official's game log.

OfficialProfile

Bases: PFRBaseModel

Top-level model for a PFR game official profile page.

OfficialSeasonStat

Bases: PFRBaseModel

A single season row from the official_stats table.

OvertimeTieEntry

Bases: PFRBaseModel

A single overtime tie game.

OvertimeTies

Bases: PFRBaseModel

Parsed result of the PFR overtime ties page.

BirthPlace

Bases: PFRBaseModel

City and state of a player's birth.

DraftInfo

Bases: PFRBaseModel

Draft selection details (team, round/overall, and year).

JerseyNumber

Bases: PFRBaseModel

A jersey number worn by the player for a team and year range.

PlayerBio

Bases: PFRBaseModel

Biographical information from the player profile meta panel.

PlayerNames

Bases: PFRBaseModel

Parsed player name components (first, middle, last, suffix, nicknames).

PlayerProfile

Bases: PFRBaseModel

Top-level model for a full PFR player profile page.

PlayerStatistics

Bases: PFRBaseModel

Regular-season and post-season stat tables keyed by category.

RoundAndOverall

Bases: PFRBaseModel

Draft round and overall pick number.

Transaction

Bases: PFRBaseModel

A roster transaction (signing, trade, release, etc.) with date.

PlayerBornBefore

Bases: PFRBaseModel

A single active player born on or before the queried date.

PlayersBornBefore

Bases: PFRBaseModel

Top-level result for the PFR players-born-before page.

PronunciationEntry

Bases: PFRBaseModel

A single player name with its phonetic pronunciation.

PronunciationGuide

Bases: PFRBaseModel

Parsed result of the PFR 'Pronunciation Guide' page.

QBWinEntry

Bases: PFRBaseModel

A quarterback with the number of franchises beaten and unbeaten list.

QBWins

Bases: PFRBaseModel

Top-level result for the PFR QB wins vs. each franchise page.

ScheduleGame

Bases: PFRBaseModel

A single game entry from the PFR season schedule table.

College

Bases: PFRBaseModel

A single college row from the all player colleges table.

CollegeList

Bases: PFRBaseModel

Top-level result for the PFR all player colleges page.

HighSchool

Bases: PFRBaseModel

A single high school row from the high schools table.

HighSchoolList

Bases: PFRBaseModel

Top-level result for the PFR high schools page.

ConferenceStanding

Bases: PFRBaseModel

A single team row from the AFC or NFC standings table.

PlayoffGame

Bases: PFRBaseModel

A single playoff game from the playoff_results table.

PlayoffStanding

Bases: PFRBaseModel

A team's playoff qualification entry with seed reasoning.

SeasonOverview

Bases: PFRBaseModel

Top-level model for a PFR season overview page.

SeasonStats

Bases: PFRBaseModel

Top-level result for a PFR season stat category page.

WeekGame

Bases: PFRBaseModel

A single game from a weekly schedule page.

WeekSummary

Bases: PFRBaseModel

Top-level result for a PFR weekly schedule page.

Security

Bases: PFRBaseModel

Bearer-token authentication model for the PFR SDK.

StadiumBestGame

Bases: PFRBaseModel

A best individual game performance at the stadium.

StadiumBio

Bases: PFRBaseModel

Stadium metadata from the profile meta panel.

StadiumGameLeader

Bases: PFRBaseModel

A stat leader within a notable game summary.

StadiumGameSummary

Bases: PFRBaseModel

A notable game at the stadium with score and stat leaders.

StadiumLeader

Bases: PFRBaseModel

A career statistical leader at the stadium.

StadiumProfile

Bases: PFRBaseModel

Top-level model for a PFR stadium profile page.

StadiumTeam

Bases: PFRBaseModel

A team that played at the stadium with their record there.

StandingsOnDate

Bases: PFRBaseModel

Parsed result of the PFR standings-on-date page.

StandingsTeamEntry

Bases: PFRBaseModel

A single team's standing on the queried date.

CareerLeader

Bases: PFRBaseModel

An all-time career leader for a particular statistic.

MilestoneEntry

Bases: PFRBaseModel

A player approaching a statistical milestone with current value and amount needed.

StatisticalMilestones

Bases: PFRBaseModel

Top-level result for a PFR statistical milestones page.

SuperBowlGame

Bases: PFRBaseModel

A single Super Bowl game entry from the history table.

SuperBowlHistory

Bases: PFRBaseModel

Top-level result for the PFR Super Bowl history page.

SuperBowlLeaderEntry

Bases: PFRBaseModel

A single player row from a Super Bowl leader table.

SuperBowlLeaders

Bases: PFRBaseModel

Top-level result for the PFR Super Bowl leaders page.

SuperBowlLeaderTable

Bases: PFRBaseModel

A single leaderboard table for a Super Bowl stat category.

SuperBowlQB

Bases: PFRBaseModel

A quarterback's Super Bowl record within a franchise standing.

SuperBowlStanding

Bases: PFRBaseModel

A single franchise row from the Super Bowl standings table.

SuperBowlStandings

Bases: PFRBaseModel

Top-level result for the PFR Super Bowl standings page.

Franchise

Bases: PFRBaseModel

Top-level model for a PFR team franchise page.

FranchiseLeader

Bases: PFRBaseModel

An all-time franchise leader in a stat category.

FranchiseMeta

Bases: PFRBaseModel

Franchise-level metadata including records and all-time leaders.

FranchiseSeasonRecord

Bases: PFRBaseModel

A single season row from the franchise team_index table.

SeasonGame

Bases: PFRBaseModel

A single game row from the team's season game log.

TeamSeason

Bases: PFRBaseModel

Top-level model for a PFR team season page.

TeamSeasonMeta

Bases: PFRBaseModel

Season-level metadata for a team (record, coaches, stadium, etc.).

UniformNumberPlayer

Bases: PFRBaseModel

A player who wore the queried uniform number.

UniformNumbers

Bases: PFRBaseModel

Top-level result for a PFR uniform numbers page.

UpcomingLeaderboardEntry

Bases: PFRBaseModel

A career leader entry with a link to the full leaderboard.

UpcomingMilestoneEntry

Bases: PFRBaseModel

A player approaching an upcoming statistical milestone.

UpcomingMilestones

Bases: PFRBaseModel

Top-level result for a PFR upcoming milestones page.