Skip to contents

Every goal of a season and tournament: scorer, assists, strength codes and skaters on ice.

Usage

liiga_goals(season = NULL, tournament = NULL)

Arguments

season

Season END year (2026 = 2025-26). Omitted = the season in progress.

tournament

Tournament: runkosarja (regular season), playoffs, playout, qualifications, valmistavat_ottelut (preseason) or chl (Champions Hockey League). Omitted = every tournament, preseason included.

Value

A fastRhockey_data tibble (30 columns; zero rows when a valid payload has none).

col_nametypedescription
seasonintegerSeason END year (2026 = 2025-26).
game_idintegerGame id, unique only within a season: key a game as (season, game_id).
sidecharacterWhich team of the game the row belongs to: home or away.
team_idintegerTeam id, the number of Liiga's <num>:<slug> team key (sent as that string, a bare integer or a digit string depending on the route).
team_slugcharacterTeam slug, the part of Liiga's <num>:<slug> team key after the colon (e.g. hpk).
log_timecharacterWall-clock time the event was logged, ISO 8601 UTC.
winning_goallogicalGame-winning goal.
game_timeintegerSeconds from the start of the game. Regular season: 3900 (65:00) = the end of the 5-minute overtime; playoff overtime runs past it.
periodintegerPeriod number: 1-3 are regulation, 4 and up overtime (or the shootout).
event_idintegerEvent id within the game.
home_team_scoreintegerHome score after the event.
away_team_scoreintegerAway score after the event.
goals_so_far_in_seasonintegerScorer's season goal count after this goal.
video_clip_urlcharacterURL of the goal's video clip; null in every capture.
video_clip_playlist_urlcharacterURL of the goal's video clip playlist; null in every capture.
video_thumbnail_urlcharacterURL of the goal video's thumbnail image; null in every capture.
scorer_player_idintegerScorer's player id.
scorer_first_namecharacterScorer's first name.
scorer_last_namecharacterScorer's last name.
assist1_player_idintegerFirst assist's player id.
assist1_first_namecharacterFirst assist's first name.
assist1_last_namecharacterFirst assist's last name.
assist1_season_assistsintegerFirst assister's season assist count after this goal.
assist2_player_idintegerSecond assist's player id.
assist2_first_namecharacterSecond assist's first name.
assist2_last_namecharacterSecond assist's last name.
assist2_season_assistsintegerSecond assister's season assist count after this goal.
goal_typescharacterGoal type codes, comma-separated Finnish abbreviations: YV power play, AV short-handed, TM empty net, RL penalty shot (others undocumented).
plus_jerseyscharacterJersey NUMBERS of this team's skaters on ice for the goal, space-separated.
minus_jerseyscharacterJersey NUMBERS of the other team's skaters on ice for the goal, space-separated.

Details

Endpoint: GET https://liiga.fi/api/v2/games

Seasons are END years (2026 = 2025-26), the same key as sdv-py. Requests to liiga.fi are spaced at least one second apart. A request Liiga answers with nothing (an unknown game, a tournament not played that season, a shot map before 2016) raises fastRhockey_no_data; a failed fetch or an error-shaped answer raises fastRhockey_asset_fetch; a bad argument raises fastRhockey_bad_request.

Examples

# \donttest{
  try(liiga_goals(season = 2026, tournament = "playoffs"))
#> ── Liiga goals Information from liiga.fi ───────────── fastRhockey 1.0.0.9000 ──
#> ℹ Data updated: 2026-10-13 01:55:24 UTC
#> # A tibble: 301 × 30
#>    season game_id side  team_id team_slug log_time winning_goal game_time period
#>     <int>   <int> <chr>   <int> <chr>     <chr>    <lgl>            <int>  <int>
#>  1   2026   55080 home   8.60e8 kalpa     2026-03… FALSE              209      1
#>  2   2026   55080 home   8.60e8 kalpa     2026-03… TRUE               639      1
#>  3   2026   55080 home   8.60e8 kalpa     2026-03… FALSE             2285      2
#>  4   2026   55080 home   8.60e8 kalpa     2026-03… FALSE             2729      3
#>  5   2026   55080 away   1.69e8 hifk      2026-03… FALSE              873      1
#>  6   2026   55081 home   6.79e8 ässät     2026-03… FALSE              165      1
#>  7   2026   55081 home   6.79e8 ässät     2026-03… FALSE             3206      3
#>  8   2026   55081 home   6.79e8 ässät     2026-03… FALSE             3477      3
#>  9   2026   55081 home   6.79e8 ässät     2026-03… TRUE              3881      4
#> 10   2026   55081 away   1.37e9 k-espoo   2026-03… FALSE              440      1
#> # ℹ 291 more rows
#> # ℹ 21 more variables: event_id <int>, home_team_score <int>,
#> #   away_team_score <int>, goals_so_far_in_season <int>, video_clip_url <chr>,
#> #   video_clip_playlist_url <chr>, video_thumbnail_url <chr>,
#> #   scorer_player_id <int>, scorer_first_name <chr>, scorer_last_name <chr>,
#> #   assist1_player_id <int>, assist1_first_name <chr>, assist1_last_name <chr>,
#> #   assist1_season_assists <int>, assist2_player_id <int>, …
# }