STAT-API

NFL draft_picks API

draft_picksnfl.draft_picks
Every NFL Draft selection from the modern draft era — round, pick number, drafting team, college, and the career stats that followed (Pro Bowls, All-Pros, Hall of Fame, total games played, career statistics by position).
Full field reference (36 columns) → Data DictionaryQuery in GraphQL →
GET/api/v1/nfl/draft_picks
Requires one of: season — requests satisfying none of these return 400.
Parameters
seasonqueryintegeroptional
Filter by season start year.
roundqueryintegeroptional
Filter by draft round.
team_idquerybigintoptional
Filter by team.
player_idquerybigintoptional
Filter to a single player.
positionquerystringoptional
Filter by player position. Values: C, CB, DB, DE, DL, DT, FB, FS, G, K, LB, LS, NT, OG, OL, OLB, OT, P, QB, RB, S, SAF, T, TE, WR.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return rows with id strictly greater than this value; page using the previous response's `next_from_id`. Omit on the first page.
Restores the documented defaults (trial keys only accept the unchanged defaults).
Request
curl -sS --compressed \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://api.stat-api.com/api/v1/nfl/draft_picks?season=1'
Responses
200draft_picks rows matching the declared filter set, wrapped in { draft_picks, limit, next_from_id }. next_from_id is the last row's id on a full page — pass it back via ?from_id= to walk the full result; null marks the terminal page.application/jsonshow example ▸
400No declared filter set was satisfied — response body matches MissingRequiredFiltersError; pick one combo from the accepted-sets hint and resend.application/json
Response Schema(36 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
cfb_player_id
stringnullable—College Football Reference player ID.
e.g. caleb-williams-3
gsis_id
string—Game Statistics and Information System ID (NFL official cross-system join key).
e.g.
player_id
bigint—
e.g. 3180
team_id
bigint—
e.g. 15
age
integernullable—Player age at the time of the draft.
e.g. 23
allpro_count
integer—Career All-Pro selections.
e.g. 0
car_av
integernullable—Career Approximate Value (unweighted sum across seasons).
e.g. — (all-null in sample)
career_to_year
integernullable—Most recent NFL season the player appeared in (calendar year).
e.g. 2026
category
string—Position category (e.g., `OFF`, `DEF`, `ST`).
Values:DBDLOLWRLBRBTEQBPKLSFSOG
college
string—College the player was drafted out of.
e.g. Georgia
def_ints
integer—Career defensive interceptions.
e.g. 0
def_sacks
decimal—Career sacks (defensive; half-sacks supported as decimals).
e.g. 0.0000
def_solo_tackles
integer—Career solo defensive tackles.
e.g. 0
dr_av
integernullable—Approximate Value accumulated while with the drafting team.
e.g. 0
games_played
integer—Total career regular-season games played.
e.g. 0
is_hof
boolean—True if the player is enshrined in the Pro Football Hall of Fame.
e.g. false
pass_attempts
integer—Career pass attempts.
e.g. 0
pass_completions
integer—Career pass completions.
e.g. 0
pass_ints
integer—Career interceptions thrown.
e.g. 0
pass_tds
integer—Career passing touchdowns.
e.g. 0
pass_yds
integer—Career passing yards.
e.g. 0
pick
integer—Pick number within the round.
e.g. 1
position
string—Position the player was drafted at (e.g., QB, WR, DE).
e.g. WR
probowl_count
integer—Career Pro Bowl selections.
e.g. 0
rec_tds
integer—Career receiving touchdowns.
e.g. 0
rec_yds
integer—Career receiving yards.
e.g. 0
receptions
integer—Career receptions.
e.g. 0
round
integer—Draft round (1-7).
e.g. 6
rush_atts
integer—Career rushing attempts.
e.g. 0
rush_tds
integer—Career rushing touchdowns.
e.g. 0
rush_yds
integer—Career rushing yards.
e.g. 0
season
integer—Calendar year of the draft.
e.g. 2022
seasons_started
integer—Number of NFL seasons in which the player was a primary starter.
e.g. 0
side
string—Side of the ball (`OFF` or `DEF`).
Values:ODS
w_av
integernullable—Weighted Approximate Value (a career composite metric).
e.g. 0
GET/api/v1/nfl/draft_picks/{id}
Parameters
idpathbigintrequired
Primary key (id) of the draft_pick row.
Restores the documented defaults (trial keys only accept the unchanged defaults).
Request
curl -sS --compressed \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://api.stat-api.com/api/v1/nfl/draft_picks/{pk_value}'
Responses
200Single draft_pick row.application/jsonshow example ▸
404Row not found.
Response Schema(36 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
cfb_player_id
stringnullable—College Football Reference player ID.
e.g. caleb-williams-3
gsis_id
string—Game Statistics and Information System ID (NFL official cross-system join key).
e.g.
player_id
bigint—
e.g. 3180
team_id
bigint—
e.g. 15
age
integernullable—Player age at the time of the draft.
e.g. 23
allpro_count
integer—Career All-Pro selections.
e.g. 0
car_av
integernullable—Career Approximate Value (unweighted sum across seasons).
e.g. — (all-null in sample)
career_to_year
integernullable—Most recent NFL season the player appeared in (calendar year).
e.g. 2026
category
string—Position category (e.g., `OFF`, `DEF`, `ST`).
Values:DBDLOLWRLBRBTEQBPKLSFSOG
college
string—College the player was drafted out of.
e.g. Georgia
def_ints
integer—Career defensive interceptions.
e.g. 0
def_sacks
decimal—Career sacks (defensive; half-sacks supported as decimals).
e.g. 0.0000
def_solo_tackles
integer—Career solo defensive tackles.
e.g. 0
dr_av
integernullable—Approximate Value accumulated while with the drafting team.
e.g. 0
games_played
integer—Total career regular-season games played.
e.g. 0
is_hof
boolean—True if the player is enshrined in the Pro Football Hall of Fame.
e.g. false
pass_attempts
integer—Career pass attempts.
e.g. 0
pass_completions
integer—Career pass completions.
e.g. 0
pass_ints
integer—Career interceptions thrown.
e.g. 0
pass_tds
integer—Career passing touchdowns.
e.g. 0
pass_yds
integer—Career passing yards.
e.g. 0
pick
integer—Pick number within the round.
e.g. 1
position
string—Position the player was drafted at (e.g., QB, WR, DE).
e.g. WR
probowl_count
integer—Career Pro Bowl selections.
e.g. 0
rec_tds
integer—Career receiving touchdowns.
e.g. 0
rec_yds
integer—Career receiving yards.
e.g. 0
receptions
integer—Career receptions.
e.g. 0
round
integer—Draft round (1-7).
e.g. 6
rush_atts
integer—Career rushing attempts.
e.g. 0
rush_tds
integer—Career rushing touchdowns.
e.g. 0
rush_yds
integer—Career rushing yards.
e.g. 0
season
integer—Calendar year of the draft.
e.g. 2022
seasons_started
integer—Number of NFL seasons in which the player was a primary starter.
e.g. 0
side
string—Side of the ball (`OFF` or `DEF`).
Values:ODS
w_av
integernullable—Weighted Approximate Value (a career composite metric).
e.g. 0