Player Receiving Stats¶

griddy / nfl / models / entities / player_receiving_stats**

player_receiving_stats ¶

Attributes¶

Classes¶

PlayerReceivingStatsTypedDict ¶

Bases: TypedDict


              flowchart TD
              griddy.nfl.models.entities.player_receiving_stats.PlayerReceivingStatsTypedDict[PlayerReceivingStatsTypedDict]

              

              click griddy.nfl.models.entities.player_receiving_stats.PlayerReceivingStatsTypedDict href "" "griddy.nfl.models.entities.player_receiving_stats.PlayerReceivingStatsTypedDict"

Attributes¶

display_name `instance-attribute` ¶

display_name: str

Player's full name

gp `instance-attribute` ¶

gp: int

Games played

gs `instance-attribute` ¶

gs: int

Games started

nfl_id `instance-attribute` ¶

nfl_id: str

NFL player identifier

position `instance-attribute` ¶

position: OffensivePlayerPositionEnum

Offensive skill position (excluding QB)

rec `instance-attribute` ¶

rec: int

Receptions

rt `instance-attribute` ¶

rt: int

Routes run

td `instance-attribute` ¶

td: int

Touchdown receptions

team_id `instance-attribute` ¶

team_id: str

Team identifier

tgt `instance-attribute` ¶

tgt: int

Targets

yds `instance-attribute` ¶

yds: int

Receiving yards

avg_rt_dep `instance-attribute` ¶

avg_rt_dep: NotRequired[float]

Average route depth (yards)

avg_sep `instance-attribute` ¶

avg_sep: NotRequired[float]

Average receiver separation at target (yards)

ay `instance-attribute` ¶

ay: NotRequired[float]

Air yards

ay_pg `instance-attribute` ¶

ay_pg: NotRequired[float]

Air yards per game

ay_tgt `instance-attribute` ¶

ay_tgt: NotRequired[float]

Air yards per target

catch `instance-attribute` ¶

catch: NotRequired[float]

Catch rate (0-1)

croe `instance-attribute` ¶

croe: NotRequired[float]

Catch Rate Over Expected

deep_tgt_pct `instance-attribute` ¶

deep_tgt_pct: NotRequired[float]

Deep target percentage (20+ air yards)

drop `instance-attribute` ¶

drop: NotRequired[int]

Dropped passes

drop_pg `instance-attribute` ¶

drop_pg: NotRequired[float]

Drops per game

drop_tgt `instance-attribute` ¶

drop_tgt: NotRequired[float]

Drop rate (0-1)

epa `instance-attribute` ¶

epa: NotRequired[float]

Expected Points Added

epa_pg `instance-attribute` ¶

epa_pg: NotRequired[float]

EPA per game

epa_rt `instance-attribute` ¶

epa_rt: NotRequired[float]

EPA per route run

epa_tgt `instance-attribute` ¶

epa_tgt: NotRequired[float]

EPA per target

ez_rec `instance-attribute` ¶

ez_rec: NotRequired[int]

End zone receptions

ez_rec_pg `instance-attribute` ¶

ez_rec_pg: NotRequired[float]

End zone receptions per game

ez_tgt `instance-attribute` ¶

ez_tgt: NotRequired[int]

End zone targets

ez_tgt_pg `instance-attribute` ¶

ez_tgt_pg: NotRequired[float]

End zone targets per game

fapi_game_id `instance-attribute` ¶

fapi_game_id: NotRequired[str]

Football API game identifier

final_score `instance-attribute` ¶

final_score: NotRequired[str]

Final score of the game

game_id `instance-attribute` ¶

game_id: NotRequired[int]

Game identifier (10-digit format YYYYMMDDNN)

game_result `instance-attribute` ¶

game_result: NotRequired[GameResultEnum]

Game result (Win/Loss/Tie)

headshot `instance-attribute` ¶

headshot: NotRequired[str]

URL to player headshot image (contains formatInstructions placeholder)

int_ `instance-attribute` ¶

int_: NotRequired[int]

Interceptions thrown on targets to this receiver

int_pg `instance-attribute` ¶

int_pg: NotRequired[float]

Interceptions per game

is_home `instance-attribute` ¶

is_home: NotRequired[bool]

Whether player's team was at home

jersey_number `instance-attribute` ¶

jersey_number: NotRequired[int]

Player's jersey number

ngs_position `instance-attribute` ¶

ngs_position: NotRequired[OffensivePlayerPositionEnum]

Offensive skill position (excluding QB)

