Skip to content

Griddy SDK Python

PFR Models

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.

OtherSportLink ¶

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.