STAT-API

NFL game_player_props API

game_player_propsnfl.game_player_props
NFL player prop bets for each game — passing yards, rushing touchdowns, receptions, and other player-statistic markets offered by sportsbooks.
Full field reference (18 columns) → Data DictionaryQuery in GraphQL →
GET/api/v1/nfl/game_player_props
Requires one of: game_id or player_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
player_idquerybigintoptional
Filter to a single player.
operator_idquerybigintoptional
Filter by sportsbook / operator.
categoryquerystringoptional
Filter by category.
market_keyquerystringoptional
Filter by raw market key (e.g., player_reception_yds).
is_openingquerybooleanoptional
Filter to opening lines only.
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/game_player_props?game_id=1'
Responses
200game_player_props rows matching the declared filter set, wrapped in { game_player_props, 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(18 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 43007
operator_id
bigintUsually consensus
e.g. 6
player_id
bigint—
e.g. 689
season_id
bigintDenormalized for efficient season-level queries
e.g. 2023
book_count
integer—Number of curated books contributing to this consensus value
e.g. 1
captured_at
timestamptz——
e.g. 2023-09-10T15:00:00.000Z
category
string—Canonical prop category. Common values: - passing_yds, passing_tds, passing_attempts, completions, interceptions - rushing_yds, rushing_tds, rushing_attempts - receiving_yds, receiving_tds, receptions, targets - longest_reception, longest_rush, longest_pass - sacks, tackles, interceptions_def - anytime_td, first_td
Values:receiving_ydsanytime_tdlast_tdfirst_tdrushing_ydspassing_ydsreceptionsrushing_attemptspassing_tdspassing_attemptscompletionsinterceptions
is_opening
boolean—True for the first capture of a (game, player, market, line)
e.g. true
line
decimalnullable—Prop line for over/under markets (275.5 yards, 1.5 TDs). NULL for yes/no markets.
e.g. 29.5000
market_key
string—Raw market key from source API (e.g., player_reception_yds)
Values:player_reception_ydsplayer_anytime_tdplayer_last_tdplayer_1st_tdplayer_rush_ydsplayer_pass_ydsplayer_receptionsplayer_rush_attemptsplayer_pass_tdsplayer_pass_attemptsplayer_pass_completionsplayer_pass_interceptio…
no_odds
integernullable—American odds for no (anytime_td, first_td)
e.g. — (all-null in sample)
outcome_type
string—ou | yes_no
Values:ouyes_no
over_odds
integernullable—American odds for over
e.g. -110
period_code
stringnullable—Optional period code (1Q, 1H). NULL = full game.
e.g. — (all-null in sample)
subcategory
stringnullable—Optional subtype (alternate, boosted, etc.)
e.g. — (all-null in sample)
under_odds
integernullable—American odds for under
e.g. -110
yes_odds
integernullable—American odds for yes (anytime_td, first_td)
e.g. 3000
GET/api/v1/nfl/game_player_props/{id}
Parameters
idpathbigintrequired
Primary key (id) of the game_player_prop 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/game_player_props/{pk_value}'
Responses
200Single game_player_prop row.application/jsonshow example ▸
404Row not found.
Response Schema(18 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 43007
operator_id
bigintUsually consensus
e.g. 6
player_id
bigint—
e.g. 689
season_id
bigintDenormalized for efficient season-level queries
e.g. 2023
book_count
integer—Number of curated books contributing to this consensus value
e.g. 1
captured_at
timestamptz——
e.g. 2023-09-10T15:00:00.000Z
category
string—Canonical prop category. Common values: - passing_yds, passing_tds, passing_attempts, completions, interceptions - rushing_yds, rushing_tds, rushing_attempts - receiving_yds, receiving_tds, receptions, targets - longest_reception, longest_rush, longest_pass - sacks, tackles, interceptions_def - anytime_td, first_td
Values:receiving_ydsanytime_tdlast_tdfirst_tdrushing_ydspassing_ydsreceptionsrushing_attemptspassing_tdspassing_attemptscompletionsinterceptions
is_opening
boolean—True for the first capture of a (game, player, market, line)
e.g. true
line
decimalnullable—Prop line for over/under markets (275.5 yards, 1.5 TDs). NULL for yes/no markets.
e.g. 29.5000
market_key
string—Raw market key from source API (e.g., player_reception_yds)
Values:player_reception_ydsplayer_anytime_tdplayer_last_tdplayer_1st_tdplayer_rush_ydsplayer_pass_ydsplayer_receptionsplayer_rush_attemptsplayer_pass_tdsplayer_pass_attemptsplayer_pass_completionsplayer_pass_interceptio…
no_odds
integernullable—American odds for no (anytime_td, first_td)
e.g. — (all-null in sample)
outcome_type
string—ou | yes_no
Values:ouyes_no
over_odds
integernullable—American odds for over
e.g. -110
period_code
stringnullable—Optional period code (1Q, 1H). NULL = full game.
e.g. — (all-null in sample)
subcategory
stringnullable—Optional subtype (alternate, boosted, etc.)
e.g. — (all-null in sample)
under_odds
integernullable—American odds for under
e.g. -110
yes_odds
integernullable—American odds for yes (anytime_td, first_td)
e.g. 3000