ngs_position_group `instance-attribute` ¶

ngs_position_group: NotRequired[OffensivePlayerPositionEnum]

Offensive skill position (excluding QB)

opponent_team_id `instance-attribute` ¶

opponent_team_id: NotRequired[str]

Opponent team identifier

position_group `instance-attribute` ¶

position_group: NotRequired[OffensivePlayerPositionEnum]

Offensive skill position (excluding QB)

qr `instance-attribute` ¶

qr: NotRequired[bool]

Qualified receiver status

rating `instance-attribute` ¶

rating: NotRequired[float]

Passer rating when targeting this receiver

rec_pg `instance-attribute` ¶

rec_pg: NotRequired[float]

Receptions per game

rt_pg `instance-attribute` ¶

rt_pg: NotRequired[float]

Routes per game

short_name `instance-attribute` ¶

short_name: NotRequired[str]

Abbreviated player name

td_pg `instance-attribute` ¶

td_pg: NotRequired[float]

Touchdowns per game

tg `instance-attribute` ¶

tg: NotRequired[int]

Team games for player

tgt_pg `instance-attribute` ¶

tgt_pg: NotRequired[float]

Targets per game

tgt_rt `instance-attribute` ¶

tgt_rt: NotRequired[float]

Target rate (targets per route run)

total_tg `instance-attribute` ¶

total_tg: NotRequired[int]

Total team games in period

tw_pct `instance-attribute` ¶

tw_pct: NotRequired[float]

Tight window percentage

week_slug `instance-attribute` ¶

week_slug: NotRequired[str]

Week identifier slug

x_catch `instance-attribute` ¶

x_catch: NotRequired[float]

Expected catch rate (0-1)

x_yac `instance-attribute` ¶

x_yac: NotRequired[float]

Expected yards after catch

x_yac_pg `instance-attribute` ¶

x_yac_pg: NotRequired[float]

Expected YAC per game

yac `instance-attribute` ¶

yac: NotRequired[float]

Yards after catch

yac_pg `instance-attribute` ¶

yac_pg: NotRequired[float]

YAC per game

yac_rec `instance-attribute` ¶

yac_rec: NotRequired[float]

YAC per reception

yacoe `instance-attribute` ¶

yacoe: NotRequired[float]

Yards after catch over expected

yacoe_pg `instance-attribute` ¶

yacoe_pg: NotRequired[float]

YACOE per game

yds_pg `instance-attribute` ¶

yds_pg: NotRequired[float]

Yards per game

yds_rec `instance-attribute` ¶

yds_rec: NotRequired[float]

Yards per reception

yds_rt `instance-attribute` ¶

yds_rt: NotRequired[float]

Yards per route run

PlayerReceivingStats ¶

Bases: BaseModel


              flowchart TD
              griddy.nfl.models.entities.player_receiving_stats.PlayerReceivingStats[PlayerReceivingStats]
              griddy.nfl.types.basemodel.BaseModel[BaseModel]

                              griddy.nfl.types.basemodel.BaseModel --> griddy.nfl.models.entities.player_receiving_stats.PlayerReceivingStats
                


              click griddy.nfl.models.entities.player_receiving_stats.PlayerReceivingStats href "" "griddy.nfl.models.entities.player_receiving_stats.PlayerReceivingStats"
              click griddy.nfl.types.basemodel.BaseModel href "" "griddy.nfl.types.basemodel.BaseModel"

Attributes¶

display_name `instance-attribute` ¶

display_name: Annotated[str, Field(alias='displayName')]

Player's full name

gp `instance-attribute` ¶

gp: int

Games played

gs `instance-attribute` ¶

gs: int

Games started

nfl_id `instance-attribute` ¶

nfl_id: Annotated[str, Field(alias='nflId')]

NFL player identifier

position `instance-attribute` ¶

position: OffensivePlayerPositionEnum

Offensive skill position (excluding QB)

rec `instance-attribute` ¶

rec: int

Receptions

rt `instance-attribute` ¶

rt: int

Routes run

td `instance-attribute` ¶

td: int

Touchdown receptions

team_id `instance-attribute` ¶

team_id: Annotated[str, Field(alias='teamId')]

Team identifier

tgt `instance-attribute` ¶

tgt: int

Targets

yds `instance-attribute` ¶

yds: int

Receiving yards

avg_rt_dep `class-attribute` `instance-attribute` ¶

avg_rt_dep: Annotated[
    Optional[float], Field(alias="avgRtDep")
] = None

Average route depth (yards)

