STAT-API

NHL player_news API

player_newsnhl.player_news
News about NHL players — trades, IR placements, line changes, suspensions, and general beat-reporter updates.
GET/api/v1/nhl/player_news
Requires one of: player_id or team_id — requests satisfying none of these return 400.
Parameters
player_idquerybigintoptional
Filter to a single player.
team_idquerybigintoptional
Filter by team.
categoryquerystringoptional
Filter by news category (injury, transaction, lineup, general). Values: general, injury, lineup, transaction.
status_enumquerystringoptional
Filter by player status designation. Values: RULED_OUT, DOUBTFUL, QUESTIONABLE, PROBABLE, CLEARED, MINUTES_LIMIT, MINUTES_LIFTED, STARTING, BENCHED, INACTIVE, ACTIVE, IR_PLACED, IR_ACTIVATED, OUT_SEASON, TRADED, RELEASED, SIGNED, ROUTINE, UNSIGNED.
urgencyquerystringoptional
Filter by news urgency. Values: BREAKING_GAME_TIME, HIGH, MEDIUM, ROUTINE.
news_timequerytimestamptzoptional
Filter by publication time (ISO 8601). Use news_time__gte to poll for items since your last check. Range syntax: news_time__gte=, news_time__lte=, news_time__between=.
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/nhl/player_news?player_id=1'
Responses
200player_news rows matching the declared filter set, wrapped in { player_news, limit, next_from_id, has_more }. has_more is true when another row follows this page. To walk every row, start with ?from_id=0 and pass each next_from_id back as from_id until it is null; the filters stay. A first page without from_id comes in the default order and gives next_from_id null.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(21 fields)show schema ▸
27 total fields (1 nested object/array groups)
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigintnullableAssociated game ID when this news item relates to a specific game.
e.g. 1930
news_id
integernullable—External news item ID from the provider.
e.g. 38315
opponent_team_id
bigintnullableOpponent team ID when this news item relates to an upcoming or active game matchup.
e.g. 32
player_id
bigintnullablePlayer ID associated with the news report.
e.g. 195
team_id
bigintnullableTeam ID of the player at the time of publication.
e.g. 22
ai_processed
boolean—Whether this story was generated or enriched via LLM summarization.
Values:falsetrue
author
stringnullable—Reporter or author of the article.
e.g. — (all-null in sample)
categories
stringnullable—Comma-separated raw topic tags.
e.g. — (all-null in sample)
category
stringnullable—injury, transaction, lineup, general
Values:injurytransactiongeneralcontractlineupsuspension
content
stringnullable—Full text content of the news report.
e.g. Carolina Hurricanes left wing William Carrier (upper body) …
description
stringnullable—Brief synopsis or summary of the news event.
e.g. Edmonton defenseman Alec Regula has been placed on injured …
first_reported_at
timestamptznullable—Timestamp when this story was first reported before multi-source compaction.
e.g. 1970-01-01T00:00:00.000Z
news_time
timestamptz—Publication timestamp of the news story.
e.g. 2026-09-29T04:00:00.000Z
priority
integer—Display priority score (1-10).
e.g. 5
situational_impact
jsonbnullable—Structured situational impact assessment and fantasy implications for the player.
e.g. {"affected_players":[]}
↳type
situational_impact.type
stringnullable—Impact direction: positive, negative, or neutral.
↳impact_enum
situational_impact.impact_enum
stringnullable—Standardized impact state (ACTIVE, CLEARED, QUESTIONABLE, etc.).
↳reason
situational_impact.reason
stringnullable—Narrative explaining the fantasy and playing-time impact.
↳ripple_effect
situational_impact.ripple_effect
stringnullable—Downstream tactical or fantasy consequences.
↳affected_players
situational_impact.affected_players
listnullable—Teammates whose opportunity or role is impacted.
↳affected_player_ids
situational_impact.affected_player_ids
listnullable—IDs of impacted teammates.
status_enum
stringnullable—Standardized player status designation (RULED_OUT, DOUBTFUL, QUESTIONABLE, PROBABLE, CLEARED, MINUTES_LIMIT, MINUTES_LIFTED, STARTING, BENCHED, INACTIVE, ACTIVE, IR_PLACED, IR_ACTIVATED, TRADED, RELEASED, SIGNED, ROUTINE).
Values:ACTIVEROUTINERELEASEDTRADEDQUESTIONABLESIGNEDRULED_OUTIR_PLACEDPROBABLEINACTIVECLEAREDSTARTINGBENCHED
terms_of_use
stringnullable—Syndication terms and attribution.
e.g. — (all-null in sample)
title
string—Headline of the news report.
e.g. Torey Krug placed on IR with ankle injury
updated_time
timestamptznullable—Timestamp when the story was last revised.
e.g. — (all-null in sample)
urgency
stringnullable—Urgency level of the news event (BREAKING_GAME_TIME, HIGH, MEDIUM, ROUTINE).
Values:ROUTINEHIGHMEDIUMBREAKING_GAME_TIME
GET/api/v1/nhl/player_news/{id}
Parameters
idpathbigintrequired
Primary key (id) of the player_new 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/nhl/player_news/{pk_value}'
Responses
200Single player_new row.application/jsonshow example ▸
404Row not found.
Response Schema(21 fields)show schema ▸
27 total fields (1 nested object/array groups)
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigintnullableAssociated game ID when this news item relates to a specific game.
e.g. 1930
news_id
integernullable—External news item ID from the provider.
e.g. 38315
opponent_team_id
bigintnullableOpponent team ID when this news item relates to an upcoming or active game matchup.
e.g. 32
player_id
bigintnullablePlayer ID associated with the news report.
e.g. 195
team_id
bigintnullableTeam ID of the player at the time of publication.
e.g. 22
ai_processed
boolean—Whether this story was generated or enriched via LLM summarization.
Values:falsetrue
author
stringnullable—Reporter or author of the article.
e.g. — (all-null in sample)
categories
stringnullable—Comma-separated raw topic tags.
e.g. — (all-null in sample)
category
stringnullable—injury, transaction, lineup, general
Values:injurytransactiongeneralcontractlineupsuspension
content
stringnullable—Full text content of the news report.
e.g. Carolina Hurricanes left wing William Carrier (upper body) …
description
stringnullable—Brief synopsis or summary of the news event.
e.g. Edmonton defenseman Alec Regula has been placed on injured …
first_reported_at
timestamptznullable—Timestamp when this story was first reported before multi-source compaction.
e.g. 1970-01-01T00:00:00.000Z
news_time
timestamptz—Publication timestamp of the news story.
e.g. 2026-09-29T04:00:00.000Z
priority
integer—Display priority score (1-10).
e.g. 5
situational_impact
jsonbnullable—Structured situational impact assessment and fantasy implications for the player.
e.g. {"affected_players":[]}
↳type
situational_impact.type
stringnullable—Impact direction: positive, negative, or neutral.
↳impact_enum
situational_impact.impact_enum
stringnullable—Standardized impact state (ACTIVE, CLEARED, QUESTIONABLE, etc.).
↳reason
situational_impact.reason
stringnullable—Narrative explaining the fantasy and playing-time impact.
↳ripple_effect
situational_impact.ripple_effect
stringnullable—Downstream tactical or fantasy consequences.
↳affected_players
situational_impact.affected_players
listnullable—Teammates whose opportunity or role is impacted.
↳affected_player_ids
situational_impact.affected_player_ids
listnullable—IDs of impacted teammates.
status_enum
stringnullable—Standardized player status designation (RULED_OUT, DOUBTFUL, QUESTIONABLE, PROBABLE, CLEARED, MINUTES_LIMIT, MINUTES_LIFTED, STARTING, BENCHED, INACTIVE, ACTIVE, IR_PLACED, IR_ACTIVATED, TRADED, RELEASED, SIGNED, ROUTINE).
Values:ACTIVEROUTINERELEASEDTRADEDQUESTIONABLESIGNEDRULED_OUTIR_PLACEDPROBABLEINACTIVECLEAREDSTARTINGBENCHED
terms_of_use
stringnullable—Syndication terms and attribution.
e.g. — (all-null in sample)
title
string—Headline of the news report.
e.g. Torey Krug placed on IR with ankle injury
updated_time
timestamptznullable—Timestamp when the story was last revised.
e.g. — (all-null in sample)
urgency
stringnullable—Urgency level of the news event (BREAKING_GAME_TIME, HIGH, MEDIUM, ROUTINE).
Values:ROUTINEHIGHMEDIUMBREAKING_GAME_TIME