Skip to contents

B.LEAGUE Schedule

Source: R/bleague.R
bleague_schedule.Rd

Games of one day of one B.LEAGUE competition and division: schedule keys, clubs, scores, venue, tip-off.

Endpoint: GET https://www.bleague.jp/schedule/

One row per game of that day with its schedule_key (the key every game wrapper takes), local date, round, both clubs (team_id is text; names are the page's short Japanese names), final score, venue and tip-off time (a bare Japan-time HH:MM). tab is the division (1 = B1, 2 = B2, 3 = B3) and event the competition type; season is the END year.

Usage

bleague_schedule(season, tab, month, day, event = NULL)

Arguments

season

(integer required): season END year (2026 = 2025-26); the site's own year is the START year, so the request sends season - 1.

tab

(integer required): division tab: 1 = B1, 2 = B2, 3 = B3.

month

(integer required): calendar month 1-12 of the game day (seasons run September to June).

day

(integer required): day of month of the game day.

event

(integer optional): competition type: 2 B1 league, 3 B1 Championship, 4 B1 relegation playoffs, 5 all-star, 7 B2 league, 8 B2 playoffs, 11 B1-B2 promotion/relegation, 15 B3 league, 32 B3 playoffs. NULL (default) = the league competition of the tab (2 / 7 / 15).

Value

A hoopR_data tibble with these columns:

col_nametypedescription
seasonintegerSeason END year (2026 = 2025-26), the feed's Year (the START year) plus one.
tabintegerDivision tab: 1 = B1, 2 = B2, 3 = B3.
eventintegerCompetition type of the page: 2 B1 league, 3 B1 Championship, 4 B1 relegation playoffs, 5 all-star, 7 B2 league, 8 B2 playoffs, 11 B1-B2 promotion/relegation, 15 B3 league, 32 B3 playoffs.
schedule_keyintegerB.LEAGUE ScheduleKey (key space: B.LEAGUE games, ONE global integer sequence across B1, B2, B3 and every season). The {schedule_key} every game wrapper takes and the schedule page's list-item id.
dateDateLocal game date, derived from the requested month and day (September to June; months 7-12 fall in the season's START year).
round_labelcharacterRound label as printed in Japanese, 'dai N setsu' (round N); playoffs print other labels.
roundintegerRound number parsed from round_label; null when the label is not 'dai N setsu' (round N).
home_team_idcharacterHome club TeamID as text, mapped from the page's club filter. B.LEAGUE TeamID as text (key space: B.LEAGUE clubs, stable across seasons AND club renames: 703 = Tochigi Brex in 2016-17 = Utsunomiya Brex in 2025-26). The feed sends a string on v2 and an integer on v1; both are text here. Not a player id.
home_teamcharacterHome club short name in Japanese as the page prints it (e.g. Osaka).
home_scoreintegerHome final score; null for a game without one.
away_team_idcharacterAway club TeamID as text, mapped from the page's club filter. B.LEAGUE TeamID as text (key space: B.LEAGUE clubs, stable across seasons AND club renames: 703 = Tochigi Brex in 2016-17 = Utsunomiya Brex in 2025-26). The feed sends a string on v2 and an integer on v1; both are text here. Not a player id.
away_teamcharacterAway club short name in Japanese as the page prints it (e.g. San-en).
away_scoreintegerAway final score; null for a game without one.
prefecturecharacterPrefecture of the venue in Japanese (e.g. Osaka Prefecture); null when the page gives none.
venuecharacterVenue name in Japanese, abbreviated by the page (e.g. Ookini for Osaka Edion Arena).
tip_timecharacterTip-off time 'HH:MM' in JST (no offset on the page); null when absent.
statecharacterScore-state label on the page (FINAL for a finished game); null when absent.

Details

Source, terms of use, request pacing, seasons, ids, coverage and error classes of this family: see the notes in bleague_game_info().

See also

Other B.LEAGUE Functions: bleague_game_info(), bleague_leaders(), bleague_pbp(), bleague_period_scores(), bleague_player_box(), bleague_schedule_clubs(), bleague_schedule_days(), bleague_schedule_events(), bleague_score_track(), bleague_shots(), bleague_standings(), bleague_team_box(), bleague_team_summary()

Examples

# \donttest{
  try(bleague_schedule(season = 2026, tab = 1, month = 10, day = 4))
#> ── B.LEAGUE schedule from www.bleague.jp ──────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:27:23 UTC
#> # A tibble: 12 × 17
#>    season   tab event schedule_key date       round_label round home_team_id
#>     <int> <int> <int>        <int> <date>     <chr>       <int> <chr>       
#>  1   2026     1     2       504748 2025-10-04 第1節           1 700         
#>  2   2026     1     2       504750 2025-10-04 第1節           1 1638        
#>  3   2026     1     2       504730 2025-10-04 第1節           1 745         
#>  4   2026     1     2       504732 2025-10-04 第1節           1 2486        
#>  5   2026     1     2       504740 2025-10-04 第1節           1 728         
#>  6   2026     1     2       504746 2025-10-04 第1節           1 699         
#>  7   2026     1     2       504742 2025-10-04 第1節           1 717         
#>  8   2026     1     2       504744 2025-10-04 第1節           1 729         
#>  9   2026     1     2       504728 2025-10-04 第1節           1 692         
#> 10   2026     1     2       504736 2025-10-04 第1節           1 726         
#> 11   2026     1     2       504738 2025-10-04 第1節           1 727         
#> 12   2026     1     2       504752 2025-10-04 第1節           1 701         
#> # ℹ 9 more variables: home_team <chr>, home_score <int>, away_team_id <chr>,
#> #   away_team <chr>, away_score <int>, prefecture <chr>, venue <chr>,
#> #   tip_time <chr>, state <chr>
# }