Skip to content

DraftBuzz Models

models

DraftBuzzBaseModel

Bases: BaseModel

Base model for all DraftBuzz 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.

BasicInfo

Bases: DraftBuzzBaseModel

Core biographical information for a draft prospect.

BaseStats

Bases: DraftBuzzBaseModel

Common fields shared across all stat types.

Comparison

Bases: DraftBuzzBaseModel

Player comparison with a similarity score.

DefenseStats

Bases: BaseStats

Combined defensive statistics.

DefensiveBackSkills

Bases: DraftBuzzBaseModel

Skill ratings for defensive back prospects.

DefensiveLinemanSkills

Bases: DraftBuzzBaseModel

Skill ratings for defensive lineman and edge rusher prospects.

InterceptionStats

Bases: BaseStats

Interception statistics for defensive players.

LinebackerSkills

Bases: DraftBuzzBaseModel

Skill ratings for linebacker prospects.

OffenseSkillPlayerStats

Bases: BaseStats

Combined rushing and receiving stats for skill position players.

OffensiveLinemanSkills

Bases: DraftBuzzBaseModel

Skill ratings for offensive lineman prospects.

PassCatcherSkills

Bases: DraftBuzzBaseModel

Skill ratings for wide receiver and tight end prospects.

PassingSkills

Bases: DraftBuzzBaseModel

Skill ratings for quarterback prospects.

PassingStats

Bases: BaseStats

Quarterback passing statistics.

ProspectProfile

Bases: DraftBuzzBaseModel

Complete prospect profile combining all scraped data.

This is the top-level model returned by the prospects.get_prospect() endpoint. It aggregates basic info, ratings, skills, stats, scouting report, and player comparisons into a single typed object.

RatingsAndRankings

Bases: DraftBuzzBaseModel

Prospect ratings, rankings, and recruiting outlet grades.

ReceivingStats

Bases: BaseStats

Receiving statistics.

RunningBackSkills

Bases: DraftBuzzBaseModel

Skill ratings for running back prospects.

RushingStats

Bases: BaseStats

Rushing statistics.

ScoutingReport

Bases: DraftBuzzBaseModel

Scouting report text including bio, strengths, weaknesses, and summary.

TackleStats

Bases: BaseStats

Tackle statistics for defensive players.

PositionRankings

Bases: DraftBuzzBaseModel

Rankings page result containing a list of ranked prospects.

Returned by the rankings.get_position_rankings() endpoint.

RankedProspect

Bases: DraftBuzzBaseModel

A single prospect entry from a position rankings page.

Security

Bases: DraftBuzzBaseModel

Bearer-token authentication model for the DraftBuzz SDK.