avg_sep `class-attribute` `instance-attribute` ¶

avg_sep: Annotated[
    Optional[float], Field(alias="avgSep")
] = None

Average receiver separation at target (yards)

ay `class-attribute` `instance-attribute` ¶

ay: Optional[float] = None

Air yards

ay_pg `class-attribute` `instance-attribute` ¶

ay_pg: Annotated[Optional[float], Field(alias="ayPG")] = (
    None
)

Air yards per game

ay_tgt `class-attribute` `instance-attribute` ¶

ay_tgt: Annotated[Optional[float], Field(alias="ayTgt")] = (
    None
)

Air yards per target

catch `class-attribute` `instance-attribute` ¶

catch: Optional[float] = None

Catch rate (0-1)

croe `class-attribute` `instance-attribute` ¶

croe: Optional[float] = None

Catch Rate Over Expected

deep_tgt_pct `class-attribute` `instance-attribute` ¶

deep_tgt_pct: Annotated[
    Optional[float], Field(alias="deepTgtPct")
] = None

Deep target percentage (20+ air yards)

drop `class-attribute` `instance-attribute` ¶

drop: Optional[int] = None

Dropped passes

drop_pg `class-attribute` `instance-attribute` ¶

drop_pg: Annotated[
    Optional[float], Field(alias="dropPG")
] = None

Drops per game

drop_tgt `class-attribute` `instance-attribute` ¶

drop_tgt: Annotated[
    Optional[float], Field(alias="dropTgt")
] = None

Drop rate (0-1)

epa `class-attribute` `instance-attribute` ¶

epa: Optional[float] = None

Expected Points Added

epa_pg `class-attribute` `instance-attribute` ¶

epa_pg: Annotated[Optional[float], Field(alias="epaPG")] = (
    None
)

EPA per game

epa_rt `class-attribute` `instance-attribute` ¶

epa_rt: Annotated[Optional[float], Field(alias="epaRt")] = (
    None
)

EPA per route run

epa_tgt `class-attribute` `instance-attribute` ¶

epa_tgt: Annotated[
    Optional[float], Field(alias="epaTgt")
] = None

EPA per target

ez_rec `class-attribute` `instance-attribute` ¶

ez_rec: Annotated[Optional[int], Field(alias="ezRec")] = (
    None
)

End zone receptions

ez_rec_pg `class-attribute` `instance-attribute` ¶

ez_rec_pg: Annotated[
    Optional[float], Field(alias="ezRecPG")
] = None

End zone receptions per game

ez_tgt `class-attribute` `instance-attribute` ¶

ez_tgt: Annotated[Optional[int], Field(alias="ezTgt")] = (
    None
)

End zone targets

ez_tgt_pg `class-attribute` `instance-attribute` ¶

ez_tgt_pg: Annotated[
    Optional[float], Field(alias="ezTgtPG")
] = None

End zone targets per game

fapi_game_id `class-attribute` `instance-attribute` ¶

fapi_game_id: Annotated[
    Optional[str], Field(alias="fapiGameId")
] = None

Football API game identifier

final_score `class-attribute` `instance-attribute` ¶

final_score: Annotated[
    Optional[str], Field(alias="finalScore")
] = None

Final score of the game

game_id `class-attribute` `instance-attribute` ¶

game_id: Annotated[Optional[int], Field(alias="gameId")] = (
    None
)

Game identifier (10-digit format YYYYMMDDNN)

game_result `class-attribute` `instance-attribute` ¶

game_result: Annotated[
    Optional[GameResultEnum], Field(alias="gameResult")
] = None

Game result (Win/Loss/Tie)

headshot `class-attribute` `instance-attribute` ¶

headshot: Optional[str] = None

URL to player headshot image (contains formatInstructions placeholder)

int_ `class-attribute` `instance-attribute` ¶

int_: Annotated[Optional[int], Field(alias='int')] = None

Interceptions thrown on targets to this receiver

int_pg `class-attribute` `instance-attribute` ¶

int_pg: Annotated[Optional[float], Field(alias="intPG")] = (
    None
)

Interceptions per game

is_home `class-attribute` `instance-attribute` ¶

is_home: Annotated[
    Optional[bool], Field(alias="isHome")
] = None

Whether player's team was at home

jersey_number `class-attribute` `instance-attribute` ¶

jersey_number: Annotated[
    Optional[int], Field(alias="jerseyNumber")
] = None

Player's jersey number

ngs_position `class-attribute` `instance-attribute` ¶

