Skip to contents

KHL Schedule

Source: R/khl.R
khl_schedule.Rd

Season schedule and results of a tournament, one row per game (All-Star games dropped).

Usage

khl_schedule(
  season = NULL,
  stage = "regular",
  headers = NULL,
  tournament_id = NULL,
  return_parsed = TRUE
)

Arguments

season

Season by its END year (2026 = 2025-26), mapped to the KHL tournament id (tnId) through the webcaster season table (khl_webcaster_stages). NULL = the site's current season.

stage

Which stage of the season: regular or playoff. One of regular, playoff.

headers

Named list of extra request headers, merged over the defaults (X-Requested-With, Origin, Referer). The cookie jar and sessid are kept in-process, so nothing needs reusing across calls.

tournament_id

khl.ru tournament id (tnId), sent as is instead of season / stage (1369 = 2025-26 regular season, 1370 its playoff; the schedule's tournament_id column). The All-Star games have their own.

return_parsed

Logical. TRUE (default) returns the parsed fastRhockey_data tibble; FALSE returns the raw khl.ru envelope as a list (status, data, errors; betting fields removed).

Value

A fastRhockey_data tibble (16 columns; zero rows with the same columns when the payload is empty), or the raw body as a list when return_parsed = FALSE. Raises fastRhockey_no_data (nothing there, or an unknown season / stage), fastRhockey_asset_fetch (an error envelope, an answer for another id than the one asked, or a failed fetch) and fastRhockey_bad_request (an invalid argument or an HTTP 400 / 422).

col_nametypesdescription
game_idintegerkhl.ru game id; equals webcaster event khl_id / match_id
tournament_idintegerkhl.ru tournament (stage) id, tnId: 1369 = 2025-26 regular season, 1370 its playoff; equals webcaster stage khl_id
datecharacterGame date YYYY-MM-DD (Moscow time)
timecharacterStart time hh:mm (Moscow time); not a game clock
home_club_idintegerHome CLUB id (stable across seasons; joins webcaster team khl_id)
home_namecharacterHome team name (Russian on www.khl.ru)
away_club_idintegerVisitor CLUB id (stable across seasons; joins webcaster team khl_id)
away_namecharacterVisitor team name (Russian on www.khl.ru)
home_scoreintegerHome goals (final, shootout winner counted)
away_scoreintegerVisitor goals (final, shootout winner counted)
decisioncharacterOT or SO when decided in overtime / a shootout; null in regulation
period_scorescharacterPer-period home:away scores, comma-joined
winner_club_idintegerClub id of the winner
approvedinteger1 = result confirmed by the league
arena_idintegerkhl.ru arena id
arena_namecharacterArena (city) name, from data.ARENAS

Details

Endpoint: POST https://www.khl.ru/rest/calendar/list/.

khl.ru REST needs a primed session (a GET of the site root sets the cookie jar and the Bitrix sessid, then each call POSTs a form); this is done for you, one session per host per R session, re-primed when the site rotates its cookie or the sessid expires. No route takes a year: season (the END year, 2026 = 2025/26) and stage are mapped to the tournament id (tnId) through the webcaster season table, or pass tournament_id (the All-Star games have their own tnId).

Ids and counts are integers (sdv-py Int64); a column holding values past 2^31 (epoch milliseconds) is returned as a whole-number double.

At least one second is left between two requests to a host.

Owner flag (sanctions). The KHL and its webcaster platform are run by Russian operators, some clubs by sanctioned state companies. Fetching on your own machine is fine; any published data release, hosted mirror or redistribution needs owner (sanctions / legal) sign-off first.

See also

Other KHL Functions: khl_game_header(), khl_game_info(), khl_game_protocol(), khl_pbp(), khl_player_box(), khl_player_career(), khl_player_profile(), khl_player_stats(), khl_playoff_bracket(), khl_roster(), khl_shots(), khl_standings(), khl_stat_filters(), khl_webcaster_event(), khl_webcaster_events(), khl_webcaster_leaders(), khl_webcaster_players(), khl_webcaster_players_light(), khl_webcaster_stages(), khl_webcaster_tables(), khl_webcaster_team(), khl_webcaster_teams()

Examples

# \donttest{
  try(khl_schedule(season = 2026))
#> ── KHL Schedule from khl.ru ────────────────────────── fastRhockey 1.0.0.9000 ──
#> ℹ Data updated: 2026-10-13 01:54:58 UTC
#> # A tibble: 748 × 16
#>    game_id tournament_id date       time  home_club_id home_name    away_club_id
#>      <int>         <int> <chr>      <chr>        <int> <chr>               <int>
#>  1  897491          1369 2025-09-05 19:30            1 Локомотив              25
#>  2  897492          1369 2025-09-06 14:30           37 Металлург Мг           53
#>  3  897494          1369 2025-09-06 16:00            2 ЦСКА                  719
#>  4  897493          1369 2025-09-06 17:00           26 Торпедо                38
#>  5  897495          1369 2025-09-06 17:00          568 Драконы                24
#>  6  897499          1369 2025-09-07 13:30           29 Сибирь                 54
#>  7  897496          1369 2025-09-07 14:30          198 Барыс                  25
#>  8  897497          1369 2025-09-07 17:00            7 Спартак               451
#>  9  897498          1369 2025-09-07 17:00           71 Нефтехимик             56
#> 10  897501          1369 2025-09-08 16:30           34 Авангард               53
#> # ℹ 738 more rows
#> # ℹ 9 more variables: away_name <chr>, home_score <int>, away_score <int>,
#> #   decision <chr>, period_scores <chr>, winner_club_id <int>, approved <int>,
#> #   arena_id <int>, arena_name <chr>
# }