NFL season_player_firstdown_stats API
season_player_firstdown_stats
nfl.season_player_firstdown_statsSeason player stats restricted to first-down plays — passing, rushing, and receiving production filtered to first-down attempts, useful for early-down efficiency analysis.
GET/api/v1/nfl/season_player_firstdown_statsList season_player_firstdown_stats for NFL
Requires one of:
season_id — requests satisfying none of these return 400.Parameters
player_idquerybigintoptionalFilter to a single player.
season_idquerybigintoptionalFilter to a season by year (e.g., 2025 for the 2025-26 season). Defaults to the current season.
limitqueryintegeroptionaldefault 100Page size. Defaults to 100; max 5000.
from_idquerybigintoptionalReturn 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/season_player_firstdown_stats?season_id=2026'Responses
200season_player_firstdown_stats rows matching the declared filter set, wrapped in { season_player_firstdown_stats, 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/jsonResponse Schema(52 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
player_id | bigint | — e.g. 2 | |
season_id | bigint | — e.g. 2020 | |
assisted_tackles | integer | — | Assisted tackles on first down e.g. 0 |
defensive_tds | integer | — | Total defensive touchdowns on first down e.g. 0 |
forced_fumbles | integer | — | Forced fumbles on first down e.g. 0 |
fumble_recovery_tds | integer | — | Fumble recovery touchdowns on first down e.g. 0 |
fumble_recovery_yds | integer | — | Fumble recovery yards on first down e.g. 0 |
fumbles | integer | — | Fumbles on first down e.g. 0 |
fumbles_lost | integer | — | Fumbles lost on first down e.g. 0 |
fumbles_recovered | integer | — | Fumbles recovered on first down e.g. 0 |
games_played | integer | — | Number of games with first down involvement e.g. 1 |
games_started | integer | — | Number of games started e.g. 0 |
interception_tds | integer | — | Interception return touchdowns on first down e.g. 0 |
interception_yds | integer | — | Interception return yards on first down e.g. 0 |
interceptions | integer | — | Interceptions on first down e.g. 0 |
offensive_snaps | integer | — | Offensive snaps played on first down e.g. 0 |
offensive_tds | integer | — | Total offensive touchdowns on first down e.g. 0 |
passes_defended | integer | — | Passes defended on first down e.g. 0 |
passing_attempts | integer | — | Passing attempts on first down e.g. 0 |
passing_completion_percentage | decimal | — | Completion percentage on first down e.g. 0.0000 |
passing_completions | integer | — | Completed passes on first down e.g. 0 |
passing_interceptions | integer | — | Interceptions thrown on first down e.g. 0 |
passing_long | integer | — | Longest pass completion on first down e.g. 0 |
passing_rating | decimal | — | Passer rating on first down e.g. 0.0000 |
passing_sack_yds | integer | — | Yards lost to sacks on first down e.g. 0 |
passing_sacks | integer | — | Times sacked on first down e.g. 0 |
passing_tds | integer | — | Passing touchdowns on first down e.g. 0 |
passing_yds | integer | — | Passing yards on first down e.g. 0 |
passing_yds_per_attempt | decimal | — | Passing yards per attempt on first down e.g. 0.0000 |
passing_yds_per_completion | decimal | — | Passing yards per completion on first down e.g. 0.0000 |
quarterback_hits | integer | — | QB hits on first down e.g. 0 |
receiving_long | integer | — | Longest reception on first down e.g. 0 |
receiving_tds | integer | — | Receiving touchdowns on first down e.g. 0 |
receiving_yds | integer | — | Receiving yards on first down e.g. 0 |
receiving_yds_per_reception | decimal | — | Yards per reception on first down e.g. 0.0000 |
receiving_yds_per_target | decimal | — | Receiving yards per target on first down e.g. 0.0000 |
reception_percentage | decimal | — | Reception percentage (receptions/targets) on first down e.g. 0.0000 |
receptions | integer | — | Receptions on first down e.g. 0 |
rushing_attempts | integer | — | Rushing attempts on first down e.g. 0 |
rushing_long | integer | — | Longest rush on first down e.g. 0 |
rushing_tds | integer | — | Rushing touchdowns on first down e.g. 0 |
rushing_yds | integer | — | Rushing yards on first down e.g. 0 |
rushing_yds_per_attempt | decimal | — | Rushing yards per attempt on first down e.g. 0.0000 |
sacks | decimal | — | Sacks on first down (0.5 for half sacks) e.g. 0.0000 |
solo_tackles | integer | — | Solo tackles on first down e.g. 0 |
tackles_for_loss | integer | — | Tackles for loss on first down e.g. 0 |
targets | integer | — | Times targeted on first down e.g. 0 |
total_tds | integer | — | Total touchdowns scored on first down e.g. 0 |
two_pt_pass_conversions | integer | — | — e.g. 0 |
two_pt_reception_conversions | integer | — | — e.g. 0 |
two_pt_rush_conversions | integer | — | — e.g. 0 |
GET/api/v1/nfl/season_player_firstdown_stats/{id}Get a single season_player_firstdown_stat by id
Parameters
idpathbigintrequiredPrimary key (id) of the season_player_firstdown_stat 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/season_player_firstdown_stats/{pk_value}'Responses
200Single season_player_firstdown_stat row.application/jsonshow example ▸
404Row not found.
Response Schema(52 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
player_id | bigint | — e.g. 2 | |
season_id | bigint | — e.g. 2020 | |
assisted_tackles | integer | — | Assisted tackles on first down e.g. 0 |
defensive_tds | integer | — | Total defensive touchdowns on first down e.g. 0 |
forced_fumbles | integer | — | Forced fumbles on first down e.g. 0 |
fumble_recovery_tds | integer | — | Fumble recovery touchdowns on first down e.g. 0 |
fumble_recovery_yds | integer | — | Fumble recovery yards on first down e.g. 0 |
fumbles | integer | — | Fumbles on first down e.g. 0 |
fumbles_lost | integer | — | Fumbles lost on first down e.g. 0 |
fumbles_recovered | integer | — | Fumbles recovered on first down e.g. 0 |
games_played | integer | — | Number of games with first down involvement e.g. 1 |
games_started | integer | — | Number of games started e.g. 0 |
interception_tds | integer | — | Interception return touchdowns on first down e.g. 0 |
interception_yds | integer | — | Interception return yards on first down e.g. 0 |
interceptions | integer | — | Interceptions on first down e.g. 0 |
offensive_snaps | integer | — | Offensive snaps played on first down e.g. 0 |
offensive_tds | integer | — | Total offensive touchdowns on first down e.g. 0 |
passes_defended | integer | — | Passes defended on first down e.g. 0 |
passing_attempts | integer | — | Passing attempts on first down e.g. 0 |
passing_completion_percentage | decimal | — | Completion percentage on first down e.g. 0.0000 |
passing_completions | integer | — | Completed passes on first down e.g. 0 |
passing_interceptions | integer | — | Interceptions thrown on first down e.g. 0 |
passing_long | integer | — | Longest pass completion on first down e.g. 0 |
passing_rating | decimal | — | Passer rating on first down e.g. 0.0000 |
passing_sack_yds | integer | — | Yards lost to sacks on first down e.g. 0 |
passing_sacks | integer | — | Times sacked on first down e.g. 0 |
passing_tds | integer | — | Passing touchdowns on first down e.g. 0 |
passing_yds | integer | — | Passing yards on first down e.g. 0 |
passing_yds_per_attempt | decimal | — | Passing yards per attempt on first down e.g. 0.0000 |
passing_yds_per_completion | decimal | — | Passing yards per completion on first down e.g. 0.0000 |
quarterback_hits | integer | — | QB hits on first down e.g. 0 |
receiving_long | integer | — | Longest reception on first down e.g. 0 |
receiving_tds | integer | — | Receiving touchdowns on first down e.g. 0 |
receiving_yds | integer | — | Receiving yards on first down e.g. 0 |
receiving_yds_per_reception | decimal | — | Yards per reception on first down e.g. 0.0000 |
receiving_yds_per_target | decimal | — | Receiving yards per target on first down e.g. 0.0000 |
reception_percentage | decimal | — | Reception percentage (receptions/targets) on first down e.g. 0.0000 |
receptions | integer | — | Receptions on first down e.g. 0 |
rushing_attempts | integer | — | Rushing attempts on first down e.g. 0 |
rushing_long | integer | — | Longest rush on first down e.g. 0 |
rushing_tds | integer | — | Rushing touchdowns on first down e.g. 0 |
rushing_yds | integer | — | Rushing yards on first down e.g. 0 |
rushing_yds_per_attempt | decimal | — | Rushing yards per attempt on first down e.g. 0.0000 |
sacks | decimal | — | Sacks on first down (0.5 for half sacks) e.g. 0.0000 |
solo_tackles | integer | — | Solo tackles on first down e.g. 0 |
tackles_for_loss | integer | — | Tackles for loss on first down e.g. 0 |
targets | integer | — | Times targeted on first down e.g. 0 |
total_tds | integer | — | Total touchdowns scored on first down e.g. 0 |
two_pt_pass_conversions | integer | — | — e.g. 0 |
two_pt_reception_conversions | integer | — | — e.g. 0 |
two_pt_rush_conversions | integer | — | — e.g. 0 |