NFL game_weathers API
game_weathers
nfl.game_weathersOn-field weather throughout each NFL game — temperature, wind, humidity, and precipitation captured at fixed intervals from kickoff. Useful for outdoor-game performance analysis.
GET/api/v1/nfl/game_weathersList game_weathers for NFL
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
stadium_idquerybigintoptionalFilter by stadium.
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; 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/game_weathers?game_id=1'Responses
200game_weathers rows matching the declared filter set, wrapped in { game_weathers, 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(23 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 4992 | |
stadium_id | bigint | — e.g. 16 | |
dew_point | floatnullable | — | Dew point (°F) at this interval. e.g. 52 |
feels_like_temperature | integernullable | — | — e.g. 72 |
field_condition | stringnullable | — | — e.g. — (all-null in sample) |
humidity | floatnullable | — | — e.g. 50 |
is_dome | boolean | — | — Values:falsetrue |
minutes_from_start | integer | — | Minutes from game start (0, 30, 60, 90, 120, 150) e.g. 0 |
precipitation | floatnullable | — | — e.g. 0 |
precipitation_probability | floatnullable | — | — e.g. 0 |
rain_accum | floatnullable | — | Cumulative liquid rain (inches) from 3 hours before kickoff through this interval. e.g. 0 |
recorded_at | timestamptz | — | — e.g. 2024-09-15T17:00:00.000Z |
roof_status | stringnullable | — | — Values:OpenDomeRetractable |
snow_accum | floatnullable | — | Cumulative snowfall (inches) from 3 hours before kickoff through this interval. e.g. 0 |
snow_depth | floatnullable | — | Snow depth on the ground (inches) at this interval. e.g. 0 |
snowfall | floatnullable | — | Snowfall rate (inches/hour) at this interval. e.g. 0 |
temperature | integernullable | — | — e.g. 72 |
weather_condition | stringnullable | — | — Values:INDOOROVERCASTCLEARDRIZZLEMAINLY_CLEARPARTLY_CLOUDYSNOWRAIN |
weather_description | stringnullable | — | — Values:Indoor stadium - contro…OvercastClear skyMainly clearLight drizzlePartly cloudyModerate drizzleSlight snowSlight rainModerate rainModerate snowDense drizzleHeavy rainHeavy snow |
wind_direction | floatnullable | — | — e.g. 0 |
wind_gust | floatnullable | — | — e.g. 0 |
wind_speed | floatnullable | — | — e.g. 0 |
GET/api/v1/nfl/game_weathers/{id}Get a single game_weather by id
Parameters
idpathbigintrequiredPrimary key (id) of the game_weather 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_weathers/{pk_value}'Responses
200Single game_weather row.application/jsonshow example ▸
404Row not found.
Response Schema(23 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 4992 | |
stadium_id | bigint | — e.g. 16 | |
dew_point | floatnullable | — | Dew point (°F) at this interval. e.g. 52 |
feels_like_temperature | integernullable | — | — e.g. 72 |
field_condition | stringnullable | — | — e.g. — (all-null in sample) |
humidity | floatnullable | — | — e.g. 50 |
is_dome | boolean | — | — Values:falsetrue |
minutes_from_start | integer | — | Minutes from game start (0, 30, 60, 90, 120, 150) e.g. 0 |
precipitation | floatnullable | — | — e.g. 0 |
precipitation_probability | floatnullable | — | — e.g. 0 |
rain_accum | floatnullable | — | Cumulative liquid rain (inches) from 3 hours before kickoff through this interval. e.g. 0 |
recorded_at | timestamptz | — | — e.g. 2024-09-15T17:00:00.000Z |
roof_status | stringnullable | — | — Values:OpenDomeRetractable |
snow_accum | floatnullable | — | Cumulative snowfall (inches) from 3 hours before kickoff through this interval. e.g. 0 |
snow_depth | floatnullable | — | Snow depth on the ground (inches) at this interval. e.g. 0 |
snowfall | floatnullable | — | Snowfall rate (inches/hour) at this interval. e.g. 0 |
temperature | integernullable | — | — e.g. 72 |
weather_condition | stringnullable | — | — Values:INDOOROVERCASTCLEARDRIZZLEMAINLY_CLEARPARTLY_CLOUDYSNOWRAIN |
weather_description | stringnullable | — | — Values:Indoor stadium - contro…OvercastClear skyMainly clearLight drizzlePartly cloudyModerate drizzleSlight snowSlight rainModerate rainModerate snowDense drizzleHeavy rainHeavy snow |
wind_direction | floatnullable | — | — e.g. 0 |
wind_gust | floatnullable | — | — e.g. 0 |
wind_speed | floatnullable | — | — e.g. 0 |