ngs_position: Annotated[
    Optional[OffensivePlayerPositionEnum],
    Field(alias="ngsPosition"),
] = None

Offensive skill position (excluding QB)

ngs_position_group `class-attribute` `instance-attribute` ¶

ngs_position_group: Annotated[
    Optional[OffensivePlayerPositionEnum],
    Field(alias="ngsPositionGroup"),
] = None

Offensive skill position (excluding QB)

opponent_team_id `class-attribute` `instance-attribute` ¶

opponent_team_id: Annotated[
    Optional[str], Field(alias="opponentTeamId")
] = None

Opponent team identifier

position_group `class-attribute` `instance-attribute` ¶

position_group: Annotated[
    Optional[OffensivePlayerPositionEnum],
    Field(alias="positionGroup"),
] = None

Offensive skill position (excluding QB)

qr `class-attribute` `instance-attribute` ¶

qr: Optional[bool] = None

Qualified receiver status

rating `class-attribute` `instance-attribute` ¶

rating: Optional[float] = None

Passer rating when targeting this receiver

rec_pg `class-attribute` `instance-attribute` ¶

rec_pg: Annotated[Optional[float], Field(alias="recPG")] = (
    None
)

Receptions per game

rt_pg `class-attribute` `instance-attribute` ¶

rt_pg: Annotated[Optional[float], Field(alias="rtPG")] = (
    None
)

Routes per game

short_name `class-attribute` `instance-attribute` ¶

short_name: Annotated[
    Optional[str], Field(alias="shortName")
] = None

Abbreviated player name

td_pg `class-attribute` `instance-attribute` ¶

td_pg: Annotated[Optional[float], Field(alias="tdPG")] = (
    None
)

Touchdowns per game

tg `class-attribute` `instance-attribute` ¶

tg: Optional[int] = None

Team games for player

tgt_pg `class-attribute` `instance-attribute` ¶

tgt_pg: Annotated[Optional[float], Field(alias="tgtPG")] = (
    None
)

Targets per game

tgt_rt `class-attribute` `instance-attribute` ¶

tgt_rt: Annotated[Optional[float], Field(alias="tgtRt")] = (
    None
)

Target rate (targets per route run)

total_tg `class-attribute` `instance-attribute` ¶

total_tg: Annotated[
    Optional[int], Field(alias="totalTg")
] = None

Total team games in period

tw_pct `class-attribute` `instance-attribute` ¶

tw_pct: Annotated[Optional[float], Field(alias="twPct")] = (
    None
)

Tight window percentage

week_slug `class-attribute` `instance-attribute` ¶

week_slug: Annotated[
    Optional[str], Field(alias="weekSlug")
] = None

Week identifier slug

x_catch `class-attribute` `instance-attribute` ¶

x_catch: Annotated[
    Optional[float], Field(alias="xCatch")
] = None

Expected catch rate (0-1)

x_yac `class-attribute` `instance-attribute` ¶

x_yac: Annotated[Optional[float], Field(alias="xYac")] = (
    None
)

Expected yards after catch

x_yac_pg `class-attribute` `instance-attribute` ¶

x_yac_pg: Annotated[
    Optional[float], Field(alias="xYacPG")
] = None

Expected YAC per game

yac `class-attribute` `instance-attribute` ¶

yac: Optional[float] = None

Yards after catch

yac_pg `class-attribute` `instance-attribute` ¶

yac_pg: Annotated[Optional[float], Field(alias="yacPG")] = (
    None
)

YAC per game

yac_rec `class-attribute` `instance-attribute` ¶

yac_rec: Annotated[
    Optional[float], Field(alias="yacRec")
] = None

YAC per reception

yacoe `class-attribute` `instance-attribute` ¶

yacoe: Optional[float] = None

Yards after catch over expected

yacoe_pg `class-attribute` `instance-attribute` ¶

yacoe_pg: Annotated[
    Optional[float], Field(alias="yacoePG")
] = None

YACOE per game

yds_pg `class-attribute` `instance-attribute` ¶

yds_pg: Annotated[Optional[float], Field(alias="ydsPG")] = (
    None
)

Yards per game

yds_rec `class-attribute` `instance-attribute` ¶

yds_rec: Annotated[
    Optional[float], Field(alias="ydsRec")
] = None

Yards per reception

yds_rt `class-attribute` `instance-attribute` ¶

yds_rt: Annotated[Optional[float], Field(alias="ydsRt")] = (
    None
)

Yards per route run

Player Receiving Stats¶