player_newsnhl.player_news

News about NHL players — trades, IR placements, line changes, suspensions, and general beat-reporter updates.

Full field reference (21 columns) → Data Dictionary Query in GraphQL →

⚠️ This endpoint is documented but not yet live. Calls return 503 until data is wired in.

GET/api/v1/nhl/player_newsList player_news for NHL

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 }. 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

503Coming soon — handler returns 503 until data is wired in.

Response Schema(21 fields)show schema ▸

Field	Type	References	Description
idkey	bigint	—	Primary Key
game_id	bigintnullable		Associated game ID when this news item relates to a specific game.
news_id	integernullable	—	External news item ID from the provider. e.g. — (all-null in sample)
opponent_team_id	bigintnullable		Opponent team ID when this news item relates to an upcoming or active game matchup.
player_id	bigintnullable		Player ID associated with the news report. e.g. — (all-null in sample)
team_id	bigintnullable		Team ID of the player at the time of publication. e.g. — (all-null in sample)
ai_processed	boolean	—	Whether this story was generated or enriched via LLM summarization. e.g. — (all-null in sample)
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 e.g. — (all-null in sample)
content	stringnullable	—	Full text content of the news report. e.g. — (all-null in sample)
description	stringnullable	—	Brief synopsis or summary of the news event.
first_reported_at	timestamptznullable	—	Timestamp when this story was first reported before multi-source compaction.
news_time	timestamptz	—	Publication timestamp of the news story. e.g. — (all-null in sample)
priority	integer	—	Display priority score (1-10). e.g. — (all-null in sample)
situational_impact	jsonbnullable	—	Structured situational impact assessment and fantasy implications for the player. e.g. — (all-null in sample)
↳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).
terms_of_use	stringnullable	—	Syndication terms and attribution. e.g. — (all-null in sample)
title	string	—	Headline of the news report. e.g. — (all-null in sample)
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).

GET/api/v1/nhl/player_news/{id}Get a single player_new by 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.

503Coming soon — handler returns 503 until data is wired in.

Response Schema(21 fields)show schema ▸

Field	Type	References	Description
idkey	bigint	—	Primary Key
game_id	bigintnullable		Associated game ID when this news item relates to a specific game.
news_id	integernullable	—	External news item ID from the provider. e.g. — (all-null in sample)
opponent_team_id	bigintnullable		Opponent team ID when this news item relates to an upcoming or active game matchup.
player_id	bigintnullable		Player ID associated with the news report. e.g. — (all-null in sample)
team_id	bigintnullable		Team ID of the player at the time of publication. e.g. — (all-null in sample)
ai_processed	boolean	—	Whether this story was generated or enriched via LLM summarization. e.g. — (all-null in sample)
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 e.g. — (all-null in sample)
content	stringnullable	—	Full text content of the news report. e.g. — (all-null in sample)
description	stringnullable	—	Brief synopsis or summary of the news event.
first_reported_at	timestamptznullable	—	Timestamp when this story was first reported before multi-source compaction.
news_time	timestamptz	—	Publication timestamp of the news story. e.g. — (all-null in sample)
priority	integer	—	Display priority score (1-10). e.g. — (all-null in sample)
situational_impact	jsonbnullable	—	Structured situational impact assessment and fantasy implications for the player. e.g. — (all-null in sample)
↳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).
terms_of_use	stringnullable	—	Syndication terms and attribution. e.g. — (all-null in sample)
title	string	—	Headline of the news report. e.g. — (all-null in sample)
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).