Skip to contents

Skater faceoffs: taken, won, lost, per game, and win percentage overall and by zone.

Reads the Swiss Ice Hockey Federation statistics API (data.sihf.ch, keyless JSON). SIHF keys a season by its END year (2026 = 2025-26). An unknown season, league_id or phase_id is never an error upstream (SIHF silently answers another one), so every table answer is checked against the body's own filter echo and refused when it differs. Every request is spaced at least one second from the last one to the host.

Usage

sihf_player_faceoffs(season, league_id = 1L, phase_id = NULL, language = "en")

Arguments

season

Required. Season by its END year (2026 = 2025-26). A season SIHF does not have raises fastRhockey_no_data error (the API itself silently answers another one).

league_id

SIHF league id: 1 = National League, 2 = Swiss League, 100 = MyHockey League, 3 = 1. Liga, 43 = SWHL B, 113 = U21-Elit (the body's League filter lists them). An id SIHF does not have for the season raises fastRhockey_no_data error.

phase_id

SIHF phase id (regular season, a playoff round, ...; the body's Phase filter lists them). NULL = no phase filter: the season summary over every phase.

language

Response language. Only part of the body is translated: status, position and penalty names stay German.

Value

A fastRhockey_data tibble with 20 columns. A zero-row tibble with these columns when the payload holds no rows.

col_nametypedescription
seasonintegerSeason by its END year (2026 = 2025-26), from the body's echo of the Season filter.
phase_idintegerSIHF phase id (regular season, a playoff round, ...); null unless a phase filter is passed.
rankintegerRank in the table; null on a summary row, and on a goaltender below the qualification line.
playercharacterPlayer name as SIHF prints it, last name first (e.g., "Dahlbeck Klas"); season tables carry no player id.
team_idintegerSIHF team id (integer join key); null on a summary row (the pseudo-team 100000).
team_namecharacterTeam display name as SIHF publishes it; "Durchschnitt" on the league-average row, "Total" on the attendance total row.
team_acronymcharacterTeam abbreviation as SIHF publishes it (e.g., "HCD"); null on a summary row.
positioncharacterPosition, German whatever the language (e.g., "Stürmer"); null when SIHF prints "-".
games_playedintegerGames played in the table's scope.
faceoffsintegerFaceoffs taken, total.
faceoffs_per_gamenumericFaceoffs taken per game.
faceoffs_percentnumericFaceoff win percentage; '-' with no faceoffs.
faceoffs_wonintegerNumber of faceoffs won.
faceoffs_lostintegerNumber of faceoffs lost.
faceoffs_won_per_gamenumericFaceoffs won per game.
faceoffs_lost_per_gamenumericFaceoffs lost per game.
faceoffs_offensive_percentnumericFaceoff win percentage, offensive zone.
faceoffs_neutral_percentnumericFaceoff win percentage, neutral zone.
faceoffs_defensive_percentnumericFaceoff win percentage, defensive zone.
row_typecharacter"data" for a regular row; "average" (league average) or "total" (attendance total) for a summary row SIHF mixes into the table.

Errors

  • fastRhockey_no_data: SIHF answered 404 (unknown game), or ignored a requested season, league or phase and served another one.

  • fastRhockey_bad_request: SIHF answered 400 / 422, or an argument is invalid.

  • fastRhockey_asset_fetch: any other non-2xx answer or a dead connection after retries, an empty or unreadable body, a stub or redirect body, a table without its filter echo, a truncated table, or a gameoverview body for another game.

Examples

# \donttest{
  try(sihf_player_faceoffs(season = 2026, league_id = 1))
#> ── SIHF Player Faceoffs Information from data.sihf.ch ──────────────────────────
#> ℹ Data updated: 2026-10-13 01:59:46 UTC
#> # A tibble: 427 × 20
#>    season phase_id  rank player          team_id team_name team_acronym position
#>     <int>    <int> <int> <chr>             <int> <chr>     <chr>        <chr>   
#>  1   2026       NA   427 Zadina Filip     101151 HC Davos  HCD          Stürmer 
#>  2   2026       NA   426 Rathgeb Yannick  103138 Fribourg… FRI          Verteid…
#>  3   2026       NA   425 Puljujärvi Jes…  103140 Genève-S… GSHC         Stürmer 
#>  4   2026       NA   424 Dahlbeck Klas    101151 HC Davos  HCD          Verteid…
#>  5   2026       NA   423 Rutta Jan        103140 Genève-S… GSHC         Verteid…
#>  6   2026       NA   422 Andersson Calle  101151 HC Davos  HCD          Verteid…
#>  7   2026       NA   421 Kapla Michael    103138 Fribourg… FRI          Verteid…
#>  8   2026       NA   420 Kessler Tino     101151 HC Davos  HCD          Stürmer 
#>  9   2026       NA   419 Lehtonen Mikko   101139 ZSC Lions ZSC          Verteid…
#> 10   2026       NA   418 Le Coultre Sim…  103140 Genève-S… GSHC         Verteid…
#> # ℹ 417 more rows
#> # ℹ 12 more variables: games_played <int>, faceoffs <int>,
#> #   faceoffs_per_game <dbl>, faceoffs_percent <dbl>, faceoffs_won <int>,
#> #   faceoffs_lost <int>, faceoffs_won_per_game <dbl>,
#> #   faceoffs_lost_per_game <dbl>, faceoffs_offensive_percent <dbl>,
#> #   faceoffs_neutral_percent <dbl>, faceoffs_defensive_percent <dbl>,
#> #   row_type <chr>
# }