STAT-API

NFL game_player_ngs_receivings API

game_player_ngs_receivingsnfl.game_player_ngs_receivings
NFL Next Gen Stats for receivers per game — RFID-tracked receiving metrics like separation at the throw, cushion at the snap, target separation, and yards over expected.
Full field reference (20 columns) → Data DictionaryQuery in GraphQL →
GET/api/v1/nfl/game_player_ngs_receivings
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.
team_idquerybigintoptional
Filter by team.
seasonqueryintegeroptional
Filter by season start year.
weekqueryintegeroptional
Filter by week of the season.
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_ngs_receivings?game_id=1'
Responses
200game_player_ngs_receivings rows matching the declared filter set, wrapped in { game_player_ngs_receivings, 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(20 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 42034
player_gsis_id
string—GSIS ID for cross-reference
e.g. 00-0036322
player_id
bigint—
e.g. 1156
team_id
bigint—
e.g. 9
avg_cushion
decimalnullable—Average distance from nearest defender at snap (yards)
e.g. 6.3400
avg_expected_yac
decimalnullable—Model-predicted YAC based on catch location/defenders
e.g. 0.0000
avg_intended_air_yds
decimalnullable—Average depth of targets
e.g. 13.6800
avg_separation
decimalnullable—Average distance from nearest defender at catch point (yards)
e.g. 2.2577
avg_yac
decimalnullable—Average yards after catch
e.g. 0.0000
avg_yac_above_expectation
decimalnullable—Actual YAC minus expected (positive = creates extra yards)
e.g. 0.0000
catch_percentage
decimalnullable——
e.g. 66.6667
percent_share_of_intended_air_yds
decimalnullable—Percentage of team total intended air yards (deep target share)
e.g. 24.4521
rec_tds
integernullable——
e.g. 0
receptions
integernullable——
e.g. 4
season
integer——
e.g. 2020
season_type
string—Canonical season phase.
e.g. regular_season
targets
integernullable——
e.g. 5
week
integer——
e.g. 1
yards
integernullable——
e.g. 41
GET/api/v1/nfl/game_player_ngs_receivings/{id}
Parameters
idpathbigintrequired
Primary key (id) of the game_player_ngs_receiving 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_ngs_receivings/{pk_value}'
Responses
200Single game_player_ngs_receiving row.application/jsonshow example ▸
404Row not found.
Response Schema(20 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 42034
player_gsis_id
string—GSIS ID for cross-reference
e.g. 00-0036322
player_id
bigint—
e.g. 1156
team_id
bigint—
e.g. 9
avg_cushion
decimalnullable—Average distance from nearest defender at snap (yards)
e.g. 6.3400
avg_expected_yac
decimalnullable—Model-predicted YAC based on catch location/defenders
e.g. 0.0000
avg_intended_air_yds
decimalnullable—Average depth of targets
e.g. 13.6800
avg_separation
decimalnullable—Average distance from nearest defender at catch point (yards)
e.g. 2.2577
avg_yac
decimalnullable—Average yards after catch
e.g. 0.0000
avg_yac_above_expectation
decimalnullable—Actual YAC minus expected (positive = creates extra yards)
e.g. 0.0000
catch_percentage
decimalnullable——
e.g. 66.6667
percent_share_of_intended_air_yds
decimalnullable—Percentage of team total intended air yards (deep target share)
e.g. 24.4521
rec_tds
integernullable——
e.g. 0
receptions
integernullable——
e.g. 4
season
integer——
e.g. 2020
season_type
string—Canonical season phase.
e.g. regular_season
targets
integernullable——
e.g. 5
week
integer——
e.g. 1
yards
integernullable——
e.g. 41