Skip to contents

Players of a team in a season phase, with the head coach.

Endpoint: GET https://api.wjbl.01core.app/api/team/roster

Usage

wjbl_roster(team_id, season_id = NULL)

Arguments

team_id

Franchise id (team_id in wjbl_teams): stable across seasons and sponsor renames, e.g. 13 (Toyota Antelopes).

season_id

Season phase id (season_id in wjbl_standing_seasons), e.g. 169 (2025-26 regular season, Premier division).

Value

A wehoop_data tibble, one row per record; the columns are always these, in this order (sdv-py wjbl_roster):

col_nametypedescription
league_idintegerCompetition-edition id league_id (key space: W League competitions; sequential, ONE id per season of the league AND per all-star game, cup or camp: 45 = '25-26 W League', 47 = '26-27', 20 = '13-14', 46 = All-Star 2025-26). The league_id parameter of /play-schedules and /play-schedule-months; enumerate with /leagues. The sdv season is the END year of league_title (END = 2000 + the second YY: '25-26' -> 2026, '99-00' -> 2000).
league_titlecharacterCompetition-edition title in Japanese: '25-26 W League' = 2025-26 W League (sdv END year 2026; END = 2000 + the second YY: '25-26' -> 2026, '99-00' -> 2000); also All-Star game, Autumn Cup, Summer Camp, 'W League SUPERGAMES'.
seasonintegerSeason END year (2025-26 = 2026, 1999-2000 = 2000) from league_title ('25-26 W League'); null for an all-star game, cup or camp.
season_idintegerThe season_id asked for: Season-phase id season_id (key space: phases WITHIN a league_id, e.g. 169 = 25-26 regular season Premier, 170 = 25-26 regular season Future, 176 = 25-26 playoff final). Not a year: one league_id has several season_ids. The season_ids parameter of /team-standings and /team-ranking and the season_id of /team/roster.
season_full_namecharacterleague_title + phase (+ division) in Japanese: 2025-26 regular season, Premier division (Future division, from 2024-25).
season_team_idintegerTeam-season registration id (key space: one per team per season phase; 1343 = Toyota in season 169). Not team_id.
team_idintegerThe team_id asked for: Franchise id team_id (key space: W League franchises, STABLE across seasons and sponsor renames: 13 = Toyota Antelopes, 12 = Denso Iris, 8 = ENEOS Sunflowers; all-star sides have their own ids, e.g. 591). The team_id of /team/roster and of the site's /team/roster/?team_id=. Not season_team_id.
coach_idintegerHead-coach id (key space: W League coaches; the coach_id of /coach and of the site's /coach/?coach_id=).
coach_namecharacterHead coach name, Japanese.
team_commentcharacterFree text the league shows with the roster (captains and other notes, HTML with <br>), as sent.
player_idintegerPlayer id player_id (key space: W League persons, STABLE across seasons and teams). The player_id of /player and the pi= of the site's /player/detail?pi=; joins the play-by-play player_id1 / player_id2.
player_namecharacterPlayer name, Japanese.
player_numbercharacterShirt number, a string.
captain_flgintegerCaptain: 1 = yes, 0 = no.
sub_captain_flgintegerVice-captain: 1 = yes, 0 = no.
transfer_flgintegerTransferred in this season ((Japanese) icon): 1 = yes, 0 = no.
positioncharacterPlaying position (G / F / C style code); empty in every sampled row.
rookieintegerRookie ((Japanese) icon): 1 = yes, 0 = no.
early_entryintegerEarly-entry player ((Japanese), a student who joined before graduating): 1 = yes, 0 = no.
picturecharacterPlayer photo path relative to https://www.wjbl.org.
foreign_national_flgintegerForeign national ((Japanese) icon): 1 = yes, 0 = no.
naturalized_flgintegerNaturalised player ((Japanese) icon): 1 = yes, 0 = no.

Details

  • Unofficial and unsupported: these wrappers read the JSON backend of www.wjbl.org (api.wjbl.01core.app), keyless, found in the site's own JavaScript. The site's terms of use (www.wjbl.org/kiyaku/) forbid reproducing, republishing or otherwise using site content without permission: a copyright clause, not an anti-scraping one. The wrappers fetch on the user's behalf; a published data release or a hosted mirror needs the owner's decision first. The site has no robots.txt (404, checked 2026-10-12), so no Crawl-delay is published; the runtime waits at least 1 s before every request, retries included. Payloads are not redistributed as release assets.

  • Women's league: the W League is Japan's top women's basketball league (the SportsDataverse R counterpart is wehoop). All text is Japanese (team names, phases, play-by-play actions); the column descriptions translate the vocabulary.

  • Seasons are END years (2026 = 2025-26, 2000 = 1999-2000). The API keys a season edition by an opaque league_id (45 = '25-26 W League'; every all-star game, cup and camp has one too) and the wrappers map the END year with the live league list (one extra, cached request; END = 2000 + the second YY of league_title). Phases inside an edition (season_id: 169 = regular season Premier, 170 = Future, 176 = playoff final; two divisions from 2024-25) are native ids, passed as given: wjbl_standing_seasons lists them with their END year.

  • The schedule is paged by month: wjbl_schedule answers ONE month (game_month, YYYY-MM; omitted = the season's latest month only). List the months with wjbl_game_months and loop. The game routes take only the global play_schedule_id and serve final games only: each makes one extra, cached request (the game header) to prove the game is final and that the answer is the game and the teams asked for.

  • Errors are HTTP 200: an unknown id answers [] (wehoop_no_data) and a missing or non-numeric parameter answers an error envelope (wehoop_asset_fetch). Coverage: schedules from 1999-2000, box scores from 2013-14, play-by-play and the period stats from 2018-19 (earlier games answer [] on the /pbp routes: wehoop_no_data). No route carries shot coordinates.

  • Personal data: the organiser's contact details (phones, e-mail) and the player's blood type are never output, and phone numbers and e-mail addresses inside free text are replaced by [redacted-phone] / [redacted-email]. Do not add them back. Player bio fields and referee names are public and stay.

  • Errors are classed conditions, all inheriting wehoop_error: wehoop_no_data (HTTP 404 or the API has nothing for the request: an empty list, an id it does not know, a game without play-by-play before 2018-19, a season without months or games), wehoop_bad_request (a season that is not the END year of a W League edition, an id that is not an integer or a game_month that is not YYYY-MM, raised before the request, or the API's HTTP 400 / 422) and wehoop_asset_fetch (any other failure: an error envelope at HTTP 200, any other non-2xx, an empty or non-JSON body, a game that is not final, a truncated play-by-play, or a body for another game, league edition, month, team, season phase or player than the one asked for; transient is TRUE for 408 / 429 / 5xx and transport failures). HTTP 500 is retried. Wrappers raise; they never warn and return an empty frame.

 wjbl_roster(season_id = 169, team_id = 13)