Package 'wehoop'

Title: Access Women's Basketball Play by Play Data
Description: A utility for working with women's basketball data. A scraping and aggregating interface for the WNBA Stats API <https://stats.wnba.com/> and ESPN's women's college basketball and WNBA statistics. It provides users with the capability to access the game play-by-plays, box scores, standings and results to analyze the data for themselves.
Authors: Saiem Gilani [aut, cre, cph] (ORCID: <https://orcid.org/0000-0002-7194-9067>), Geoffery Hutchinson [aut]
Maintainer: Saiem Gilani <[email protected]>
License: MIT + file LICENSE
Version: 3.1.0
Built: 2026-10-18 23:28:22 UTC
Source: https://github.com/sportsdataverse/wehoop

Help Index


Add players on court in WNBA Stats API play-by-play

Description

Add players on court in WNBA Stats API play-by-play


Atrium Player Box Score

Description

One game's box score: one row per rostered player with the statistics the site configures.

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/fixture_detail?sub=statistics⁠

A player who did not play has participated FALSE and NA statistics. LNB has blocks_received and plus_minus but no field-goal totals; LNBP the reverse. minutes is the ISO duration as sent and seconds_played its value. Percentages are 0-100. side is home or away.

Usage

atrium_box_score(website_id, fixture_id, locale = NULL)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

fixture_id

(character required): Game UUID (fixture_id in atrium_fixtures()), e.g. "0dc631bd-c34c-11f1-8d16-4d5a21afb79d".

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

Value

A wehoop_data tibble, one row per ⁠(fixture_id, person_id)⁠:

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
entity_id character Team UUID the player is rostered with for this game.
side character Side of the game the row belongs to: home or away (from the fixture's isHome flag).
person_id character Player UUID (person), shared across seasons and sites.
person_name character Player name as the site prints it (upper case on LNBP and NBL1).
bib character Jersey number the player wears, as text.
position character Position code on the roster (LNB, e.g. PG); null on LNBP.
starter logical True when the player started the game.
active logical True when the player is on the court in a live game.
participated logical True when the player entered the game; false rows have null statistics.
did_not_play_reason character Reason the player did not play; null in every body seen.
minutes character Time played as an ISO 8601 duration (PT7M23S); a team's is the sum over its players (PT200M) (player, this game).
seconds_played integer Time played in whole seconds, parsed from minutes (player, this game).
points integer Points scored (player, this game).
rebounds integer Total rebounds (player, this game).
rebounds_offensive integer Offensive rebounds (player, this game).
rebounds_defensive integer Defensive rebounds (player, this game).
assists integer Assists (player, this game).
steals integer Steals (player, this game).
blocks integer Shots blocked (player, this game).
blocks_received integer Own shots blocked by an opponent (LNB only) (player, this game).
turnovers integer Turnovers (player, this game).
fouls_total integer Fouls committed (player, this game).
fouls_drawn integer Fouls drawn (committed against the player or team; LNBP only) (player, this game).
plus_minus integer Plus/minus, the point differential while on court (LNB only; null in some team lines) (player, this game).
efficiency integer Efficiency rating, from the site's own formula (player, this game).
field_goals_made integer Field goals made, two- and three-pointers together (LNBP only) (player, this game).
field_goals_attempted integer Field goals attempted (LNBP only) (player, this game).
field_goals_percentage double Field-goal percentage, 0-100 (LNBP only) (player, this game).
points_two_made integer Two-point field goals made (player, this game).
points_two_attempted integer Two-point field goals attempted (player, this game).
points_two_percentage double Two-point percentage, 0-100 (player, this game).
points_three_made integer Three-point field goals made (player, this game).
points_three_attempted integer Three-point field goals attempted (player, this game).
points_three_percentage double Three-point percentage, 0-100 (player, this game).
free_throws_made integer Free throws made (player, this game).
free_throws_attempted integer Free throws attempted (player, this game).
free_throws_percentage double Free-throw percentage, 0-100 (player, this game).
points_fast_break integer Fast-break points (LNBP only) (player, this game).

See Also

Other Atrium Functions: atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition

Examples

try(atrium_box_score(website_id = 14, fixture_id = "0dc631bd-c34c-11f1-8d16-4d5a21afb79d"))

Atrium Competition Player Stats (long form)

Description

Player statistics of a competition in long form (names only: the bodies carry no ids).

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/statistics_competition_persons⁠

Usage

atrium_competition_player_stats(website_id, competition_id, locale = NULL)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

competition_id

(character required): Competition UUID (competition_id in atrium_seasons()), e.g. "3f4064bb-51ad-11f0-aaaf-2923c944b404".

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

 atrium_competition_player_stats(
   website_id = 12, competition_id = "3f4064bb-51ad-11f0-aaaf-2923c944b404"
 )

Value

A wehoop_data tibble, one row per ⁠(table_key, person_name, stat_key)⁠:

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID of the table; null for the competition-scoped routes (their bodies carry none).
table_key character Statistics table the row is from: averages, shootingstatistics, totals, ... (the set is per site).
table_label character The table's heading in the site's language (e.g. Moyennes).
person_id character Player UUID decoded from the widget link beside the name (the tables carry names only); null when the link is missing or undecodable, and always null in team and competition bodies.
person_name character Player name as the site prints it; null in team tables.
entity_id character Team UUID decoded from the widget link (team tables only; player tables name the team but carry no id).
entity_name character Team name as the site prints it; for player rows of a stat table it is the player's team.
stat_key character Statistic key as the API names it (pointsPerGame, fieldGoalsMade, ...), unchanged from header key.
stat_name character Short column heading the site shows for the statistic (PTS, REB), in the site's language.
stat_label character Longer statistic label the site shows (code in the API), in the site's language.
value double Numeric value of the statistic; null when the API sends a duration or text (see value_text).
value_text character Non-numeric statistic value, e.g. an ISO 8601 duration such as PT12M2S for minutes per game.

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition


Atrium Competition Team Stats (long form)

Description

Team statistics of a competition in long form (names only: the bodies carry no ids).

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/statistics_competition_entities⁠

Usage

atrium_competition_team_stats(website_id, competition_id, locale = NULL)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

competition_id

(character required): Competition UUID (competition_id in atrium_seasons()), e.g. "3f4064bb-51ad-11f0-aaaf-2923c944b404".

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

 atrium_competition_team_stats(
   website_id = 12, competition_id = "3f4064bb-51ad-11f0-aaaf-2923c944b404"
 )

Value

A wehoop_data tibble, one row per ⁠(table_key, entity_name, stat_key)⁠:

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID of the table; null for the competition-scoped routes (their bodies carry none).
table_key character Statistics table the row is from: averages, shootingstatistics, totals, ... (the set is per site).
table_label character The table's heading in the site's language (e.g. Moyennes).
person_id character Player UUID decoded from the widget link beside the name (the tables carry names only); null when the link is missing or undecodable, and always null in team and competition bodies.
person_name character Player name as the site prints it; null in team tables.
entity_id character Team UUID decoded from the widget link (team tables only; player tables name the team but carry no id).
entity_name character Team name as the site prints it; for player rows of a stat table it is the player's team.
stat_key character Statistic key as the API names it (pointsPerGame, fieldGoalsMade, ...), unchanged from header key.
stat_name character Short column heading the site shows for the statistic (PTS, REB), in the site's language.
stat_label character Longer statistic label the site shows (code in the API), in the site's language.
value double Numeric value of the statistic; null when the API sends a duration or text (see value_text).
value_text character Non-numeric statistic value, e.g. an ISO 8601 duration such as PT12M2S for minutes per game.

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition


Atrium END Year

Description

The sdv season key (END year) of a site's own year, or NA when it cannot be mapped.

Usage

atrium_end_year(website_id, year)

Arguments

website_id

(integer required): The site (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro).

year

(integer required): The year of a site's season list (START year on site 12, the calendar year elsewhere); a vector is mapped element by element.

Value

An integer vector: year + 1 on site 12 (2025 -> 2026 = 2025-26), year on the calendar-year sites, NA for an unregistered site, site 236 (no season list) or a value that is not a whole number.

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition

Examples

atrium_end_year(12, 2025)
atrium_end_year(14, 2026)

Atrium Fixture (game header)

Description

One game's header: teams, score, venue, status, rules (periods, overtime, shot clock) and captains.

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/fixture_detail?sub=statistics⁠

The rules (number_of_periods, period_length in minutes, overtime_length, shot_clock in seconds, ...) come from the game's profile. ⁠*_captain_person_id⁠ is the person id of each team's captain.

Usage

atrium_fixture(website_id, fixture_id, locale = NULL)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

fixture_id

(character required): Game UUID (fixture_id in atrium_fixtures()), e.g. "0dc631bd-c34c-11f1-8d16-4d5a21afb79d".

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

Value

A wehoop_data tibble, one row for the game:

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
competition_name character Name of the competition, in the site's language.
name character Fixture name; null on LNBP.
fixture_type character Kind of game as sent: REGULAR, PLAYOFF, ... (the set is open).
age_group character Age group of the competition, e.g. SENIOR.
status character Status code of the game, e.g. CONFIRMED (final), as sent.
status_label character Status of the game as the site words it in its own language (e.g. Termine, Final).
start_time_utc POSIXct Scheduled start, naive datetime in UTC (the API sends no offset).
start_time_local character Scheduled start in the venue's local time, as the API sends it (YYYY-MM-DDTHH:MM:SS, no offset; timezone gives the zone, which varies per row).
timezone character IANA time zone of the venue (e.g. Europe/Paris, Mexico/General) that start_time_local is in.
venue character Name of the arena where the game is played.
venue_id character Venue UUID; joins no other route.
attendance integer Spectators at the game; null when not reported.
external_id character The league's own match number (LNB: the lnb.fr number); null elsewhere.
updated POSIXct When the record was last updated, naive datetime (no offset; zone unverified).
live_data_available logical True when live data feeds are enabled for the game.
live_video_available logical True when a live video stream is attached.
discipline character Discipline label of the game; null in every body seen.
series character Playoff series the game belongs to as sent (JSON text when an object); null outside a series.
number_of_periods integer Regulation periods in the game (4).
period_length integer Length of a regulation period, in minutes.
overtime_allowed logical True when the game may go to overtime.
overtime_length integer Length of an overtime period, in minutes.
shot_clock integer Shot clock length, in seconds.
max_fouls_personal integer Personal fouls that disqualify a player.
fouls_before_bonus integer Team fouls in a period before the bonus applies.
maximum_players_on_court integer Players a team has on court at once.
maximum_roster_size integer Largest roster a team may enter for the game.
home_entity_id character Team UUID of the home team.
home_code character Short code of the home team (e.g. PAB).
home_name character Name of the home team.
home_score integer Points scored by the home team (the API sends a string; Int64 here).
home_result_status character Result status of the home team's score, e.g. CONFIRMED.
away_entity_id character Team UUID of the away team.
away_code character Short code of the away team (e.g. PAB).
away_name character Name of the away team.
away_score integer Points scored by the away team (the API sends a string; Int64 here).
away_result_status character Result status of the away team's score, e.g. CONFIRMED.
home_captain_person_id character Person UUID of the home team's captain; null when the body names none.
away_captain_person_id character Person UUID of the away team's captain; null when the body names none.

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition

Examples

try(atrium_fixture(website_id = 14, fixture_id = "0dc631bd-c34c-11f1-8d16-4d5a21afb79d"))

Atrium Fixture Periods

Description

One game's periods with the points each team scored in each, overtime periods included (ids 11+).

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/fixture_detail?sub=statistics⁠

home_points / away_points are the points scored IN that period, not the running score. Overtime periods are period_id 11, 12, ... (not 5).

Usage

atrium_fixture_periods(website_id, fixture_id, locale = NULL)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

fixture_id

(character required): Game UUID (fixture_id in atrium_fixtures()), e.g. "0dc631bd-c34c-11f1-8d16-4d5a21afb79d".

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

 atrium_fixture_periods(website_id = 14, fixture_id = "0dc631bd-c34c-11f1-8d16-4d5a21afb79d")

Value

A wehoop_data tibble, one row per ⁠(fixture_id, period_id)⁠:

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
period_id integer Period number: 1-4 regulation, 11, 12, ... overtimes (not 5).
label character Short period label in the site's language (Q1, P1), as sent.
is_overtime logical True for an overtime period.
is_shootout logical True for a shootout period.
started logical True once the period has started.
ended logical True once the period has ended.
duration_minutes integer Length of the period in minutes.
elapsed_minutes_before_period integer Minutes of game time played before the period starts (40 for the first overtime).
home_entity_id character Team UUID of the home team, from the fixture's isHome flag.
away_entity_id character Team UUID of the away team, from the fixture's isHome flag.
home_points integer Points the home team scored in this period (not the running score).
away_points integer Points the away team scored in this period (not the running score).

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition


Atrium Fixtures (schedule and results)

Description

Fixtures (schedule and results) of a season, home and away side by side.

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/fixtures⁠

Scores are integers (the API sends strings); start_time_utc is a UTC POSIXct; start_time_local is the venue's wall-clock time as the API sends it (character: its zone, timezone, varies per row, so no single POSIXct zone fits). sdv-py keeps both naive.

Usage

atrium_fixtures(
  website_id,
  season = NULL,
  season_id = NULL,
  competition_id = NULL,
  entity_id = NULL,
  round_number = NULL,
  sub = NULL,
  locale = NULL
)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

season

(integer optional): Season END year (2026 = 2025-26 on LNB, site 12, whose own year is the START year; the calendar year on the other sites). Needs competition_id when several competitions share that year (see atrium_seasons()). Omit season and season_id for the site's default season.

season_id

(character optional): Season UUID (season_id in atrium_seasons()); sent as is, skipping the END-year lookup of season.

competition_id

(character optional): Competition UUID (competition_id in atrium_seasons()). Picks the season together with season, and is then not sent; with neither season nor season_id the API filters by it.

entity_id

(character optional): Team UUID (entity_id in atrium_teams() or any fixture row).

round_number

(integer optional): Round (journee) number to show; the pages that take it list their rounds.

sub

(character optional): Tab: "FIXTURES" (upcoming) or "RESULTS" (played). Omitted = the site's default tab.

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

Value

A wehoop_data tibble, one row per fixture_id:

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID the page is about (the site's default season when none was asked).
competition_id character Competition UUID of the season.
competition_name character Competition name in the site's language, e.g. Betclic ELITE or LIGA CALIENTE.MX LNBP.
season_end_year integer Season END year (the sdv key): the site's year + 1 on LNB (site 12), the calendar year on the other registered sites; null when the site is unregistered, lists no seasons or the body has no season list.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
fixture_type character Kind of game as sent: REGULAR, PLAYOFF, ... (the set is open).
name character Fixture name as the site prints it (e.g. Paris - Lyon-Villeurbanne); null on LNBP.
round character Round of the game as the site words it, e.g. Journee: 30.
round_code character Round code; null in every body seen.
pool character Pool the game belongs to; null when the competition has none.
series character Playoff series the game belongs to as sent (JSON text when an object); null outside a series.
stage_code character Opaque 30-hex stage code of the game; null in every body seen.
status character Status code of the game, e.g. CONFIRMED (final), as sent.
status_label character Status of the game as the site words it in its own language (e.g. Termine, Final).
start_time_utc POSIXct Scheduled start, naive datetime in UTC (the API sends no offset).
start_time_local character Scheduled start in the venue's local time, as the API sends it (YYYY-MM-DDTHH:MM:SS, no offset; timezone gives the zone, which varies per row).
timezone character IANA time zone of the venue (e.g. Europe/Paris, Mexico/General) that start_time_local is in.
times_unconfirmed logical True while the start time is not final.
venue character Name of the arena where the game is played.
venue_id character Venue UUID; joins no other route.
attendance integer Spectators at the game; null when not reported.
home_entity_id character Team UUID of the home team.
home_code character Short code of the home team (e.g. PAB).
home_name character Name of the home team.
home_score integer Points scored by the home team (the API sends a string; Int64 here).
home_result_place integer Result place of the home team: 1 for the winner, 2 for the loser.
home_result_status character Result status of the home team's score, e.g. CONFIRMED.
home_draw logical True when the game ended level for the home team.
home_shootout_attempts character Shootout attempts of the home team as sent (an empty string becomes null).
home_secondary_score character Secondary score of the home team (unused in the samples; shown as text).
away_entity_id character Team UUID of the away team.
away_code character Short code of the away team (e.g. PAB).
away_name character Name of the away team.
away_score integer Points scored by the away team (the API sends a string; Int64 here).
away_result_place integer Result place of the away team: 1 for the winner, 2 for the loser.
away_result_status character Result status of the away team's score, e.g. CONFIRMED.
away_draw logical True when the game ended level for the away team.
away_shootout_attempts character Shootout attempts of the away team as sent (an empty string becomes null).
away_secondary_score character Secondary score of the away team (unused in the samples; shown as text).

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition

Examples

try(atrium_fixtures(website_id = 14))

Atrium Fixtures Ribbon

Description

The fixtures ribbon: recent and upcoming games across the site's competitions (empty on LNB off-season).

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/fixtures_ribbon⁠

Its scores are integers; start_time_local is the ribbon's fixture.date (a local time, no offset; unverified).

Usage

atrium_fixtures_ribbon(
  website_id,
  season = NULL,
  season_id = NULL,
  competition_id = NULL,
  entity_id = NULL,
  locale = NULL
)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

season

(integer optional): Season END year (2026 = 2025-26 on LNB, site 12, whose own year is the START year; the calendar year on the other sites). Needs competition_id when several competitions share that year (see atrium_seasons()). Omit season and season_id for the site's default season.

season_id

(character optional): Season UUID (season_id in atrium_seasons()); sent as is, skipping the END-year lookup of season.

competition_id

(character optional): Competition UUID (competition_id in atrium_seasons()). Picks the season together with season, and is then not sent; with neither season nor season_id the API filters by it.

entity_id

(character optional): Team UUID (entity_id in atrium_teams() or any fixture row).

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

 atrium_fixtures_ribbon(website_id = 14)

Value

A wehoop_data tibble, one row per fixture_id:

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID of the game.
season_name character Name of the season / competition the game belongs to.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
series character Playoff series the game belongs to as sent (JSON text when an object); null outside a series.
stage_name character Name of the stage; null in every body seen.
status character Status code of the game, e.g. CONFIRMED.
status_label character Status of the game as the site words it in its own language (e.g. Termine, Final).
is_final logical True when the game is over.
is_live logical True while the game is being played.
times_unconfirmed logical True while the start time is not final.
start_time_utc POSIXct Scheduled start, naive datetime in UTC (the API sends no offset).
start_time_local character The ribbon's fixture date as the API sends it: a local wall-clock time (no offset; the zone is not given).
home_entity_id character Team UUID of the home team.
home_name character Name of the home team.
home_score integer Points scored by the home team (the API sends a string; Int64 here).
home_result_status character Result status of the home team's score, e.g. CONFIRMED.
home_is_leading logical True while the home team leads (ribbon rows).
away_entity_id character Team UUID of the away team.
away_name character Name of the away team.
away_score integer Points scored by the away team (the API sends a string; Int64 here).
away_result_status character Result status of the away team's score, e.g. CONFIRMED.
away_is_leading logical True while the away team leads (ribbon rows).

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition


Atrium Leaders

Description

Season leaders per statistic (top 5 each), with their player and team ids.

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/statistics_leaders⁠

rank is the 1-based position within the statistic. value is numeric; a duration statistic (minutesPerGame) lands in value_text as an ISO string.

Usage

atrium_leaders(
  website_id,
  season = NULL,
  season_id = NULL,
  competition_id = NULL,
  entity_id = NULL,
  locale = NULL
)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

season

(integer optional): Season END year (2026 = 2025-26 on LNB, site 12, whose own year is the START year; the calendar year on the other sites). Needs competition_id when several competitions share that year (see atrium_seasons()). Omit season and season_id for the site's default season.

season_id

(character optional): Season UUID (season_id in atrium_seasons()); sent as is, skipping the END-year lookup of season.

competition_id

(character optional): Competition UUID (competition_id in atrium_seasons()). Picks the season together with season, and is then not sent; with neither season nor season_id the API filters by it.

entity_id

(character optional): Team UUID (entity_id in atrium_teams() or any fixture row).

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

 atrium_leaders(
   website_id = 12, season = 2026, competition_id = "3f4064bb-51ad-11f0-aaaf-2923c944b404"
 )

Value

A wehoop_data tibble, one row per ⁠(season_id, stat_key, rank)⁠:

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID of the leaders.
stat_key character Statistic the leader is ranked in (points, pointsPerGame, efficiency, doubleDouble, ...).
stat_name character Short column heading the site shows for the statistic (PTS, REB), in the site's language.
stat_label character Longer statistic label the site shows (code in the API), in the site's language.
rank integer Position of the leader within the statistic, 1-based (the API lists the top 5).
entity_id character Team UUID of the leader's team.
entity_name character Name of the leader's team.
person_id character Player UUID of the leader.
person_name character Name of the leader.
value double Numeric value of the statistic; null when the API sends a duration or text (see value_text).
value_text character Non-numeric statistic value, e.g. an ISO 8601 duration such as PT12M2S for minutes per game.

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition


Atrium Play-by-Play

Description

One game's play-by-play: every event with the period clock, the player and the running score.

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/fixture_detail?sub=pbp⁠

sequence is the 1-based position in the body (periods in order, events chronological within a period). clock is the time REMAINING in the period as sent (PT10M0S at the start) and clock_seconds its value. home_score / away_score are the running score after the event. x / y (shots only) are percent of the court (0-100). Team events have no person_id. Overtime is period_id 11+.

Usage

atrium_pbp(website_id, fixture_id, locale = NULL)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

fixture_id

(character required): Game UUID (fixture_id in atrium_fixtures()), e.g. "0dc631bd-c34c-11f1-8d16-4d5a21afb79d".

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

Value

A wehoop_data tibble, one row per event_id:

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
sequence integer 1-based position of the event in the game (periods in order, events chronological).
event_id character Event UUID, shared with the same event in atrium_shots.
period_id integer Period number: 1-4 regulation, 11, 12, ... overtimes (not 5).
clock character Time REMAINING in the period as an ISO 8601 duration (PT10M0S at the start).
clock_seconds integer Seconds remaining in the period, parsed from clock.
entity_id character Team UUID the event is credited to.
side character Side of the game the row belongs to: home or away (from the fixture's isHome flag).
person_id character Player UUID; null for team events (time-outs, team rebounds).
person_name character Player the event is credited to; null for team events (time-outs, team rebounds).
bib character Jersey number of the player, as text; null for team events.
event_type character Event type: 2pt, 3pt, freeThrow, rebound, assist, steal, block, turnover, foul, substitution, timeOut, jumpBall, ... (language-independent).
event_sub_type character Event detail: jumpShot, layup, offensive, defensive, in, out, 1Of2, personal, ...; null when none.
description character The event's text in the site's language (e.g. Entre-deux remporte).
success logical True when a shot or free throw was made, false when missed; null for other events.
success_label character The made / missed label in the site's language; sent on shot events only.
x double Shot location along the 28 m court length as percent of the court (0-100, origin at a corner); the home team attacks the low-x basket all game; null for non-shots.
y double Shot location across the 15 m width as percent of the court (0-100); which sideline is 0 is unverified; null for non-shots.
home_score integer Home team's running score after the event.
away_score integer Away team's running score after the event.

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition

Examples

try(atrium_pbp(website_id = 14, fixture_id = "0dc631bd-c34c-11f1-8d16-4d5a21afb79d"))

Atrium Player Page

Description

A player page: bio and the season averages the card shows.

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/person_detail⁠

Info items the documented columns do not list (height, position, ...) are appended as columns named after their key.

Usage

atrium_player(
  website_id,
  person_id,
  season = NULL,
  season_id = NULL,
  competition_id = NULL,
  locale = NULL
)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

person_id

(character required): Player UUID (person_id in atrium_players() or a box score), e.g. "4458f165-f865-11f0-8ebf-539c931c1654".

season

(integer optional): Season END year (2026 = 2025-26 on LNB, site 12, whose own year is the START year; the calendar year on the other sites). Needs competition_id when several competitions share that year (see atrium_seasons()). Omit season and season_id for the site's default season.

season_id

(character optional): Season UUID (season_id in atrium_seasons()); sent as is, skipping the END-year lookup of season.

competition_id

(character optional): Competition UUID (competition_id in atrium_seasons()). Picks the season together with season, and is then not sent; with neither season nor season_id the API filters by it.

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

 atrium_player(website_id = 12, person_id = "4458f165-f865-11f0-8ebf-539c931c1654")

Value

A wehoop_data tibble, one row for the player:

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
person_id character Player UUID (person), shared across seasons and sites.
name character Player name as the site prints it.
bib character Jersey number on the card; null when none.
team_id character Team UUID of the player's current team on the card.
team_name character Name of the player's current team on the card.
image_url character URL of the Sportradar-hosted image (400 px).
date_of_birth Date Player's date of birth, from the card's info items.
age integer Player's age in years, from the card's info items.
nationality character Player's nationality in the site's language, from the card's info items.
points_per_game double Points per game over the season shown on the card.
rebounds_offensive_per_game double Offensive rebounds per game over the season shown on the card.
rebounds_defensive_per_game double Defensive rebounds per game over the season shown on the card.

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition


Atrium Player Game Log

Description

A player's game log: one row per game with the opponent, result and the statistics the site shows.

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/person_detail?sub=log⁠

score is the site's text ("88 - 91"); which side is listed first is unverified, so it is not split. date is the local start time (no offset). The log carries no fixture id: join on date and opponent.

Usage

atrium_player_game_log(
  website_id,
  person_id,
  season = NULL,
  season_id = NULL,
  competition_id = NULL,
  locale = NULL
)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

person_id

(character required): Player UUID (person_id in atrium_players() or a box score), e.g. "4458f165-f865-11f0-8ebf-539c931c1654".

season

(integer optional): Season END year (2026 = 2025-26 on LNB, site 12, whose own year is the START year; the calendar year on the other sites). Needs competition_id when several competitions share that year (see atrium_seasons()). Omit season and season_id for the site's default season.

season_id

(character optional): Season UUID (season_id in atrium_seasons()); sent as is, skipping the END-year lookup of season.

competition_id

(character optional): Competition UUID (competition_id in atrium_seasons()). Picks the season together with season, and is then not sent; with neither season nor season_id the API filters by it.

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

 atrium_player_game_log(website_id = 12, person_id = "4458f165-f865-11f0-8ebf-539c931c1654")

Value

A wehoop_data tibble, one row per game:

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
person_id character Player UUID (person), shared across seasons and sites.
season_id character Season UUID the log is for (the season asked, else the site's default).
date character Local start of the game as the API sends it (YYYY-MM-DDTHH:MM:SS, no offset; the zone is not given): the field the ribbon's start_time_local reads.
opponent_entity_id character Team UUID of the opponent.
opponent_name character Name of the opponent.
result character Result for the player's team: W or L.
result_label character Result label in the site's language (V, D).
score character Final score as the site's text (e.g. 88 - 91); which side is listed first is unverified, so it is not split.
minutes character Time played as an ISO 8601 duration (PT7M23S); a team's is the sum over its players (PT200M) (player, that game).
seconds_played integer Time played in whole seconds, parsed from minutes (player, that game).
points integer Points scored (player, that game).
rebounds integer Total rebounds (player, that game).
rebounds_offensive integer Offensive rebounds (player, that game).
rebounds_defensive integer Defensive rebounds (player, that game).
assists integer Assists (player, that game).
steals integer Steals (player, that game).
blocks integer Shots blocked (player, that game).
blocks_received integer Own shots blocked by an opponent (LNB only) (player, that game).
turnovers integer Turnovers (player, that game).
fouls_total integer Fouls committed (player, that game).
fouls_drawn integer Fouls drawn (committed against the player or team; LNBP only) (player, that game).
plus_minus integer Plus/minus, the point differential while on court (LNB only; null in some team lines) (player, that game).
efficiency integer Efficiency rating, from the site's own formula (player, that game).
field_goals_made integer Field goals made, two- and three-pointers together (LNBP only) (player, that game).
field_goals_attempted integer Field goals attempted (LNBP only) (player, that game).
field_goals_percentage double Field-goal percentage, 0-100 (LNBP only) (player, that game).
points_two_made integer Two-point field goals made (player, that game).
points_two_attempted integer Two-point field goals attempted (player, that game).
points_two_percentage double Two-point percentage, 0-100 (player, that game).
points_three_made integer Three-point field goals made (player, that game).
points_three_attempted integer Three-point field goals attempted (player, that game).
points_three_percentage double Three-point percentage, 0-100 (player, that game).
free_throws_made integer Free throws made (player, that game).
free_throws_attempted integer Free throws attempted (player, that game).
free_throws_percentage double Free-throw percentage, 0-100 (player, that game).
points_fast_break integer Fast-break points (LNBP only) (player, that game).
dunks integer Dunks (player, that game).
fouls_personal integer Personal fouls (player, that game).

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition


Atrium Player Seasons

Description

A player's per-game averages, one row per competition-season.

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/person_detail⁠

season_year is the site's own year and season_end_year the sdv END year. The statistics are the per-game averages the site configures (double rates, ISO minutes_per_game).

Usage

atrium_player_seasons(
  website_id,
  person_id,
  season = NULL,
  season_id = NULL,
  competition_id = NULL,
  locale = NULL
)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

person_id

(character required): Player UUID (person_id in atrium_players() or a box score), e.g. "4458f165-f865-11f0-8ebf-539c931c1654".

season

(integer optional): Season END year (2026 = 2025-26 on LNB, site 12, whose own year is the START year; the calendar year on the other sites). Needs competition_id when several competitions share that year (see atrium_seasons()). Omit season and season_id for the site's default season.

season_id

(character optional): Season UUID (season_id in atrium_seasons()); sent as is, skipping the END-year lookup of season.

competition_id

(character optional): Competition UUID (competition_id in atrium_seasons()). Picks the season together with season, and is then not sent; with neither season nor season_id the API filters by it.

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

 atrium_player_seasons(website_id = 12, person_id = "4458f165-f865-11f0-8ebf-539c931c1654")

Value

A wehoop_data tibble, one row per ⁠(person_id, season_name, team_id)⁠:

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
person_id character Player UUID (person), shared across seasons and sites.
season_name character Competition-season the line is for, in the site's language (Betclic ELITE - Playoffs 2025).
season_year integer The site's own year of that season (START year on LNB).
season_end_year integer Season END year of that season (sdv key); null when the site is unmapped.
team_id character Team UUID the player played for in that season.
team_name character Name of the team the player played for in that season.
minutes_per_game character Minutes per game as an ISO 8601 duration (player, that competition-season).
points_per_game double Points per game (player, that competition-season).
rebounds_per_game double Rebounds per game (player, that competition-season).
rebounds_offensive_per_game double Offensive rebounds per game (player, that competition-season).
rebounds_defensive_per_game double Defensive rebounds per game (player, that competition-season).
assists_per_game double Assists per game (player, that competition-season).
steals_per_game double Steals per game (player, that competition-season).
blocks_per_game double Blocks per game (player, that competition-season).
turnovers_per_game double Turnovers per game (player, that competition-season).
fouls_personal_per_game double Personal fouls per game (player, that competition-season).
dunks_per_game double Dunks per game (player, that competition-season).
efficiency integer Efficiency rating, from the site's own formula (player, that competition-season).

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition


Atrium Player Stats (season, long form)

Description

Player season statistics in long form (one row per player, table and statistic); ids decoded from the widget links.

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/statistics_persons⁠

Each body holds several tables (averages, shootingstatistics, totals, ...) whose statistic set the site configures. stat_key (pointsPerGame) carries its numeric value or, for ISO durations, value_text; pivot on stat_key for a wide table. Percentages are 0-100.

Usage

atrium_player_stats(
  website_id,
  season = NULL,
  season_id = NULL,
  competition_id = NULL,
  locale = NULL
)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

season

(integer optional): Season END year (2026 = 2025-26 on LNB, site 12, whose own year is the START year; the calendar year on the other sites). Needs competition_id when several competitions share that year (see atrium_seasons()). Omit season and season_id for the site's default season.

season_id

(character optional): Season UUID (season_id in atrium_seasons()); sent as is, skipping the END-year lookup of season.

competition_id

(character optional): Competition UUID (competition_id in atrium_seasons()). Picks the season together with season, and is then not sent; with neither season nor season_id the API filters by it.

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

Value

A wehoop_data tibble, one row per ⁠(table_key, person_id, stat_key)⁠:

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID of the table; null for the competition-scoped routes (their bodies carry none).
table_key character Statistics table the row is from: averages, shootingstatistics, totals, ... (the set is per site).
table_label character The table's heading in the site's language (e.g. Moyennes).
person_id character Player UUID decoded from the widget link beside the name (the tables carry names only); null when the link is missing or undecodable, and always null in team and competition bodies.
person_name character Player name as the site prints it; null in team tables.
entity_id character Team UUID decoded from the widget link (team tables only; player tables name the team but carry no id).
entity_name character Team name as the site prints it; for player rows of a stat table it is the player's team.
stat_key character Statistic key as the API names it (pointsPerGame, fieldGoalsMade, ...), unchanged from header key.
stat_name character Short column heading the site shows for the statistic (PTS, REB), in the site's language.
stat_label character Longer statistic label the site shows (code in the API), in the site's language.
value double Numeric value of the statistic; null when the API sends a duration or text (see value_text).
value_text character Non-numeric statistic value, e.g. an ISO 8601 duration such as PT12M2S for minutes per game.

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition

Examples

try(atrium_player_stats(
    website_id = 12, season = 2026, competition_id = "3f4064bb-51ad-11f0-aaaf-2923c944b404"
  ))

Atrium Players

Description

The players of a season, with position, nationality, birth date, age and height.

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/persons⁠

height is an integer where the site gives one (centimetres; unit unverified). position_code / position_name follow the site locale (the name is translated, the code is not). person_id is stable across seasons and sites.

Usage

atrium_players(
  website_id,
  season = NULL,
  season_id = NULL,
  competition_id = NULL,
  entity_id = NULL,
  locale = NULL
)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

season

(integer optional): Season END year (2026 = 2025-26 on LNB, site 12, whose own year is the START year; the calendar year on the other sites). Needs competition_id when several competitions share that year (see atrium_seasons()). Omit season and season_id for the site's default season.

season_id

(character optional): Season UUID (season_id in atrium_seasons()); sent as is, skipping the END-year lookup of season.

competition_id

(character optional): Competition UUID (competition_id in atrium_seasons()). Picks the season together with season, and is then not sent; with neither season nor season_id the API filters by it.

entity_id

(character optional): Team UUID (entity_id in atrium_teams() or any fixture row).

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

Value

A wehoop_data tibble, one row per ⁠(season_id, person_id)⁠:

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID of the roster list.
person_id character Player UUID (person), shared across seasons and sites.
name character Player name as the site prints it.
bib character Jersey number, as text.
entity_id character Team UUID the player is rostered with that season.
team_name character Team name in the site's language.
position_code character Position code (C, PG, SF, ...), language-independent.
position_name character Position name in the site's language.
nationality character Player's nationality in the site's language (e.g. Belgique).
date_of_birth Date Player's date of birth.
age integer Player's age in years when the body was generated.
height integer Height as an integer, centimetres presumed (unit unverified); null when the site gives none.
status character Player status in the site's language (Actif, Blesse).
image_url character URL of the Sportradar-hosted image (400 px).

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition

Examples

try(atrium_players(
    website_id = 12, season = 2026, competition_id = "3f4064bb-51ad-11f0-aaaf-2923c944b404"
  ))

Atrium Season Id

Description

The seasonId of a site's season, from its END year and optionally its competition.

Maps through the site's own season list (⁠/{website_id}/fixtures⁠), fetched once and cached for an hour per site.

Usage

atrium_season_id(website_id, season, competition_id = NULL)

Arguments

website_id

(integer required): The site (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 326 Montenegro). Site 236 lists no seasons.

season

(integer required): The sdv season END year (2026 = 2025-26 on LNB; the calendar year on the other sites). A whole number; a string, a logical or a fraction is refused.

competition_id

(character optional): The competition when the site lists several for that year (see atrium_seasons()). Omit it when the year is unique.

Details

Raises wehoop_bad_request when season is not a whole number, the site is not a known Atrium site, it lists no seasons (236), or the year is shared by several competitions and competition_id is missing; wehoop_no_data when the site lists no such season; wehoop_asset_fetch when the season list could not be fetched or is not the site's.

 atrium_season_id(14, 2026, competition_id = "16be8396-24fb-11ef-9ab7-df6be196e88f")

Value

The season's UUID (a character string), for the season_id argument of every season-scoped wrapper.

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition


Atrium Seasons

Description

Every season (competition and year) a site lists, with the sdv END year of each.

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/fixtures⁠

A season is one competition in one year. year is the site's own key (START year on site 12, calendar year elsewhere); season_end_year is the sdv END year. Site 236 lists no seasons, so its frame is empty.

Usage

atrium_seasons(website_id, locale = NULL)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

Value

A wehoop_data tibble, one row per season_id; is_default_season marks the season the site serves by default:

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID; pass it as season_id to any season-scoped wrapper.
competition_id character Competition UUID; pass it as competition_id to pick one of several seasons of an END year.
competition_name character Competition name in the site's language; the same name can appear for several years.
season_name character Season name in the site's language, e.g. Betclic ELITE 2025.
abbreviation_local character Local abbreviation of the season; null in every body seen.
year integer The site's own year of the season: the START year on LNB (site 12), the calendar year elsewhere.
season_end_year integer Season END year (the sdv key): the site's year + 1 on LNB (site 12), the calendar year on the other registered sites; null when the site is unregistered, lists no seasons or the body has no season list.
is_default_season logical True for the season the body is about (the site's default when none was asked).

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition

Examples

try(atrium_seasons(website_id = 12))

Atrium Shots

Description

One game's 2pt / 3pt attempts with their court location (percent of the court) and result.

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/fixture_detail?sub=shot_chart⁠

The shot chart holds field-goal attempts only (no free throws); event_id joins the same event in atrium_pbp(). x / y are percent of the court (0-100, origin at a corner, x along the 28 m length). LNBP and NBL1 clamp rim attempts to x = 5 / 95.

Usage

atrium_shots(website_id, fixture_id, locale = NULL)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

fixture_id

(character required): Game UUID (fixture_id in atrium_fixtures()), e.g. "0dc631bd-c34c-11f1-8d16-4d5a21afb79d".

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

Value

A wehoop_data tibble, one row per shot (event_id):

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
sequence integer 1-based position of the shot among the shots of the game (not the pbp sequence).
event_id character Event UUID of the shot; the same event in atrium_pbp.
period_id integer Period number: 1-4 regulation, 11, 12, ... overtimes (not 5).
clock character Time REMAINING in the period as an ISO 8601 duration (PT10M0S at the start).
clock_seconds integer Seconds remaining in the period, parsed from clock.
entity_id character Team UUID the event is credited to.
side character Side of the game the row belongs to: home or away (from the fixture's isHome flag).
person_id character Player UUID of the shooter.
person_name character Name of the shooter.
bib character Jersey number of the player, as text; null for team events.
event_type character Event type: 2pt, 3pt, freeThrow, rebound, assist, steal, block, turnover, foul, substitution, timeOut, jumpBall, ... (language-independent).
event_sub_type character Event detail: jumpShot, layup, offensive, defensive, in, out, 1Of2, personal, ...; null when none.
description character The event's text in the site's language (e.g. Entre-deux remporte).
success logical True when the shot was made, false when missed.
success_label character The made / missed label in the site's language; sent on shot events only.
x double Shot location along the 28 m court length as percent of the court (0-100, origin at a corner); the home team attacks the low-x basket all game; LNBP and NBL1 clamp rim attempts to 5 / 95.
y double Shot location across the 15 m width as percent of the court (0-100); which sideline is 0 is unverified.
home_score integer Home team's running score after the event.
away_score integer Away team's running score after the event.

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition

Examples

try(atrium_shots(website_id = 14, fixture_id = "0dc631bd-c34c-11f1-8d16-4d5a21afb79d"))

Atrium Standings

Description

Standings of a season, with the columns the site configures (LNB home / away splits, LNBP played and points).

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/standings⁠

win_percentage is a 0-1 fraction. group is the table's label (empty for a single table).

Usage

atrium_standings(
  website_id,
  season = NULL,
  season_id = NULL,
  competition_id = NULL,
  round_number = NULL,
  locale = NULL
)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

season

(integer optional): Season END year (2026 = 2025-26 on LNB, site 12, whose own year is the START year; the calendar year on the other sites). Needs competition_id when several competitions share that year (see atrium_seasons()). Omit season and season_id for the site's default season.

season_id

(character optional): Season UUID (season_id in atrium_seasons()); sent as is, skipping the END-year lookup of season.

competition_id

(character optional): Competition UUID (competition_id in atrium_seasons()). Picks the season together with season, and is then not sent; with neither season nor season_id the API filters by it.

round_number

(integer optional): Round (journee) number to show; the pages that take it list their rounds.

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

Value

A wehoop_data tibble, one row per ⁠(season_id, group, entity_id)⁠:

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID of the table.
season_end_year integer Season END year (the sdv key): the site's year + 1 on LNB (site 12), the calendar year on the other registered sites; null when the site is unregistered, lists no seasons or the body has no season list.
group character Label of the table when the standings hold several groups; null for a single table.
position integer League table position (1 = first).
entity_id character Team UUID of the row.
team_name character Team name as the site prints it.
is_current_team logical True for the team the page was opened for (team context); false on a plain standings request.
logo_url character URL of the team logo image.
wins integer Games won; -1 for two teams in the 2025-26 LNB table (an administrative ranking, unverified), kept as sent (team, this table).
losses integer Games lost (team, this table).
played integer Games played (LNBP and the compact standings) (team, this table).
standing_points integer League table points (LNBP) (team, this table).
win_percentage double Share of games won as a 0-1 fraction (not 0-100) (team, this table).
scored_for integer Points scored over the season (team, this table).
scored_against integer Points conceded over the season (team, this table).
point_difference integer Point differential over the season (team, this table).
result_string_home character Home results as a string of result letters in the site's language, one per game (order and letters per locale; unverified) (team, this table).
scored_for_home integer Points scored in home games (team, this table).
scored_against_home integer Points conceded in home games (team, this table).
point_difference_home integer Point differential in home games (team, this table).
result_string_away character Away results as a string of result letters in the site's language, one per game (order and letters per locale; unverified) (team, this table).
scored_for_away integer Points scored in away games (team, this table).
scored_against_away integer Points conceded in away games (team, this table).
point_difference_away integer Point differential in away games (team, this table).
streak integer Length of the current run of results (the win / loss sign convention is unverified) (team, this table).
streak_home integer Length of the current run of home results (sign convention unverified) (team, this table).
streak_away integer Length of the current run of away results (sign convention unverified) (team, this table).

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition

Examples

try(atrium_standings(
    website_id = 12, season = 2026, competition_id = "3f4064bb-51ad-11f0-aaaf-2923c944b404"
  ))

Atrium Standings Summary

Description

Compact standings of a season: position, wins, losses and games played.

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/standings_fragment⁠

The columns are those of atrium_standings(); the compact fragment fills only wins / losses / played.

Usage

atrium_standings_summary(
  website_id,
  season = NULL,
  season_id = NULL,
  competition_id = NULL,
  locale = NULL
)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

season

(integer optional): Season END year (2026 = 2025-26 on LNB, site 12, whose own year is the START year; the calendar year on the other sites). Needs competition_id when several competitions share that year (see atrium_seasons()). Omit season and season_id for the site's default season.

season_id

(character optional): Season UUID (season_id in atrium_seasons()); sent as is, skipping the END-year lookup of season.

competition_id

(character optional): Competition UUID (competition_id in atrium_seasons()). Picks the season together with season, and is then not sent; with neither season nor season_id the API filters by it.

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

 atrium_standings_summary(website_id = 12, season = 2026,
                          competition_id = "3f4064bb-51ad-11f0-aaaf-2923c944b404")

Value

A wehoop_data tibble, one row per ⁠(season_id, group, entity_id)⁠:

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID of the table.
season_end_year integer Season END year (the sdv key): the site's year + 1 on LNB (site 12), the calendar year on the other registered sites; null when the site is unregistered, lists no seasons or the body has no season list.
group character Label of the table when the standings hold several groups; null for a single table.
position integer League table position (1 = first).
entity_id character Team UUID of the row.
team_name character Team name as the site prints it.
is_current_team logical True for the team the page was opened for (team context); false on a plain standings request.
logo_url character URL of the team logo image.
wins integer Games won; -1 for two teams in the 2025-26 LNB table (an administrative ranking, unverified), kept as sent (team, this table).
losses integer Games lost (team, this table).
played integer Games played (LNBP and the compact standings) (team, this table).
standing_points integer League table points (LNBP) (team, this table).
win_percentage double Share of games won as a 0-1 fraction (not 0-100) (team, this table).
scored_for integer Points scored over the season (team, this table).
scored_against integer Points conceded over the season (team, this table).
point_difference integer Point differential over the season (team, this table).
result_string_home character Home results as a string of result letters in the site's language, one per game (order and letters per locale; unverified) (team, this table).
scored_for_home integer Points scored in home games (team, this table).
scored_against_home integer Points conceded in home games (team, this table).
point_difference_home integer Point differential in home games (team, this table).
result_string_away character Away results as a string of result letters in the site's language, one per game (order and letters per locale; unverified) (team, this table).
scored_for_away integer Points scored in away games (team, this table).
scored_against_away integer Points conceded in away games (team, this table).
point_difference_away integer Point differential in away games (team, this table).
streak integer Length of the current run of results (the win / loss sign convention is unverified) (team, this table).
streak_home integer Length of the current run of home results (sign convention unverified) (team, this table).
streak_away integer Length of the current run of away results (sign convention unverified) (team, this table).

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition


Atrium Team Page

Description

A team page (summary tab): the team and its last and next game.

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/entity_detail⁠

⁠previous_*⁠ is the last played game and ⁠next_*⁠ the next scheduled one (NA when the page shows none). entity_id is decoded from the page's tab links; color is a hex string with its ⁠#⁠.

Usage

atrium_team(
  website_id,
  entity_id,
  season = NULL,
  season_id = NULL,
  competition_id = NULL,
  locale = NULL
)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

entity_id

(character required): Team UUID (entity_id in atrium_teams() or any fixture row), e.g. "f43b1b0f-55bc-11f0-84d9-01499d2f0a07".

season

(integer optional): Season END year (2026 = 2025-26 on LNB, site 12, whose own year is the START year; the calendar year on the other sites). Needs competition_id when several competitions share that year (see atrium_seasons()). Omit season and season_id for the site's default season.

season_id

(character optional): Season UUID (season_id in atrium_seasons()); sent as is, skipping the END-year lookup of season.

competition_id

(character optional): Competition UUID (competition_id in atrium_seasons()). Picks the season together with season, and is then not sent; with neither season nor season_id the API filters by it.

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

 atrium_team(website_id = 12, entity_id = "f43b1b0f-55bc-11f0-84d9-01499d2f0a07")

Value

A wehoop_data tibble, one row for the team:

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
entity_id character Team UUID, decoded from the page's tab links (the body does not echo it elsewhere).
name character Team name from the page banner.
color character Team colour from the banner, hex string with its #.
logo_url character URL of the banner's team logo.
previous_fixture_id character Game UUID of the last played game shown on the team page.
previous_round character Round of the last played game as the site words it (e.g. 30).
previous_status character Status code of the last played game, e.g. CONFIRMED.
previous_start_time_utc POSIXct Start of the last played game, naive UTC datetime.
previous_start_time_local character Start of the last played game in venue-local time, as the API sends it (no offset).
previous_venue character Arena of the last played game.
previous_attendance integer Spectators at the last played game; null when not reported.
previous_home_entity_id character Team UUID of the last played game's home team.
previous_home_name character Name of the last played game's home team.
previous_home_score integer Home team's points in the last played game.
previous_away_entity_id character Team UUID of the last played game's away team.
previous_away_name character Name of the last played game's away team.
previous_away_score integer Away team's points in the last played game.
next_fixture_id character Game UUID of the next scheduled game shown on the team page.
next_round character Round of the next scheduled game as the site words it (e.g. 30).
next_status character Status code of the next scheduled game, e.g. CONFIRMED.
next_start_time_utc POSIXct Start of the next scheduled game, naive UTC datetime.
next_start_time_local character Start of the next scheduled game in venue-local time, as the API sends it (no offset).
next_venue character Arena of the next scheduled game.
next_attendance integer Spectators at the next scheduled game; null when not reported.
next_home_entity_id character Team UUID of the next scheduled game's home team.
next_home_name character Name of the next scheduled game's home team.
next_home_score integer Home team's points in the next scheduled game.
next_away_entity_id character Team UUID of the next scheduled game's away team.
next_away_name character Name of the next scheduled game's away team.
next_away_score integer Away team's points in the next scheduled game.

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition


Atrium Team Box Score

Description

One game's team lines: the team totals, the team-level counts and the game aggregates (lead changes, biggest lead).

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/fixture_detail?sub=statistics⁠

The team line is the API's entity block (minutes are the sum over players, PT200M); ⁠extra_*⁠ are the team-level counts not credited to a player (team rebounds and turnovers) and ⁠total_*⁠ the game-level aggregates.

Usage

atrium_team_box_score(website_id, fixture_id, locale = NULL)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

fixture_id

(character required): Game UUID (fixture_id in atrium_fixtures()), e.g. "0dc631bd-c34c-11f1-8d16-4d5a21afb79d".

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

Value

A wehoop_data tibble, one row per ⁠(fixture_id, entity_id)⁠:

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
entity_id character Team UUID (from the fixture's isHome flag).
side character Side of the game the row belongs to: home or away (from the fixture's isHome flag).
minutes character Time played as an ISO 8601 duration (PT7M23S); a team's is the sum over its players (PT200M) (team, this game).
seconds_played integer Time played in whole seconds, parsed from minutes (team, this game).
points integer Points scored (team, this game).
rebounds integer Total rebounds (team, this game).
rebounds_offensive integer Offensive rebounds (team, this game).
rebounds_defensive integer Defensive rebounds (team, this game).
assists integer Assists (team, this game).
steals integer Steals (team, this game).
blocks integer Shots blocked (team, this game).
blocks_received integer Own shots blocked by an opponent (LNB only) (team, this game).
turnovers integer Turnovers (team, this game).
fouls_total integer Fouls committed (team, this game).
fouls_drawn integer Fouls drawn (committed against the player or team; LNBP only) (team, this game).
plus_minus integer Plus/minus, the point differential while on court (LNB only; null in some team lines) (team, this game).
efficiency integer Efficiency rating, from the site's own formula (team, this game).
field_goals_made integer Field goals made, two- and three-pointers together (LNBP only) (team, this game).
field_goals_attempted integer Field goals attempted (LNBP only) (team, this game).
field_goals_percentage double Field-goal percentage, 0-100 (LNBP only) (team, this game).
points_two_made integer Two-point field goals made (team, this game).
points_two_attempted integer Two-point field goals attempted (team, this game).
points_two_percentage double Two-point percentage, 0-100 (team, this game).
points_three_made integer Three-point field goals made (team, this game).
points_three_attempted integer Three-point field goals attempted (team, this game).
points_three_percentage double Three-point percentage, 0-100 (team, this game).
free_throws_made integer Free throws made (team, this game).
free_throws_attempted integer Free throws attempted (team, this game).
free_throws_percentage double Free-throw percentage, 0-100 (team, this game).
points_fast_break integer Fast-break points (LNBP only) (team, this game).
extra_fouls_total integer Fouls committed (team, credited to the team rather than a player).
extra_rebounds integer Total rebounds (team, credited to the team rather than a player).
extra_rebounds_defensive integer Defensive rebounds (team, credited to the team rather than a player).
extra_rebounds_offensive integer Offensive rebounds (team, credited to the team rather than a player).
extra_turnovers integer Turnovers (team, credited to the team rather than a player).
total_biggest_lead integer Biggest lead of the game, in points (team, game total).
total_biggest_scoring_run integer Longest unanswered scoring run of the game, in points (team, game total).
total_field_goals_percentage double Field-goal percentage, 0-100 (LNBP only) (team, game total).
total_free_throws_percentage double Free-throw percentage, 0-100 (team, game total).
total_lead_changes integer Number of lead changes in the game (team, game total).
total_points_fast_break integer Fast-break points (LNBP only) (team, game total).
total_points_from_bench integer Points scored by non-starters (LNBP only) (team, game total).
total_points_from_turnover integer Points scored off opponent turnovers (LNBP only) (team, game total).
total_time_in_lead character Time the team led, as an ISO 8601 duration (PT36M11S) (team, game total).
total_time_in_lead_seconds integer Time the team led, in whole seconds (team, game total).
total_turnovers integer Turnovers (team, game total).

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition

Examples

try(atrium_team_box_score(website_id = 12, fixture_id = "5423072b-6715-11f0-bd8b-9ffadebc148f"))

Atrium Team Stats (season, long form)

Description

Team season statistics in long form (one row per team, table and statistic).

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/statistics_entities⁠

Usage

atrium_team_stats(
  website_id,
  season = NULL,
  season_id = NULL,
  competition_id = NULL,
  locale = NULL
)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

season

(integer optional): Season END year (2026 = 2025-26 on LNB, site 12, whose own year is the START year; the calendar year on the other sites). Needs competition_id when several competitions share that year (see atrium_seasons()). Omit season and season_id for the site's default season.

season_id

(character optional): Season UUID (season_id in atrium_seasons()); sent as is, skipping the END-year lookup of season.

competition_id

(character optional): Competition UUID (competition_id in atrium_seasons()). Picks the season together with season, and is then not sent; with neither season nor season_id the API filters by it.

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

Value

A wehoop_data tibble, one row per ⁠(table_key, entity_name, stat_key)⁠:

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID of the table; null for the competition-scoped routes (their bodies carry none).
table_key character Statistics table the row is from: averages, shootingstatistics, totals, ... (the set is per site).
table_label character The table's heading in the site's language (e.g. Moyennes).
person_id character Player UUID decoded from the widget link beside the name (the tables carry names only); null when the link is missing or undecodable, and always null in team and competition bodies.
person_name character Player name as the site prints it; null in team tables.
entity_id character Team UUID decoded from the widget link (team tables only; player tables name the team but carry no id).
entity_name character Team name as the site prints it; for player rows of a stat table it is the player's team.
stat_key character Statistic key as the API names it (pointsPerGame, fieldGoalsMade, ...), unchanged from header key.
stat_name character Short column heading the site shows for the statistic (PTS, REB), in the site's language.
stat_label character Longer statistic label the site shows (code in the API), in the site's language.
value double Numeric value of the statistic; null when the API sends a duration or text (see value_text).
value_text character Non-numeric statistic value, e.g. an ISO 8601 duration such as PT12M2S for minutes per game.

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition

Examples

try(atrium_team_stats(
    website_id = 12, season = 2026, competition_id = "3f4064bb-51ad-11f0-aaaf-2923c944b404"
  ))

Atrium Teams

Description

The teams of a season.

Endpoint: ⁠GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/entities⁠

Usage

atrium_teams(
  website_id,
  season = NULL,
  season_id = NULL,
  competition_id = NULL,
  locale = NULL
)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

season

(integer optional): Season END year (2026 = 2025-26 on LNB, site 12, whose own year is the START year; the calendar year on the other sites). Needs competition_id when several competitions share that year (see atrium_seasons()). Omit season and season_id for the site's default season.

season_id

(character optional): Season UUID (season_id in atrium_seasons()); sent as is, skipping the END-year lookup of season.

competition_id

(character optional): Competition UUID (competition_id in atrium_seasons()). Picks the season together with season, and is then not sent; with neither season nor season_id the API filters by it.

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

Value

A wehoop_data tibble, one row per ⁠(season_id, entity_id)⁠; entity_id is stable across seasons:

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID of the team list.
entity_id character Team UUID (entity): one id per club across seasons, shared by every site that shows the team.
name character Team name in the site's language.
image_url character URL of the Sportradar-hosted image (400 px).

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), lmb_competition, lnbp_competition, lpb_competition, nbl1_competition

Examples

try(atrium_teams(
    website_id = 12, season = 2026, competition_id = "3f4064bb-51ad-11f0-aaaf-2923c944b404"
  ))

Bart Torvik Women's Season Schedule & Results

Description

Get the full women's game-by-game schedule and results for a season from barttorvik.com. Pulls the ⁠/ncaaw/{year}_super_sked.json⁠ file (one row per game). No API key required.

Usage

bart_wbb_game_schedule(year = most_recent_wbb_season())

Arguments

year

Season, 4-digit ending-year format (e.g. 2024). Defaults to most_recent_wbb_season().

Value

A wehoop_data tibble, one row per game: muid, date, team1, team2, t1pts, t2pts, winner, loser, plus efficiency / quality columns, and year.

See Also

Other Bart Torvik Functions: bart_wbb_ratings()

Examples

try(bart_wbb_game_schedule(year = 2024))

Bart Torvik Women's T-Rank Ratings

Description

Get women's college basketball T-Rank team ratings and adjusted efficiencies from barttorvik.com. Pulls the ⁠/ncaaw/{year}_team_results.csv⁠ file (one row per team). No API key required.

Usage

bart_wbb_ratings(year = most_recent_wbb_season())

Arguments

year

Season, 4-digit ending-year format (e.g. 2024). Defaults to most_recent_wbb_season().

Value

A wehoop_data tibble, one row per team: rank, team, conf, record, adjoe, adjde, barthag, plus projection / SOS / quality columns, and year.

See Also

Other Bart Torvik Functions: bart_wbb_game_schedule()

Examples

try(bart_wbb_ratings(year = 2024))

Basketball-Reference WNBA Player Season Stats

Description

Get WNBA league-wide player season statistics from Basketball-Reference.

One row per player for a season. No account or API key is required. Basketball-Reference rate-limits aggressive scraping (~20 requests/minute) – space repeated calls with Sys.sleep().

Usage

bref_wnba_player_stats(season = most_recent_wnba_season(), table = "per_game")

Arguments

season

Season, in 4-digit year format (e.g. 2024). Defaults to most_recent_wnba_season().

table

Which stats table – one of "per_game" (default), "totals" or "advanced".

Value

A wehoop_data tibble with one row per player, carrying season and table columns.

col_name types
player character
team_id character
pos character
g numeric
pts_per_g numeric
season integer
table character

See Also

Other WNBA Basketball-Reference Functions: bref_wnba_standings(), bref_wnba_team_stats()

Examples

try(bref_wnba_player_stats(season = 2024, table = "per_game"))

Basketball-Reference WNBA Standings

Description

Get WNBA standings (both conferences) from Basketball-Reference.

One row per team with record and win percentage, labelled by a conference column (Eastern / Western). No account or API key is required.

Usage

bref_wnba_standings(season = most_recent_wnba_season())

Arguments

season

Season, 4-digit year format (e.g. 2024). Defaults to most_recent_wnba_season().

Value

A wehoop_data tibble with one row per team:

col_name types
team character
wins numeric
losses numeric
win_loss_pct numeric
conference character
season integer

See Also

Other WNBA Basketball-Reference Functions: bref_wnba_player_stats(), bref_wnba_team_stats()

Examples

try(bref_wnba_standings(season = 2024))

Basketball-Reference WNBA Team Season Stats

Description

Get WNBA team season statistics from Basketball-Reference.

One row per team for a season. No account or API key is required.

Usage

bref_wnba_team_stats(season = most_recent_wnba_season(), table = "per_game")

Arguments

season

Season, 4-digit year format (e.g. 2024). Defaults to most_recent_wnba_season().

table

Which stats table – one of "per_game" (default), "totals", "per_poss" or "advanced".

Value

A wehoop_data tibble with one row per team, carrying season and table columns.

col_name types
team character
g numeric
pts_per_g numeric
season integer
table character

See Also

Other WNBA Basketball-Reference Functions: bref_wnba_player_stats(), bref_wnba_standings()

Examples

try(bref_wnba_team_stats(season = 2024, table = "per_game"))

Check Status function

Description

Check Status function

Usage

check_status(res)

Arguments

res

Response from an httr2 request


Load .csv / .csv.gz file from a remote connection

Description

This is a thin wrapper on data.table::fread

Usage

csv_from_url(...)

Arguments

...

passed to data.table::fread


ESPN Basketball Endpoint Overview (WNBA + WBB)

Description

Wrappers around ESPN's basketball endpoints. Two parallel families share a common set of internal helpers in R/espn_basketball_*.R:

  • ⁠espn_wnba_*()⁠ — ESPN WNBA wrappers

  • ⁠espn_wbb_*()⁠ — ESPN women's college basketball wrappers

Each public wrapper is a thin shim over an internal helper that takes a league argument ("wnba" or "womens-college-basketball"); the helper does the actual HTTP call + parsing. Error reporting flows through ESPN-side reporters .report_api_error() / .report_api_warning() in R/utils.R (do not use raw cli::cli_alert_danger() here — that is the WNBA Stats convention).

Details

Play-by-play, scoreboard, schedule

WNBA function WBB function
espn_wnba_pbp() espn_wbb_pbp()
espn_wnba_scoreboard() espn_wbb_scoreboard()
espn_wnba_game_all() espn_wbb_game_all()
espn_wnba_game_rosters() espn_wbb_game_rosters()
espn_wnba_player_box() espn_wbb_player_box()
espn_wnba_team_box() espn_wbb_team_box()

Reference data

WNBA function WBB function
espn_wnba_teams() espn_wbb_teams()
espn_wnba_standings() espn_wbb_standings()
espn_wnba_player_stats() espn_wbb_player_stats()
espn_wnba_team_stats() espn_wbb_team_stats()
espn_wbb_conferences()
espn_wbb_rankings()

HTTP layer

ESPN wrappers call .retry_request() directly without ..., so per-call proxy overrides aren't supported. Use options(wehoop.proxy = ...) or the http_proxy / https_proxy env vars for proxy routing.

See Also

Other ESPN Basketball: espn_basketball_player_core()


Project an ESPN core-v2 athlete record into a player_core row

Description

Turns one ESPN core-v2 ⁠/athletes/{id}⁠ payload into the single tidy row released as the player_core dataset.

This is a pure projection: it takes an already-fetched payload and never performs I/O. That is deliberate — the compile stages in wehoop-wnba-data / wehoop-wbb-data read the payload from the sibling -raw tree, and re-fetching here would both break the one-way raw -> data boundary and mean the R and Python pipelines read different bytes, so a value divergence could not be attributed to method.

Ids for college and current team are parsed out of the payload's ⁠$ref⁠ URLs (⁠/colleges/{id}⁠, ⁠/teams/{id}⁠). The ⁠$ref⁠ is never followed.

Usage

espn_basketball_player_core(payload, athlete_id)

Arguments

payload

list. One athlete's core-v2 ⁠/athletes/{athlete_id}⁠ payload, as returned by jsonlite::fromJSON(..., simplifyVector = FALSE). An empty or non-list value yields a zero-row tibble rather than an error.

athlete_id

numeric or character. The ESPN athlete id. Required and never inferred from the payload — callers pass the id from the file path, so a payload missing its own id still produces a joinable row.

Details

What the row means. current_team_id is the athlete's team today, not their team in any past season — the season a released row is filed under is participation (who appeared that year, taken from player_box), not the vintage of the bio. Height, weight and jersey are likewise a current snapshot: ESPN overwrites them in place, so era-correct bio is not obtainable from this endpoint.

Parity. This is a port of sportsdataverse.wbb.helper_wbb_player_core (sdv-py 0.0.75), which produces the released dataset today. The two are held to byte-parity by tests/testthat/test-espn_basketball_player_core.R against a golden fixture captured from that function; see tests/testthat/fixtures/player_core/README.md for provenance. Neither implementation is authoritative — a divergence is a review item.

Value

A one-row tibble carrying the full 35-column set (absent fields are NA), so callers see a stable schema regardless of payload completeness:

col_name types
athlete_id integer
guid character
uid character
slug character
type character
first_name character
last_name character
full_name character
display_name character
short_name character
height numeric
display_height character
weight numeric
display_weight character
age integer
date_of_birth character
birth_city character
birth_state character
birth_country character
jersey character
position_id integer
position_name character
position_abbreviation character
position_display_name character
college_id integer
current_team_id integer
headshot_href character
experience_years integer
status_id integer
status_name character
status_type character
draft_year integer
draft_round integer
draft_selection integer
active logical

Twin

hoopR::espn_basketball_player_core() is the identical function for the men's leagues. The core-v2 athlete resource is the same payload shape for nba/wnba/mbb/wbb, so the projection is league-agnostic – sdv-py implements it once and re-exports it per league. hoopR and wehoop are independently published and neither depends on the other, so here it is duplicated: a change to one must land in the other in the same session, verified.

Author(s)

Saiem Gilani

See Also

Other ESPN Basketball: espn_basketball

Examples

# Split across lines to keep the Rd under the line-width limit; the
  # core-v2 $ref URLs are long enough to be truncated in the PDF manual.
  team_ref <- paste0(
    "http://sports.core.api.espn.com/v2/sports/basketball/",
    "leagues/wnba/seasons/2025/teams/22"
  )
  payload <- list(
    guid = "abc", fullName = "Jane Doe", jersey = "23",
    position = list(id = "5", abbreviation = "G"),
    team = list(`$ref` = team_ref)
  )
  espn_basketball_player_core(payload, athlete_id = 1966)

Get ESPN Women's College Basketball Athletes Index

Description

Get ESPN Women's College Basketball Athletes Index

Get ESPN Women's College Basketball Athletes Index

Usage

espn_wbb_athletes_index(
  season = most_recent_wbb_season(),
  active = TRUE,
  limit = 25000L,
  ...
)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent WBB season.

active

logical. When TRUE (default) only active athletes are returned. Set to FALSE for the full historical roster.

limit

integer. Maximum number of rows to return. Default 25000. WBB can return 6,000-12,000 athletes per season; increase if needed. Pass a small value (e.g. limit = 50) in tests to keep execution fast.

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(wehoop.proxy = ...) – see ?wehoop for details.

Value

A single wehoop_data tibble with one row per athlete.

Columns as documented in the shared espn_basketball_athletes_index_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_athletes_index(season = 2025, limit = 50)

Get ESPN WBB Season Award Detail

Description

Returns the name, description, and winners of one WBB season award.

Usage

espn_wbb_award(award_id, season = most_recent_wbb_season(), ...)

Arguments

award_id

ESPN award identifier (character or numeric).

season

Season year (numeric). Defaults to the most recent WBB season.

...

Additional arguments; currently unused.

Value

A tibble with one row per winner.

col_name types description
league character League slug.
season integer Season year.
award_id character ESPN award identifier.
name character Award name.
description character Award description.
athlete_id character ESPN athlete id of winner.
team_id character ESPN team id.
athlete_ref character ⁠$ref⁠ to winner's per-season athlete resource.
team_ref character ⁠$ref⁠ to winner's per-season team resource.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_award(award_id = 344, season = 2024)

Get ESPN WBB Calendar

Description

Get ESPN WBB Calendar

Get ESPN Women's College Basketball Calendar

Usage

espn_wbb_calendar(season = most_recent_wbb_season())

Arguments

season

integer or character. Four-digit season year (e.g. 2025). Defaults to most_recent_wbb_season().

Details

Retrieve the ESPN women's college basketball schedule calendar for a given season. The underlying scoreboard response contains a leagues[[1]]$calendar block with season-type entries (pre-season, regular, post). Uses getOption("wehoop.proxy") or http_proxy/https_proxy environment variables for proxy configuration (per-call proxy override is not supported for ESPN wrappers).

Value

Returns a tibble of calendar entries.

Columns as documented in the shared espn_basketball_calendar_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_calendar(season = 2025)

Get ESPN WBB Single-Coach Detail

Description

Returns biography, current team / college refs, and counts of career record entries + per-season coaching entries for one WBB head coach.

Usage

espn_wbb_coach(coach_id, ...)

Arguments

coach_id

ESPN coach identifier (character or numeric).

...

Additional arguments; currently unused.

Value

A single-row tibble.

col_name types description
coach_id character ESPN coach identifier.
uid character ESPN UID string.
first_name character First name.
last_name character Last name.
date_of_birth character Date of birth (ISO 8601).
birth_city character Birth city.
birth_state character Birth state / region.
n_career_records integer Count of career-records entries.
n_coach_seasons integer Count of seasons coached.
college_ref character ⁠$ref⁠ to the coach's college.
team_ref character ⁠$ref⁠ to the coach's current team.
league character League slug.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_coach(coach_id = 2167842)

Get ESPN WBB Coach Career Record (Long Format)

Description

Returns a coach's career record by type in long format (one row per stat in the record's stats[] array). record_type codes commonly populated: 0 = Total, 1 = Pre Season, 2 = Regular Season, 3 = Post Season. Use espn_wbb_coaches() to discover coach_ids for a season.

Usage

espn_wbb_coach_record(coach_id, record_type = 0L, ...)

Arguments

coach_id

ESPN coach identifier (use espn_wbb_coaches() to find).

record_type

Integer record type: 0 = Total (default), 1 = Pre Season, 2 = Regular Season, 3 = Post Season.

...

Additional arguments; currently unused.

Value

A long tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_coach_record(coach_id = 2167842, record_type = 2)

Get ESPN WBB Coach-in-Season Detail

Description

Per-season coach detail (name, birth info, ⁠$ref⁠s to team/college/ person). ESPN's coverage of this endpoint is sparse; many (coach × season) combinations return 404.

Usage

espn_wbb_coach_season(coach_id, season = most_recent_wbb_season(), ...)

Arguments

coach_id

ESPN coach identifier.

season

Season year. Defaults to most recent WBB season.

...

Additional arguments; currently unused.

Details

Get ESPN WBB Coach-in-Season Detail

Value

A single-row tibble.

Columns as documented in the shared espn_basketball_coach_season_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_coach_season(coach_id = 2167842, season = 2025)

Get ESPN Women's College Basketball Coaches

Description

Get ESPN Women's College Basketball Coaches

Get ESPN Women's College Basketball Coaches

Usage

espn_wbb_coaches(season = most_recent_wbb_season(), ...)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent WBB season.

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(wehoop.proxy = ...) – see ?wehoop for details.

Value

A single wehoop_data tibble with one row per coach.

col_name types description
coach_id character Unique identifier for coach.
first_name character Player's first name.
last_name character Player's last name.
full_name character Player's full name.
experience integer Years of professional experience.
team_id character Unique team identifier.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_coaches(season = 2025)

Get women's college basketball conferences

Description

Get women's college basketball conferences

Usage

espn_wbb_conferences()

Value

Returns a tibble

Columns as documented in the shared espn_basketball_conferences_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

try(espn_wbb_conferences())

Get ESPN WBB Franchise Detail

Description

Returns franchise-level metadata for a women's college basketball program. Franchise IDs are stable across program reorganization or rebrands.

Usage

espn_wbb_franchise(franchise_id, ...)

Arguments

franchise_id

ESPN franchise identifier (character or numeric).

...

Additional arguments; currently unused.

Value

A single-row tibble.

col_name types description
id character ESPN franchise identifier.
uid character ESPN UID string.
slug character URL-safe identifier.
location character Franchise location.
name character Franchise name.
nickname character Common nickname.
abbreviation character Short abbreviation.
display_name character Full display name.
short_display_name character Short display name.
color character Primary color (hex, no leading '#').
is_active logical Whether franchise is currently active.
league character League slug.
logo character Primary logo URL.
logo_dark character Dark-mode logo URL.
venue_ref character ⁠$ref⁠ to franchise's primary venue.
team_ref character ⁠$ref⁠ to the current team for franchise.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_franchise(franchise_id = 2509)

Get ESPN WBB Franchises Index

Description

Returns the full WBB franchises index from sports.core.api.espn.com/v2/sports/basketball/leagues/womens-college-basketball/franchises. Each row is one franchise with its ID and the canonical ⁠$ref⁠ URL — pass an ID to espn_wbb_franchise() for full franchise detail.

Usage

espn_wbb_franchises(...)

Arguments

...

Additional arguments; currently unused.

Value

A tibble with one row per franchise.

col_name types description
franchise_id character ESPN franchise identifier.
ref character Full ⁠$ref⁠ URL for franchise detail.
league character League slug ("womens-college-basketball").

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_franchises()

Get ESPN women's college basketball game data (play-by-play, team and player box)

Description

Get ESPN women's college basketball game data (play-by-play, team and player box)

Get ESPN women's college basketball play by play data

Get ESPN women's college basketball team box data

Get ESPN women's college basketball player box

Get ESPN women's college basketball game rosters

Usage

espn_wbb_game_all(game_id)

espn_wbb_pbp(game_id)

espn_wbb_team_box(game_id)

espn_wbb_player_box(game_id)

espn_wbb_game_rosters(game_id)

Arguments

game_id

Game ID

Value

A named list of dataframes: Plays, Team, Player

Plays

Columns as documented in the shared espn_basketball_game_all_plays_plays_schema table.

Team

Columns as documented in the shared espn_basketball_team_box_schema table.

Player

Columns as documented in the shared espn_basketball_game_all_player_player_schema table.

Returns a play-by-play data frame

Plays

Columns as documented in the shared espn_basketball_game_all_plays_plays_schema table.

Returns a team boxscore data frame

Team

Columns as documented in the shared espn_basketball_team_box_schema table.

Returns a player boxscore data frame

Player

Columns as documented in the shared espn_basketball_game_all_player_player_schema table.

A game rosters data frame

col_name types description
athlete_id integer Unique athlete identifier (ESPN).
athlete_uid character ESPN athlete UID (universal identifier).
athlete_guid character ESPN athlete GUID.
athlete_type character Athlete type / class.
sdr integer Sdr.
first_name character Player's first name.
last_name character Player's last name.
full_name character Player's full name.
athlete_display_name character Athlete display name (full).
short_name character Short display name.
height integer Player height (string e.g. '6-2' or inches).
display_height character Player height in display format (e.g. '6-2').
birth_place_city character Birth place city.
birth_place_state character Birth place state.
birth_place_country character Birth place country.
slug character URL-safe identifier.
headshot_href character Headshot image URL.
headshot_alt character Alternative-text label for the headshot.
jersey character Jersey number worn by the player.
position_id integer Unique position identifier.
position_name character Listed roster position ('Guard', 'Forward', 'Center').
position_display_name character Position display name.
position_abbreviation character Position abbreviation ('G' / 'F' / 'C').
position_leaf logical Position leaf.
linked logical TRUE if the record is linked to a related entity.
experience_years integer Experience years.
experience_display_value character Experience display value.
experience_abbreviation character Experience abbreviation.
active logical TRUE if the row represents an active record (player / team / season).
status_id integer Status identifier.
status_name character Status label.
status_type character Status type.
status_abbreviation character Status abbreviation.
starter logical TRUE if the player was in the starting lineup; FALSE otherwise.
valid logical Valid.
did_not_play logical TRUE if the player did not appear in the game.
display_name character Display name.
ejected logical TRUE if the player was ejected from the game.
team_id integer Unique team identifier.
team_guid character ESPN team GUID.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_sdr integer ESPN team SDR identifier.
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location character Team city or location string.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_nickname character Team nickname.
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_display_name character Full team display name.
team_short_display_name character Short team display name (e.g. 'Aces').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
is_active logical Is active.
is_all_star logical Is all star.
logo_href character Team or league logo URL.
logo_dark_href character Logo URL for dark backgrounds.
game_id integer Unique game identifier.
order integer Display order within the result set.
home_away character Game venue label ('home' or 'away').
winner logical Winner.
roster_href character URL for roster.
hand_type character Hand type.
hand_abbreviation character Hand abbreviation.
hand_display_value character Hand display value.
age integer Player age (in years).
date_of_birth character Date of birth (YYYY-MM-DD).
weight integer Player weight in pounds.
display_weight character Player weight in display format (e.g. '180 lbs').

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

try(espn_wbb_game_all(game_id = 401276115))
 

  try(espn_wbb_pbp(game_id = 401498717))


  try(espn_wbb_team_box(game_id = 401276115))


  try(espn_wbb_player_box(game_id = 401276115))


  try(espn_wbb_game_rosters(game_id = 401276115))

Get ESPN Women's College Basketball Event Odds

Description

Returns the live game situation for one WBB event: timeouts remaining, team fouls, fouls to give, bonus state, and a ⁠$ref⁠ to the last play. During a live game this reflects current state; after the game ends the values are frozen.

Returns pre-game predictor statistics for one WBB event in long format: one row per (team × statistic). Typical stats include matchup quality, predicted score, win probability, and team strength metrics. Returns empty for events without predictor data (often the case for already-played games).

Returns the per-team power-index ⁠$ref⁠ URLs for one WBB event. Coverage is sparse — many events return zero items.

Usage

espn_wbb_game_odds(event_id, ...)

espn_wbb_game_officials(event_id, ...)

espn_wbb_game_broadcasts(event_id, ...)

espn_wbb_game_situation(event_id, ...)

espn_wbb_game_predictor(event_id, ...)

espn_wbb_game_powerindex(event_id, ...)

Arguments

event_id

ESPN event identifier.

...

Additional arguments; currently unused.

Details

Get ESPN WBB Event Predictor (Pre-game)

Get ESPN WBB Event Power Index Index

Value

A tibble with one row per odds provider (typically empty for WBB because ESPN does not carry NCAA basketball betting lines).

Columns as documented in the shared espn_basketball_game_odds_schema table.

A tibble with one row per official assigned to the game.

Columns as documented in the shared espn_basketball_game_officials_schema table.

A tibble with one row per broadcast outlet for the game.

Columns as documented in the shared espn_basketball_game_broadcasts_schema table.

A single-row tibble with timeouts + fouls for both teams.

A long tibble with rows for both home and away teams.

A tibble with one row per team-game power-index entry.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_game_odds(event_id = "401276115")


  espn_wbb_game_officials(event_id = "401276115")


  espn_wbb_game_broadcasts(event_id = "401276115")


  espn_wbb_game_situation(event_id = 401276115)


  espn_wbb_game_predictor(event_id = 401276115)


  espn_wbb_game_powerindex(event_id = 401276115)

Get ESPN WBB Event Official Detail (Single Official)

Description

Returns a single-row tibble for one referee assigned to one WBB event, with their name, position (Referee / Crew Chief / Umpire), and crew order. Pair with espn_wbb_game_officials() to enumerate the crew.

Usage

espn_wbb_game_official_detail(event_id, order, ...)

Arguments

event_id

ESPN event identifier.

order

Crew order index (1 = first official). Pair with the order column from event_officials().

...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_game_official_detail(event_id = 401276115, order = 1)

Get ESPN WBB Event Play Detail (Single Play)

Description

Returns the rich detail block for a single WBB play: sequence, period, clock, text, scoring/shooting flags, current home/away score, team ⁠$ref⁠, and shot coordinates if applicable. Complements the bulk espn_wbb_pbp() output by exposing the canonical core-v2 play record.

Usage

espn_wbb_game_play(event_id, play_id, ...)

Arguments

event_id

ESPN event identifier.

play_id

ESPN play identifier (visible in pbp() output as play_id or extractable from ⁠plays[].$ref⁠).

...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_game_play(event_id = 401276115, play_id = 401276115101899901)

Get ESPN WBB Event Play Personnel (On-Court Lineup at Play)

Description

Returns the players on court at a specific WBB play in long format (one row per athlete entry across both competitors). Foundation for lineup analysis. ESPN coverage is sparse — many plays return zero rows; the wrapper returns a typed empty tibble in that case.

Usage

espn_wbb_game_play_personnel(event_id, play_id, ...)

Arguments

event_id

ESPN event identifier.

play_id

ESPN play identifier.

...

Additional arguments; currently unused.

Value

A long tibble with one row per on-court athlete.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_game_play_personnel(event_id = 401276115, play_id = 401276115101899901)

Get ESPN WBB Event Player Box Score (Long Format)

Description

Returns the long-format per-game box score for a single athlete in one WBB event. One row per (category x stat). Same shape as espn_wbb_game_team_statistics() but scoped to a single athlete-in-event instead of the full team. stat_type defaults to 0 (regular-season aggregate as ESPN tags it for finished events).

Usage

espn_wbb_game_player_box(event_id, team_id, athlete_id, stat_type = 0L, ...)

Arguments

event_id

ESPN event identifier.

team_id

ESPN team identifier (the competitor the athlete played for).

athlete_id

ESPN athlete identifier.

stat_type

Integer stat-type segment. Defaults to 0 (the only type commonly populated for finished events).

...

Additional arguments; currently unused.

Value

A long tibble with one row per (category x stat).

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_game_player_box(event_id = 401276115, team_id = 52,
                               athlete_id = 4433404)

Get ESPN Women's College Basketball Event Win Probabilities

Description

Get ESPN Women's College Basketball Event Win Probabilities

Get ESPN Women's College Basketball Event Win Probabilities

Usage

espn_wbb_game_probabilities(event_id, limit = 200, ...)

Arguments

event_id

ESPN event/game identifier (character or numeric).

limit

integer. Maximum number of probability rows to return. Defaults to 200. Pagination is handled internally.

...

Additional arguments; currently unused.

Value

A tibble with one row per play-level win-probability entry.

Columns as documented in the shared espn_basketball_game_probabilities_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_game_probabilities(event_id = "401276115", limit = 50)

Get ESPN WBB Event Prop Bets (Long Format)

Description

Returns prop-bet markets for one WBB event + provider in long format: one row per (athlete × prop type). Each row has american / decimal / fraction odds plus the current target (e.g. over/under line). Hits the core-v2 competitions/{id}/odds/{provider_id}/propBets endpoint and auto-paginates.

Usage

espn_wbb_game_propbets(event_id, provider_id, ...)

Arguments

event_id

ESPN event identifier.

provider_id

Sportsbook provider id (e.g. 58 = ESPN BET, 100 = Caesars). Look up via espn_wbb_game_odds().

...

Additional arguments; currently unused.

Details

Get ESPN WBB Event Prop Bets (Long Format)

Value

A long tibble with one row per (athlete × prop type).

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_game_propbets(event_id = 401276115, provider_id = 58)

Get ESPN WBB Event Competitor Linescores (Per-Quarter)

Description

Returns the per-quarter scoring breakdown for one team in one NBA event. One row per period (regulation quarters + any overtime periods).

Returns the per-team statistical leaders for one WBB event in long format: one row per (category x athlete rank). Categories typically include points, rebounds, assists, and rating.

Returns the game-day roster index for one team in one WBB event. Each row carries the athlete id and the core-v2 ⁠$ref⁠ URL — use the ref to dereference athlete-game splits or biographical data.

Returns full team-game statistics for one team in one WBB event in long format: one row per (category x stat). Covers offensive, defensive, and general categories with both raw values and display strings.

Returns team records as of the given WBB event: overall, home, away, conference, and division breakdowns where available. One row per record type.

Returns a one-row tibble with one team's final score for one WBB event: numeric value, display string, winner flag, and source metadata. Quick-lookup wrapper — use espn_wbb_game_team_linescores() for per-period detail.

Usage

espn_wbb_game_team_linescores(event_id, team_id, ...)

espn_wbb_game_team_leaders(event_id, team_id, ...)

espn_wbb_game_team_roster(event_id, team_id, ...)

espn_wbb_game_team_statistics(event_id, team_id, ...)

espn_wbb_game_team_records(event_id, team_id, ...)

espn_wbb_game_team_score(event_id, team_id, ...)

Arguments

event_id

ESPN event identifier.

team_id

ESPN team identifier.

...

Additional arguments; currently unused.

Value

A tibble with one row per period.

A long tibble with one row per (category x rank).

A tibble with one row per active athlete.

A long tibble with one row per (category x stat).

A tibble with one row per record type.

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_game_team_linescores(event_id = 401276115, team_id = 52)


  espn_wbb_game_team_leaders(event_id = 401276115, team_id = 52)


  espn_wbb_game_team_roster(event_id = 401276115, team_id = 52)


  espn_wbb_game_team_statistics(event_id = 401276115, team_id = 52)


  espn_wbb_game_team_records(event_id = 401276115, team_id = 52)


  espn_wbb_game_team_score(event_id = 401276115, team_id = 52)

Get ESPN WBB Event Competitor Roster Entry (Per-Athlete Game-Day Row)

Description

Returns a single-row tibble describing one athlete's game-day roster entry for one WBB event. Carries the starter flag, didNotPlay flag with reason, ejection flag, and the substitution slot if the athlete came in for another player. Pair with espn_wbb_game_team_roster() to enumerate the roster.

Usage

espn_wbb_game_team_roster_entry(event_id, team_id, athlete_id, ...)

Arguments

event_id

ESPN event identifier.

team_id

ESPN team identifier.

athlete_id

ESPN athlete identifier.

...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_game_team_roster_entry(event_id = 401276115,
                                            team_id = 2509,
                                            athlete_id = 4433404)

Get ESPN Women's College Basketball Injuries

Description

Get ESPN Women's College Basketball Injuries

Get ESPN Women's College Basketball Injuries

Usage

espn_wbb_injuries(season = most_recent_wbb_season(), ...)

Arguments

season

Numeric or character season year (e.g. 2025). The ESPN injury endpoint does not filter by season server-side; the value is attached as a constant column on the returned tibble for downstream joins. Defaults to most_recent_wbb_season().

...

Currently unused; reserved for future argument threading.

Value

Returns a tibble of league-wide WBB injury records. ESPN's WBB injury data is typically sparse; the function returns an empty tibble (zero rows) when no injuries are reported.

Injuries

Columns as documented in the shared espn_basketball_injuries_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_injuries()

Get ESPN Women's College Basketball League Leaders

Description

Get ESPN Women's College Basketball League Leaders

Get ESPN Women's College Basketball League Leaders

Usage

espn_wbb_leaders(season = most_recent_wbb_season(), season_type = 2, ...)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent WBB season.

season_type

Integer season type: 1 = preseason, 2 = regular (default), 3 = postseason.

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(wehoop.proxy = ...) – see ?wehoop for details.

Value

A single wehoop_data tibble with one row per category-athlete pair.

Columns as documented in the shared espn_basketball_leaders_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_leaders(season = 2025, season_type = 2)

Get ESPN WBB News

Description

Get ESPN WBB News

Get ESPN Women's College Basketball News

Usage

espn_wbb_news(limit = 50)

Arguments

limit

integer. Maximum number of articles to return. Default 50.

Details

Retrieve ESPN women's college basketball news. Uses getOption("wehoop.proxy") or http_proxy/https_proxy environment variables for proxy configuration (per-call proxy override is not supported for ESPN wrappers).

Value

Returns a tibble of news articles.

Columns as documented in the shared espn_basketball_news_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_news(limit = 5)

Get ESPN Women's College Basketball Athlete Awards

Description

Get ESPN Women's College Basketball Athlete Awards

Get ESPN Women's College Basketball Athlete Awards

Usage

espn_wbb_player_awards(athlete_id, ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).

...

Additional arguments; currently unused.

Value

A single tibble. This endpoint is sparse; many athletes have no award data, in which case an empty tibble with canonical columns is returned.

Columns as documented in the shared espn_basketball_player_awards_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_player_awards(athlete_id = "4433404")

Get ESPN WBB Athlete Career Stats (Long Format)

Description

Returns career stats for a WBB athlete in long format. Default stat_type = 0L fetches the standard "All Splits" / regular-season view. Pass a vector like c(0L, 1L, 2L) to attempt multiple types and bind them via a stat_type_id column; variants that 404 for that athlete are silently skipped. Stat types: 0 = regular season (default endpoint), 1 = postseason, 2 = career aggregate. Coverage of types 1 and 2 is sparse — many athletes only have type 0 populated.

Usage

espn_wbb_player_career_stats(athlete_id, stat_type = 0L, ...)

Arguments

athlete_id

ESPN athlete identifier.

stat_type

Integer or integer vector of stat-type codes. Default 0L fetches the standard "All Splits" / regular-season view. Pass a vector like c(0L, 1L, 2L) to bind multiple types via a stat_type_id column; non-existent variants are silently skipped.

...

Additional arguments; currently unused.

Details

Get ESPN WBB Athlete Career Stats (Long Format)

Value

A long tibble (one row per stat_type × split × category × stat).

Columns as documented in the shared espn_basketball_player_career_stats_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

# LeBron James — regular + postseason combined
  espn_wbb_player_career_stats(athlete_id = 4433404)
  # Just career aggregate
  espn_wbb_player_career_stats(athlete_id = 4433404, stat_type = 2L)

Get ESPN WBB Athlete Per-Season Event Log (core-v2)

Description

Returns one row per (event x team) for an WBB athlete's appearances in a given season. Distinct from espn_wbb_player_eventlog() which wraps the web-common-v3 endpoint; this core-v2 variant is era-correct.

Usage

espn_wbb_player_eventlog_v2(athlete_id, season = most_recent_wbb_season(), ...)

Arguments

athlete_id

ESPN athlete identifier.

season

Season year. Defaults to most recent WBB season.

...

Additional arguments; currently unused.

Value

A tibble with one row per event appearance.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_player_eventlog_v2(athlete_id = 4433404, season = 2025)

Get ESPN Women's College Basketball Athlete Info

Description

Get ESPN Women's College Basketball Athlete Info

Get ESPN Women's College Basketball Athlete Info

Usage

espn_wbb_player_info(athlete_id, ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(wehoop.proxy = ...) – see ?wehoop for details.

Value

A named list of data frames: Bio, Team, Position, Status, College, Draft.

Bio

Columns as documented in the shared espn_basketball_player_info_bio_schema table.

Team

col_name types description
id character Unique play identifcation number
abbreviation character Short abbreviation.
display_name character Display name.

Position

col_name types description
id character Unique play identifcation number
name character Display name.
abbreviation character Short abbreviation.

Status

col_name types description
id character Unique play identifcation number
name character Display name.
type character Record type / category.

College

col_name types description
id character Unique play identifcation number
name character Display name.
mascot character Team mascot.

Draft

col_name types description
year character 4-digit year.
round character Tournament / playoff round.
selection character Selection.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_player_info(athlete_id = "4433404")

Get ESPN Women's College Basketball Athlete Overview

Description

Get ESPN Women's College Basketball Athlete Overview

Get ESPN Women's College Basketball Athlete Stats

Get ESPN Women's College Basketball Athlete Gamelog

Get ESPN Women's College Basketball Athlete Splits

Get ESPN Women's College Basketball Athlete Eventlog

Get ESPN Women's College Basketball Athlete Eventlog

Get ESPN Women's College Basketball Athlete Statisticslog

Usage

espn_wbb_player_overview(athlete_id, season = most_recent_wbb_season(), ...)

espn_wbb_player_stats_v3(athlete_id, season = most_recent_wbb_season(), ...)

espn_wbb_player_gamelog(athlete_id, season = most_recent_wbb_season(), ...)

espn_wbb_player_splits(athlete_id, season = most_recent_wbb_season(), ...)

espn_wbb_player_eventlog(athlete_id, season = most_recent_wbb_season(), ...)

espn_wbb_player_statisticslog(
  athlete_id,
  season = most_recent_wbb_season(),
  ...
)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).

season

Season year (numeric). Defaults to the most recent WBB season.

...

Additional arguments; currently unused.

Value

A named list of data frames: Statistics, NextGame, Last5Games, Headlines, FantasyOutlook.

Statistics

Columns as documented in the shared espn_basketball_player_overview_statistics_schema table.

NextGame

Columns as documented in the shared espn_basketball_player_overview_next_game_schema table.

Last5Games

Columns as documented in the shared espn_basketball_player_overview_statistics_schema table.

Headlines

col_name types description
headline character News headline.
description character Long-form description text.
published character Publication timestamp (ISO 8601).

FantasyOutlook

Columns as documented in the shared espn_basketball_player_overview_statistics_schema table.

A wide wehoop_data tibble, one row per athlete-season-team, with the ESPN stat categories spread across prefixed columns:

col_name types description
athlete_id character ESPN athlete identifier (echoed input).
season integer Season year for the stat line.
team_id character ESPN team identifier for that season.
team_slug character Team slug (e.g. 'iowa-hawkeyes').
avg_* numeric Per-game season-average stats (e.g. avg_avg_points).
tot_* numeric Season-total stats (e.g. tot_points).
misc_* numeric Miscellaneous season totals.

Stat column names come from ESPN's positional names array per category, cleaned via janitor::make_clean_names(); the exact set varies by league and season.

A single tibble with one row per game. Column names reflect the stat labels returned by ESPN and will vary by season and player.

A single long-format tibble. When data are present, columns include at minimum category and split_name, plus per-stat columns driven by ESPN labels.

A single tibble. Per-event statistics.$ref URLs from the ESPN core-v2 API are returned as the character column statistics_ref and are NOT resolved. Similarly, event_ref, competition_ref, and team_ref are returned as character columns.

col_name types description
event_ref character Reference link to the originating event.
competition_ref character Competition ref.
team_ref character Team ref.
statistics_ref character Statistics ref.

A single tibble. When resolved, each row corresponds to one statistical entry in the core-v2 statistics log, with event_ref and statistics_ref character columns pointing to resolvable ESPN endpoints.

col_name types description
event_ref character Reference link to the originating event.
statistics_ref character Statistics ref.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_player_overview(athlete_id = "4433404", season = 2025)


  espn_wbb_player_stats_v3(athlete_id = "4433985", season = 2025)


  espn_wbb_player_gamelog(athlete_id = "4433404", season = 2025)


  espn_wbb_player_splits(athlete_id = "4433404", season = 2025)


  espn_wbb_player_eventlog(athlete_id = "4433404", season = 2025)


  espn_wbb_player_statisticslog(athlete_id = "4433404", season = 2025)

Get ESPN WBB Athlete Career Seasons

Description

Returns the list of seasons an WBB athlete appeared in. Useful for bounding follow-up calls to per-season endpoints.

Usage

espn_wbb_player_seasons(athlete_id, ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).

...

Additional arguments; currently unused.

Value

A tibble with one row per career season.

col_name types description
league character League slug.
athlete_id character ESPN athlete id.
season integer Season year.
ref character ⁠$ref⁠ URL to the season detail.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

# LeBron James (1966): 23 career seasons
  espn_wbb_player_seasons(athlete_id = 4433404)

Get ESPN women's college basketball player stats data

Description

Get ESPN women's college basketball player stats data

Usage

espn_wbb_player_stats(athlete_id, year, season_type = "regular", total = FALSE)

Arguments

athlete_id

Athlete ID

year

Year

season_type

(character, default: regular): Season type - regular or postseason

total

(boolean, default: FALSE): Totals

Value

Returns a tibble with the player stats data

col_name types description
athlete_id integer Unique athlete identifier (ESPN).
athlete_uid character ESPN athlete UID (universal identifier).
athlete_guid character ESPN athlete GUID.
athlete_type character Athlete type / class.
sdr integer Sdr.
first_name character Player's first name.
last_name character Player's last name.
full_name character Player's full name.
display_name character Display name.
short_name character Short display name.
height numeric Player height (string e.g. '6-2' or inches).
display_height character Player height in display format (e.g. '6-2').
birth_place_city character Birth place city.
birth_place_state character Birth place state.
birth_place_country character Birth place country.
slug character URL-safe identifier.
headshot_href character Headshot image URL.
headshot_alt character Alternative-text label for the headshot.
jersey character Jersey number worn by the player.
position_id integer Unique position identifier.
position_name character Listed roster position ('Guard', 'Forward', 'Center').
position_display_name character Position display name.
position_abbreviation character Position abbreviation ('G' / 'F' / 'C').
position_leaf logical Position leaf.
linked logical TRUE if the record is linked to a related entity.
experience_years integer Experience years.
experience_display_value character Experience display value.
experience_abbreviation character Experience abbreviation.
active logical TRUE if the row represents an active record (player / team / season).
status_id integer Status identifier.
status_name character Status label.
status_type character Status type.
status_abbreviation character Status abbreviation.
defensive_blocks numeric Short for blocked shot, number of times when a defensive player legally deflects a field goal attempt from an offensive player.
defensive_defensive_rebounds numeric The number of times when the defense obtains the possession of the ball after a missed shot by the offense.
defensive_steals numeric The number of times a defensive player forced a turnover by intercepting or deflecting a pass or a dribble of an offensive player.
defensive_turnover_points numeric The amount of points resulting from the possession following a turnover.
defensive_avg_defensive_rebounds numeric The average defensive rebounds per game.
defensive_avg_blocks numeric The average blocks per game.
defensive_avg_steals numeric The average steals per game.
general_disqualifications numeric The number of times a player reached the foul limit.
general_flagrant_fouls numeric The number of fouls that the officials thought were unnecessary or excessive.
general_fouls numeric The number of times a player had illegal contact with the opponent.
general_per numeric A numerical value for each of a player's accomplishments per-minute and is pace-adjusted for the team they play on. The league average in PER to 15.00 every season.
general_ejections numeric The number of times a player or coach is removed from the game as a result of a serious offense.
general_technical_fouls numeric The number of times an player or coach was called for a technical foul (unsportsmanlike conduct or violations).
general_rebounds numeric The total number of rebounds (offensive and defensive).
general_minutes numeric The total number of minutes played.
general_avg_minutes numeric The average number of minutes per game.
general_fantasy_rating numeric The Fantasy Rating of a player.
general_plus_minus numeric A player's estimated on-court impact on team performance measured in point differential per 100 possessions.
general_avg_rebounds numeric The average rebounds per game.
general_avg_fouls numeric The average fouls committed per game.
general_avg_flagrant_fouls numeric The average number of flagrant fouls per game.
general_avg_technical_fouls numeric The average number of technical fouls per game.
general_avg_ejections numeric The average ejections per game.
general_avg_disqualifications numeric The average number of disqualifications per game.
general_assist_turnover_ratio numeric The average number of assists a player or team records per turnover.
general_steal_foul_ratio numeric The average number of steals a player or team records per foul committed.
general_block_foul_ratio numeric The average number of blocks a player or record per foul committed.
general_avg_team_rebounds numeric The average number of rebounds for a team per game.
general_total_rebounds numeric The total number of rebounds for a team or player.
general_total_technical_fouls numeric The total number of technical fouls for a team or player.
general_steal_turnover_ratio numeric The number of steals per turnover.
general_games_played numeric Games Played.
general_games_started numeric The number of games started by an athlete.
general_double_double numeric The number of times double digit values were accumulated in 2 of the following categories: points, rebounds, assists, steals, and blocked shots.
general_triple_double numeric The number of times double digit values were accumulated in 3 of the following categories: points, rebounds, assists, steals, and blocked shots.
offensive_assists numeric The number of times a player who passes the ball to a teammate in a way that leads to a score by field goal, meaning that he or she was "assisting" in the basket. There is some judgment involved in deciding whether a passer should be credited with an assist.
offensive_field_goals numeric Field Goal makes and attempts.
offensive_field_goals_attempted numeric The number of times a 2pt field goal was attempted.
offensive_field_goals_made numeric The number of times a 2pt field goal was made.
offensive_field_goal_pct numeric The ratio of field goals made to field goals attempted: FGM / FGA.
offensive_free_throws numeric Free Throw makes and attempts.
offensive_free_throw_pct numeric The ratio of free throws made to free throws attempted: FTM / FTA.
offensive_free_throws_attempted numeric The number of times a free throw was attempted.
offensive_free_throws_made numeric The number of times a free throw was made.
offensive_offensive_rebounds numeric The number of times when the offense obtains the possession of the ball after a missed shot.
offensive_points numeric The number of points scored.
offensive_turnovers numeric The number of times a player loses possession to the other team.
offensive_three_point_field_goals_attempted numeric The number of times a 3pt field goal was attempted.
offensive_three_point_field_goals_made numeric The number of times a 3pt field goal was made.
offensive_total_turnovers numeric The number of turnovers plus team turnovers for the team.
offensive_points_in_paint numeric The amount of points scored in the area known as "the Paint"(the rectangle between the foul line and the baseline).
offensive_fast_break_points numeric The number of points scored on fast breaks.
offensive_avg_field_goals_made numeric The average field goals made per game.
offensive_avg_field_goals_attempted numeric The average field goals attempted per game.
offensive_avg_three_point_field_goals_made numeric The average three point field goals made per game.
offensive_avg_three_point_field_goals_attempted numeric The average three point field goals attempted per game.
offensive_avg_free_throws_made numeric The average free throw shots made per game.
offensive_avg_free_throws_attempted numeric The average free throw shots attempted per game.
offensive_avg_points numeric The average number of points scored per game.
offensive_avg_offensive_rebounds numeric The average offensive rebounds per game.
offensive_avg_assists numeric The average assists per game.
offensive_avg_turnovers numeric The average turnovers committed per game.
offensive_offensive_rebound_pct numeric The percentage of the number of times they obtain the possession of the ball after a missed shot.
offensive_estimated_possessions numeric An estimation of the number of possessions for a team or player.
offensive_avg_estimated_possessions numeric The average number of estimated possessions per game for a team or player.
offensive_points_per_estimated_possessions numeric The number of points per estimated possession for a team or player.
offensive_avg_team_turnovers numeric The average number of turnovers for a team per game.
offensive_avg_total_turnovers numeric The average number of total turnovers for a team per game.
offensive_three_point_field_goal_pct numeric The ratio of 3pt field goals made to 3pt field goals attempted: 3PM / 3PA.
offensive_two_point_field_goals_made numeric The number of 2-point field goals made for a team or player.
offensive_two_point_field_goals_attempted numeric The number of 2-point field goals attempted for a team or player.
offensive_avg_two_point_field_goals_made numeric The number of 2-point field goals made per game for a team or player.
offensive_avg_two_point_field_goals_attempted numeric The number of 2-point field goals attempted per game for a team or player.
offensive_two_point_field_goal_pct numeric The percentage of 2-points fields goals made by a team or player.
offensive_shooting_efficiency numeric The efficiency with which a team or player shoots the basketball.
offensive_scoring_efficiency numeric The efficiency with which a team or player scores the basketball.
team_id integer Unique team identifier.
team_guid character ESPN team GUID.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_sdr integer ESPN team SDR identifier.
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location character Team city or location string.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_nickname character Team nickname.
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_display_name character Full team display name.
team_short_display_name character Short team display name (e.g. 'Aces').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
team_is_active logical TRUE if the team is currently active.
team_is_all_star logical TRUE if the row represents an All-Star team.
logo_href character Team or league logo URL.
logo_dark_href character Logo URL for dark backgrounds.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

try(espn_wbb_player_stats(athlete_id = 2984250, year = 2022))

Get ESPN WBB Position Detail

Description

Returns metadata for a single WBB position. Useful for dereferencing position ⁠$ref⁠ URLs embedded in athlete records, and for navigating parent/leaf relationships in the position taxonomy.

Usage

espn_wbb_position(position_id, ...)

Arguments

position_id

ESPN position identifier (character or numeric).

...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_position(position_id = 1)

Get ESPN WBB Positions Index

Description

Returns the WBB position dictionary index. One row per position with its id and the canonical ⁠$ref⁠ URL — pass an id to espn_wbb_position() for full details (display name, abbreviation, leaf flag, parent link).

Usage

espn_wbb_positions(...)

Arguments

...

Additional arguments; currently unused.

Value

A tibble with one row per position.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_positions()

Get ESPN WBB Season Power Index (Long Format)

Description

Returns ESPN's Basketball Power Index (BPI) and related per-team metrics for one WBB season, in long format: one row per (team x stat).

Usage

espn_wbb_powerindex(
  season = most_recent_wbb_season(),
  season_type = c(2L, 3L),
  ...
)

Arguments

season

Season year (numeric). Defaults to the most recent WBB season.

season_type

Integer (1=preseason, 2=regular (default), 3=postseason).

...

Additional arguments; currently unused.

Value

A long tibble with one row per (team x stat).

col_name types description
league character League slug.
season integer Season year.
season_type integer 1=preseason, 2=regular, 3=postseason.
team_id character ESPN team id.
stat_name character Internal stat key.
abbreviation character Short stat abbreviation.
display_name character Human-readable stat name.
description character Stat description.
value numeric Stat value.
display_value character Display-formatted value.
last_updated character Last-updated timestamp.
team_ref character ⁠$ref⁠ to the team-in-season resource.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_powerindex(season = 2025)

Get women's college basketball AP and Coaches poll rankings

Description

Get women's college basketball AP and Coaches poll rankings

Usage

espn_wbb_rankings()

Value

Returns a tibble

col_name types description
id integer Unique play identifcation number
name character Display name.
short_name character Short display name.
type character Record type / category.
headline character News headline.
short_headline character Short news headline.
current integer Current.
previous integer Previous.
points numeric Points scored.
first_place_votes integer First place votes.
trend character Trend.
date character Date in YYYY-MM-DD format.
last_updated character Last updated.
record_summary character Win-loss record summary string.
team_id integer Unique team identifier.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_location character Team city or location string.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_nickname character Team nickname.
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_color character Team primary color (hex without leading '#').
team_logo character Team logo image URL.
occurrence_number integer Occurrence number.
occurrence_type character Occurrence type.
occurrence_last logical Occurrence last.
occurrence_value character Occurrence value.
occurrence_display_value character Occurrence display value.
season_year integer Season year string ('YYYY-YY' format).
season_start_date character Date in YYYY-MM-DD format.
season_end_date character Date in YYYY-MM-DD format.
season_display_name character Season display label.
season_type_type integer Season type type.
season_type_name character Season type name.
season_type_abbreviation character Season type abbreviation.
first_occurrence_type character First occurrence type.
first_occurrence_value character First occurrence value.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

# Get current AP and Coaches Poll rankings

  try(espn_wbb_rankings())

Get ESPN women's college basketball schedule for a specific year

Description

Get ESPN women's college basketball schedule for a specific year

Usage

espn_wbb_scoreboard(season)

Arguments

season

Either numeric or character

Value

Returns a tibble

Columns as documented in the shared espn_basketball_scoreboard_schema table.

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

# Get schedule from date 2022-11-15

  try(espn_wbb_scoreboard (season = "20230225"))

Get ESPN WBB Season Awards Index

Description

Returns the list of award IDs given out in a WBB season from sports.core.api.espn.com/v2/sports/basketball/leagues/womens-college-basketball/seasons/{season}/awards. The index only contains IDs and ⁠$ref⁠ URLs — pass an ID to espn_wbb_award() for the award name, description, and winners.

Usage

espn_wbb_season_awards(season = most_recent_wbb_season(), ...)

Arguments

season

Season year (numeric). Defaults to the most recent WBB season.

...

Additional arguments; currently unused.

Value

A tibble with one row per award.

col_name types description
season integer Season year.
award_id character ESPN award identifier.
ref character Full ⁠$ref⁠ URL for the award detail.
league character League slug ("womens-college-basketball").

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_season_awards(season = 2024)

Get ESPN WBB Season Group Detail

Description

Returns metadata for one group (conference or division) in one (WBB season x season-type), plus ⁠$ref⁠ URLs to its parent group, children groups, member teams, and standings.

Returns the list of child groups (e.g. divisions within a conference) for one (WBB season x season-type x parent-group).

Returns the list of team IDs that belong to one group (conference or division) for one (WBB season x season-type).

Usage

espn_wbb_season_group(
  group_id,
  season = most_recent_wbb_season(),
  season_type = 2L,
  ...
)

espn_wbb_season_group_children(
  group_id,
  season = most_recent_wbb_season(),
  season_type = 2L,
  ...
)

espn_wbb_season_group_teams(
  group_id,
  season = most_recent_wbb_season(),
  season_type = 2L,
  ...
)

Arguments

group_id

ESPN group identifier.

season

Season year. Defaults to most recent WBB season.

season_type

Season-type id (2 = regular (default)).

...

Additional arguments; currently unused.

Details

Get ESPN WBB Season Group Detail

Get ESPN WBB Season Group Children Index

Get ESPN WBB Season Group Teams Index

Value

A single-row tibble.

Columns as documented in the shared espn_basketball_season_group_schema table.

A tibble with one row per child group.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
parent_group_id character Parent group id (queried).
child_group_id character Child group id.
ref character ⁠$ref⁠ to child group detail.

A tibble with one row per team in the group.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
group_id character ESPN group id.
team_id character ESPN team id.
ref character ⁠$ref⁠ URL to the team-in-season entry.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_season_group(group_id = 5, season = 2025)


  espn_wbb_season_group_children(group_id = 5, season = 2025)


  espn_wbb_season_group_teams(group_id = 5, season = 2025)

Get ESPN WBB Season Groups Index

Description

Returns the list of group IDs (conferences / divisions) for one (WBB season x season-type) via core-v2 ⁠/seasons/{season}/types/{season_type}/groups⁠.

Usage

espn_wbb_season_groups(
  season = most_recent_wbb_season(),
  season_type = c(2L, 3L),
  ...
)

Arguments

season

Season year. Defaults to most recent WBB season.

season_type

Season-type id (2 = regular (default)).

...

Additional arguments; currently unused.

Value

A tibble with one row per group.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
group_id character ESPN group id.
ref character ⁠$ref⁠ URL for the group detail.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_season_groups(season = 2025)

Get ESPN Women's College Basketball Season Info

Description

Get ESPN Women's College Basketball Season Info

Get ESPN Women's College Basketball Season Info

Usage

espn_wbb_season_info(season = most_recent_wbb_season(), ...)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent WBB season.

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(wehoop.proxy = ...) – see ?wehoop for details.

Value

A named list of wehoop_data tibbles: Info, Types, Athletes, Coaches, Teams, Awards. ⁠$ref⁠ URL components are returned as character columns and are NOT auto-resolved – use targeted endpoint functions for details.

Info

col_name types description
year integer 4-digit year.
start_date character Start date (YYYY-MM-DD).
end_date character End date (YYYY-MM-DD).
display_name character Display name.
type_id character Type identifier (numeric).
type_name character Type name.

Types / Athletes / Coaches / Teams / Awards

col_name types description
count integer Count of count.
ref character Ref.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_season_info(season = 2025)

Get ESPN WBB Season Leaders (Long Format)

Description

Returns the per-category leaderboard for one (WBB season x season-type), in long format. Each row is one (category x rank) entry, e.g. "Points Per Game x rank 1 x LeBron James".

Usage

espn_wbb_season_leaders(
  season = most_recent_wbb_season(),
  season_type = c(2L, 3L),
  ...
)

Arguments

season

Season year. Defaults to most recent WBB season.

season_type

Season-type id (2 = regular (default), 3 = postseason).

...

Additional arguments; currently unused.

Details

Get ESPN WBB Season Leaders (Long Format)

Value

A long tibble with one row per (category x leader).

Columns as documented in the shared espn_basketball_season_leaders_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_season_leaders(season = 2025)

Get ESPN WBB Season Ranking Detail

Description

Returns the per-week snapshot index for one ranking source (e.g. AP Top 25). Each row is one weekly snapshot; the ref URL resolves to the actual ranked teams for that (season-type x week) and will be wrapped by a forthcoming espn_LOWERWBB_week_ranking().

Usage

espn_wbb_season_ranking(ranking_id, season = most_recent_wbb_season(), ...)

Arguments

ranking_id

ESPN ranking identifier (character or numeric).

season

Season year. Defaults to most recent WBB season.

...

Additional arguments; currently unused.

Details

Get ESPN WBB Season Ranking Detail

Value

A tibble with one row per weekly snapshot.

Columns as documented in the shared espn_basketball_season_ranking_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_season_ranking(ranking_id = 1, season = 2025)

Get ESPN WBB Season Rankings Index

Description

Returns the index of season-level rankings recorded for one WBB season. Typical sources: AP Top 25 (id 1), Coaches Poll (id 2). Pass an ranking_id to espn_wbb_season_ranking() for the ranked teams.

Usage

espn_wbb_season_rankings(season = most_recent_wbb_season(), ...)

Arguments

season

Season year. Defaults to most recent WBB season.

...

Additional arguments; currently unused.

Details

Get ESPN WBB Season Rankings Index

Value

A tibble with one row per ranking source.

col_name types description
league character League slug.
season integer Season year.
ranking_id character ESPN ranking id.
ref character ⁠$ref⁠ URL for the ranking detail.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_season_rankings(season = 2025)

Get ESPN WBB Season-Type Detail

Description

Returns metadata for one season-type within an WBB season: name, abbreviation, start / end dates, and whether it carries groups, standings, or playoff legs.

Usage

espn_wbb_season_type(season_type = 2L, season = most_recent_wbb_season(), ...)

Arguments

season_type

Season-type id (1 = preseason, 2 = regular (default), 3 = postseason, 4 = off-season).

season

Season year. Defaults to most recent WBB season.

...

Additional arguments; currently unused.

Details

Get ESPN WBB Season-Type Detail

Value

A single-row tibble.

Columns as documented in the shared espn_basketball_season_type_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_season_type(season_type = 2, season = 2025)

Get ESPN WBB Season Types Index

Description

Returns the index of season-type IDs that exist for one WBB season (typically 1 = preseason, 2 = regular, 3 = postseason, 4 = off-season). Pass an ID to espn_wbb_season_type() for the start/end dates and whether that type carries groups, standings, or legs.

Usage

espn_wbb_season_types(season = most_recent_wbb_season(), ...)

Arguments

season

Season year (numeric). Defaults to the most recent WBB season.

...

Additional arguments; currently unused.

Value

A tibble with one row per season type.

col_name types description
league character League slug ("womens-college-basketball").
season integer Season year.
season_type integer Season-type id (1/2/3/4).
ref character ⁠$ref⁠ URL for the type detail.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_season_types(season = 2025)

Get ESPN WBB Season-Week Detail

Description

Returns metadata for one week (number, start / end dates, text label, and ⁠$ref⁠ to the per-week rankings endpoint).

Usage

espn_wbb_season_week(
  week,
  season = most_recent_wbb_season(),
  season_type = 2L,
  ...
)

Arguments

week

Week number.

season

Season year. Defaults to most recent WBB season.

season_type

Season-type id (2 = regular (default)).

...

Additional arguments; currently unused.

Details

Get ESPN WBB Season-Week Detail

Value

A single-row tibble.

Columns as documented in the shared espn_basketball_season_week_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_season_week(week = 5, season = 2025)

Get ESPN WBB Season Weeks Index

Description

Returns the list of week IDs for one (WBB season x season-type). WBB uses a week structure inherited from ESPN's schema, but week-level rankings are populated only for college (MBB / WBB).

Usage

espn_wbb_season_weeks(
  season = most_recent_wbb_season(),
  season_type = c(2L, 3L),
  ...
)

Arguments

season

Season year. Defaults to most recent WBB season.

season_type

Season-type id (2 = regular (default), 3 = postseason).

...

Additional arguments; currently unused.

Value

A tibble with one row per week.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
week integer Week number (1-based).
ref character ⁠$ref⁠ URL for the week detail.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_season_weeks(season = 2025)

Get ESPN Women's College Basketball Seasons

Description

Get ESPN Women's College Basketball Seasons

Get ESPN Women's College Basketball Seasons

Usage

espn_wbb_seasons(...)

Arguments

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(wehoop.proxy = ...) – see ?wehoop for details.

Value

A single wehoop_data tibble with one row per season.

col_name types description
season integer Season identifier (4-digit year or 'YYYY-YY' string).
start_date character Start date (YYYY-MM-DD).
end_date character End date (YYYY-MM-DD).
display_name character Display name.
season_type_count integer Count of season type.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_seasons()

Get ESPN women's college basketball standings

Description

Get ESPN women's college basketball standings

Usage

espn_wbb_standings(year)

Arguments

year

Either numeric or character (YYYY)

Value

Returns a tibble

col_name types description
team_id integer Unique team identifier.
team character Team-side label or team identifier.
conference character Conference group name from ESPN standings.
avgpointsagainst numeric Avgpointsagainst.
avgpointsfor numeric Avgpointsfor.
gamesbehind numeric Gamesbehind.
leaguewinpercent numeric Leaguewinpercent.
losses numeric Total losses.
playoffseed numeric Playoffseed.
pointsagainst numeric Pointsagainst.
pointsfor numeric Pointsfor.
streak numeric Current streak (e.g. 'W3' for three-game win streak).
winpercent numeric Winpercent.
wins numeric Total wins.
total character Total.
home_avgpointsagainst numeric Home team's avgpointsagainst.
home_avgpointsfor numeric Home team's avgpointsfor.
home_gamesbehind numeric Home team's gamesbehind.
home_leaguewinpercent numeric Home team's leaguewinpercent.
home_losses numeric Home team's losses.
home_playoffseed numeric Home team's playoffseed.
home_pointsagainst numeric Home team's pointsagainst.
home_pointsfor numeric Home team's pointsfor.
home_streak numeric Home team's streak.
home_winpercent numeric Home team's winpercent.
home_wins numeric Home team's wins.
home character Home.
road_avgpointsagainst numeric Road avgpointsagainst.
road_avgpointsfor numeric Road avgpointsfor.
road_gamesbehind numeric Road gamesbehind.
road_leaguewinpercent numeric Road leaguewinpercent.
road_losses numeric Road losses.
road_playoffseed numeric Road playoffseed.
road_pointsagainst numeric Road pointsagainst.
road_pointsfor numeric Road pointsfor.
road_streak numeric Road streak.
road_winpercent numeric Road winpercent.
road_wins numeric Road wins.
road character Road.
vsaprankedteams_avgpointsagainst numeric Vsaprankedteams avgpointsagainst.
vsaprankedteams_avgpointsfor numeric Vsaprankedteams avgpointsfor.
vsaprankedteams_gamesbehind numeric Vsaprankedteams gamesbehind.
vsaprankedteams_leaguewinpercent numeric Vsaprankedteams leaguewinpercent.
vsaprankedteams_losses numeric Vsaprankedteams losses.
vsaprankedteams_playoffseed numeric Vsaprankedteams playoffseed.
vsaprankedteams_pointsagainst numeric Vsaprankedteams pointsagainst.
vsaprankedteams_pointsfor numeric Vsaprankedteams pointsfor.
vsaprankedteams_streak numeric Vsaprankedteams streak.
vsaprankedteams_winpercent numeric Vsaprankedteams winpercent.
vsaprankedteams_wins numeric Vsaprankedteams wins.
vsaprankedteams character Vsaprankedteams.
vsusarankedteams_avgpointsagainst numeric Vsusarankedteams avgpointsagainst.
vsusarankedteams_avgpointsfor numeric Vsusarankedteams avgpointsfor.
vsusarankedteams_gamesbehind numeric Vsusarankedteams gamesbehind.
vsusarankedteams_leaguewinpercent numeric Vsusarankedteams leaguewinpercent.
vsusarankedteams_losses numeric Vsusarankedteams losses.
vsusarankedteams_playoffseed numeric Vsusarankedteams playoffseed.
vsusarankedteams_pointsagainst numeric Vsusarankedteams pointsagainst.
vsusarankedteams_pointsfor numeric Vsusarankedteams pointsfor.
vsusarankedteams_streak numeric Vsusarankedteams streak.
vsusarankedteams_winpercent numeric Vsusarankedteams winpercent.
vsusarankedteams_wins numeric Vsusarankedteams wins.
vsusarankedteams character Vsusarankedteams.
vsconf_avgpointsagainst numeric Vsconf avgpointsagainst.
vsconf_avgpointsfor numeric Vsconf avgpointsfor.
vsconf_gamesbehind numeric Vsconf gamesbehind.
vsconf_leaguewinpercent numeric Vsconf leaguewinpercent.
vsconf_losses numeric Vsconf losses.
vsconf_playoffseed numeric Vsconf playoffseed.
vsconf_pointsagainst numeric Vsconf pointsagainst.
vsconf_pointsfor numeric Vsconf pointsfor.
vsconf_streak numeric Vsconf streak.
vsconf_winpercent numeric Vsconf winpercent.
vsconf_wins numeric Vsconf wins.
vsconf character Vsconf.

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

try(espn_wbb_standings(2021))

Get ESPN Women's College Basketball Team Detail

Description

Era-correct team identity for a women's college basketball program in a specific season, plus the available ⁠$ref⁠ URLs for deeper resources (record, statistics, leaders, athletes/roster, coaches, college, etc.). Backed by the core-v2 endpoint sports.core.api.espn.com/v2/sports/basketball/leagues/womens-college-basketball/seasons/{season}/teams/{team_id}.

Historical depth goes back to 1982 at ESPN (NCAA-tournament-era forward). Older seasons return fewer ⁠$ref⁠ keys; missing refs become NA.

Usage

espn_wbb_team(team_id, season = most_recent_wbb_season(), ...)

espn_wbb_team_roster(team_id, season = most_recent_wbb_season(), ...)

espn_wbb_team_leaders(team_id, season = most_recent_wbb_season(), ...)

espn_wbb_team_season_profile(team_id, season = most_recent_wbb_season(), ...)

Arguments

team_id

ESPN team identifier (character or numeric).

season

Season year (numeric). Defaults to the most recent WBB season.

...

Additional arguments; currently unused.

Value

A named list of data frames: Info, Record, NextEvent, StandingSummary, Coaches.

Info

Columns as documented in the shared espn_basketball_team_info_schema table.

Record

col_name types description
type character Record type / category.
summary character Summary.
stats list Stats.

NextEvent

Columns as documented in the shared espn_basketball_player_overview_next_game_schema table.

StandingSummary

col_name types description
standing_summary character Standing summary.

Coaches

col_name types description
id character Unique play identifcation number
first_name character Player's first name.
last_name character Player's last name.
experience integer Years of professional experience.

A single tibble with one row per athlete.

Columns as documented in the shared espn_basketball_team_roster_schema table. ESPN's roster endpoint ignores the season, so a season before the current one is built from that season's published player box scores (name, jersey, position and headshot from the athlete's last game; bio columns NA), and errors when none are published.

A single long-format tibble (one row per category-rank-athlete).

Columns as documented in the shared espn_basketball_team_leaders_schema table.

A single-row tibble with team identity scalars and ⁠_ref⁠ URL columns. Selected columns:

col_name types description
id character ESPN team identifier.
guid character Stable cross-league team GUID.
uid character ESPN UID string.
slug character URL-safe identifier.
location character School/program location (e.g. "UConn").
name character Team name (e.g. "Huskies").
nickname character Common nickname (often same as location).
abbreviation character Short abbreviation (e.g. "CONN").
display_name character Full display name.
short_display_name character Short display name.
color character Primary color (hex, no leading '#').
alternate_color character Alternate color (hex, no leading '#').
is_active logical Whether the team was active in this season.
season integer Season year.
logo character Primary logo URL.
logo_dark character Dark-mode logo URL.
record_ref character ⁠$ref⁠ to team record resource.
statistics_ref character ⁠$ref⁠ to team statistics resource.
athletes_ref character ⁠$ref⁠ to team roster resource (college-only).
college_ref character ⁠$ref⁠ to college (institution) resource.
coaches_ref character ⁠$ref⁠ to team coaches resource.
franchise_ref character ⁠$ref⁠ to franchise resource.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_team(team_id = "2509", season = 2025)


  espn_wbb_team_roster(team_id = "2509", season = 2025)


  espn_wbb_team_leaders(team_id = "2509", season = 2025)


  espn_wbb_team_season_profile(team_id = "2509", season = 2025)

Get ESPN Women's College Basketball Team Injuries

Description

Get ESPN Women's College Basketball Team Injuries

Get ESPN Women's College Basketball Team Injuries

Usage

espn_wbb_team_injuries(team_id, ...)

Arguments

team_id

ESPN team identifier (character or numeric; passed as-is). Use espn_wbb_teams() to look up team IDs. Example: "2509" (UConn).

...

Currently unused; reserved for future argument threading.

Value

Returns a tibble of injury records for the specified WBB team. Returns an empty tibble (zero rows) when the team has no reported injuries.

Injuries

Columns as documented in the shared espn_basketball_team_injuries_injuries_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_team_injuries(team_id = "2509")

Get ESPN WBB Team News

Description

Get ESPN WBB Team News

Get ESPN Women's College Basketball Team News

Usage

espn_wbb_team_news(team_id, limit = 25)

Arguments

team_id

character or integer. ESPN team ID (e.g. 2509 for UConn).

limit

integer. Maximum number of articles to return. Default 25.

Details

Retrieve ESPN women's college basketball news for a specific team. Uses getOption("wehoop.proxy") or http_proxy/https_proxy environment variables for proxy configuration (per-call proxy override is not supported for ESPN wrappers).

Value

Returns a tibble of team news articles.

Columns as documented in the shared espn_basketball_news_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_team_news(team_id = "2509", limit = 5)

Get ESPN WBB Team Record Detail (Long Format)

Description

Returns one team's record detail in long format: one row per stat in the record's stats[] array. Use the record-index endpoint to enumerate available record_id values per team-season (overall / home / away / conference + per-opponent breakdowns).

Usage

espn_wbb_team_record_detail(team_id, season, record_id, season_type = 2L, ...)

Arguments

team_id

ESPN team identifier.

season

Season year (numeric).

record_id

Record identifier (from the record-index endpoint index).

season_type

Integer season type: 1 = preseason, 2 = regular (default), 3 = postseason.

...

Additional arguments; currently unused.

Value

A long tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_team_record_detail(team_id = 2509, season = 2024, record_id = 0)

Get ESPN Women's College Basketball Team Schedule

Description

Get ESPN Women's College Basketball Team Schedule

Get ESPN Women's College Basketball Team Schedule

Usage

espn_wbb_team_schedule(
  team_id,
  season = most_recent_wbb_season(),
  season_type = 2,
  ...
)

Arguments

team_id

ESPN team identifier (character or numeric).

season

Season year (numeric). Defaults to the most recent WBB season.

season_type

Integer season type: 1 = preseason, 2 = regular (default), 3 = postseason.

...

Additional arguments; currently unused.

Value

A single tibble with one row per event.

Columns as documented in the shared espn_basketball_team_schedule_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_team_schedule(team_id = "2509", season = 2025)

Get ESPN WBB Team Roster (Per-Season, core-v2)

Description

Returns the per-season team roster as a tibble of athlete IDs from seasons/{y}/teams/{id}/athletes. Distinct from espn_wbb_team_roster() which targets a site-v2 endpoint optimized for the current season; this core-v2 variant is era-correct and available back to ESPN's earliest season for each league.

Usage

espn_wbb_team_season_roster(team_id, season = most_recent_wbb_season(), ...)

Arguments

team_id

ESPN team identifier.

season

Season year. Defaults to most recent WBB season.

...

Additional arguments; currently unused.

Details

Get ESPN WBB Team Roster (Per-Season, core-v2)

Value

A tibble with one row per athlete on the season roster.

col_name types description
league character League slug.
team_id character ESPN team id.
season integer Season year.
athlete_id character ESPN athlete id.
ref character ⁠$ref⁠ URL to athlete-in-season detail.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_team_season_roster(team_id = 2509, season = 2025)

Get ESPN WBB Team Season Statistics (Long Format with Rank)

Description

Returns the full team-season-type statistics sheet for one WBB team in long format: one row per (category x stat). Each row carries the team's league rank for that stat where ESPN provides it (rank + rank_display_value). Complements W-L records (not directly wrapped for WBB) with the full stat package.

Usage

espn_wbb_team_season_statistics(
  team_id,
  season = most_recent_wbb_season(),
  season_type = 2L,
  ...
)

Arguments

team_id

ESPN team identifier.

season

Season year (numeric). Defaults to the most recent WBB season.

season_type

Integer season type: 1 = preseason, 2 = regular (default), 3 = postseason.

...

Additional arguments; currently unused.

Value

A long tibble with one row per (category x stat).

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_team_season_statistics(team_id = 2509, season = 2024)

Get ESPN women's college basketball team stats data

Description

Get ESPN women's college basketball team stats data

Usage

espn_wbb_team_stats(team_id, year, season_type = "regular", total = FALSE)

Arguments

team_id

Team ID

year

Year

season_type

(character, default: regular): Season type - regular or postseason

total

(boolean, default: FALSE): Totals

Value

Returns a tibble with the team stats data

col_name types description
team_id integer Unique team identifier.
team_guid character ESPN team GUID.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_sdr integer ESPN team SDR identifier.
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location character Team city or location string.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_nickname character Team nickname.
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_display_name character Full team display name.
team_short_display_name character Short team display name (e.g. 'Aces').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
team_is_active logical TRUE if the team is currently active.
team_is_all_star logical TRUE if the row represents an All-Star team.
logo_href character Team or league logo URL.
logo_dark_href character Logo URL for dark backgrounds.
defensive_blocks numeric Short for blocked shot, number of times when a defensive player legally deflects a field goal attempt from an offensive player.
defensive_defensive_rebounds numeric The number of times when the defense obtains the possession of the ball after a missed shot by the offense.
defensive_steals numeric The number of times a defensive player forced a turnover by intercepting or deflecting a pass or a dribble of an offensive player.
defensive_turnover_points numeric The amount of points resulting from the possession following a turnover.
defensive_avg_defensive_rebounds numeric The average defensive rebounds per game.
defensive_avg_blocks numeric The average blocks per game.
defensive_avg_steals numeric The average steals per game.
general_disqualifications numeric The number of times a player reached the foul limit.
general_flagrant_fouls numeric The number of fouls that the officials thought were unnecessary or excessive.
general_fouls numeric The number of times a player had illegal contact with the opponent.
general_ejections numeric The number of times a player or coach is removed from the game as a result of a serious offense.
general_technical_fouls numeric The number of times an player or coach was called for a technical foul (unsportsmanlike conduct or violations).
general_rebounds numeric The total number of rebounds (offensive and defensive).
general_minutes numeric The total number of minutes played.
general_avg_minutes numeric The average number of minutes per game.
general_fantasy_rating numeric The Fantasy Rating of a player.
general_avg_rebounds numeric The average rebounds per game.
general_avg_fouls numeric The average fouls committed per game.
general_avg_flagrant_fouls numeric The average number of flagrant fouls per game.
general_avg_technical_fouls numeric The average number of technical fouls per game.
general_avg_ejections numeric The average ejections per game.
general_avg_disqualifications numeric The average number of disqualifications per game.
general_assist_turnover_ratio numeric The average number of assists a player or team records per turnover.
general_steal_foul_ratio numeric The average number of steals a player or team records per foul committed.
general_block_foul_ratio numeric The average number of blocks a player or record per foul committed.
general_avg_team_rebounds numeric The average number of rebounds for a team per game.
general_total_rebounds numeric The total number of rebounds for a team or player.
general_total_technical_fouls numeric The total number of technical fouls for a team or player.
general_team_assist_turnover_ratio numeric The number of assists per turnover for a team.
general_team_rebounds numeric The total number of rebounds for a team.
general_steal_turnover_ratio numeric The number of steals per turnover.
general_games_played numeric Games Played.
general_games_started numeric The number of games started by an athlete.
general_double_double numeric The number of times double digit values were accumulated in 2 of the following categories: points, rebounds, assists, steals, and blocked shots.
general_triple_double numeric The number of times double digit values were accumulated in 3 of the following categories: points, rebounds, assists, steals, and blocked shots.
offensive_assists numeric The number of times a player who passes the ball to a teammate in a way that leads to a score by field goal, meaning that he or she was "assisting" in the basket. There is some judgment involved in deciding whether a passer should be credited with an assist.
offensive_field_goals numeric Field Goal makes and attempts.
offensive_field_goals_attempted numeric The number of times a 2pt field goal was attempted.
offensive_field_goals_made numeric The number of times a 2pt field goal was made.
offensive_field_goal_pct numeric The ratio of field goals made to field goals attempted: FGM / FGA.
offensive_free_throws numeric Free Throw makes and attempts.
offensive_free_throw_pct numeric The ratio of free throws made to free throws attempted: FTM / FTA.
offensive_free_throws_attempted numeric The number of times a free throw was attempted.
offensive_free_throws_made numeric The number of times a free throw was made.
offensive_offensive_rebounds numeric The number of times when the offense obtains the possession of the ball after a missed shot.
offensive_points numeric The number of points scored.
offensive_turnovers numeric The number of times a player loses possession to the other team.
offensive_three_point_field_goals_attempted numeric The number of times a 3pt field goal was attempted.
offensive_three_point_field_goals_made numeric The number of times a 3pt field goal was made.
offensive_team_turnovers numeric The number of turnovers for the team.
offensive_total_turnovers numeric The number of turnovers plus team turnovers for the team.
offensive_fast_break_points numeric The number of points scored on fast breaks.
offensive_avg_field_goals_made numeric The average field goals made per game.
offensive_avg_field_goals_attempted numeric The average field goals attempted per game.
offensive_avg_three_point_field_goals_made numeric The average three point field goals made per game.
offensive_avg_three_point_field_goals_attempted numeric The average three point field goals attempted per game.
offensive_avg_free_throws_made numeric The average free throw shots made per game.
offensive_avg_free_throws_attempted numeric The average free throw shots attempted per game.
offensive_avg_points numeric The average number of points scored per game.
offensive_avg_offensive_rebounds numeric The average offensive rebounds per game.
offensive_avg_assists numeric The average assists per game.
offensive_avg_turnovers numeric The average turnovers committed per game.
offensive_offensive_rebound_pct numeric The percentage of the number of times they obtain the possession of the ball after a missed shot.
offensive_estimated_possessions numeric An estimation of the number of possessions for a team or player.
offensive_avg_estimated_possessions numeric The average number of estimated possessions per game for a team or player.
offensive_points_per_estimated_possessions numeric The number of points per estimated possession for a team or player.
offensive_avg_team_turnovers numeric The average number of turnovers for a team per game.
offensive_avg_total_turnovers numeric The average number of total turnovers for a team per game.
offensive_three_point_field_goal_pct numeric The ratio of 3pt field goals made to 3pt field goals attempted: 3PM / 3PA.
offensive_two_point_field_goals_made numeric The number of 2-point field goals made for a team or player.
offensive_two_point_field_goals_attempted numeric The number of 2-point field goals attempted for a team or player.
offensive_avg_two_point_field_goals_made numeric The number of 2-point field goals made per game for a team or player.
offensive_avg_two_point_field_goals_attempted numeric The number of 2-point field goals attempted per game for a team or player.
offensive_two_point_field_goal_pct numeric The percentage of 2-points fields goals made by a team or player.
offensive_shooting_efficiency numeric The efficiency with which a team or player shoots the basketball.
offensive_scoring_efficiency numeric The efficiency with which a team or player scores the basketball.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

try(espn_wbb_team_stats(team_id = 2509, year = 2020))

Get ESPN women's college basketball team names and ids

Description

Get ESPN women's college basketball team names and ids

Usage

espn_wbb_teams(year = most_recent_wbb_season())

Arguments

year

Either numeric or character (YYYY)

Value

Returns a teams infomation data frame

col_name types description
team_id integer Unique team identifier.
abbreviation character Short abbreviation.
display_name character Display name.
short_name character Short display name.
mascot character Team mascot.
nickname character Team or athlete nickname.
team character Team-side label or team identifier.
color character Primary color (hex without leading '#').
alternate_color character Alternate color (hex without leading '#').
logo character Team or league logo URL.
logo_dark character Logo dark.
href character Link / page URL.
conference_url character URL for conference.
group_id integer Group identifier (e.g. conference group_id).
conference_short_name character Conference short name (e.g. 'ACC').
conference_uid character ESPN universal conference identifier.
conference_name character Full conference name.
conference_logo character Logo image URL for conference.
parent_group_id integer Unique identifier for parent group.
conference_id integer Conference identifier.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

try(espn_wbb_teams())

Get ESPN WBB Tournament Detail

Description

Returns metadata for a single WBB tournament plus the ⁠$ref⁠ URL for the tournament's seasons list. Tournament IDs of interest include the NCAA Tournament and WNIT (resolve via espn_wbb_tournaments()).

Usage

espn_wbb_tournament(tournament_id, ...)

Arguments

tournament_id

ESPN tournament identifier.

...

Additional arguments; currently unused.

Value

A single-row tibble.

col_name types description
tournament_id character ESPN tournament identifier.
display_name character Human-readable tournament name.
seasons_ref character ⁠$ref⁠ to the seasons-list endpoint.
league character League slug.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_tournament(tournament_id = 3)

Get ESPN WBB Tournament Season Detail

Description

Returns single-row detail for one (tournament, season) pair: id, display name, number of rounds, and ⁠$ref⁠s to the season + bracketology resources. Use espn_wbb_tournament_seasons() to enumerate valid (tournament_id, season) pairs.

Usage

espn_wbb_tournament_season(tournament_id, season, ...)

Arguments

tournament_id

ESPN tournament identifier.

season

Season year (numeric).

...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_tournament_season(tournament_id = 3, season = 2024)

Get ESPN WBB Tournament Seasons List

Description

Returns the seasons in which a given WBB tournament was held.

Usage

espn_wbb_tournament_seasons(tournament_id, ...)

Arguments

tournament_id

ESPN tournament identifier.

...

Additional arguments; currently unused.

Value

A tibble with one row per season.

col_name types description
league character League slug.
tournament_id character ESPN tournament identifier.
season integer Season year.
ref character Full ⁠$ref⁠ URL for that season.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_tournament_seasons(tournament_id = 3)

Get ESPN WBB Tournaments Index

Description

Returns the index of women's college basketball tournaments tracked by ESPN — including the NCAA Tournament, WNIT, conference tournaments, and other in-season events. Pass an ID to espn_wbb_tournament() for the human-readable name and seasons-list ref.

Note: ESPN does not expose a tournaments endpoint for the WNBA.

Usage

espn_wbb_tournaments(...)

Arguments

...

Additional arguments; currently unused.

Value

A tibble with one row per tournament.

col_name types description
tournament_id character ESPN tournament identifier.
ref character Full ⁠$ref⁠ URL for the detail.
league character League slug ("womens-college-basketball").

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_tournaments()

Get ESPN Women's College Basketball Venues

Description

Get ESPN Women's College Basketball Venues

Get ESPN Women's College Basketball Venues

Usage

espn_wbb_venues(...)

Arguments

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(wehoop.proxy = ...) – see ?wehoop for details.

Value

A single wehoop_data tibble with one row per venue.

Columns as documented in the shared espn_basketball_venues_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Examples

espn_wbb_venues()

Get ESPN WBB Per-Week Ranking Detail

Description

Returns the long-format ranked teams for one (season x season-type x week x ranking-source). Typically 25 rows for WBB (AP Top 25).

Usage

espn_wbb_week_ranking(
  ranking_id,
  week,
  season = most_recent_wbb_season(),
  season_type = 2L,
  ...
)

Arguments

ranking_id

Ranking source id (1 = AP, 2 = Coaches, etc.).

week

Week number.

season

Season year. Defaults to most recent WBB season.

season_type

Season-type id (2 = regular (default)).

...

Additional arguments; currently unused.

Details

Get ESPN WBB Per-Week Ranking Detail

Value

A tibble with one row per ranked team (typically 25).

Columns as documented in the shared espn_basketball_week_ranking_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_rankings()

Examples

espn_wbb_week_ranking(ranking_id = 1, week = 5, season = 2025)

Get ESPN WBB Per-Week Rankings Index

Description

Returns the index of ranking sources available for one (WBB season x season-type x week). Typical sources: AP Top 25 (id 1), Coaches Poll (id 2). Pass an id to espn_wbb_week_ranking() for the ranked teams.

Usage

espn_wbb_week_rankings(
  week,
  season = most_recent_wbb_season(),
  season_type = 2L,
  ...
)

Arguments

week

Week number.

season

Season year. Defaults to most recent WBB season.

season_type

Season-type id (2 = regular (default)).

...

Additional arguments; currently unused.

Details

Get ESPN WBB Per-Week Rankings Index

Value

A tibble with one row per ranking source.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
week integer Week number.
ranking_id character ESPN ranking id.
ref character ⁠$ref⁠ URL for the ranked-teams detail.

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_team_linescores(), espn_wbb_game_team_roster_entry(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog_v2(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_stats(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_injuries(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_schedule(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking()

Examples

espn_wbb_week_rankings(week = 5, season = 2025)

Get ESPN WNBA Athletes Index

Description

Get ESPN WNBA Athletes Index

Get ESPN WNBA Athletes Index

Usage

espn_wnba_athletes_index(
  season = most_recent_wnba_season(),
  active = TRUE,
  limit = 5000L,
  ...
)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent WNBA season.

active

logical. When TRUE (default) only active athletes are returned. Set to FALSE for the full historical roster.

limit

integer. Maximum number of rows to return. Default 5000. Pass a small value (e.g. limit = 50) in tests to keep execution fast.

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(wehoop.proxy = ...) – see ?wehoop for details.

Value

A single wehoop_data tibble with one row per athlete.

Columns as documented in the shared espn_basketball_athletes_index_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_athletes_index(season = 2025, limit = 50)

Get ESPN WNBA Season Award Detail

Description

Returns the name, description, and winners of one WNBA season award.

Usage

espn_wnba_award(award_id, season = most_recent_wnba_season(), ...)

Arguments

award_id

ESPN award identifier (character or numeric).

season

Season year (numeric). Defaults to the most recent WNBA season.

...

Additional arguments; currently unused.

Value

A tibble with one row per winner.

col_name types description
league character League slug ("wnba").
season integer Season year.
award_id character ESPN award identifier.
name character Award name.
description character Award description.
athlete_id character ESPN athlete id of winner.
team_id character ESPN team id.
athlete_ref character ⁠$ref⁠ to winner's per-season athlete resource.
team_ref character ⁠$ref⁠ to winner's per-season team resource.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_award(award_id = 247, season = 2024)

Get ESPN WNBA Calendar

Description

Get ESPN WNBA Calendar

Get ESPN WNBA Calendar

Usage

espn_wnba_calendar(season = most_recent_wnba_season())

Arguments

season

integer or character. Four-digit season year (e.g. 2025). Defaults to most_recent_wnba_season().

Details

Retrieve the ESPN WNBA schedule calendar for a given season. The underlying scoreboard response contains a leagues[[1]]$calendar block with season-type entries (pre-season, regular, post). Uses getOption("wehoop.proxy") or http_proxy/https_proxy environment variables for proxy configuration (per-call proxy override is not supported for ESPN wrappers).

Value

Returns a tibble of calendar entries.

Columns as documented in the shared espn_basketball_calendar_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_calendar(season = 2025)

Get ESPN WNBA Coach-in-Season Detail

Description

Per-season coach detail (name, birth info, ⁠$ref⁠s to team/college/ person). ESPN's coverage of this endpoint is sparse; many (coach × season) combinations return 404.

Usage

espn_wnba_coach_season(coach_id, season = most_recent_wnba_season(), ...)

Arguments

coach_id

ESPN coach identifier.

season

Season year. Defaults to most recent WNBA season.

...

Additional arguments; currently unused.

Details

Get ESPN WNBA Coach-in-Season Detail

Value

A single-row tibble.

Columns as documented in the shared espn_basketball_coach_season_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_coach_season(coach_id = 52063, season = 2025)

Get ESPN WNBA Coaches

Description

Get ESPN WNBA Coaches

Get ESPN WNBA Coaches

Usage

espn_wnba_coaches(season = most_recent_wnba_season(), ...)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent WNBA season.

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(wehoop.proxy = ...) – see ?wehoop for details.

Value

A single wehoop_data tibble with one row per coach.

col_name types description
coach_id character Unique identifier for coach.
first_name character Player's first name.
last_name character Player's last name.
full_name character Player's full name.
experience integer Years of professional experience.
team_id character Unique team identifier.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_coaches(season = 2025)

Get ESPN WNBA Conferences

Description

Get ESPN WNBA Conferences

Get ESPN WNBA Conferences

Usage

espn_wnba_conferences()

Value

A wehoop_data tibble with one row per conference:

Columns as documented in the shared espn_basketball_conferences_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

try(espn_wnba_conferences())

Get ESPN WNBA Draft Picks

Description

Get ESPN WNBA Draft Picks

Get ESPN WNBA Draft Picks

Usage

espn_wnba_draft(season = most_recent_wnba_season(), ...)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent WNBA season.

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(wehoop.proxy = ...).

Details

Calls the ESPN core-v2 endpoint ⁠https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/seasons/{year}/draft/rounds⁠, which returns each round of the draft with its picks inlined as ⁠picks: [...]⁠. For historical seasons with no ESPN draft data the function returns an empty tibble rather than erroring.

Value

A wehoop_data tibble with one row per draft pick:

col_name types description
season integer Season identifier (4-digit year or 'YYYY-YY' string).
round integer Tournament / playoff round.
pick integer Pick.
overall integer Overall.
traded logical Traded.
trade_note character Trade note.
status character Status label.
athlete_id character Unique athlete identifier (ESPN).
athlete_ref character Athlete ref.
team_id character Unique team identifier.
team_ref character Team ref.

Athlete and team details (name, position, college, abbreviation) are not inlined in the draft response; resolve them via espn_wnba_player_info() or espn_wnba_team() using the returned IDs.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_draft(season = 2024)

Get ESPN WNBA Draft Athlete Detail (Single Drafted Player)

Description

Returns rich single-row detail for one drafted athlete in one NBA draft year: name, height, weight, position, pick (overall/round/team), and a ⁠$ref⁠ to the athlete's core-v2 profile. Use espn_wnba_draft_athletes() to enumerate draftees for a year.

Usage

espn_wnba_draft_athlete_detail(
  season = most_recent_wnba_season(),
  athlete_id,
  ...
)

Arguments

season

Draft year (numeric). Defaults to the most recent NBA season.

athlete_id

ESPN draftee identifier.

...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_draft_athlete_detail(season = 2024, athlete_id = 3149391)

Get ESPN WNBA Draft Pick Detail

Description

Returns a single WNBA draft pick. Defaults to the most recent WNBA season's #1 overall pick. For a full draft, use espn_wnba_draft().

Usage

espn_wnba_draft_pick(
  season = most_recent_wnba_season(),
  round = 1L,
  pick = 1L,
  ...
)

Arguments

season

Season year. Defaults to most recent WNBA season.

round

Draft round (default 1).

pick

Pick number within the round (default 1).

...

Additional arguments; currently unused.

Details

Get ESPN WNBA Draft Pick Detail

Value

A single-row tibble.

col_name types description
league character League slug.
season integer Season year of the draft.
round integer Round number.
pick integer Pick within the round.
overall integer Overall pick number.
traded logical Whether the pick was traded.
trade_note character Trade note (if any).
status character Pick status name.
athlete_id character Drafted athlete's ESPN id.
team_id character Drafting team's ESPN id.
athlete_ref character ⁠$ref⁠ to athlete.
team_ref character ⁠$ref⁠ to team.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_draft_pick(season = 2024, round = 1, pick = 1)

Get ESPN WNBA Draft Rounds Summary

Description

Returns one row per round of the WNBA draft (typically 2 rounds: 1st with 30 picks, 2nd with ~28 picks).

Returns one row per drafted athlete in a given WNBA draft year.

Returns the current status of one WNBA draft year (round, state, description). Live during the draft; static afterward.

Returns a single-row tibble with top-level draft-year metadata: year, number of rounds, display name, plus ⁠$ref⁠s for the deeper sub-resources (status, athletes, rounds) already wrapped by espn_wnba_draft_status(), espn_wnba_draft_athletes(), and espn_wnba_draft_rounds().

Usage

espn_wnba_draft_rounds(season = most_recent_wnba_season(), ...)

espn_wnba_draft_athletes(season = most_recent_wnba_season(), ...)

espn_wnba_draft_status(season = most_recent_wnba_season(), ...)

espn_wnba_season_draft(season = most_recent_wnba_season(), ...)

Arguments

season

Season year (numeric). Defaults to the most recent WNBA season.

...

Additional arguments; currently unused.

Details

Get ESPN WNBA Draft Rounds Summary

Get ESPN WNBA Draft Athletes Index

Get ESPN WNBA Draft Status

Value

A tibble with one row per round.

A tibble of athlete IDs + ⁠$ref⁠ URLs.

A single-row tibble.

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_draft_rounds(season = 2024)


  espn_wnba_draft_athletes(season = 2024)


  espn_wnba_draft_status(season = 2024)


  espn_wnba_season_draft(season = 2024)

Get ESPN WNBA Franchise Detail

Description

Returns franchise-level metadata for a WNBA franchise. Franchise IDs are stable across relocations and rebrands.

Usage

espn_wnba_franchise(franchise_id, ...)

Arguments

franchise_id

ESPN franchise identifier (character or numeric).

...

Additional arguments; currently unused.

Value

A single-row tibble.

col_name types description
id character ESPN franchise identifier.
uid character ESPN UID string.
slug character URL-safe identifier.
location character Franchise location.
name character Franchise name.
nickname character Common nickname.
abbreviation character Short abbreviation.
display_name character Full display name.
short_display_name character Short display name.
color character Primary color (hex, no leading '#').
is_active logical Whether franchise is currently active.
league character League slug ("wnba").
logo character Primary logo URL.
logo_dark character Dark-mode logo URL.
venue_ref character ⁠$ref⁠ to franchise's primary venue.
team_ref character ⁠$ref⁠ to the current team for franchise.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_franchise(franchise_id = 17)

Get ESPN WNBA Franchises Index

Description

Returns the full WNBA franchises index from sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/franchises. Each row is one franchise with its ID and the canonical ⁠$ref⁠ URL — pass an ID to espn_wnba_franchise() for full franchise detail.

Usage

espn_wnba_franchises(...)

Arguments

...

Additional arguments; currently unused.

Value

A tibble with one row per franchise.

col_name types description
franchise_id character ESPN franchise identifier.
ref character Full ⁠$ref⁠ URL for franchise detail.
league character League slug ("wnba").

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_franchises()

Get ESPN WNBA Free Agents

Description

Get ESPN WNBA Free Agents

Get ESPN WNBA Free Agents

Usage

espn_wnba_freeagents(season = most_recent_wnba_season(), ...)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent WNBA season.

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(wehoop.proxy = ...).

Details

Calls the ESPN core-v2 endpoint ⁠https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/seasons/{year}/freeagents⁠. As of 2026-05, this endpoint returns HTTP 500 for every season tested and there is no documented replacement; the function consequently returns an empty tibble and emits a CLI error message. It is retained so that downstream code does not break if ESPN restores the endpoint, but should not be relied on in the meantime.

Value

A wehoop_data tibble with one row per free agent:

col_name types description
season integer Season identifier (4-digit year or 'YYYY-YY' string).
athlete_id character Unique athlete identifier (ESPN).
athlete_name character Athlete display name (ESPN).
position character Listed roster position (G, F, C, etc.).
prior_team_id character Unique identifier for prior team.
status character Status label.
signed_team_id character Unique identifier for signed team.
signed_date character Date in YYYY-MM-DD format.
contract_value character Contract value.
contract_term_years character Contract term years.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_freeagents(season = 2025)

Get ESPN WNBA Season Futures (Long Format)

Description

Returns the full futures-betting board for a WNBA season, in long format: one row per (market x team). Markets include championship winner and conference winners. Backed by sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/seasons/{season}/futures.

Note: ESPN does not currently expose a futures endpoint for women's college basketball.

Usage

espn_wnba_futures(season = most_recent_wnba_season(), ...)

Arguments

season

Season year (numeric). Defaults to the most recent WNBA season.

...

Additional arguments; currently unused.

Value

A long-format tibble.

col_name types description
season integer Season year.
league character League slug ("wnba").
market_id character ESPN futures-market identifier.
market_name character Internal market name.
market_type character Market type code.
market_display character Human-readable market name.
provider_id character Sportsbook provider identifier.
provider_name character Sportsbook provider name.
team_id character ESPN team id.
odds_value character American odds for the team.
team_ref character ⁠$ref⁠ to the per-season team resource.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_futures(season = 2025)

Get ESPN's WNBA game data (play-by-play, team and player box)

Description

Get ESPN's WNBA game data (play-by-play, team and player box)

Get ESPN's WNBA play by play data

Get ESPN's WNBA team box data

Get ESPN's WNBA player box data

Get ESPN WNBA game rosters

Usage

espn_wnba_game_all(game_id)

espn_wnba_pbp(game_id)

espn_wnba_team_box(game_id)

espn_wnba_player_box(game_id)

espn_wnba_game_rosters(game_id)

Arguments

game_id

Game ID

Value

A named list of dataframes: Plays, Team, Player

Plays

Columns as documented in the shared espn_basketball_game_all_plays_schema table.

Team

Columns as documented in the shared espn_basketball_team_box_schema table.

Player

Columns as documented in the shared espn_basketball_game_all_player_schema table.

Returns a play-by-play data frame

Plays

Columns as documented in the shared espn_basketball_game_all_plays_schema table.

Returns a team boxscore data frame

Team

Columns as documented in the shared espn_basketball_team_box_schema table.

Returns a player boxscore data frame

Player

Columns as documented in the shared espn_basketball_game_all_player_schema table.

A game rosters data frame

col_name types description
athlete_id integer Unique athlete identifier (ESPN).
athlete_uid character ESPN athlete UID (universal identifier).
athlete_guid character ESPN athlete GUID.
athlete_type character Athlete type / class.
sdr integer Sdr.
first_name character Player's first name.
last_name character Player's last name.
full_name character Player's full name.
athlete_display_name character Athlete display name (full).
short_name character Short display name.
weight numeric Player weight in pounds.
display_weight character Player weight in display format (e.g. '180 lbs').
height numeric Player height (string e.g. '6-2' or inches).
display_height character Player height in display format (e.g. '6-2').
age integer Player age (in years).
date_of_birth character Date of birth (YYYY-MM-DD).
slug character URL-safe identifier.
headshot_href character Headshot image URL.
headshot_alt character Alternative-text label for the headshot.
jersey character Jersey number worn by the player.
position_id integer Unique position identifier.
position_name character Listed roster position ('Guard', 'Forward', 'Center').
position_display_name character Position display name.
position_abbreviation character Position abbreviation ('G' / 'F' / 'C').
position_leaf logical Position leaf.
linked logical TRUE if the record is linked to a related entity.
years integer Years.
active logical TRUE if the row represents an active record (player / team / season).
status_id integer Status identifier.
status_name character Status label.
status_type character Status type.
status_abbreviation character Status abbreviation.
birth_place_city character Birth place city.
birth_place_state character Birth place state.
birth_place_country character Birth place country.
starter logical TRUE if the player was in the starting lineup; FALSE otherwise.
valid logical Valid.
did_not_play logical TRUE if the player did not appear in the game.
display_name character Display name.
reason character Reason.
ejected logical TRUE if the player was ejected from the game.
team_id integer Unique team identifier.
team_guid character ESPN team GUID.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_sdr integer ESPN team SDR identifier.
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location character Team city or location string.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_display_name character Full team display name.
team_short_display_name character Short team display name (e.g. 'Aces').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
team_is_active logical TRUE if the team is currently active.
is_all_star logical Is all star.
logo_href character Team or league logo URL.
logo_dark_href character Logo URL for dark backgrounds.
logos_href_2 character Logos href 2.
logos_href_3 character Logos href 3.
game_id integer Unique game identifier.
order integer Display order within the result set.
home_away character Game venue label ('home' or 'away').
winner logical Winner.
draft_display_text character Draft display text.
draft_round integer Round of the draft selection.
draft_year integer Draft year (4-digit).
draft_selection integer Draft selection.
hand_type character Hand type.
hand_abbreviation character Hand abbreviation.
hand_display_value character Hand display value.
citizenship character Citizenship.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

try(espn_wnba_game_all(game_id = 401244185))



   try(espn_wnba_pbp(game_id = 401455681))



   try(espn_wnba_team_box(game_id = 401244185))


  try(espn_wnba_player_box(game_id = 401244185))



  try(espn_wnba_game_rosters(game_id = 401244185))

Get ESPN WNBA Event Odds

Description

Returns the live game situation for one WNBA event: timeouts remaining, team fouls, fouls to give, bonus state, and a ⁠$ref⁠ to the last play. During a live game this reflects current state; after the game ends the values are frozen.

Returns pre-game predictor statistics for one WNBA event in long format: one row per (team × statistic). Typical stats include matchup quality, predicted score, win probability, and team strength metrics. Returns empty for events without predictor data (often the case for already-played games).

Returns the per-team power-index ⁠$ref⁠ URLs for one WNBA event. Coverage is sparse — many events return zero items.

Usage

espn_wnba_game_odds(event_id, ...)

espn_wnba_game_officials(event_id, ...)

espn_wnba_game_broadcasts(event_id, ...)

espn_wnba_game_situation(event_id, ...)

espn_wnba_game_predictor(event_id, ...)

espn_wnba_game_powerindex(event_id, ...)

Arguments

event_id

ESPN event identifier.

...

Additional arguments; currently unused.

Details

Get ESPN WNBA Event Predictor (Pre-game)

Get ESPN WNBA Event Power Index Index

Value

A tibble with one row per odds provider.

Columns as documented in the shared espn_basketball_game_odds_schema table.

A tibble with one row per official assigned to the game.

Columns as documented in the shared espn_basketball_game_officials_schema table.

A tibble with one row per broadcast outlet for the game.

Columns as documented in the shared espn_basketball_game_broadcasts_schema table.

A single-row tibble with timeouts + fouls for both teams.

A long tibble with rows for both home and away teams.

A tibble with one row per team-game power-index entry.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_game_odds(event_id = "401736171")


  espn_wnba_game_officials(event_id = "401736171")


  espn_wnba_game_broadcasts(event_id = "401736171")


  espn_wnba_game_situation(event_id = 401736171)


  espn_wnba_game_predictor(event_id = 401736171)


  espn_wnba_game_powerindex(event_id = 401736171)

Get ESPN WNBA Event Official Detail (Single Official)

Description

Returns a single-row tibble for one referee assigned to one WNBA event, with their name, position (Referee / Crew Chief / Umpire), and crew order. Pair with espn_wnba_game_officials() to enumerate the crew.

Usage

espn_wnba_game_official_detail(event_id, order, ...)

Arguments

event_id

ESPN event identifier.

order

Crew order index (1 = first official). Pair with the order column from event_officials().

...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_game_official_detail(event_id = 401736171, order = 1)

Get ESPN WNBA Event Play Detail (Single Play)

Description

Returns the rich detail block for a single WNBA play: sequence, period, clock, text, scoring/shooting flags, current home/away score, team ⁠$ref⁠, and shot coordinates if applicable. Complements the bulk espn_wnba_pbp() output by exposing the canonical core-v2 play record.

Usage

espn_wnba_game_play(event_id, play_id, ...)

Arguments

event_id

ESPN event identifier.

play_id

ESPN play identifier (visible in pbp() output as play_id or extractable from ⁠plays[].$ref⁠).

...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_game_play(event_id = 401736171, play_id = 4017361714)

Get ESPN WNBA Event Play Personnel (On-Court Lineup at Play)

Description

Returns the players on court at a specific WNBA play in long format (one row per athlete entry across both competitors). Foundation for lineup analysis. ESPN coverage is sparse — many plays return zero rows; the wrapper returns a typed empty tibble in that case.

Usage

espn_wnba_game_play_personnel(event_id, play_id, ...)

Arguments

event_id

ESPN event identifier.

play_id

ESPN play identifier.

...

Additional arguments; currently unused.

Value

A long tibble with one row per on-court athlete.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_game_play_personnel(event_id = 401736171, play_id = 4017361714)

Get ESPN WNBA Event Player Box Score (Long Format)

Description

Returns the long-format per-game box score for a single athlete in one WNBA event. One row per (category x stat). Same shape as espn_wnba_game_team_statistics() but scoped to a single athlete-in-event instead of the full team. stat_type defaults to 0 (regular-season aggregate as ESPN tags it for finished events).

Usage

espn_wnba_game_player_box(event_id, team_id, athlete_id, stat_type = 0L, ...)

Arguments

event_id

ESPN event identifier.

team_id

ESPN team identifier (the competitor the athlete played for).

athlete_id

ESPN athlete identifier.

stat_type

Integer stat-type segment. Defaults to 0 (the only type commonly populated for finished events).

...

Additional arguments; currently unused.

Value

A long tibble with one row per (category x stat).

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_game_player_box(event_id = 401736171, team_id = 17,
                               athlete_id = 3149391)

Get ESPN WNBA Event Win Probabilities

Description

Get ESPN WNBA Event Win Probabilities

Get ESPN WNBA Event Win Probabilities

Usage

espn_wnba_game_probabilities(event_id, limit = 200, ...)

Arguments

event_id

ESPN event/game identifier (character or numeric).

limit

integer. Maximum number of probability rows to return. Defaults to 200. Pagination is handled internally.

...

Additional arguments; currently unused.

Value

A tibble with one row per play-level win-probability entry.

Columns as documented in the shared espn_basketball_game_probabilities_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_game_probabilities(event_id = "401736171", limit = 50)

Get ESPN WNBA Event Prop Bets (Long Format)

Description

Returns prop-bet markets for one WNBA event + provider in long format: one row per (athlete × prop type). Each row has american / decimal / fraction odds plus the current target (e.g. over/under line). Hits the core-v2 competitions/{id}/odds/{provider_id}/propBets endpoint and auto-paginates.

Usage

espn_wnba_game_propbets(event_id, provider_id, ...)

Arguments

event_id

ESPN event identifier.

provider_id

Sportsbook provider id (e.g. 58 = ESPN BET, 100 = Caesars). Look up via espn_wnba_game_odds().

...

Additional arguments; currently unused.

Details

Get ESPN WNBA Event Prop Bets (Long Format)

Value

A long tibble with one row per (athlete × prop type).

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_game_propbets(event_id = 401736171, provider_id = 58)

Get ESPN WNBA Event Competitor Linescores (Per-Quarter)

Description

Returns the per-quarter scoring breakdown for one team in one NBA event. One row per period (regulation quarters + any overtime periods).

Returns the per-team statistical leaders for one WNBA event in long format: one row per (category x athlete rank). Categories typically include points, rebounds, assists, and rating.

Returns the game-day roster index for one team in one WNBA event. Each row carries the athlete id and the core-v2 ⁠$ref⁠ URL — use the ref to dereference athlete-game splits or biographical data.

Returns full team-game statistics for one team in one WNBA event in long format: one row per (category x stat). Covers offensive, defensive, and general categories with both raw values and display strings.

Returns team records as of the given WNBA event: overall, home, away, conference, and division breakdowns where available. One row per record type.

Returns a one-row tibble with one team's final score for one WNBA event: numeric value, display string, winner flag, and source metadata. Quick-lookup wrapper — use espn_wnba_game_team_linescores() for per-period detail.

Usage

espn_wnba_game_team_linescores(event_id, team_id, ...)

espn_wnba_game_team_leaders(event_id, team_id, ...)

espn_wnba_game_team_roster(event_id, team_id, ...)

espn_wnba_game_team_statistics(event_id, team_id, ...)

espn_wnba_game_team_records(event_id, team_id, ...)

espn_wnba_game_team_score(event_id, team_id, ...)

Arguments

event_id

ESPN event identifier.

team_id

ESPN team identifier.

...

Additional arguments; currently unused.

Value

A tibble with one row per period.

A long tibble with one row per (category x rank).

A tibble with one row per active athlete.

A long tibble with one row per (category x stat).

A tibble with one row per record type.

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_game_team_linescores(event_id = 401736171, team_id = 17)


  espn_wnba_game_team_leaders(event_id = 401736171, team_id = 17)


  espn_wnba_game_team_roster(event_id = 401736171, team_id = 17)


  espn_wnba_game_team_statistics(event_id = 401736171, team_id = 17)


  espn_wnba_game_team_records(event_id = 401736171, team_id = 17)


  espn_wnba_game_team_score(event_id = 401736171, team_id = 17)

Get ESPN WNBA Event Competitor Roster Entry (Per-Athlete Game-Day Row)

Description

Returns a single-row tibble describing one athlete's game-day roster entry for one WNBA event. Carries the starter flag, didNotPlay flag with reason, ejection flag, and the substitution slot if the athlete came in for another player. Pair with espn_wnba_game_team_roster() to enumerate the roster.

Usage

espn_wnba_game_team_roster_entry(event_id, team_id, athlete_id, ...)

Arguments

event_id

ESPN event identifier.

team_id

ESPN team identifier.

athlete_id

ESPN athlete identifier.

...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_game_team_roster_entry(event_id = 401736171,
                                            team_id = 17,
                                            athlete_id = 3149391)

Get ESPN WNBA Injuries

Description

Get ESPN WNBA Injuries

Get ESPN WNBA Injuries

Usage

espn_wnba_injuries(season = most_recent_wnba_season(), ...)

Arguments

season

Numeric or character season year (e.g. 2025). The ESPN injury endpoint does not filter by season server-side; the value is attached as a constant column on the returned tibble for downstream joins. Defaults to most_recent_wnba_season().

...

Currently unused; reserved for future argument threading.

Value

Returns a tibble of league-wide WNBA injury records. Returns an empty tibble (zero rows) when no injuries are reported.

Injuries

Columns as documented in the shared espn_basketball_injuries_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_injuries()

Get ESPN WNBA League Leaders

Description

Get ESPN WNBA League Leaders

Get ESPN WNBA League Leaders

Usage

espn_wnba_leaders(season = most_recent_wnba_season(), season_type = 2, ...)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent WNBA season.

season_type

Integer season type: 1 = preseason, 2 = regular (default), 3 = postseason.

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(wehoop.proxy = ...) – see ?wehoop for details.

Value

A single wehoop_data tibble with one row per category-athlete pair.

Columns as documented in the shared espn_basketball_leaders_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_leaders(season = 2024, season_type = 2)

Get ESPN WNBA News

Description

Get ESPN WNBA News

Get ESPN WNBA News

Usage

espn_wnba_news(limit = 50)

Arguments

limit

integer. Maximum number of articles to return. Default 50.

Details

Retrieve ESPN WNBA news. Uses getOption("wehoop.proxy") or http_proxy/https_proxy environment variables for proxy configuration (per-call proxy override is not supported for ESPN wrappers).

Value

Returns a tibble of news articles.

Columns as documented in the shared espn_basketball_news_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_news(limit = 5)

Get ESPN WNBA Athlete Awards

Description

Get ESPN WNBA Athlete Awards

Get ESPN WNBA Athlete Awards

Usage

espn_wnba_player_awards(athlete_id, ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).

...

Additional arguments; currently unused.

Value

A single tibble. This endpoint is sparse; many athletes have no award data, in which case an empty tibble with canonical columns is returned.

Columns as documented in the shared espn_basketball_player_awards_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_player_awards(athlete_id = "3149391")

Get ESPN WNBA Athlete Career Stats (Long Format)

Description

Returns career stats for a WNBA athlete in long format. Default stat_type = 0L fetches the standard "All Splits" / regular-season view. Pass a vector like c(0L, 1L, 2L) to attempt multiple types and bind them via a stat_type_id column; variants that 404 for that athlete are silently skipped. Stat types: 0 = regular season (default endpoint), 1 = postseason, 2 = career aggregate. Coverage of types 1 and 2 is sparse — many athletes only have type 0 populated.

Usage

espn_wnba_player_career_stats(athlete_id, stat_type = 0L, ...)

Arguments

athlete_id

ESPN athlete identifier.

stat_type

Integer or integer vector of stat-type codes. Default 0L fetches the standard "All Splits" / regular-season view. Pass a vector like c(0L, 1L, 2L) to bind multiple types via a stat_type_id column; non-existent variants are silently skipped.

...

Additional arguments; currently unused.

Details

Get ESPN WNBA Athlete Career Stats (Long Format)

Value

A long tibble (one row per stat_type × split × category × stat).

Columns as documented in the shared espn_basketball_player_career_stats_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

# LeBron James — regular + postseason combined
  espn_wnba_player_career_stats(athlete_id = 3149391)
  # Just career aggregate
  espn_wnba_player_career_stats(athlete_id = 3149391, stat_type = 2L)

Get ESPN WNBA Athlete Per-Season Event Log (core-v2)

Description

Returns one row per (event x team) for an WNBA athlete's appearances in a given season. Distinct from espn_wnba_player_eventlog() which wraps the web-common-v3 gamelog endpoint returning stats per game; this core-v2 variant returns refs + played flag and is era-correct.

Usage

espn_wnba_player_eventlog_v2(
  athlete_id,
  season = most_recent_wnba_season(),
  ...
)

Arguments

athlete_id

ESPN athlete identifier.

season

Season year. Defaults to most recent WNBA season.

...

Additional arguments; currently unused.

Value

A tibble with one row per event appearance. See package source for column schema.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_player_eventlog_v2(athlete_id = 2999102, season = 2025)

Get ESPN WNBA Athlete Info

Description

Get ESPN WNBA Athlete Info

Get ESPN WNBA Athlete Info

Usage

espn_wnba_player_info(athlete_id, ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(wehoop.proxy = ...) – see ?wehoop for details.

Value

A named list of data frames: Bio, Team, Position, Status, College, Draft.

Bio

Columns as documented in the shared espn_basketball_player_info_bio_schema table.

Team

col_name types description
id character Unique play identifcation number
abbreviation character Short abbreviation.
display_name character Display name.

Position

col_name types description
id character Unique play identifcation number
name character Display name.
abbreviation character Short abbreviation.

Status

col_name types description
id character Unique play identifcation number
name character Display name.
type character Record type / category.

College

col_name types description
id character Unique play identifcation number
name character Display name.
mascot character Team mascot.

Draft

col_name types description
year character 4-digit year.
round character Tournament / playoff round.
selection character Selection.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_player_info(athlete_id = "3149391")

Get ESPN WNBA Athlete Overview

Description

Get ESPN WNBA Athlete Overview

Get ESPN WNBA Athlete Stats

Get ESPN WNBA Athlete Gamelog

Get ESPN WNBA Athlete Splits

Get ESPN WNBA Athlete Eventlog

Get ESPN WNBA Athlete Eventlog

Get ESPN WNBA Athlete Statisticslog

Usage

espn_wnba_player_overview(athlete_id, season = most_recent_wnba_season(), ...)

espn_wnba_player_stats_v3(athlete_id, season = most_recent_wnba_season(), ...)

espn_wnba_player_gamelog(athlete_id, season = most_recent_wnba_season(), ...)

espn_wnba_player_splits(athlete_id, season = most_recent_wnba_season(), ...)

espn_wnba_player_eventlog(athlete_id, season = most_recent_wnba_season(), ...)

espn_wnba_player_statisticslog(
  athlete_id,
  season = most_recent_wnba_season(),
  ...
)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).

season

Season year (numeric). Defaults to the most recent WNBA season.

...

Additional arguments; currently unused.

Value

A named list of data frames: Statistics, NextGame, Last5Games, Headlines, FantasyOutlook.

Statistics

Columns as documented in the shared espn_basketball_player_overview_statistics_schema table.

NextGame

Columns as documented in the shared espn_basketball_player_overview_next_game_schema table.

Last5Games

Columns as documented in the shared espn_basketball_player_overview_statistics_schema table.

Headlines

col_name types description
headline character News headline.
description character Long-form description text.
published character Publication timestamp (ISO 8601).

FantasyOutlook

Columns as documented in the shared espn_basketball_player_overview_statistics_schema table.

A wide wehoop_data tibble, one row per athlete-season-team, with the ESPN stat categories spread across prefixed columns:

col_name types description
athlete_id character ESPN athlete identifier (echoed input).
season integer Season year for the stat line.
team_id character ESPN team identifier for that season.
team_slug character Team slug (e.g. 'phoenix-mercury').
avg_* numeric Per-game season-average stats (e.g. avg_avg_points).
tot_* numeric Season-total stats (e.g. tot_points).
misc_* numeric Miscellaneous season totals.

Stat column names come from ESPN's positional names array per category, cleaned via janitor::make_clean_names(); the exact set varies by season.

A single tibble with one row per game. Column names reflect the stat labels returned by ESPN and will vary by season and player.

A single long-format tibble. When data are present, columns include at minimum category and split_name, plus per-stat columns driven by ESPN labels.

A single tibble. Per-event statistics.$ref URLs from the ESPN core-v2 API are returned as the character column statistics_ref and are NOT resolved. Similarly, event_ref, competition_ref, and team_ref are returned as character columns.

col_name types description
event_ref character Reference link to the originating event.
competition_ref character Competition ref.
team_ref character Team ref.
statistics_ref character Statistics ref.

A single tibble. When resolved, each row corresponds to one statistical entry in the core-v2 statistics log, with event_ref and statistics_ref character columns pointing to resolvable ESPN endpoints.

col_name types description
event_ref character Reference link to the originating event.
statistics_ref character Statistics ref.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_player_overview(athlete_id = "3149391", season = 2024)


  espn_wnba_player_stats_v3(athlete_id = "4068159", season = 2024)


  espn_wnba_player_gamelog(athlete_id = "3149391", season = 2024)


  espn_wnba_player_splits(athlete_id = "3149391", season = 2024)


  espn_wnba_player_eventlog(athlete_id = "3149391", season = 2024)


  espn_wnba_player_statisticslog(athlete_id = "3149391", season = 2024)

Get ESPN WNBA Athlete Career Seasons

Description

Returns the list of seasons an WNBA athlete appeared in. Useful for bounding follow-up calls to per-season endpoints.

Usage

espn_wnba_player_seasons(athlete_id, ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).

...

Additional arguments; currently unused.

Value

A tibble with one row per career season.

col_name types description
league character League slug.
athlete_id character ESPN athlete id.
season integer Season year.
ref character ⁠$ref⁠ URL to the season detail.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

# LeBron James (1966): 23 career seasons
  espn_wnba_player_seasons(athlete_id = 3149391)

Get ESPN WNBA player stats data

Description

Get ESPN WNBA player stats data

Usage

espn_wnba_player_stats(
  athlete_id,
  year,
  season_type = "regular",
  total = FALSE
)

Arguments

athlete_id

Athlete ID

year

Year

season_type

(character, default: regular): Season type - regular or postseason

total

(boolean, default: FALSE): Totals

Value

Returns a tibble with the player stats data

col_name types description
athlete_id integer Unique athlete identifier (ESPN).
athlete_uid character ESPN athlete UID (universal identifier).
athlete_guid character ESPN athlete GUID.
athlete_type character Athlete type / class.
sdr integer Sdr.
first_name character Player's first name.
last_name character Player's last name.
full_name character Player's full name.
display_name character Display name.
short_name character Short display name.
weight numeric Player weight in pounds.
display_weight character Player weight in display format (e.g. '180 lbs').
height numeric Player height (string e.g. '6-2' or inches).
display_height character Player height in display format (e.g. '6-2').
age integer Player age (in years).
date_of_birth character Date of birth (YYYY-MM-DD).
slug character URL-safe identifier.
headshot_href character Headshot image URL.
headshot_alt character Alternative-text label for the headshot.
position_id integer Unique position identifier.
position_name character Listed roster position ('Guard', 'Forward', 'Center').
position_display_name character Position display name.
position_abbreviation character Position abbreviation ('G' / 'F' / 'C').
position_leaf logical Position leaf.
linked logical TRUE if the record is linked to a related entity.
years integer Years.
active logical TRUE if the row represents an active record (player / team / season).
status_id integer Status identifier.
status_name character Status label.
status_type character Status type.
status_abbreviation character Status abbreviation.
defensive_blocks numeric Short for blocked shot, number of times when a defensive player legally deflects a field goal attempt from an offensive player.
defensive_defensive_rebounds numeric The number of times when the defense obtains the possession of the ball after a missed shot by the offense.
defensive_steals numeric The number of times a defensive player forced a turnover by intercepting or deflecting a pass or a dribble of an offensive player.
defensive_avg_defensive_rebounds numeric The average defensive rebounds per game.
defensive_avg_blocks numeric The average blocks per game.
defensive_avg_steals numeric The average steals per game.
defensive_avg48defensive_rebounds numeric The average number of defensive rebounds per 48 minutes.
defensive_avg48blocks numeric The average number of blocks per 48 minutes.
defensive_avg48steals numeric The average number of steals per 48 minutes.
general_disqualifications numeric The number of times a player reached the foul limit.
general_flagrant_fouls numeric The number of fouls that the officials thought were unnecessary or excessive.
general_fouls numeric The number of times a player had illegal contact with the opponent.
general_ejections numeric The number of times a player or coach is removed from the game as a result of a serious offense.
general_technical_fouls numeric The number of times an player or coach was called for a technical foul (unsportsmanlike conduct or violations).
general_rebounds numeric The total number of rebounds (offensive and defensive).
general_vorp numeric Value Over Replacement Player.
general_minutes numeric The total number of minutes played.
general_avg_minutes numeric The average number of minutes per game.
general_fantasy_rating numeric The Fantasy Rating of a player.
general_nba_rating numeric General nba rating.
general_plus_minus numeric A player's estimated on-court impact on team performance measured in point differential per 100 possessions.
general_avg_rebounds numeric The average rebounds per game.
general_avg_fouls numeric The average fouls committed per game.
general_avg_flagrant_fouls numeric The average number of flagrant fouls per game.
general_avg_technical_fouls numeric The average number of technical fouls per game.
general_avg_ejections numeric The average ejections per game.
general_avg_disqualifications numeric The average number of disqualifications per game.
general_assist_turnover_ratio numeric The average number of assists a player or team records per turnover.
general_steal_foul_ratio numeric The average number of steals a player or team records per foul committed.
general_block_foul_ratio numeric The average number of blocks a player or record per foul committed.
general_avg_team_rebounds numeric The average number of rebounds for a team per game.
general_total_rebounds numeric The total number of rebounds for a team or player.
general_total_technical_fouls numeric The total number of technical fouls for a team or player.
general_team_assist_turnover_ratio numeric The number of assists per turnover for a team.
general_steal_turnover_ratio numeric The number of steals per turnover.
general_avg48rebounds numeric The average number of rebounds per 48 minutes.
general_avg48fouls numeric The average number of fouls committed per 48 minutes.
general_avg48flagrant_fouls numeric The average number of flagrant fouls committed per 48 minutes.
general_avg48technical_fouls numeric The average number of technical fouls committed per 48 minutes.
general_avg48ejections numeric The average number of ejections per 48 minutes.
general_avg48disqualifications numeric The average number of disqualifications per 48 minutes.
general_games_played numeric Games Played.
general_games_started numeric The number of games started by an athlete.
general_double_double numeric The number of times double digit values were accumulated in 2 of the following categories: points, rebounds, assists, steals, and blocked shots.
general_triple_double numeric The number of times double digit values were accumulated in 3 of the following categories: points, rebounds, assists, steals, and blocked shots.
offensive_assists numeric The number of times a player who passes the ball to a teammate in a way that leads to a score by field goal, meaning that he or she was "assisting" in the basket. There is some judgment involved in deciding whether a passer should be credited with an assist.
offensive_field_goals numeric Field Goal makes and attempts.
offensive_field_goals_attempted numeric The number of times a 2pt field goal was attempted.
offensive_field_goals_made numeric The number of times a 2pt field goal was made.
offensive_field_goal_pct numeric The ratio of field goals made to field goals attempted: FGM / FGA.
offensive_free_throws numeric Free Throw makes and attempts.
offensive_free_throw_pct numeric The ratio of free throws made to free throws attempted: FTM / FTA.
offensive_free_throws_attempted numeric The number of times a free throw was attempted.
offensive_free_throws_made numeric The number of times a free throw was made.
offensive_offensive_rebounds numeric The number of times when the offense obtains the possession of the ball after a missed shot.
offensive_points numeric The number of points scored.
offensive_turnovers numeric The number of times a player loses possession to the other team.
offensive_three_point_pct numeric The ratio of 3pt field goals made to 3pt field goals attempted: 3PM / 3PA.
offensive_three_point_field_goals_attempted numeric The number of times a 3pt field goal was attempted.
offensive_three_point_field_goals_made numeric The number of times a 3pt field goal was made.
offensive_total_turnovers numeric The number of turnovers plus team turnovers for the team.
offensive_points_in_paint numeric The amount of points scored in the area known as "the Paint"(the rectangle between the foul line and the baseline).
offensive_brick_index numeric How many points a player costs his team with his shooting compared with the league average on a per-40-minute basis. ((52.8 - TS%) x (FGA + (FTA x 0.44))) / (Min/40) .
offensive_avg_field_goals_made numeric The average field goals made per game.
offensive_avg_field_goals_attempted numeric The average field goals attempted per game.
offensive_avg_three_point_field_goals_made numeric The average three point field goals made per game.
offensive_avg_three_point_field_goals_attempted numeric The average three point field goals attempted per game.
offensive_avg_free_throws_made numeric The average free throw shots made per game.
offensive_avg_free_throws_attempted numeric The average free throw shots attempted per game.
offensive_avg_points numeric The average number of points scored per game.
offensive_avg_offensive_rebounds numeric The average offensive rebounds per game.
offensive_avg_assists numeric The average assists per game.
offensive_avg_turnovers numeric The average turnovers committed per game.
offensive_offensive_rebound_pct numeric The percentage of the number of times they obtain the possession of the ball after a missed shot.
offensive_estimated_possessions numeric An estimation of the number of possessions for a team or player.
offensive_avg_estimated_possessions numeric The average number of estimated possessions per game for a team or player.
offensive_points_per_estimated_possessions numeric The number of points per estimated possession for a team or player.
offensive_avg_team_turnovers numeric The average number of turnovers for a team per game.
offensive_avg_total_turnovers numeric The average number of total turnovers for a team per game.
offensive_three_point_field_goal_pct numeric The ratio of 3pt field goals made to 3pt field goals attempted: 3PM / 3PA.
offensive_two_point_field_goals_made numeric The number of 2-point field goals made for a team or player.
offensive_two_point_field_goals_attempted numeric The number of 2-point field goals attempted for a team or player.
offensive_avg_two_point_field_goals_made numeric The number of 2-point field goals made per game for a team or player.
offensive_avg_two_point_field_goals_attempted numeric The number of 2-point field goals attempted per game for a team or player.
offensive_two_point_field_goal_pct numeric The percentage of 2-points fields goals made by a team or player.
offensive_shooting_efficiency numeric The efficiency with which a team or player shoots the basketball.
offensive_scoring_efficiency numeric The efficiency with which a team or player scores the basketball.
offensive_avg48field_goals_made numeric The average number of fieldgoals made per 48 minutes.
offensive_avg48field_goals_attempted numeric The average number of fieldgoals attempted per 48 minutes.
offensive_avg48three_point_field_goals_made numeric The average per number of 3-Pointers made per 48 minutes.
offensive_avg48three_point_field_goals_attempted numeric The average number of 3-pointers attempted per 48 minutes.
offensive_avg48free_throws_made numeric The average number of Free Throws made per 48 minutes.
offensive_avg48free_throws_attempted numeric The average number of free throws attempted per 48 minutes.
offensive_avg48points numeric The average number of points scored per 48 minutes.
offensive_avg48offensive_rebounds numeric The average number of offenseive rebounds per 48 minutes.
offensive_avg48assists numeric The average number of assists per 48 minutes.
offensive_avg48turnovers numeric The average number of turnovers per 48 minutes.
team_id integer Unique team identifier.
team_guid character ESPN team GUID.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_sdr integer ESPN team SDR identifier.
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location character Team city or location string.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_display_name character Full team display name.
team_short_display_name character Short team display name (e.g. 'Aces').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
team_is_active logical TRUE if the team is currently active.
team_is_all_star logical TRUE if the row represents an All-Star team.
logo_href character Team or league logo URL.
logo_dark_href character Logo URL for dark backgrounds.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

try(espn_wnba_player_stats(athlete_id = 2529130, year = 2022))

Get ESPN WNBA Position Detail

Description

Returns metadata for a single WNBA position. Useful for dereferencing position ⁠$ref⁠ URLs embedded in athlete records, and for navigating parent/leaf relationships in the position taxonomy.

Usage

espn_wnba_position(position_id, ...)

Arguments

position_id

ESPN position identifier (character or numeric).

...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_position(position_id = 1)

Get ESPN WNBA Positions Index

Description

Returns the WNBA position dictionary index. One row per position with its id and the canonical ⁠$ref⁠ URL — pass an id to espn_wnba_position() for full details (display name, abbreviation, leaf flag, parent link).

Usage

espn_wnba_positions(...)

Arguments

...

Additional arguments; currently unused.

Value

A tibble with one row per position.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_positions()

Get ESPN WNBA Season Power Index (Long Format)

Description

Returns ESPN's Basketball Power Index (BPI) and related per-team metrics for one WNBA season, in long format: one row per (team x stat).

Usage

espn_wnba_powerindex(
  season = most_recent_wnba_season(),
  season_type = c(2L, 3L),
  ...
)

Arguments

season

Season year (numeric). Defaults to the most recent WNBA season.

season_type

Integer (1=preseason, 2=regular (default), 3=postseason).

...

Additional arguments; currently unused.

Value

A long tibble with one row per (team x stat).

col_name types description
league character League slug ("wnba").
season integer Season year.
season_type integer 1=preseason, 2=regular, 3=postseason.
team_id character ESPN team id.
stat_name character Internal stat key.
abbreviation character Short stat abbreviation.
display_name character Human-readable stat name.
description character Stat description.
value numeric Stat value.
display_value character Display-formatted value.
last_updated character Last-updated timestamp.
team_ref character ⁠$ref⁠ to the team-in-season resource.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_powerindex(season = 2025)

Get WNBA schedule for a specific year/date from ESPN's API

Description

Get WNBA schedule for a specific year/date from ESPN's API

Usage

espn_wnba_scoreboard(season)

Arguments

season

Either numeric or character

Value

Returns a tibble

Columns as documented in the shared espn_basketball_scoreboard_schema table.

Author(s)

Saiem Gilani.

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

# Get schedule from date 2022-08-31

  try(espn_wnba_scoreboard (season = "20220831"))

Get ESPN WNBA Season Awards Index

Description

Returns the list of award IDs given out in a WNBA season from sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/seasons/{season}/awards. The index only contains IDs and ⁠$ref⁠ URLs — pass an ID to espn_wnba_award() for the award name, description, and winners.

Usage

espn_wnba_season_awards(season = most_recent_wnba_season(), ...)

Arguments

season

Season year (numeric). Defaults to the most recent WNBA season.

...

Additional arguments; currently unused.

Value

A tibble with one row per award.

col_name types description
season integer Season year.
award_id character ESPN award identifier.
ref character Full ⁠$ref⁠ URL for the award detail.
league character League slug ("wnba").

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_season_awards(season = 2024)

Get ESPN WNBA Season Group Detail

Description

Returns metadata for one group (conference or division) in one (WNBA season x season-type), plus ⁠$ref⁠ URLs to its parent group, children groups, member teams, and standings.

Returns the list of child groups (e.g. divisions within a conference) for one (WNBA season x season-type x parent-group).

Returns the list of team IDs that belong to one group (conference or division) for one (WNBA season x season-type).

Usage

espn_wnba_season_group(
  group_id,
  season = most_recent_wnba_season(),
  season_type = 2L,
  ...
)

espn_wnba_season_group_children(
  group_id,
  season = most_recent_wnba_season(),
  season_type = 2L,
  ...
)

espn_wnba_season_group_teams(
  group_id,
  season = most_recent_wnba_season(),
  season_type = 2L,
  ...
)

Arguments

group_id

ESPN group identifier.

season

Season year. Defaults to most recent WNBA season.

season_type

Season-type id (2 = regular (default)).

...

Additional arguments; currently unused.

Details

Get ESPN WNBA Season Group Detail

Get ESPN WNBA Season Group Children Index

Get ESPN WNBA Season Group Teams Index

Value

A single-row tibble.

Columns as documented in the shared espn_basketball_season_group_schema table.

A tibble with one row per child group.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
parent_group_id character Parent group id (queried).
child_group_id character Child group id.
ref character ⁠$ref⁠ to child group detail.

A tibble with one row per team in the group.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
group_id character ESPN group id.
team_id character ESPN team id.
ref character ⁠$ref⁠ URL to the team-in-season entry.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_season_group(group_id = 5, season = 2025)


  espn_wnba_season_group_children(group_id = 5, season = 2025)


  espn_wnba_season_group_teams(group_id = 5, season = 2025)

Get ESPN WNBA Season Groups Index

Description

Returns the list of group IDs (conferences / divisions) for one (WNBA season x season-type) via core-v2 ⁠/seasons/{season}/types/{season_type}/groups⁠.

Usage

espn_wnba_season_groups(
  season = most_recent_wnba_season(),
  season_type = c(2L, 3L),
  ...
)

Arguments

season

Season year. Defaults to most recent WNBA season.

season_type

Season-type id (2 = regular (default)).

...

Additional arguments; currently unused.

Value

A tibble with one row per group.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
group_id character ESPN group id.
ref character ⁠$ref⁠ URL for the group detail.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_season_groups(season = 2025)

Get ESPN WNBA Season Info

Description

Get ESPN WNBA Season Info

Get ESPN WNBA Season Info

Usage

espn_wnba_season_info(season = most_recent_wnba_season(), ...)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent WNBA season.

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(wehoop.proxy = ...) – see ?wehoop for details.

Value

A named list of wehoop_data tibbles: Info, Types, Athletes, Coaches, Teams, Awards. ⁠$ref⁠ URL components are returned as character columns and are NOT auto-resolved – use targeted endpoint functions for details.

Info

col_name types description
year integer 4-digit year.
start_date character Start date (YYYY-MM-DD).
end_date character End date (YYYY-MM-DD).
display_name character Display name.
type_id character Type identifier (numeric).
type_name character Type name.

Types / Athletes / Coaches / Teams / Awards

col_name types description
count integer Count of count.
ref character Ref.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_season_info(season = 2025)

Get ESPN WNBA Season Leaders (Long Format)

Description

Returns the per-category leaderboard for one (WNBA season x season-type), in long format. Each row is one (category x rank) entry, e.g. "Points Per Game x rank 1 x LeBron James".

Usage

espn_wnba_season_leaders(
  season = most_recent_wnba_season(),
  season_type = c(2L, 3L),
  ...
)

Arguments

season

Season year. Defaults to most recent WNBA season.

season_type

Season-type id (2 = regular (default), 3 = postseason).

...

Additional arguments; currently unused.

Details

Get ESPN WNBA Season Leaders (Long Format)

Value

A long tibble with one row per (category x leader).

Columns as documented in the shared espn_basketball_season_leaders_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_season_leaders(season = 2025)

Get ESPN WNBA Season Ranking Detail

Description

Returns the per-week snapshot index for one ranking source (e.g. AP Top 25). Each row is one weekly snapshot; the ref URL resolves to the actual ranked teams for that (season-type x week) and will be wrapped by a forthcoming espn_LOWERWNBA_week_ranking().

Usage

espn_wnba_season_ranking(ranking_id, season = most_recent_wnba_season(), ...)

Arguments

ranking_id

ESPN ranking identifier (character or numeric).

season

Season year. Defaults to most recent WNBA season.

...

Additional arguments; currently unused.

Details

Get ESPN WNBA Season Ranking Detail

Value

A tibble with one row per weekly snapshot.

Columns as documented in the shared espn_basketball_season_ranking_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_season_ranking(ranking_id = 1, season = 2025)

Get ESPN WNBA Season Rankings Index

Description

Returns the index of season-level rankings recorded for one WNBA season. WNBA typically returns zero rankings (ranking polls are a college concept); the wrapper is provided for symmetry across leagues. For WBB use the matching espn_wbb_season_rankings().

Usage

espn_wnba_season_rankings(season = most_recent_wnba_season(), ...)

Arguments

season

Season year. Defaults to most recent WNBA season.

...

Additional arguments; currently unused.

Details

Get ESPN WNBA Season Rankings Index

Value

A tibble with one row per ranking source.

col_name types description
league character League slug.
season integer Season year.
ranking_id character ESPN ranking id.
ref character ⁠$ref⁠ URL for the ranking detail.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_season_rankings(season = 2025)

Get ESPN WNBA Season-Type Detail

Description

Returns metadata for one season-type within an WNBA season: name, abbreviation, start / end dates, and whether it carries groups, standings, or playoff legs.

Usage

espn_wnba_season_type(
  season_type = 2L,
  season = most_recent_wnba_season(),
  ...
)

Arguments

season_type

Season-type id (1 = preseason, 2 = regular (default), 3 = postseason, 4 = off-season).

season

Season year. Defaults to most recent WNBA season.

...

Additional arguments; currently unused.

Details

Get ESPN WNBA Season-Type Detail

Value

A single-row tibble.

Columns as documented in the shared espn_basketball_season_type_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_season_type(season_type = 2, season = 2025)

Get ESPN WNBA Season Types Index

Description

Returns the index of season-type IDs that exist for one WNBA season (typically 1 = preseason, 2 = regular, 3 = postseason, 4 = off-season). Pass an ID to espn_wnba_season_type() for the start/end dates and whether that type carries groups, standings, or legs.

Usage

espn_wnba_season_types(season = most_recent_wnba_season(), ...)

Arguments

season

Season year (numeric). Defaults to the most recent WNBA season.

...

Additional arguments; currently unused.

Value

A tibble with one row per season type.

col_name types description
league character League slug ("wnba").
season integer Season year.
season_type integer Season-type id (1/2/3/4).
ref character ⁠$ref⁠ URL for the type detail.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_season_types(season = 2025)

Get ESPN WNBA Season-Week Detail

Description

Returns metadata for one week (number, start / end dates, text label, and ⁠$ref⁠ to the per-week rankings endpoint).

Usage

espn_wnba_season_week(
  week,
  season = most_recent_wnba_season(),
  season_type = 2L,
  ...
)

Arguments

week

Week number.

season

Season year. Defaults to most recent WNBA season.

season_type

Season-type id (2 = regular (default)).

...

Additional arguments; currently unused.

Details

Get ESPN WNBA Season-Week Detail

Value

A single-row tibble.

Columns as documented in the shared espn_basketball_season_week_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_season_week(week = 5, season = 2025)

Get ESPN WNBA Season Weeks Index

Description

Returns the list of week IDs for one (WNBA season x season-type). WNBA uses a week structure inherited from ESPN's schema, but week-level rankings are populated only for college (MBB / WBB).

Usage

espn_wnba_season_weeks(
  season = most_recent_wnba_season(),
  season_type = c(2L, 3L),
  ...
)

Arguments

season

Season year. Defaults to most recent WNBA season.

season_type

Season-type id (2 = regular (default), 3 = postseason).

...

Additional arguments; currently unused.

Value

A tibble with one row per week.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
week integer Week number (1-based).
ref character ⁠$ref⁠ URL for the week detail.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_season_weeks(season = 2025)

Get ESPN WNBA Seasons

Description

Get ESPN WNBA Seasons

Get ESPN WNBA Seasons

Usage

espn_wnba_seasons(...)

Arguments

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(wehoop.proxy = ...) – see ?wehoop for details.

Value

A single wehoop_data tibble with one row per season.

col_name types description
season integer Season identifier (4-digit year or 'YYYY-YY' string).
start_date character Start date (YYYY-MM-DD).
end_date character End date (YYYY-MM-DD).
display_name character Display name.
season_type_count integer Count of season type.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_seasons()

Get ESPN WNBA Standings

Description

Get ESPN WNBA Standings

Usage

espn_wnba_standings(year)

Arguments

year

Either numeric or character (YYYY)

Value

Returns a tibble

col_name types description
team_id integer Unique team identifier.
team character Team-side label or team identifier.
avgpointsagainst numeric Avgpointsagainst.
avgpointsfor numeric Avgpointsfor.
clincher numeric Clincher.
differential numeric Differential.
divisionwinpercent numeric Divisionwinpercent.
gamesbehind numeric Gamesbehind.
leaguewinpercent numeric Leaguewinpercent.
losses numeric Total losses.
playoffseed numeric Playoffseed.
streak numeric Current streak (e.g. 'W3' for three-game win streak).
winpercent numeric Winpercent.
wins numeric Total wins.
leaguestandings character Leaguestandings.
home character Home.
road character Road.
vsdiv character Vsdiv.
vsconf character Vsconf.
lasttengames character Lasttengames.

Author(s)

Geoff Hutchinson

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

try(espn_wnba_standings(year = 2021))

Get ESPN WNBA Team Detail

Description

Era-correct team identity for a WNBA franchise in a specific season, plus the available ⁠$ref⁠ URLs for deeper resources (record, statistics, leaders, coaches, transactions, etc.). Backed by the core-v2 endpoint sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/seasons/{season}/teams/{team_id}.

Historical depth goes back to 1997 (WNBA founding). Older seasons return fewer ⁠$ref⁠ keys; missing refs become NA.

Usage

espn_wnba_team(team_id, season = most_recent_wnba_season(), ...)

espn_wnba_team_roster(team_id, season = most_recent_wnba_season(), ...)

espn_wnba_team_leaders(team_id, season = most_recent_wnba_season(), ...)

espn_wnba_team_season_profile(team_id, season = most_recent_wnba_season(), ...)

Arguments

team_id

ESPN team identifier (character or numeric).

season

Season year (numeric). Defaults to the most recent WNBA season.

...

Additional arguments; currently unused.

Value

A named list of data frames: Info, Record, NextEvent, StandingSummary, Coaches.

Info

Columns as documented in the shared espn_basketball_team_info_schema table.

Record

col_name types description
type character Record type / category.
summary character Summary.
stats list Stats.

NextEvent

Columns as documented in the shared espn_basketball_player_overview_next_game_schema table.

StandingSummary

col_name types description
standing_summary character Standing summary.

Coaches

col_name types description
id character Unique play identifcation number
first_name character Player's first name.
last_name character Player's last name.
experience integer Years of professional experience.

A single tibble with one row per athlete.

Columns as documented in the shared espn_basketball_team_roster_schema table. ESPN's roster endpoint ignores the season, so a season before the current one is built from that season's published player box scores (name, jersey, position and headshot from the athlete's last game; bio columns NA), and errors when none are published.

A single long-format tibble (one row per category-rank-athlete).

Columns as documented in the shared espn_basketball_team_leaders_schema table.

A single-row tibble with team identity scalars and ⁠_ref⁠ URL columns. Selected columns:

col_name types description
id character ESPN team identifier.
guid character Stable cross-league team GUID.
uid character ESPN UID string.
slug character URL-safe identifier.
location character Team city/region (e.g. "Indiana").
name character Team name (e.g. "Fever").
abbreviation character Short abbreviation (e.g. "IND").
display_name character Full display name.
short_display_name character Short display name.
color character Primary color (hex, no leading '#').
alternate_color character Alternate color (hex, no leading '#').
is_active logical Whether the team was active in this season.
season integer Season year.
logo character Primary logo URL.
logo_dark character Dark-mode logo URL.
record_ref character ⁠$ref⁠ to team record resource.
statistics_ref character ⁠$ref⁠ to team statistics resource.
leaders_ref character ⁠$ref⁠ to team leaders resource.
coaches_ref character ⁠$ref⁠ to team coaches resource.
transactions_ref character ⁠$ref⁠ to team transactions resource.
franchise_ref character ⁠$ref⁠ to franchise resource.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_team(team_id = "17", season = 2025)


  espn_wnba_team_roster(team_id = "17", season = 2025)


  espn_wnba_team_leaders(team_id = "17", season = 2025)


  espn_wnba_team_season_profile(team_id = "17", season = 2025)

Get ESPN WNBA Team Injuries

Description

Get ESPN WNBA Team Injuries

Get ESPN WNBA Team Injuries

Usage

espn_wnba_team_injuries(team_id, ...)

Arguments

team_id

ESPN team identifier (character or numeric; passed as-is). Use espn_wnba_teams() to look up team IDs. Example: "17" (Las Vegas Aces).

...

Currently unused; reserved for future argument threading.

Value

Returns a tibble of injury records for the specified WNBA team. Returns an empty tibble (zero rows) when the team has no reported injuries.

Injuries

Columns as documented in the shared espn_basketball_team_injuries_injuries_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_team_injuries(team_id = "17")

Get ESPN WNBA Team News

Description

Get ESPN WNBA Team News

Get ESPN WNBA Team News

Usage

espn_wnba_team_news(team_id, limit = 25)

Arguments

team_id

character or integer. ESPN team ID (e.g. 17 for Las Vegas Aces).

limit

integer. Maximum number of articles to return. Default 25.

Details

Retrieve ESPN WNBA news for a specific team. Uses getOption("wehoop.proxy") or http_proxy/https_proxy environment variables for proxy configuration (per-call proxy override is not supported for ESPN wrappers).

Value

Returns a tibble of team news articles.

Columns as documented in the shared espn_basketball_news_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_team_news(team_id = "17", limit = 5)

Get ESPN WNBA Team Record (Per Season Type)

Description

Returns the long-format record breakdown for a WNBA team in one season and season-type. Each row is one record category.

Usage

espn_wnba_team_record(
  team_id,
  season = most_recent_wnba_season(),
  season_type = c(2L, 3L),
  ...
)

Arguments

team_id

ESPN team identifier.

season

Season year. Defaults to most recent WNBA season.

season_type

Integer (2 = regular season default).

...

Additional arguments; currently unused.

Value

A tibble with one row per record category.

col_name types description
league character League slug ("wnba").
team_id character ESPN team identifier.
season integer Season year.
season_type integer Season type (1/2/3).
record_id character Record sub-id.
name character Internal record name.
abbreviation character Abbreviation.
display_name character Display name.
short_display_name character Short display.
description character Description.
type character Record type code.
summary character W-L summary.
display_value character Display value.
value numeric Win percentage (0-1).

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_team_record(team_id = 17, season = 2025)

Get ESPN WNBA Team Record Detail (Long Format)

Description

Returns one team's record detail in long format: one row per stat in the record's stats[] array. Use espn_wnba_team_record() to enumerate available record_id values per team-season (overall / home / away / conference + per-opponent breakdowns).

Usage

espn_wnba_team_record_detail(team_id, season, record_id, season_type = 2L, ...)

Arguments

team_id

ESPN team identifier.

season

Season year (numeric).

record_id

Record identifier (from espn_wnba_team_record() index).

season_type

Integer season type: 1 = preseason, 2 = regular (default), 3 = postseason.

...

Additional arguments; currently unused.

Value

A long tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_team_record_detail(team_id = 17, season = 2024, record_id = 0)

Get ESPN WNBA Team Schedule

Description

Get ESPN WNBA Team Schedule

Get ESPN WNBA Team Schedule

Usage

espn_wnba_team_schedule(
  team_id,
  season = most_recent_wnba_season(),
  season_type = 2,
  ...
)

Arguments

team_id

ESPN team identifier (character or numeric).

season

Season year (numeric). Defaults to the most recent WNBA season.

season_type

Integer season type: 1 = preseason, 2 = regular (default), 3 = postseason.

...

Additional arguments; currently unused.

Value

A single tibble with one row per event.

Columns as documented in the shared espn_basketball_team_schedule_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_team_schedule(team_id = "17", season = 2025)

Get ESPN WNBA Team Roster (Per-Season, core-v2)

Description

Returns the per-season team roster as a tibble of athlete IDs from seasons/{y}/teams/{id}/athletes. Distinct from espn_wnba_team_roster() which targets a site-v2 endpoint optimized for the current season; this core-v2 variant is era-correct and available back to ESPN's earliest season for each league.

Usage

espn_wnba_team_season_roster(team_id, season = most_recent_wnba_season(), ...)

Arguments

team_id

ESPN team identifier.

season

Season year. Defaults to most recent WNBA season.

...

Additional arguments; currently unused.

Details

Get ESPN WNBA Team Roster (Per-Season, core-v2)

Value

A tibble with one row per athlete on the season roster.

col_name types description
league character League slug.
team_id character ESPN team id.
season integer Season year.
athlete_id character ESPN athlete id.
ref character ⁠$ref⁠ URL to athlete-in-season detail.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_team_season_roster(team_id = 17, season = 2025)

Get ESPN WNBA Team Season Statistics (Long Format with Rank)

Description

Returns the full team-season-type statistics sheet for one WNBA team in long format: one row per (category x stat). Each row carries the team's league rank for that stat where ESPN provides it (rank + rank_display_value). Complements espn_wnba_team_record() (W-L only) with the full stat package.

Usage

espn_wnba_team_season_statistics(
  team_id,
  season = most_recent_wnba_season(),
  season_type = 2L,
  ...
)

Arguments

team_id

ESPN team identifier.

season

Season year (numeric). Defaults to the most recent WNBA season.

season_type

Integer season type: 1 = preseason, 2 = regular (default), 3 = postseason.

...

Additional arguments; currently unused.

Value

A long tibble with one row per (category x stat).

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_team_season_statistics(team_id = 17, season = 2024)

Get ESPN WNBA team stats data

Description

Get ESPN WNBA team stats data

Usage

espn_wnba_team_stats(team_id, year, season_type = "regular", total = FALSE)

Arguments

team_id

Team ID

year

Year

season_type

(character, default: regular): Season type - regular or postseason

total

(boolean, default: FALSE): Totals

Value

Returns a tibble with the team stats data

col_name types description
team_id integer Unique team identifier.
team_guid character ESPN team GUID.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_sdr integer ESPN team SDR identifier.
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location character Team city or location string.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_display_name character Full team display name.
team_short_display_name character Short team display name (e.g. 'Aces').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
team_is_active logical TRUE if the team is currently active.
team_is_all_star logical TRUE if the row represents an All-Star team.
logo_href character Team or league logo URL.
logo_dark_href character Logo URL for dark backgrounds.
defensive_blocks numeric Short for blocked shot, number of times when a defensive player legally deflects a field goal attempt from an offensive player.
defensive_defensive_rebounds numeric The number of times when the defense obtains the possession of the ball after a missed shot by the offense.
defensive_steals numeric The number of times a defensive player forced a turnover by intercepting or deflecting a pass or a dribble of an offensive player.
defensive_avg_defensive_rebounds numeric The average defensive rebounds per game.
defensive_avg_blocks numeric The average blocks per game.
defensive_avg_steals numeric The average steals per game.
defensive_avg48defensive_rebounds numeric The average number of defensive rebounds per 48 minutes.
defensive_avg48blocks numeric The average number of blocks per 48 minutes.
defensive_avg48steals numeric The average number of steals per 48 minutes.
general_disqualifications numeric The number of times a player reached the foul limit.
general_flagrant_fouls numeric The number of fouls that the officials thought were unnecessary or excessive.
general_fouls numeric The number of times a player had illegal contact with the opponent.
general_ejections numeric The number of times a player or coach is removed from the game as a result of a serious offense.
general_technical_fouls numeric The number of times an player or coach was called for a technical foul (unsportsmanlike conduct or violations).
general_rebounds numeric The total number of rebounds (offensive and defensive).
general_avg_minutes numeric The average number of minutes per game.
general_nba_rating numeric General nba rating.
general_plus_minus numeric A player's estimated on-court impact on team performance measured in point differential per 100 possessions.
general_game_day_of_year numeric The day of the season on which this game falls; if it's the 15th day of the regular season in Nov, the game day of year is 15 (ie, game day of year != day of year).
general_avg_rebounds numeric The average rebounds per game.
general_avg_fouls numeric The average fouls committed per game.
general_avg_flagrant_fouls numeric The average number of flagrant fouls per game.
general_avg_technical_fouls numeric The average number of technical fouls per game.
general_avg_ejections numeric The average ejections per game.
general_avg_disqualifications numeric The average number of disqualifications per game.
general_assist_turnover_ratio numeric The average number of assists a player or team records per turnover.
general_steal_foul_ratio numeric The average number of steals a player or team records per foul committed.
general_block_foul_ratio numeric The average number of blocks a player or record per foul committed.
general_avg_team_rebounds numeric The average number of rebounds for a team per game.
general_total_rebounds numeric The total number of rebounds for a team or player.
general_total_technical_fouls numeric The total number of technical fouls for a team or player.
general_team_assist_turnover_ratio numeric The number of assists per turnover for a team.
general_team_rebounds numeric The total number of rebounds for a team.
general_steal_turnover_ratio numeric The number of steals per turnover.
general_avg48rebounds numeric The average number of rebounds per 48 minutes.
general_avg48fouls numeric The average number of fouls committed per 48 minutes.
general_avg48flagrant_fouls numeric The average number of flagrant fouls committed per 48 minutes.
general_avg48technical_fouls numeric The average number of technical fouls committed per 48 minutes.
general_avg48ejections numeric The average number of ejections per 48 minutes.
general_avg48disqualifications numeric The average number of disqualifications per 48 minutes.
general_games_played numeric Games Played.
general_games_started numeric The number of games started by an athlete.
general_double_double numeric The number of times double digit values were accumulated in 2 of the following categories: points, rebounds, assists, steals, and blocked shots.
general_triple_double numeric The number of times double digit values were accumulated in 3 of the following categories: points, rebounds, assists, steals, and blocked shots.
offensive_assists numeric The number of times a player who passes the ball to a teammate in a way that leads to a score by field goal, meaning that he or she was "assisting" in the basket. There is some judgment involved in deciding whether a passer should be credited with an assist.
offensive_field_goals numeric Field Goal makes and attempts.
offensive_field_goals_attempted numeric The number of times a 2pt field goal was attempted.
offensive_field_goals_made numeric The number of times a 2pt field goal was made.
offensive_field_goal_pct numeric The ratio of field goals made to field goals attempted: FGM / FGA.
offensive_free_throws numeric Free Throw makes and attempts.
offensive_free_throw_pct numeric The ratio of free throws made to free throws attempted: FTM / FTA.
offensive_free_throws_attempted numeric The number of times a free throw was attempted.
offensive_free_throws_made numeric The number of times a free throw was made.
offensive_offensive_rebounds numeric The number of times when the offense obtains the possession of the ball after a missed shot.
offensive_points numeric The number of points scored.
offensive_turnovers numeric The number of times a player loses possession to the other team.
offensive_three_point_pct numeric The ratio of 3pt field goals made to 3pt field goals attempted: 3PM / 3PA.
offensive_three_point_field_goals_attempted numeric The number of times a 3pt field goal was attempted.
offensive_three_point_field_goals_made numeric The number of times a 3pt field goal was made.
offensive_team_turnovers numeric The number of turnovers for the team.
offensive_total_turnovers numeric The number of turnovers plus team turnovers for the team.
offensive_points_in_paint numeric The amount of points scored in the area known as "the Paint"(the rectangle between the foul line and the baseline).
offensive_brick_index numeric How many points a player costs his team with his shooting compared with the league average on a per-40-minute basis. ((52.8 - TS%) x (FGA + (FTA x 0.44))) / (Min/40) .
offensive_avg_field_goals_made numeric The average field goals made per game.
offensive_avg_field_goals_attempted numeric The average field goals attempted per game.
offensive_avg_three_point_field_goals_made numeric The average three point field goals made per game.
offensive_avg_three_point_field_goals_attempted numeric The average three point field goals attempted per game.
offensive_avg_free_throws_made numeric The average free throw shots made per game.
offensive_avg_free_throws_attempted numeric The average free throw shots attempted per game.
offensive_avg_points numeric The average number of points scored per game.
offensive_avg_points_allowed numeric The average number of points allowed per game.
offensive_avg_offensive_rebounds numeric The average offensive rebounds per game.
offensive_avg_assists numeric The average assists per game.
offensive_avg_turnovers numeric The average turnovers committed per game.
offensive_offensive_rebound_pct numeric The percentage of the number of times they obtain the possession of the ball after a missed shot.
offensive_estimated_possessions numeric An estimation of the number of possessions for a team or player.
offensive_avg_estimated_possessions numeric The average number of estimated possessions per game for a team or player.
offensive_points_per_estimated_possessions numeric The number of points per estimated possession for a team or player.
offensive_avg_team_turnovers numeric The average number of turnovers for a team per game.
offensive_avg_total_turnovers numeric The average number of total turnovers for a team per game.
offensive_three_point_field_goal_pct numeric The ratio of 3pt field goals made to 3pt field goals attempted: 3PM / 3PA.
offensive_two_point_field_goals_made numeric The number of 2-point field goals made for a team or player.
offensive_two_point_field_goals_attempted numeric The number of 2-point field goals attempted for a team or player.
offensive_avg_two_point_field_goals_made numeric The number of 2-point field goals made per game for a team or player.
offensive_avg_two_point_field_goals_attempted numeric The number of 2-point field goals attempted per game for a team or player.
offensive_two_point_field_goal_pct numeric The percentage of 2-points fields goals made by a team or player.
offensive_shooting_efficiency numeric The efficiency with which a team or player shoots the basketball.
offensive_scoring_efficiency numeric The efficiency with which a team or player scores the basketball.
offensive_avg48field_goals_made numeric The average number of fieldgoals made per 48 minutes.
offensive_avg48field_goals_attempted numeric The average number of fieldgoals attempted per 48 minutes.
offensive_avg48three_point_field_goals_made numeric The average per number of 3-Pointers made per 48 minutes.
offensive_avg48three_point_field_goals_attempted numeric The average number of 3-pointers attempted per 48 minutes.
offensive_avg48free_throws_made numeric The average number of Free Throws made per 48 minutes.
offensive_avg48free_throws_attempted numeric The average number of free throws attempted per 48 minutes.
offensive_avg48points numeric The average number of points scored per 48 minutes.
offensive_avg48offensive_rebounds numeric The average number of offenseive rebounds per 48 minutes.
offensive_avg48assists numeric The average number of assists per 48 minutes.
offensive_avg48turnovers numeric The average number of turnovers per 48 minutes.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

try(espn_wnba_team_stats(team_id = 17, year = 2020))

Get ESPN's WNBA team names and ids

Description

Get ESPN's WNBA team names and ids

Usage

espn_wnba_teams()

Value

Returns a tibble

col_name types description
team_id integer Unique team identifier.
team character Team-side label or team identifier.
mascot character Team mascot.
display_name character Display name.
short_name character Short display name.
abbreviation character Short abbreviation.
color character Primary color (hex without leading '#').
alternate_color character Alternate color (hex without leading '#').
logo character Team or league logo URL.
logo_dark character Logo dark.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

try(espn_wnba_teams())

Get ESPN WNBA Transactions

Description

Get ESPN WNBA Transactions

Get ESPN WNBA Transactions

Usage

espn_wnba_transactions(season = most_recent_wnba_season(), limit = 100, ...)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent WNBA season.

limit

Maximum number of transactions to return (integer). Default 100.

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(wehoop.proxy = ...).

Details

Calls the ESPN site-v2 endpoint ⁠https://site.api.espn.com/apis/site/v2/sports/basketball/wnba/transactions?season={year}&limit={limit}⁠. Releases have a NULL to_team_id; those are stored as NA. Returns an empty tibble rather than erroring when no transactions are available.

Value

A wehoop_data tibble with one row per transaction:

col_name types description
transaction_id character Unique identifier for transaction.
date character Date in YYYY-MM-DD format.
type character Record type / category.
description character Long-form description text.
team_id character Unique team identifier.
athlete_id character Unique athlete identifier (ESPN).
athlete_name character Athlete display name (ESPN).
from_team_id character Unique identifier for from team.
to_team_id character Unique identifier for to team.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_transactions(season = 2025, limit = 10)

Get ESPN WNBA Venues

Description

Get ESPN WNBA Venues

Get ESPN WNBA Venues

Usage

espn_wnba_venues(...)

Arguments

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(wehoop.proxy = ...) – see ?wehoop for details.

Value

A single wehoop_data tibble with one row per venue.

Columns as documented in the shared espn_basketball_venues_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Examples

espn_wnba_venues()

Get ESPN WNBA Per-Week Ranking Detail

Description

Returns the long-format ranked teams for one (season x season-type x week x ranking-source). WNBA typically returns an empty tibble.

Usage

espn_wnba_week_ranking(
  ranking_id,
  week,
  season = most_recent_wnba_season(),
  season_type = 2L,
  ...
)

Arguments

ranking_id

Ranking source id (1 = AP, 2 = Coaches, etc.).

week

Week number.

season

Season year. Defaults to most recent WNBA season.

season_type

Season-type id (2 = regular (default)).

...

Additional arguments; currently unused.

Details

Get ESPN WNBA Per-Week Ranking Detail

Value

A tibble with one row per ranked team (typically 25).

Columns as documented in the shared espn_basketball_week_ranking_schema table.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_rankings()

Examples

espn_wnba_week_ranking(ranking_id = 1, week = 5, season = 2025)

Get ESPN WNBA Per-Week Rankings Index

Description

Returns the index of ranking sources available for one (WNBA season x season-type x week). WNBA does not publish weekly rankings, so this typically returns an empty tibble; the wrapper is provided for symmetry with college (MBB / WBB).

Usage

espn_wnba_week_rankings(
  week,
  season = most_recent_wnba_season(),
  season_type = 2L,
  ...
)

Arguments

week

Week number.

season

Season year. Defaults to most recent WNBA season.

season_type

Season-type id (2 = regular (default)).

...

Additional arguments; currently unused.

Details

Get ESPN WNBA Per-Week Rankings Index

Value

A tibble with one row per ranking source.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
week integer Week number.
ranking_id character ESPN ranking id.
ref character ⁠$ref⁠ URL for the ranked-teams detail.

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athlete_detail(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_freeagents(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_odds(), espn_wnba_game_official_detail(), espn_wnba_game_play(), espn_wnba_game_play_personnel(), espn_wnba_game_player_box(), espn_wnba_game_probabilities(), espn_wnba_game_propbets(), espn_wnba_game_team_linescores(), espn_wnba_game_team_roster_entry(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_player_awards(), espn_wnba_player_career_stats(), espn_wnba_player_eventlog_v2(), espn_wnba_player_info(), espn_wnba_player_overview(), espn_wnba_player_seasons(), espn_wnba_player_stats(), espn_wnba_position(), espn_wnba_positions(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_injuries(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_record_detail(), espn_wnba_team_schedule(), espn_wnba_team_season_roster(), espn_wnba_team_season_statistics(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking()

Examples

espn_wnba_week_rankings(week = 5, season = 2025)

FEB Game Info

Description

Game header of one FEB game: competition, tip-off, venue, officials, status, both teams and the score.

Endpoint: ⁠GET https://intrafeb.feb.es/LiveStats.API/api/v1/TeamStats/{game_id}⁠ (every game route carries the header; this reads the lightest one).

Usage

feb_game_info(game_id)

Arguments

game_id

(integer required): FEB game id, e.g. 2535725; the game_id column of feb_schedule(), feb_results() and feb_overview().

Details

The Spanish Basketball Federation (FEB) wrappers cover Primera FEB, Segunda FEB and Liga Femenina Endesa (plus the federation's other groups on the same routes). They mirror sdv-py's sportsdataverse.basketball.feb wrappers of the same names: same arguments, the same snake_case columns and types, one row per sdv-py row.

Legal notice. The FEB's aviso legal (legal notice) asserts intellectual-property rights over the site's content and its databases (the EU database right). It has no explicit scraping clause, and robots.txt answers 404 on both hosts. Fetching for your own use on your own machine is how these wrappers are meant to be used; check the notice before you republish the data.

Unofficial and unsupported. The LiveStats API (intrafeb.feb.es) is the federation's own widget backend, not a documented public API. It needs a bearer token, which is public: it is read from the home page of baloncestoenvivo.feb.es at run time, kept in memory for the R session (24 h validity, renewed once on an HTTP 401) and never printed, logged or written. Requests are spaced at least one second apart per host; 429 and 5xx answers are retried (three attempts).

Coverage. The game routes answer from 2020-21 (Liga Femenina Endesa from its first game; Primera FEB from 2021-03-12, so its earlier 2020-21 games and every earlier season answer 404). 2020-21 play-by-play is text only. The schedule pages go back to 1996-97 (season = 1997).

Seasons are END years (season = 2027 is 2026-27); the site's own t key is the START year, so the request sends t = season - 1.

Errors are classed conditions, never a warning plus an empty frame: wehoop_no_data (HTTP 404, an unknown group, a schedule page with no games, an empty overview window), wehoop_bad_request (HTTP 400 / 422, or a game_id, group or season that is not a non-negative integer) and wehoop_asset_fetch (any other failure: another status, a transport error, a token the API still rejects after one renewal, a non-JSON or non-HTML body, an error or changed envelope, a play-by-play of another game, a page for another group or season, or layout drift). All inherit wehoop_error.

Value

A wehoop_data tibble with these columns:

col_name type description
game_id integer FEB game id (one global sequence): the {gameId} of every LiveStats route and the p= of Partido.aspx. Game bodies do not print it, so it comes from the request.
comp_id integer Competition id (constant across seasons): 115 Primera FEB (LEB Oro), 118 Segunda FEB, 210 Liga Femenina Endesa, 214 LF Challenge, 218 LF-2, 111 Tercera FEB. Not the site's menu group.
competition character Competition name as printed that season, uppercase ('PRIMERA FEB'; 2020-21 'LIGA LEB ORO').
group_label character The game's group (grupo) label, trimmed: 'Unico' = the single group, '"A"' = group A. It is the page's group label, not the site's menu group number.
period integer Current or last period number; 4 for a finished regulation game.
clock character 'FINAL' once the game is over, else the game clock 'mm:ss' remaining in the period.
start_time POSIXct Tip-off in Spanish local time (POSIXct, tz Europe/Madrid): the source carries no offset, so the zone is assumed.
venue character Venue (pabellon) name.
address character Venue street address, free text.
referee1 character Crew chief (arbitro principal), 'SURNAMES, NAME'.
referee2 character First umpire (arbitro auxiliar 1), 'SURNAMES, NAME'.
referee3 character Second umpire (arbitro auxiliar 2), 'SURNAMES, NAME'; null when the game had two referees.
status integer Game state code: 3 = finished (status_text FINISHED). Null on 2020-21 games.
status_text character Game state label in English ('FINISHED'). Null on 2020-21 games.
home_team_id integer Home team-season id (key space: FEB team registrations, new every season).
home_team character Home team name for the season (sponsor name, uppercase).
home_team_code character Home federation team code, 8 digits as a string. Null on 2020-21 games.
home_club_code character Home federation club code, 6 digits as a string. Null on 2020-21 games.
home_score integer Home points: the final score when clock is FINAL, else the live score.
away_team_id integer Away team-season id (key space: FEB team registrations, new every season).
away_team character Away team name for the season (sponsor name, uppercase).
away_team_code character Away federation team code, 8 digits as a string. Null on 2020-21 games.
away_club_code character Away federation club code, 6 digits as a string. Null on 2020-21 games.
away_score integer Away points: the final score when clock is FINAL, else the live score.

See Also

Other FEB Functions: feb_leaders(), feb_overview(), feb_pbp(), feb_period_scores(), feb_player_box(), feb_results(), feb_schedule(), feb_shots(), feb_standings(), feb_team_stats()

Examples

try(feb_game_info(game_id = 2535725))

FEB Game Leaders

Description

Each team's top players of one FEB game by points, rebounds, assists and fouls.

Endpoint: ⁠GET https://intrafeb.feb.es/LiveStats.API/api/v1/Ranking/{game_id}⁠

One row per team, category and ranked player (rank 1 = the leader, in the order the feed lists them).

Usage

feb_leaders(game_id)

Arguments

game_id

(integer required): FEB game id, e.g. 2535725; the game_id column of feb_schedule(), feb_results() and feb_overview().

Details

The Spanish Basketball Federation (FEB) wrappers cover Primera FEB, Segunda FEB and Liga Femenina Endesa (plus the federation's other groups on the same routes). They mirror sdv-py's sportsdataverse.basketball.feb wrappers of the same names: same arguments, the same snake_case columns and types, one row per sdv-py row.

Legal notice. The FEB's aviso legal (legal notice) asserts intellectual-property rights over the site's content and its databases (the EU database right). It has no explicit scraping clause, and robots.txt answers 404 on both hosts. Fetching for your own use on your own machine is how these wrappers are meant to be used; check the notice before you republish the data.

Unofficial and unsupported. The LiveStats API (intrafeb.feb.es) is the federation's own widget backend, not a documented public API. It needs a bearer token, which is public: it is read from the home page of baloncestoenvivo.feb.es at run time, kept in memory for the R session (24 h validity, renewed once on an HTTP 401) and never printed, logged or written. Requests are spaced at least one second apart per host; 429 and 5xx answers are retried (three attempts).

Coverage. The game routes answer from 2020-21 (Liga Femenina Endesa from its first game; Primera FEB from 2021-03-12, so its earlier 2020-21 games and every earlier season answer 404). 2020-21 play-by-play is text only. The schedule pages go back to 1996-97 (season = 1997).

Seasons are END years (season = 2027 is 2026-27); the site's own t key is the START year, so the request sends t = season - 1.

Errors are classed conditions, never a warning plus an empty frame: wehoop_no_data (HTTP 404, an unknown group, a schedule page with no games, an empty overview window), wehoop_bad_request (HTTP 400 / 422, or a game_id, group or season that is not a non-negative integer) and wehoop_asset_fetch (any other failure: another status, a transport error, a token the API still rejects after one renewal, a non-JSON or non-HTML body, an error or changed envelope, a play-by-play of another game, a page for another group or season, or layout drift). All inherit wehoop_error.

 feb_leaders(game_id = 2535725)

Value

A wehoop_data tibble with these columns:

col_name type description
game_id integer FEB game id (one global sequence): the {gameId} of every LiveStats route and the p= of Partido.aspx. Game bodies do not print it, so it comes from the request.
team_side character Side of the game the row belongs to: home or away (the feed's TEAM[0] / TEAM[1], or its 1/2 and 0/1 side codes, normalised).
team_id integer Team-season id (key space: FEB team registrations; a NEW id every season, e.g. HLA Alicante = 979989 in 2025-26 and 1008687 in 2026-27). Joins the schedule's home_team_id / away_team_id; not a club or player id.
team character Team name as registered for the season (sponsor name, uppercase: 'HLA ALICANTE').
category character Leader category: points, rebounds, assists or fouls (the feed's Puntos, Rebotes, Asistencias, Faltas).
rank integer Place in the team's category list, 1 = the leader, in the order the feed lists them.
player_id integer FEB person id: stable across seasons and clubs (A. Jorda Rodriguez = 1676991 in 2025-26 and 2026-27). Joins the box score, play-by-play, shots and leaders; not the per-season licence_id.
shirt_number character Shirt number (dorsal) as a string, so '00' and '0' stay distinct. The shot feed names the shooter by this number.
player character Player name as 'I. SURNAME(S)', uppercase ('V. AGUILAR HERNANDEZ').
starter logical True when the player was in the starting five (the page's I column), false when on the bench.
captain logical True for the team captain. Null on 2020-21 games, where the feed does not send it.
value integer The player's count in the row's category (points, rebounds, assists or personal fouls).

See Also

Other FEB Functions: feb_game_info(), feb_overview(), feb_pbp(), feb_period_scores(), feb_player_box(), feb_results(), feb_schedule(), feb_shots(), feb_standings(), feb_team_stats()


FEB Overview

Description

Today's (or the latest) games of every live FEB competition, with scores and status.

Endpoint: ⁠GET https://intrafeb.feb.es/LiveStats.API/api/v1/overview⁠

One row per game across the competitions with games in the window. An off day with no competitions raises wehoop_no_data; a game listed under another competition is refused (wehoop_asset_fetch).

Usage

feb_overview()

Details

The Spanish Basketball Federation (FEB) wrappers cover Primera FEB, Segunda FEB and Liga Femenina Endesa (plus the federation's other groups on the same routes). They mirror sdv-py's sportsdataverse.basketball.feb wrappers of the same names: same arguments, the same snake_case columns and types, one row per sdv-py row.

Legal notice. The FEB's aviso legal (legal notice) asserts intellectual-property rights over the site's content and its databases (the EU database right). It has no explicit scraping clause, and robots.txt answers 404 on both hosts. Fetching for your own use on your own machine is how these wrappers are meant to be used; check the notice before you republish the data.

Unofficial and unsupported. The LiveStats API (intrafeb.feb.es) is the federation's own widget backend, not a documented public API. It needs a bearer token, which is public: it is read from the home page of baloncestoenvivo.feb.es at run time, kept in memory for the R session (24 h validity, renewed once on an HTTP 401) and never printed, logged or written. Requests are spaced at least one second apart per host; 429 and 5xx answers are retried (three attempts).

Coverage. The game routes answer from 2020-21 (Liga Femenina Endesa from its first game; Primera FEB from 2021-03-12, so its earlier 2020-21 games and every earlier season answer 404). 2020-21 play-by-play is text only. The schedule pages go back to 1996-97 (season = 1997).

Seasons are END years (season = 2027 is 2026-27); the site's own t key is the START year, so the request sends t = season - 1.

Errors are classed conditions, never a warning plus an empty frame: wehoop_no_data (HTTP 404, an unknown group, a schedule page with no games, an empty overview window), wehoop_bad_request (HTTP 400 / 422, or a game_id, group or season that is not a non-negative integer) and wehoop_asset_fetch (any other failure: another status, a transport error, a token the API still rejects after one renewal, a non-JSON or non-HTML body, an error or changed envelope, a play-by-play of another game, a page for another group or season, or layout drift). All inherit wehoop_error.

 feb_overview()

Value

A wehoop_data tibble with these columns:

col_name type description
comp_id integer Competition id (constant across seasons): 115 Primera FEB (LEB Oro), 118 Segunda FEB, 210 Liga Femenina Endesa, 214 LF Challenge, 218 LF-2, 111 Tercera FEB. Not the site's menu group.
comp_code integer Season-specific competition edition code (e.g. 23473 = Primera FEB 2026-27).
competition character Competition name as printed that season, uppercase ('PRIMERA FEB'; 2020-21 'LIGA LEB ORO').
game_id integer FEB game id (one global sequence): the {gameId} of every LiveStats route.
round_id integer Round id; 0 in every sample (the route does not fill it).
stage character Stage code as a string; '0' in every sample (meaning unverified).
venue character Name of the venue (pabellon) where the game is played.
start_time POSIXct Tip-off in Spanish local time (POSIXct, tz Europe/Madrid; the source has no offset).
start_time_utc POSIXct Tip-off in UTC (POSIXct, tz UTC).
period integer Current or last period (4 when finished).
clock character 'FINAL' once finished, else the game clock ('00:00' before tip-off).
status integer Game state code: 3 = finished, 1 = scheduled (seen 2026-10-12); the live codes are unverified.
home_team_id integer Home team-season id (new every season; joins the schedule pages).
home_team character Home team name for the season.
home_team_code character Home federation team code, 8 digits as a string.
home_club_code character Home federation club code, 6 digits as a string.
home_abbreviation character Home team three-letter abbreviation ('PAL').
home_score integer Home points (0 before tip-off).
away_team_id integer Away team-season id (new every season; joins the schedule pages).
away_team character Away team name for the season.
away_team_code character Away federation team code, 8 digits as a string.
away_club_code character Away federation club code, 6 digits as a string.
away_abbreviation character Away team three-letter abbreviation.
away_score integer Away points (0 before tip-off).
period_scores character Points per period as 'home-away' pairs joined by ';' ('16-16;19-16;10-21;14-14'); null before tip-off.

See Also

Other FEB Functions: feb_game_info(), feb_leaders(), feb_pbp(), feb_period_scores(), feb_player_box(), feb_results(), feb_schedule(), feb_shots(), feb_standings(), feb_team_stats()


FEB Play-by-Play

Description

Play-by-play of one FEB game (KeyFacts): every shot, rebound, foul, substitution and timeout, in Spanish text with coded actions, oldest play first.

Endpoint: ⁠GET https://intrafeb.feb.es/LiveStats.API/api/v1/KeyFacts/{game_id}⁠

A body whose plays name another game is refused (wehoop_asset_fetch), not returned. 2020-21 games are text only: action, the ids, the parameters, the position and the log times are NA there.

Usage

feb_pbp(game_id)

Arguments

game_id

(integer required): FEB game id, e.g. 2535725; the game_id column of feb_schedule(), feb_results() and feb_overview().

Details

The Spanish Basketball Federation (FEB) wrappers cover Primera FEB, Segunda FEB and Liga Femenina Endesa (plus the federation's other groups on the same routes). They mirror sdv-py's sportsdataverse.basketball.feb wrappers of the same names: same arguments, the same snake_case columns and types, one row per sdv-py row.

Legal notice. The FEB's aviso legal (legal notice) asserts intellectual-property rights over the site's content and its databases (the EU database right). It has no explicit scraping clause, and robots.txt answers 404 on both hosts. Fetching for your own use on your own machine is how these wrappers are meant to be used; check the notice before you republish the data.

Unofficial and unsupported. The LiveStats API (intrafeb.feb.es) is the federation's own widget backend, not a documented public API. It needs a bearer token, which is public: it is read from the home page of baloncestoenvivo.feb.es at run time, kept in memory for the R session (24 h validity, renewed once on an HTTP 401) and never printed, logged or written. Requests are spaced at least one second apart per host; 429 and 5xx answers are retried (three attempts).

Coverage. The game routes answer from 2020-21 (Liga Femenina Endesa from its first game; Primera FEB from 2021-03-12, so its earlier 2020-21 games and every earlier season answer 404). 2020-21 play-by-play is text only. The schedule pages go back to 1996-97 (season = 1997).

Seasons are END years (season = 2027 is 2026-27); the site's own t key is the START year, so the request sends t = season - 1.

Errors are classed conditions, never a warning plus an empty frame: wehoop_no_data (HTTP 404, an unknown group, a schedule page with no games, an empty overview window), wehoop_bad_request (HTTP 400 / 422, or a game_id, group or season that is not a non-negative integer) and wehoop_asset_fetch (any other failure: another status, a transport error, a token the API still rejects after one renewal, a non-JSON or non-HTML body, an error or changed envelope, a play-by-play of another game, a page for another group or season, or layout drift). All inherit wehoop_error.

Value

A wehoop_data tibble with these columns:

col_name type description
game_id integer FEB game id (one global sequence): the {gameId} of every LiveStats route and the p= of Partido.aspx. Game bodies do not print it, so it comes from the request.
play_num integer Play sequence number, 1 = the first play of the game; unique per game. The parser sorts by it (the feed lists newest first).
period integer Period number of the play.
clock character Game clock REMAINING in the period as 'mm:ss' (it counts down from 10:00).
clock_seconds integer The clock as whole seconds remaining in the period (08:34 = 514), derived by the parser.
team_side character Side of the acting team: home (feed code 1) or away (2); null on period lines.
team_id integer Team-season id of the acting team (new every season); null on period lines and 2020-21 games.
player_id integer FEB person id of the actor (stable across seasons); null on team, period and 2020-21 lines.
license_id integer Per-season player licence id of the actor (changes when the player re-registers; A. Jorda Rodriguez = 10901171 in 2025-26, 11266668 in 2026-27). Null on team and period lines and 2020-21 games.
action character Action code: shoot, fthrow, rebound, assist, recovery (steal), lose (turnover), blockshot, foul, subst, timeout, period. Null on 2020-21 games.
text character Play description in Spanish: '(TEAM) I. SURNAME: ACTION (running count)'; 2020-21 games use older wording and are text only.
score_home integer Home score AFTER the play; filled on scoring plays only.
score_away integer Away score AFTER the play; filled on scoring plays only.
x double Court x position of a shoot line: percent (0-100) of the length of a horizontal full-court image, origin top-left (the same scale as feb_shots). Null when the action has none and on 2020-21 games.
y double Court y position of a shoot line: percent (0-100) of the width from the top edge (the same scale as feb_shots). Null when the action has none and on 2020-21 games.
log_param1 character Action parameter 1 (string). Team and player actions: a pseudo-GUID '00000000-0000-000{side}-0000-{game id, 12 digits}' (side 1 home, 2 away); period lines: the period number.
log_param2 character Action parameter 2 (string). The actor's licence id on shoot, fthrow, foul, rebound, assist, recovery and blockshot lines; period lines: '0' start, '1' end; lose: '0' or '1' (meaning unverified).
log_param3 character Action parameter 3 (string). fthrow: '1' made, '0' missed; subst: the outgoing player's licence; foul: a foul-type code. Others unverified.
log_param4 character Action parameter 4 (string). shoot and fthrow: '1' made, '0' missed; foul: the licence of the fouled player; lose: a licence (role unverified).
log_param5 character Action parameter 5 (string); action-dependent, meaning unverified.
log_param6 character Action parameter 6 (string). shoot: shot value '2' or '3'; fthrow: '1'; foul: free throws awarded.
log_param7 character Action parameter 7 (string); action-dependent, meaning unverified.
log_param8 character Action parameter 8 (string): a small integer on shoot, foul and lose lines (by distribution a zone or sub-type code); unverified.
log_param9 character Action parameter 9 (string); blank or null in every sampled game.
log_param10 character Action parameter 10 (string): '1' on almost every foul; meaning unverified.
log_time POSIXct Wall-clock time the play was logged, Spanish local time (POSIXct, tz Europe/Madrid). NA on 2020-21 games.
log_time_utc POSIXct The log time in UTC (POSIXct, tz UTC). NA on 2020-21 games.

See Also

Other FEB Functions: feb_game_info(), feb_leaders(), feb_overview(), feb_period_scores(), feb_player_box(), feb_results(), feb_schedule(), feb_shots(), feb_standings(), feb_team_stats()

Examples

try(feb_pbp(game_id = 2535725))

FEB Period Scores

Description

Points each team scored in each period of one FEB game.

Endpoint: ⁠GET https://intrafeb.feb.es/LiveStats.API/api/v1/TeamStats/{game_id}⁠

One row per period played; the points are scored IN the period, not cumulative. Overtime numbering is unverified.

Usage

feb_period_scores(game_id)

Arguments

game_id

(integer required): FEB game id, e.g. 2535725; the game_id column of feb_schedule(), feb_results() and feb_overview().

Details

The Spanish Basketball Federation (FEB) wrappers cover Primera FEB, Segunda FEB and Liga Femenina Endesa (plus the federation's other groups on the same routes). They mirror sdv-py's sportsdataverse.basketball.feb wrappers of the same names: same arguments, the same snake_case columns and types, one row per sdv-py row.

Legal notice. The FEB's aviso legal (legal notice) asserts intellectual-property rights over the site's content and its databases (the EU database right). It has no explicit scraping clause, and robots.txt answers 404 on both hosts. Fetching for your own use on your own machine is how these wrappers are meant to be used; check the notice before you republish the data.

Unofficial and unsupported. The LiveStats API (intrafeb.feb.es) is the federation's own widget backend, not a documented public API. It needs a bearer token, which is public: it is read from the home page of baloncestoenvivo.feb.es at run time, kept in memory for the R session (24 h validity, renewed once on an HTTP 401) and never printed, logged or written. Requests are spaced at least one second apart per host; 429 and 5xx answers are retried (three attempts).

Coverage. The game routes answer from 2020-21 (Liga Femenina Endesa from its first game; Primera FEB from 2021-03-12, so its earlier 2020-21 games and every earlier season answer 404). 2020-21 play-by-play is text only. The schedule pages go back to 1996-97 (season = 1997).

Seasons are END years (season = 2027 is 2026-27); the site's own t key is the START year, so the request sends t = season - 1.

Errors are classed conditions, never a warning plus an empty frame: wehoop_no_data (HTTP 404, an unknown group, a schedule page with no games, an empty overview window), wehoop_bad_request (HTTP 400 / 422, or a game_id, group or season that is not a non-negative integer) and wehoop_asset_fetch (any other failure: another status, a transport error, a token the API still rejects after one renewal, a non-JSON or non-HTML body, an error or changed envelope, a play-by-play of another game, a page for another group or season, or layout drift). All inherit wehoop_error.

 feb_period_scores(game_id = 2535725)

Value

A wehoop_data tibble with these columns:

col_name type description
game_id integer FEB game id (one global sequence): the {gameId} of every LiveStats route and the p= of Partido.aspx. Game bodies do not print it, so it comes from the request.
period integer Period number (1-4 regulation; overtime numbering is unverified, no overtime game is in the samples).
home_points integer Points the home team scored IN this period (not cumulative).
away_points integer Points the away team scored IN this period (not cumulative).

See Also

Other FEB Functions: feb_game_info(), feb_leaders(), feb_overview(), feb_pbp(), feb_player_box(), feb_results(), feb_schedule(), feb_shots(), feb_standings(), feb_team_stats()


FEB Player Box Score

Description

Per-player box score of one FEB game: minutes, points, shooting splits, rebounds, assists, fouls and plus/minus.

Endpoint: ⁠GET https://intrafeb.feb.es/LiveStats.API/api/v1/BoxScore/{game_id}⁠

One row per player and team. p1 / p2 / p3 are free throws, two- and three-point field goals (m made, a attempted, p percentage 0-100); seconds_played is the provider's min (seconds, not minutes); player_id is the FEB person id (stable across seasons) and shirt_number stays a string ("00" is not "0").

Usage

feb_player_box(game_id)

Arguments

game_id

(integer required): FEB game id, e.g. 2535725; the game_id column of feb_schedule(), feb_results() and feb_overview().

Details

The Spanish Basketball Federation (FEB) wrappers cover Primera FEB, Segunda FEB and Liga Femenina Endesa (plus the federation's other groups on the same routes). They mirror sdv-py's sportsdataverse.basketball.feb wrappers of the same names: same arguments, the same snake_case columns and types, one row per sdv-py row.

Legal notice. The FEB's aviso legal (legal notice) asserts intellectual-property rights over the site's content and its databases (the EU database right). It has no explicit scraping clause, and robots.txt answers 404 on both hosts. Fetching for your own use on your own machine is how these wrappers are meant to be used; check the notice before you republish the data.

Unofficial and unsupported. The LiveStats API (intrafeb.feb.es) is the federation's own widget backend, not a documented public API. It needs a bearer token, which is public: it is read from the home page of baloncestoenvivo.feb.es at run time, kept in memory for the R session (24 h validity, renewed once on an HTTP 401) and never printed, logged or written. Requests are spaced at least one second apart per host; 429 and 5xx answers are retried (three attempts).

Coverage. The game routes answer from 2020-21 (Liga Femenina Endesa from its first game; Primera FEB from 2021-03-12, so its earlier 2020-21 games and every earlier season answer 404). 2020-21 play-by-play is text only. The schedule pages go back to 1996-97 (season = 1997).

Seasons are END years (season = 2027 is 2026-27); the site's own t key is the START year, so the request sends t = season - 1.

Errors are classed conditions, never a warning plus an empty frame: wehoop_no_data (HTTP 404, an unknown group, a schedule page with no games, an empty overview window), wehoop_bad_request (HTTP 400 / 422, or a game_id, group or season that is not a non-negative integer) and wehoop_asset_fetch (any other failure: another status, a transport error, a token the API still rejects after one renewal, a non-JSON or non-HTML body, an error or changed envelope, a play-by-play of another game, a page for another group or season, or layout drift). All inherit wehoop_error.

Value

A wehoop_data tibble with these columns:

col_name type description
game_id integer FEB game id (one global sequence): the {gameId} of every LiveStats route and the p= of Partido.aspx. Game bodies do not print it, so it comes from the request.
team_side character Side of the game the row belongs to: home or away (the feed's TEAM[0] / TEAM[1], or its 1/2 and 0/1 side codes, normalised).
team_id integer Team-season id (key space: FEB team registrations; a NEW id every season, e.g. HLA Alicante = 979989 in 2025-26 and 1008687 in 2026-27). Joins the schedule's home_team_id / away_team_id; not a club or player id.
team character Team name as registered for the season (sponsor name, uppercase: 'HLA ALICANTE').
player_id integer FEB person id: stable across seasons and clubs (A. Jorda Rodriguez = 1676991 in 2025-26 and 2026-27). Joins the box score, play-by-play, shots and leaders; not the per-season licence_id.
shirt_number character Shirt number (dorsal) as a string, so '00' and '0' stay distinct. The shot feed names the shooter by this number.
player character Player name as 'I. SURNAME(S)', uppercase ('V. AGUILAR HERNANDEZ').
starter logical True when the player was in the starting five (the page's I column), false when on the bench.
captain logical True for the team captain. Null on 2020-21 games, where the feed does not send it.
seconds_played integer Seconds on court (the feed's min, an integer count of seconds: 1064 = 17:44; a team row sums its players, 12000 = 200:00). Null on /TeamStats rows.
min_formatted character Time played as 'mm:ss'.
pts integer Points scored (the team's points on team rows; the final score when the clock is FINAL, else live).
p1m integer Free throws made (tiros libres; integer as a string).
p1a integer Free throws attempted (integer as a string).
p1p double Free-throw percentage, 0-100, as a string with a DECIMAL COMMA ('77,3'); '0,0' when no attempts.
p2m integer Two-point field goals made (integer as a string).
p2a integer Two-point field goals attempted (integer as a string).
p2p double Two-point percentage, 0-100, string with a decimal comma ('54,1').
p3m integer Three-point field goals made (integer as a string).
p3a integer Three-point field goals attempted (integer as a string).
p3p double Three-point percentage, 0-100, string with a decimal comma ('47,6').
fgm integer Field goals made, 2PT + 3PT (tiros de campo; integer as a string).
fga integer Field goals attempted, 2PT + 3PT (integer as a string).
fgp double Field-goal percentage, 0-100, string with a decimal comma ('51,7').
ro integer Offensive rebounds (rebotes ofensivos; integer as a string).
rd integer Defensive rebounds (rebotes defensivos; integer as a string).
rt integer Total rebounds (rebotes totales; integer as a string).
reb integer Total rebounds (the same count as rt).
assist integer Assists (asistencias; integer as a string).
st integer Steals (balones robados, page column BR; integer as a string).
to integer Turnovers (balones perdidos, page column BP; integer as a string).
bs integer Blocks made (tapones a favor, page column TF; integer as a string).
tc integer Shots of this player/team that were blocked (tapones en contra / recibidos, page column TC; integer as a string).
mt integer Dunks (mates, page column MT; integer as a string).
pf integer Personal fouls committed (faltas cometidas, page column FC; integer as a string).
rf integer Fouls received / drawn (faltas recibidas, page column FR; integer as a string).
pllss integer Plus/minus while the player was on court (balance, page column +/-), signed integer.
val integer FEB efficiency rating (valoracion): points + rebounds + assists + steals + blocks + fouls drawn - missed shots - turnovers - shots blocked - fouls committed.

See Also

Other FEB Functions: feb_game_info(), feb_leaders(), feb_overview(), feb_pbp(), feb_period_scores(), feb_results(), feb_schedule(), feb_shots(), feb_standings(), feb_team_stats()

Examples

try(feb_player_box(game_id = 2535725))

FEB Results

Description

Latest round's results and the next round's fixtures of a FEB competition season.

Endpoint: ⁠GET https://baloncestoenvivo.feb.es/resultados.aspx?g={group}&t={season - 1}⁠

section is results (the LATEST round of the shown phase; for a finished season the last playoff round) or next_round (empty once the season is over). comp_id ties the site group to the API's competition id (group 1 -> 115, 2 -> 118, 4 -> 210).

Usage

feb_results(group = 4, season)

Arguments

group

(integer default 4, Liga Femenina Endesa): The site's menu group: 1 Primera FEB, 2 Segunda FEB, 4 Liga Femenina Endesa, 9 and 10 LF-2, 67 LF Challenge, 73 Copa de Espana, 74 Liga U. A group is not a competition id (see comp_id).

season

(integer required): Season END year (2027 = 2026-27), sent to the site as its START-year key t = season - 1.

Details

The Spanish Basketball Federation (FEB) wrappers cover Primera FEB, Segunda FEB and Liga Femenina Endesa (plus the federation's other groups on the same routes). They mirror sdv-py's sportsdataverse.basketball.feb wrappers of the same names: same arguments, the same snake_case columns and types, one row per sdv-py row.

Legal notice. The FEB's aviso legal (legal notice) asserts intellectual-property rights over the site's content and its databases (the EU database right). It has no explicit scraping clause, and robots.txt answers 404 on both hosts. Fetching for your own use on your own machine is how these wrappers are meant to be used; check the notice before you republish the data.

Unofficial and unsupported. The LiveStats API (intrafeb.feb.es) is the federation's own widget backend, not a documented public API. It needs a bearer token, which is public: it is read from the home page of baloncestoenvivo.feb.es at run time, kept in memory for the R session (24 h validity, renewed once on an HTTP 401) and never printed, logged or written. Requests are spaced at least one second apart per host; 429 and 5xx answers are retried (three attempts).

Coverage. The game routes answer from 2020-21 (Liga Femenina Endesa from its first game; Primera FEB from 2021-03-12, so its earlier 2020-21 games and every earlier season answer 404). 2020-21 play-by-play is text only. The schedule pages go back to 1996-97 (season = 1997).

Seasons are END years (season = 2027 is 2026-27); the site's own t key is the START year, so the request sends t = season - 1.

Errors are classed conditions, never a warning plus an empty frame: wehoop_no_data (HTTP 404, an unknown group, a schedule page with no games, an empty overview window), wehoop_bad_request (HTTP 400 / 422, or a game_id, group or season that is not a non-negative integer) and wehoop_asset_fetch (any other failure: another status, a transport error, a token the API still rejects after one renewal, a non-JSON or non-HTML body, an error or changed envelope, a play-by-play of another game, a page for another group or season, or layout drift). All inherit wehoop_error.

Value

A wehoop_data tibble with these columns:

col_name type description
group integer The site's menu group (1 Primera FEB, 2 Segunda FEB, 4 Liga Femenina Endesa); not a competition id.
season integer Season END year (2027 = 2026-27), the site's START-year key plus one.
competition character Competition name on the page header ('PRIMERA FEB').
comp_id integer Competition id (CompID) read from the page; ties the site group to the API (group 1 -> 115, 2 -> 118, 4 -> 210).
section character Which table the row comes from: results (the latest round) or next_round (the following fixtures).
round_title character Title of the table as printed ('Resultados Jornada 3(09/10/2026)').
game_id integer FEB game id (one global sequence): the {gameId} of every LiveStats route and the p= of Partido.aspx. Game bodies do not print it, so it comes from the request.
home_team_id integer Home team-season id (new every season; joins feb_overview and the game wrappers).
home_team character Home team name, uppercase.
away_team_id integer Away team-season id (new every season).
away_team character Away team name, uppercase.
result_text character Result cell verbatim: 'home-away' points when played; before the game the calendar shows the Spanish weekday, date and time and the results page shows '-'.
home_score integer Home points; null before the game.
away_score integer Away points; null before the game.
status character played when the result cell holds a score, scheduled otherwise.
date Date Game date; null for played games on the schedule page (use round_date).
time character Tip-off 'HH:MM', Spanish local time; null for played games on the schedule page.

See Also

Other FEB Functions: feb_game_info(), feb_leaders(), feb_overview(), feb_pbp(), feb_period_scores(), feb_player_box(), feb_schedule(), feb_shots(), feb_standings(), feb_team_stats()

Examples

try(feb_results(group = 1, season = 2027))

FEB Schedule

Description

Full schedule of one group (phase) of a FEB competition season: every round, game, result and team-season id.

Endpoint: ⁠GET https://baloncestoenvivo.feb.es/calendario.aspx?g={group}&t={season - 1}⁠

Played games carry no date or time on this page: use round_date or feb_game_info()'s start_time. The page renders only the FIRST phase of the group (Segunda FEB shows group A); other phases and the playoffs need an ASP.NET postback and are not modelled. A page for another group or season is refused (wehoop_asset_fetch), an unknown group is wehoop_no_data.

Usage

feb_schedule(group = 4, season)

Arguments

group

(integer default 4, Liga Femenina Endesa): The site's menu group: 1 Primera FEB, 2 Segunda FEB, 4 Liga Femenina Endesa, 9 and 10 LF-2, 67 LF Challenge, 73 Copa de Espana, 74 Liga U. A group is not a competition id (see comp_id).

season

(integer required): Season END year (2027 = 2026-27), sent to the site as its START-year key t = season - 1.

Details

The Spanish Basketball Federation (FEB) wrappers cover Primera FEB, Segunda FEB and Liga Femenina Endesa (plus the federation's other groups on the same routes). They mirror sdv-py's sportsdataverse.basketball.feb wrappers of the same names: same arguments, the same snake_case columns and types, one row per sdv-py row.

Legal notice. The FEB's aviso legal (legal notice) asserts intellectual-property rights over the site's content and its databases (the EU database right). It has no explicit scraping clause, and robots.txt answers 404 on both hosts. Fetching for your own use on your own machine is how these wrappers are meant to be used; check the notice before you republish the data.

Unofficial and unsupported. The LiveStats API (intrafeb.feb.es) is the federation's own widget backend, not a documented public API. It needs a bearer token, which is public: it is read from the home page of baloncestoenvivo.feb.es at run time, kept in memory for the R session (24 h validity, renewed once on an HTTP 401) and never printed, logged or written. Requests are spaced at least one second apart per host; 429 and 5xx answers are retried (three attempts).

Coverage. The game routes answer from 2020-21 (Liga Femenina Endesa from its first game; Primera FEB from 2021-03-12, so its earlier 2020-21 games and every earlier season answer 404). 2020-21 play-by-play is text only. The schedule pages go back to 1996-97 (season = 1997).

Seasons are END years (season = 2027 is 2026-27); the site's own t key is the START year, so the request sends t = season - 1.

Errors are classed conditions, never a warning plus an empty frame: wehoop_no_data (HTTP 404, an unknown group, a schedule page with no games, an empty overview window), wehoop_bad_request (HTTP 400 / 422, or a game_id, group or season that is not a non-negative integer) and wehoop_asset_fetch (any other failure: another status, a transport error, a token the API still rejects after one renewal, a non-JSON or non-HTML body, an error or changed envelope, a play-by-play of another game, a page for another group or season, or layout drift). All inherit wehoop_error.

Value

A wehoop_data tibble with these columns:

col_name type description
group integer The site's menu group (1 Primera FEB, 2 Segunda FEB, 4 Liga Femenina Endesa); not a competition id.
season integer Season END year (2027 = 2026-27), the site's START-year key plus one.
competition character Competition name on the page header ('PRIMERA FEB').
round integer Round number (jornada) the game belongs to.
round_label character Round heading as printed ('Jornada 4 16/10/2026').
round_date Date Date of the round (the heading's date); played games carry no date of their own on this page.
game_id integer FEB game id (one global sequence): the {gameId} of every LiveStats route and the p= of Partido.aspx. Game bodies do not print it, so it comes from the request.
home_team_id integer Home team-season id (new every season; joins feb_overview and the game wrappers).
home_team character Home team name, uppercase.
away_team_id integer Away team-season id (new every season).
away_team character Away team name, uppercase.
result_text character Result cell verbatim: 'home-away' points when played; before the game the calendar shows the Spanish weekday, date and time and the results page shows '-'.
home_score integer Home points; null before the game.
away_score integer Away points; null before the game.
status character played when the result cell holds a score, scheduled otherwise.
weekday character English weekday of a scheduled game (translated from the Spanish cell); null for played games.
date Date Game date; null for played games on the schedule page (use round_date).
time character Tip-off 'HH:MM', Spanish local time; null for played games on the schedule page.

See Also

Other FEB Functions: feb_game_info(), feb_leaders(), feb_overview(), feb_pbp(), feb_period_scores(), feb_player_box(), feb_results(), feb_shots(), feb_standings(), feb_team_stats()

Examples

try(feb_schedule(group = 1, season = 2027))

FEB Shots

Description

Every field-goal attempt of one FEB game with its court position (percent of a full-court image).

Endpoint: ⁠GET https://intrafeb.feb.es/LiveStats.API/api/v1/ShotChart/{game_id}⁠

Free throws are not in the feed. x / y are percent (0-100) of a horizontal full-court image, origin top-left; teams change ends at half-time. The feed names the shooter by shirt number: player_id is resolved through the game's roster (side + shirt number) and is NA when that pair is not unique.

Usage

feb_shots(game_id)

Arguments

game_id

(integer required): FEB game id, e.g. 2535725; the game_id column of feb_schedule(), feb_results() and feb_overview().

Details

The Spanish Basketball Federation (FEB) wrappers cover Primera FEB, Segunda FEB and Liga Femenina Endesa (plus the federation's other groups on the same routes). They mirror sdv-py's sportsdataverse.basketball.feb wrappers of the same names: same arguments, the same snake_case columns and types, one row per sdv-py row.

Legal notice. The FEB's aviso legal (legal notice) asserts intellectual-property rights over the site's content and its databases (the EU database right). It has no explicit scraping clause, and robots.txt answers 404 on both hosts. Fetching for your own use on your own machine is how these wrappers are meant to be used; check the notice before you republish the data.

Unofficial and unsupported. The LiveStats API (intrafeb.feb.es) is the federation's own widget backend, not a documented public API. It needs a bearer token, which is public: it is read from the home page of baloncestoenvivo.feb.es at run time, kept in memory for the R session (24 h validity, renewed once on an HTTP 401) and never printed, logged or written. Requests are spaced at least one second apart per host; 429 and 5xx answers are retried (three attempts).

Coverage. The game routes answer from 2020-21 (Liga Femenina Endesa from its first game; Primera FEB from 2021-03-12, so its earlier 2020-21 games and every earlier season answer 404). 2020-21 play-by-play is text only. The schedule pages go back to 1996-97 (season = 1997).

Seasons are END years (season = 2027 is 2026-27); the site's own t key is the START year, so the request sends t = season - 1.

Errors are classed conditions, never a warning plus an empty frame: wehoop_no_data (HTTP 404, an unknown group, a schedule page with no games, an empty overview window), wehoop_bad_request (HTTP 400 / 422, or a game_id, group or season that is not a non-negative integer) and wehoop_asset_fetch (any other failure: another status, a transport error, a token the API still rejects after one renewal, a non-JSON or non-HTML body, an error or changed envelope, a play-by-play of another game, a page for another group or season, or layout drift). All inherit wehoop_error.

 feb_shots(game_id = 2535725)

Value

A wehoop_data tibble with these columns:

col_name type description
game_id integer FEB game id (one global sequence): the {gameId} of every LiveStats route and the p= of Partido.aspx. Game bodies do not print it, so it comes from the request.
period integer Period number of the attempt.
clock character Game clock REMAINING in the period at the shot, 'mm:ss' (the play-by-play line's time).
clock_seconds integer The clock as whole seconds remaining in the period (08:34 = 514), derived by the parser.
team_side character Side of the shooter: home (feed code 0) or away (feed code 1; play-by-play uses 1/2).
team_id integer Team-season id of the shooter's team (from the shot chart's TEAM list); new every season.
shirt_number character Shirt number (dorsal) as a string, so '00' and '0' stay distinct. The shot feed names the shooter by this number.
player_id integer FEB person id of the shooter, resolved from side + shirt number in the game's roster; null when that pair is not unique. The feed itself carries no player id.
made logical True when the shot was made, false when missed. Free throws are not in the feed.
x double Court x position: percent (0-100) of the length of a horizontal full-court image, origin top-left. Teams change ends at half-time; metres (x/100 x 28) are an unverified inference.
y double Court y position: percent (0-100) of the width of a horizontal full-court image from the top edge; baskets sit near y = 50. Metres (y/100 x 15) are an unverified inference.

See Also

Other FEB Functions: feb_game_info(), feb_leaders(), feb_overview(), feb_pbp(), feb_period_scores(), feb_player_box(), feb_results(), feb_schedule(), feb_standings(), feb_team_stats()


FEB Standings

Description

League table of a FEB competition season (live standings, or the final classification once it is over).

Endpoint: ⁠GET https://baloncestoenvivo.feb.es/resultados.aspx?g={group}&t={season - 1}⁠

table is live (the in-season table) or final (the final classification: only position and the team, every other statistic is NA); the page shows one of the two. Only the first phase of the group is shown.

Usage

feb_standings(group = 4, season)

Arguments

group

(integer default 4, Liga Femenina Endesa): The site's menu group: 1 Primera FEB, 2 Segunda FEB, 4 Liga Femenina Endesa, 9 and 10 LF-2, 67 LF Challenge, 73 Copa de Espana, 74 Liga U. A group is not a competition id (see comp_id).

season

(integer required): Season END year (2027 = 2026-27), sent to the site as its START-year key t = season - 1.

Details

The Spanish Basketball Federation (FEB) wrappers cover Primera FEB, Segunda FEB and Liga Femenina Endesa (plus the federation's other groups on the same routes). They mirror sdv-py's sportsdataverse.basketball.feb wrappers of the same names: same arguments, the same snake_case columns and types, one row per sdv-py row.

Legal notice. The FEB's aviso legal (legal notice) asserts intellectual-property rights over the site's content and its databases (the EU database right). It has no explicit scraping clause, and robots.txt answers 404 on both hosts. Fetching for your own use on your own machine is how these wrappers are meant to be used; check the notice before you republish the data.

Unofficial and unsupported. The LiveStats API (intrafeb.feb.es) is the federation's own widget backend, not a documented public API. It needs a bearer token, which is public: it is read from the home page of baloncestoenvivo.feb.es at run time, kept in memory for the R session (24 h validity, renewed once on an HTTP 401) and never printed, logged or written. Requests are spaced at least one second apart per host; 429 and 5xx answers are retried (three attempts).

Coverage. The game routes answer from 2020-21 (Liga Femenina Endesa from its first game; Primera FEB from 2021-03-12, so its earlier 2020-21 games and every earlier season answer 404). 2020-21 play-by-play is text only. The schedule pages go back to 1996-97 (season = 1997).

Seasons are END years (season = 2027 is 2026-27); the site's own t key is the START year, so the request sends t = season - 1.

Errors are classed conditions, never a warning plus an empty frame: wehoop_no_data (HTTP 404, an unknown group, a schedule page with no games, an empty overview window), wehoop_bad_request (HTTP 400 / 422, or a game_id, group or season that is not a non-negative integer) and wehoop_asset_fetch (any other failure: another status, a transport error, a token the API still rejects after one renewal, a non-JSON or non-HTML body, an error or changed envelope, a play-by-play of another game, a page for another group or season, or layout drift). All inherit wehoop_error.

Value

A wehoop_data tibble with these columns:

col_name type description
group integer The site's menu group (1 Primera FEB, 2 Segunda FEB, 4 Liga Femenina Endesa); not a competition id.
season integer Season END year (2027 = 2026-27), the site's START-year key plus one.
competition character Competition name on the page header ('PRIMERA FEB').
comp_id integer Competition id (CompID) read from the page; ties the site group to the API (group 1 -> 115, 2 -> 118, 4 -> 210).
table character live = the in-season league table; final = the final classification once the season is over.
position integer Rank in the table (Po).
team_id integer Team-season id (new every season; joins the schedule and game wrappers).
team character Team name as printed in the table (sponsor name, uppercase).
played integer Games played (PJ); null in the final classification.
won integer Games won (PG); null in the final classification.
lost integer Games lost (PP); null in the final classification.
points_for integer Points scored (PF); null in the final classification.
points_against integer Points conceded (PC); null in the final classification.
point_diff integer Point difference (DIF), signed; null in the final classification.
win_pct double Win percentage, 0-100 (the page's '100,0%', decimal comma converted).
streak integer Current streak as a signed integer: +3 = three wins in a row, -2 = two losses.
streak_text character The streak cell verbatim ('+3').

See Also

Other FEB Functions: feb_game_info(), feb_leaders(), feb_overview(), feb_pbp(), feb_period_scores(), feb_player_box(), feb_results(), feb_schedule(), feb_shots(), feb_team_stats()

Examples

try(feb_standings(group = 1, season = 2027))

FEB Team Stats

Description

Team totals of both teams in one FEB game: shooting, rebounds, assists, turnovers, fouls.

Endpoint: ⁠GET https://intrafeb.feb.es/LiveStats.API/api/v1/TeamStats/{game_id}⁠

One row per team, home first. fastb, ptsto, secpts, bench and paint are null on every sampled game (the stat crews do not fill them); seconds_played and val are null on these rows.

Usage

feb_team_stats(game_id)

Arguments

game_id

(integer required): FEB game id, e.g. 2535725; the game_id column of feb_schedule(), feb_results() and feb_overview().

Details

The Spanish Basketball Federation (FEB) wrappers cover Primera FEB, Segunda FEB and Liga Femenina Endesa (plus the federation's other groups on the same routes). They mirror sdv-py's sportsdataverse.basketball.feb wrappers of the same names: same arguments, the same snake_case columns and types, one row per sdv-py row.

Legal notice. The FEB's aviso legal (legal notice) asserts intellectual-property rights over the site's content and its databases (the EU database right). It has no explicit scraping clause, and robots.txt answers 404 on both hosts. Fetching for your own use on your own machine is how these wrappers are meant to be used; check the notice before you republish the data.

Unofficial and unsupported. The LiveStats API (intrafeb.feb.es) is the federation's own widget backend, not a documented public API. It needs a bearer token, which is public: it is read from the home page of baloncestoenvivo.feb.es at run time, kept in memory for the R session (24 h validity, renewed once on an HTTP 401) and never printed, logged or written. Requests are spaced at least one second apart per host; 429 and 5xx answers are retried (three attempts).

Coverage. The game routes answer from 2020-21 (Liga Femenina Endesa from its first game; Primera FEB from 2021-03-12, so its earlier 2020-21 games and every earlier season answer 404). 2020-21 play-by-play is text only. The schedule pages go back to 1996-97 (season = 1997).

Seasons are END years (season = 2027 is 2026-27); the site's own t key is the START year, so the request sends t = season - 1.

Errors are classed conditions, never a warning plus an empty frame: wehoop_no_data (HTTP 404, an unknown group, a schedule page with no games, an empty overview window), wehoop_bad_request (HTTP 400 / 422, or a game_id, group or season that is not a non-negative integer) and wehoop_asset_fetch (any other failure: another status, a transport error, a token the API still rejects after one renewal, a non-JSON or non-HTML body, an error or changed envelope, a play-by-play of another game, a page for another group or season, or layout drift). All inherit wehoop_error.

 feb_team_stats(game_id = 2535725)

Value

A wehoop_data tibble with these columns:

col_name type description
game_id integer FEB game id (one global sequence): the {gameId} of every LiveStats route and the p= of Partido.aspx. Game bodies do not print it, so it comes from the request.
team_side character Side of the game the row belongs to: home or away (the feed's TEAM[0] / TEAM[1], or its 1/2 and 0/1 side codes, normalised).
team_id integer Team-season id (key space: FEB team registrations; a NEW id every season, e.g. HLA Alicante = 979989 in 2025-26 and 1008687 in 2026-27). Joins the schedule's home_team_id / away_team_id; not a club or player id.
team character Team name as registered for the season (sponsor name, uppercase: 'HLA ALICANTE').
team_code character Federation team code, 8 digits as a string: the 6-digit club_code plus a 2-digit team suffix ('03058600'). Null on 2020-21 games.
club_code character Federation club code, 6 digits as a string (the first 6 digits of team_code). Whether it is stable across seasons is unverified. Null on 2020-21 games.
seconds_played integer Seconds on court (the feed's min, an integer count of seconds: 1064 = 17:44; a team row sums its players, 12000 = 200:00). Null on /TeamStats rows.
min_formatted character Time played as 'mm:ss'; '0:00' on /TeamStats rows (only box-score totals carry a value).
pts integer Team points: the final score when the game is over, else the live score.
p1m integer Free throws made (tiros libres; integer as a string).
p1a integer Free throws attempted (integer as a string).
p1p double Free-throw percentage, 0-100, as a string with a DECIMAL COMMA ('77,3'); '0,0' when no attempts.
p2m integer Two-point field goals made (integer as a string).
p2a integer Two-point field goals attempted (integer as a string).
p2p double Two-point percentage, 0-100, string with a decimal comma ('54,1').
p3m integer Three-point field goals made (integer as a string).
p3a integer Three-point field goals attempted (integer as a string).
p3p double Three-point percentage, 0-100, string with a decimal comma ('47,6').
fgm integer Field goals made, 2PT + 3PT (tiros de campo; integer as a string).
fga integer Field goals attempted, 2PT + 3PT (integer as a string).
fgp double Field-goal percentage, 0-100, string with a decimal comma ('51,7').
ro integer Offensive rebounds (rebotes ofensivos; integer as a string).
rd integer Defensive rebounds (rebotes defensivos; integer as a string).
rt integer Total rebounds (rebotes totales; integer as a string).
assist integer Assists (asistencias; integer as a string).
st integer Steals (balones robados, page column BR; integer as a string).
to integer Turnovers (balones perdidos, page column BP; integer as a string).
bs integer Blocks made (tapones a favor, page column TF; integer as a string).
tc integer Shots of this team that were blocked (tapones en contra, page column TC). Null on /TeamStats rows.
mt integer Dunks (mates, page column MT). Null on /TeamStats rows.
pf integer Personal fouls committed (faltas cometidas, page column FC; integer as a string).
rf integer Fouls received / drawn (faltas recibidas, page column FR; integer as a string).
fouls integer Team fouls committed in the game (equals pf on the samples).
val integer FEB efficiency rating (valoracion). Null on /TeamStats rows, filled on box-score totals.
fastb integer Fast-break points. Null on every sampled game: the federation's stat crews do not fill it.
ptsto integer Points off turnovers. Null on every sampled game: the federation's stat crews do not fill it.
secpts integer Second-chance points. Null on every sampled game: the federation's stat crews do not fill it.
bench integer Bench points. Null on every sampled game: the federation's stat crews do not fill it.
paint integer Points in the paint. Null on every sampled game: the federation's stat crews do not fill it.

See Also

Other FEB Functions: feb_game_info(), feb_leaders(), feb_overview(), feb_pbp(), feb_period_scores(), feb_player_box(), feb_results(), feb_schedule(), feb_shots(), feb_standings()


FIBA competition: EuroCup Women (FIBA Women's European Club Competitions Tier 2)

Description

Per-competition aliases of the FIBA wrappers for EuroCup Women (FIBA Women's European Club Competitions Tier 2) (GDAP competition family 165), named as in sdv-py. Season rule: END year (2024-25 = 2025).

Usage

fiba_ecw_editions(season = NULL, to_season = NULL, return_parsed = TRUE)

fiba_ecw_schedule(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_ecw_standings(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_ecw_teams(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_ecw_player_box(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_ecw_team_box(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_ecw_pbp(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_ecw_shots(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

Arguments

game_id

FIBA game id (game_id in the schedule).

season

Edition season key (END year (2024-25 = 2025)). Omitted = the newest edition that has started; a game function needs season or comp. For fiba_ecw_editions(): the first season (inclusive), omitted = every edition.

to_season

Last season, inclusive (fiba_ecw_editions() only).

comp

FIBA competition id (one per edition); skips the edition lookup and is needed when a season lists several editions. Checked to be an edition of this competition (one cached getGdapCompetitionById request).

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source: the GDAP developer-portal terms limit API use to 'Authorized Users' and the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers. See fiba_gdap_awards() for the shared notes.

A comp of another competition family, or one GDAP gives no family, is wehoop_asset_fetch; a season with no edition is wehoop_no_data; a season listing several editions, or a game function called with neither season nor comp, is wehoop_bad_request.

 fiba_ecw_editions(season = 2025)
 fiba_ecw_schedule(season = 2025)

Value

A wehoop_data tibble with the columns of the base wrapper (the raw JSON list when return_parsed = FALSE), one table per function:

fiba_ecw_editions()

The columns of fiba_gdap_editions():

col_name type description
hosts character Host countries with their cities. Stored as a JSON string.
competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_code character Competition code (WMM men's World Cup, WOLYM, BCL, ELW...).
season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
official_name character Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
start character First day, YYYY-MM-DD.
end character Last day, YYYY-MM-DD.
status character Competition status: In Progress, Completed, Closed.
age_category character Age category (Senior, Under 16...).
gender character Men or Women: the gender of the competition.
fiba_zone character FIBA zone the competition belongs to (World, Europe, Americas...).
zone_information_zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
zone_information_zone_official_name character Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
zone_information_zone_code character Zone code (W, E, AF, AM, AS, OC).
zone_information_top_zone_id integer Parent zone id; null for top zones.
zone_information_top_zone_official_name character Parent zone name; always null in the samples, values unverified.
zone_information_top_zone_code character Parent zone code; always null in the samples, values unverified.
competition_type character National Teams or Clubs.
competition_category_is_league logical True for league-format club competitions.
competition_category_age_type character Age type code: S senior, U16.
competition_category_code character Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_category_name character Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
official_flag_item_code character Official-status code: O = official.
official_flag_item_name character Official-status label.
official character Official-status label.
discipline character Discipline (Basketball; 3x3 is a separate platform).
competition_marketing_name_competition_marketing_name_id integer Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the ⁠<histId>⁠ of /en/history/ pages.
competition_marketing_name_marketing_name character Competition family name; slugified it is the ⁠<histSlug>⁠ of /en/history/ pages.
competition_marketing_name_code character Family code; null in every sample.

fiba_ecw_schedule()

The columns of fiba_gdap_schedule():

col_name type description
game_id integer FIBA game id, global across competitions (GDAP key space): gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
game_name character Technical game name '⁠<roundId>⁠-⁠<groupPairingCode>⁠-⁠<gameNumber>⁠'.
game_number character Game number within the round or pairing (a string: '1', 'A').
status_code character Game status code: VALID (validated result), CLOS (closed, pre-2000 rows).
team_a_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_a_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_a_code character Team code (national: FIBA country code; club: a club abbreviation such as OOST).
team_a_official_name character Official name of team A: the country for a national team, the club for a club team.
team_a_short_name character Short name of team A: the country code for a national team, the club's short name for a club.
team_b_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_b_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_b_code character Team code (national: FIBA country code; club: a club abbreviation such as NANT).
team_b_official_name character Official name of team B: the country for a national team, the club for a club team.
team_b_short_name character Short name of team B: the country code for a national team, the club's short name for a club.
team_a_score integer Final score of team A.
team_b_score integer Final score of team B.
is_live logical True while the game is being played.
current_period character Last period reached ('Q4', 'OT1').
chrono character Game clock of the current period, 'mm:ss' ('00:00' when finished).
live_game_status integer Live state code: 999 on every finished game; 5 seen on a finished 2024 youth game; mapping unverified.
current_period_status character State of the current period: E = ended (the only value sampled).
host_city character City of the venue.
host_country character Country of the venue (name; a FIBA code in getgdapgameswithleaderdetailsbyteamid).
host_country_code character FIBA code of the venue's country.
venue_id integer Venue id (GDAP key space; 0 = unknown).
venue_name character Name of the arena the game is played in.
game_date_time character Tip-off in venue-local wall-clock time, ISO 8601 without offset (T00:00:00 when hasTimeGameDateTime is false).
game_date_time_utc character Tip-off in UTC, ISO 8601 without the Z.
has_time_game_date_time logical False when only the date is known (the time part is then 00:00:00).
iana_time_zone character IANA time zone of the venue.
utc_offset double Venue UTC offset at tip-off, in hours (Float64: a half-hour zone such as India +5.5 or Adelaide +9.5 is a fraction; whole hours in every sample).
is_postponed logical True when the game was postponed.
is_played_behind_closed_doors logical True when played without spectators.
venue_capacity integer Venue capacity (0 = unknown).
spectators integer Attendance at the game, as recorded by FIBA.
statistic_system character Live-stats system that scored the game: OVR (FIBA's Olympic/World Cup system), FLS (FIBA LiveStats), null before about 2006.
group_id character Group id (GDAP key space).
group_pairing_code character Group letter (group play) or pairing number (knockout bracket slot).
round_round_id integer Round id (GDAP key space, unique across competitions); the first segment of gameName.
round_round_code character Round code (GP group phase, QF, SF, F final, RS regular season, CL17-32 classification...).
round_round_name character Round label (Group Phase, Quarter-Finals, Final...).
round_round_number integer Round number within the competition (1-based).
round_round_type character Round type label: Group Round, Non Group Round, Super Round (getgdapgamesbycompetitionid uses the code G/NG here).
round_round_status_code character Round status: COMPL completed, PROGR in progress, CLOS closed.
round_game_system character Pairing system label (Single, Home and Away, Best of 3).
round_game_system_code character Pairing system code: S single game, HA home and away, BOF3 best of three.
round_start_date character Round start, local date-time.
round_end_date character Round end, local date-time (23:59:59.9999999 on the last day).
round_round_kind character Standard Round or Qualifiers.
round_round_order integer Display order of the round.
competition_competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_competition_code character Competition code (WMM men's World Cup, WOLYM, BCL, ELW...).
competition_season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
competition_official_name character Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
competition_start character First day, YYYY-MM-DD.
competition_end character Last day, YYYY-MM-DD.
competition_status character Competition status: In Progress, Completed, Closed.
competition_age_category character Age category (Senior, Under 16...).
competition_gender character Men or Women: the gender of the competition.
competition_fiba_zone character FIBA zone the competition belongs to (World, Europe, Americas...).
competition_zone_information_zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
competition_zone_information_zone_official_name character Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
competition_zone_information_zone_code character Zone code (W, E, AF, AM, AS, OC).
competition_zone_information_top_zone_id integer Parent zone id; null for top zones.
competition_zone_information_top_zone_official_name character Parent zone name; always null in the samples, values unverified.
competition_zone_information_top_zone_code character Parent zone code; always null in the samples, values unverified.
competition_competition_type character National Teams or Clubs.
competition_competition_category_is_league logical True for league-format club competitions.
competition_competition_category_age_type character Age type code: S senior, U16.
competition_competition_category_code character Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_competition_category_name character Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
competition_official_flag_item_code character Official-status code: O = official.
competition_official_flag_item_name character Official-status label.
competition_official character Official-status label.
competition_discipline character Discipline (Basketball; 3x3 is a separate platform).
competition_competition_marketing_name_competition_marketing_name_id integer Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the ⁠<histId>⁠ of /en/history/ pages.
competition_competition_marketing_name_marketing_name character Competition family name; slugified it is the ⁠<histSlug>⁠ of /en/history/ pages.
competition_competition_marketing_name_code character Family code; null in every sample.
game_statistic_status_code character Box-score validation status: VALID.
game_play_by_play_status_code character Play-by-play availability flag: VALID or EMPTY. UNRELIABLE: World Cup 2014 and EuroBasket 2017 say EMPTY but their game pages carry full play-by-play; always check the page.
game_result_status_code character Result validation status: VALID.
game_result_additional_information character Free-text result note (forfeit, overtime remark); null when none.
window_code character Qualifier window code; null otherwise.
window_name character Qualifier window name; null otherwise.
team_a_from character How team A qualified for this slot ('Winner of Game 87', '1st of group C'); null in group play.
team_b_from character How team B qualified for this slot ('Winner of Game 88', '2nd of group A'); null in group play.

fiba_ecw_standings()

The columns of fiba_gdap_final_standings():

col_name type description
competition_id integer FIBA competition id (Int64) the final ranking belongs to; the comp argument.
final_rank integer Final rank in the competition.
team_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_team_code character Team abbreviation (FIBA country code or club abbreviation).
team_short_name character Short team name: the country code for a national team, the club's short name for a club.
team_profile character Team profile; null in this route.
team_status_code character Team entry status; always null in the samples, values unverified.
team_status_name character Team entry status label; always null in the samples, values unverified.
team_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.

fiba_ecw_teams()

The columns of fiba_gdap_teams():

col_name type description
team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_code character Team abbreviation (FIBA country code or club abbreviation).
short_name character Short team name: the country code for a national team, the club's short name for a club.
profile_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
profile_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
profile_name character Team name as registered for the competition.
profile_code character Team code (FIBA country code or club abbreviation).
profile_country_name character Country of the team, in English.
profile_country_code character Country FIBA code.
profile_gender character Men or Women: the gender of the team's competition.
profile_facebook character Facebook handle or URL; always null in the samples, values unverified.
profile_twitter character X/Twitter handle; always null in the samples, values unverified.
profile_instagram character Instagram handle; always null in the samples, values unverified.
profile_website character The team's website address.
profile_you_tube character YouTube handle; always null in the samples, values unverified.
profile_final_ranking integer Final rank in the competition.
profile_points_per_game double The team's average points per game played.
profile_rebounds_per_game double The team's average rebounds per game played.
profile_assists_per_game double The team's average assists per game played.
profile_rank_points_per_game double Rank in the competition by points per game (1 = highest).
profile_rank_rebounds_per_game double Rank in the competition by rebounds per game (1 = highest).
profile_rank_assists_per_game double Rank in the competition by assists per game (1 = highest).
profile_total_games_won integer The team's total games won over the games played.
profile_total_games_lost integer The team's total games lost over the games played.
profile_social_networks character Social-network handles. Stored as a JSON string.
profile_competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
status_code character Team entry status: APPR approved.
status_name character Team entry status label (Approved).
organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.

fiba_ecw_player_box()

The columns of fiba_gamepage_box_players():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
first_name character Given name(s) as registered with FIBA.
last_name character Last name as registered with FIBA.
jersey character Jersey number as a string.
position character Playing position code from the lineup card (PG, SG, SF, PF, C).
is_captain logical True for the team captain.
is_starter logical True for the starting five.
has_played logical True when the player got on the court.
minutes character Minutes played as an 'm:ss' string ('0:0' = did not play).
seconds_played integer Seconds played, derived from minutes.
points integer Points scored in the game.
fg_made integer Field goals made (2 + 3 points).
fg_attempted integer Field goals attempted (2 + 3 points).
fg_pct double Field-goal percentage, 0-100.
fg2_made integer Two-point field goals made.
fg2_attempted integer Two-point field goals attempted.
fg2_pct double Two-point field-goal percentage, 0-100.
fg3_made integer Three-point field goals made.
fg3_attempted integer Three-point field goals attempted.
fg3_pct double Three-point field-goal percentage, 0-100.
ft_made integer Free throws made.
ft_attempted integer Free throws attempted.
ft_pct double Free-throw percentage, 0-100.
reb_offensive integer Offensive rebounds.
reb_defensive integer Defensive rebounds.
reb_total integer Total rebounds (a team row includes the team rebounds team_reb_total).
assists integer Assists credited in the game.
steals integer Steals credited in the game.
blocks integer Blocked shots (blocks made).
blocks_received integer Own shots blocked by the opponent (blocks received).
turnovers integer Turnovers (a team row includes the team turnovers team_turnovers).
fouls integer Personal fouls (a team row includes the team fouls team_fouls).
fouls_drawn integer Fouls drawn in the game.
paint_fg_made integer Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game).
paint_fg_attempted integer Field goals attempted in the paint.
paint_fg_pct double Field-goal percentage in the paint, 0-100.
efficiency integer Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers).
plus_minus integer Plus/minus: the team's point differential while the player was on the court.
cb logical Boolean flag, false on every sampled player; meaning unverified.

fiba_ecw_team_box()

The columns of fiba_gamepage_box_teams():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
score integer Team final score.
points integer Points scored in the game.
fg_made integer Field goals made (2 + 3 points).
fg_attempted integer Field goals attempted (2 + 3 points).
fg_pct double Field-goal percentage, 0-100.
fg2_made integer Two-point field goals made.
fg2_attempted integer Two-point field goals attempted.
fg2_pct double Two-point field-goal percentage, 0-100.
fg3_made integer Three-point field goals made.
fg3_attempted integer Three-point field goals attempted.
fg3_pct double Three-point field-goal percentage, 0-100.
ft_made integer Free throws made.
ft_attempted integer Free throws attempted.
ft_pct double Free-throw percentage, 0-100.
reb_offensive integer Offensive rebounds.
reb_defensive integer Defensive rebounds.
reb_total integer Total rebounds (a team row includes the team rebounds team_reb_total).
assists integer Assists credited in the game.
steals integer Steals credited in the game.
blocks integer Blocked shots (blocks made).
blocks_received integer Own shots blocked by the opponent (blocks received).
turnovers integer Turnovers (a team row includes the team turnovers team_turnovers).
fouls integer Personal fouls (a team row includes the team fouls team_fouls).
fouls_drawn integer Fouls drawn in the game.
paint_fg_made integer Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game).
paint_fg_attempted integer Field goals attempted in the paint.
paint_fg_pct double Field-goal percentage in the paint, 0-100.
efficiency integer Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers).
biggest_lead integer Biggest lead, points.
biggest_lead_score character Score when the biggest lead was reached, 'A-B' string (spacing varies; empty when the team never led).
biggest_run integer Biggest scoring run, points.
biggest_run_score character Score of the biggest scoring run, 'x-y' string; exact meaning unverified.
fast_break_points integer Fast-break points.
points_off_turnovers integer Points scored after turnovers.
bench_points integer Points from the bench (the sum of the non-starters' points).
points_in_paint integer Points in the paint (2 x paint_fg_made).
second_chance_points integer Second-chance points.
a_act integer Always 0 in the samples; meaning unverified (FIBA stat code A_ACT).
a_foul integer Always 0 in the samples; meaning unverified (FIBA stat code A_FOUL).
a_tod integer Always 0 in the samples; meaning unverified (FIBA stat code A_TOD).
a_tot integer Always 0 in the samples; meaning unverified (FIBA stat code A_TOT).
team_reb_offensive integer Team offensive rebounds, credited to no player.
team_reb_defensive integer Team defensive rebounds, credited to no player.
team_reb_total integer Team rebounds (total rebounds minus the players' sum).
team_fouls integer Team (bench/coach) fouls (personal fouls minus the players' sum).
team_turnovers integer Team turnovers (turnovers minus the players' sum).
team_bench_points_flag integer Bench points in FLS games (equal to bench_points); 0 in OVR games (FIBA stat code T_PFB).
time_led character Time the team led, 'mm:ss' string.
lead_changes integer Lead changes in the game (game-level; repeats on both team rows).
times_tied integer Times the score was tied (game-level; repeats on both team rows).
duration character Game duration as an 'h:mm' string (game-level; repeats on both team rows).
attendance integer Attendance (game-level; repeats on both team rows).

fiba_ecw_pbp()

The columns of fiba_gamepage_pbp():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
period character Period name: Q1..Q4, then OT1, OT2...
period_number integer 1-based position of the period in the game.
action_id character Action id (String): '⁠<n>⁠:⁠<seq>⁠' in OVR games (3:0015), a sequence number in FLS games; unique within the game.
order integer Sort key within the period (OVR: 1, 2, ...; FLS: 1000, 2000, ...); null on some period events.
clock character Game clock: time REMAINING in the period, 'm:ss', counting down from 10:00 (5:00 in overtime).
clock_seconds integer Seconds remaining in the period, derived from clock.
wall_time_ms double Wall-clock time of the action, Unix epoch milliseconds. (Int64 in sdv-py; numeric here, the values exceed R's 32-bit integer range)
score_a integer Team A score after the action.
score_b integer Team B score after the action.
action_code character Action code: P2 two-point shot, P3 three-point shot, FT free throw, REB rebound, TREB team rebound, ASS assist, ST steal, BS block, TO turnover, TTO team turnover, FOUL foul, RFOUL foul drawn, SUBST substitution, TIMO timeout, plus period events (STARTG, STARTP, ENDP, ENDG).
action_family character Action family: shot, subst, timeout, periods, and 'unknwown' (FIBA's spelling) for every other action.
description character English action text ('3pt jump shot missed', 'defensive rebound'); null on most OVR actions.
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
player2_id integer FIBA person id (Int64) of the second player on a substitution; null when the game does not record it (the refs note FLS only, but the Paris 2024 final, an OVR game, carries it and the FLS games sampled leave it null).
sub_direction character Substitution direction: IN or OUT; null on other actions.
made logical True when the shot went in (two-pointers, three-pointers and free throws only; null otherwise).
points_attempted integer Points the attempt was worth (2, 3 or 1), made or not; null on other actions.
shot_type character Shot type derived from action_code: 2PT, 3PT or FT; null on other actions.
shot_x integer Shot x, integer pixels on a half-court image across the court width (observed 0-278, basket near x = 139). Present only on shots; free throws are 0. Which sideline is x = 0 and the scale are UNVERIFIED.
shot_y integer Shot y, integer pixels from the baseline (y = 0) towards midcourt (observed 0-224, basket near y = 25); both teams' shots are drawn on one basket. Free throws are 0. Scale UNVERIFIED.
has_location logical True when shot_x / shot_y locate the shot (two- and three-pointers); False for free throws (always 0, 0); null on other actions.

fiba_ecw_shots()

The columns of fiba_gamepage_shots():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
period character Period name: Q1..Q4, then OT1, OT2...
period_number integer 1-based position of the period in the game.
action_id character Action id (String): '⁠<n>⁠:⁠<seq>⁠' in OVR games (3:0015), a sequence number in FLS games; unique within the game.
order integer Sort key within the period (OVR: 1, 2, ...; FLS: 1000, 2000, ...); null on some period events.
clock character Game clock: time REMAINING in the period, 'm:ss', counting down from 10:00 (5:00 in overtime).
clock_seconds integer Seconds remaining in the period, derived from clock.
action_code character Action code: P2 two-point shot, P3 three-point shot, FT free throw, REB rebound, TREB team rebound, ASS assist, ST steal, BS block, TO turnover, TTO team turnover, FOUL foul, RFOUL foul drawn, SUBST substitution, TIMO timeout, plus period events (STARTG, STARTP, ENDP, ENDG).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
shot_type character Shot type derived from action_code: 2PT, 3PT or FT; null on other actions.
points_attempted integer Points the attempt was worth (2, 3 or 1), made or not; null on other actions.
made logical True when the shot went in (two-pointers, three-pointers and free throws only; null otherwise).
shot_x integer Shot x, integer pixels on a half-court image across the court width (observed 0-278, basket near x = 139). Present only on shots; free throws are 0. Which sideline is x = 0 and the scale are UNVERIFIED.
shot_y integer Shot y, integer pixels from the baseline (y = 0) towards midcourt (observed 0-224, basket near y = 25); both teams' shots are drawn on one basket. Free throws are 0. Scale UNVERIFIED.
has_location logical True when shot_x / shot_y locate the shot (two- and three-pointers); False for free throws (always 0, 0); null on other actions.

See Also

Other FIBA Competition Functions: fiba_elw_competition, fiba_wafrobasket_competition, fiba_wamericup_competition, fiba_wasiacup_competition, fiba_weurobasket_competition, fiba_woly_competition, fiba_wwc_competition


FIBA competition: EuroLeague Women (FIBA Women's European Club Competitions Tier 1)

Description

Per-competition aliases of the FIBA wrappers for EuroLeague Women (FIBA Women's European Club Competitions Tier 1) (GDAP competition family 211), named as in sdv-py. Season rule: END year (2024-25 = 2025).

Usage

fiba_elw_editions(season = NULL, to_season = NULL, return_parsed = TRUE)

fiba_elw_schedule(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_elw_standings(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_elw_teams(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_elw_player_box(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_elw_team_box(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_elw_pbp(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_elw_shots(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

Arguments

game_id

FIBA game id (game_id in the schedule).

season

Edition season key (END year (2024-25 = 2025)). Omitted = the newest edition that has started; a game function needs season or comp. For fiba_elw_editions(): the first season (inclusive), omitted = every edition.

to_season

Last season, inclusive (fiba_elw_editions() only).

comp

FIBA competition id (one per edition); skips the edition lookup and is needed when a season lists several editions. Checked to be an edition of this competition (one cached getGdapCompetitionById request).

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source: the GDAP developer-portal terms limit API use to 'Authorized Users' and the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers. See fiba_gdap_awards() for the shared notes.

A comp of another competition family, or one GDAP gives no family, is wehoop_asset_fetch; a season with no edition is wehoop_no_data; a season listing several editions, or a game function called with neither season nor comp, is wehoop_bad_request.

 fiba_elw_editions(season = 2025)
 fiba_elw_schedule(season = 2025)

Value

A wehoop_data tibble with the columns of the base wrapper (the raw JSON list when return_parsed = FALSE), one table per function:

fiba_elw_editions()

The columns of fiba_gdap_editions():

col_name type description
hosts character Host countries with their cities. Stored as a JSON string.
competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_code character Competition code (WMM men's World Cup, WOLYM, BCL, ELW...).
season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
official_name character Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
start character First day, YYYY-MM-DD.
end character Last day, YYYY-MM-DD.
status character Competition status: In Progress, Completed, Closed.
age_category character Age category (Senior, Under 16...).
gender character Men or Women: the gender of the competition.
fiba_zone character FIBA zone the competition belongs to (World, Europe, Americas...).
zone_information_zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
zone_information_zone_official_name character Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
zone_information_zone_code character Zone code (W, E, AF, AM, AS, OC).
zone_information_top_zone_id integer Parent zone id; null for top zones.
zone_information_top_zone_official_name character Parent zone name; always null in the samples, values unverified.
zone_information_top_zone_code character Parent zone code; always null in the samples, values unverified.
competition_type character National Teams or Clubs.
competition_category_is_league logical True for league-format club competitions.
competition_category_age_type character Age type code: S senior, U16.
competition_category_code character Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_category_name character Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
official_flag_item_code character Official-status code: O = official.
official_flag_item_name character Official-status label.
official character Official-status label.
discipline character Discipline (Basketball; 3x3 is a separate platform).
competition_marketing_name_competition_marketing_name_id integer Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the ⁠<histId>⁠ of /en/history/ pages.
competition_marketing_name_marketing_name character Competition family name; slugified it is the ⁠<histSlug>⁠ of /en/history/ pages.
competition_marketing_name_code character Family code; null in every sample.

fiba_elw_schedule()

The columns of fiba_gdap_schedule():

col_name type description
game_id integer FIBA game id, global across competitions (GDAP key space): gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
game_name character Technical game name '⁠<roundId>⁠-⁠<groupPairingCode>⁠-⁠<gameNumber>⁠'.
game_number character Game number within the round or pairing (a string: '1', 'A').
status_code character Game status code: VALID (validated result), CLOS (closed, pre-2000 rows).
team_a_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_a_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_a_code character Team code (national: FIBA country code; club: a club abbreviation such as OOST).
team_a_official_name character Official name of team A: the country for a national team, the club for a club team.
team_a_short_name character Short name of team A: the country code for a national team, the club's short name for a club.
team_b_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_b_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_b_code character Team code (national: FIBA country code; club: a club abbreviation such as NANT).
team_b_official_name character Official name of team B: the country for a national team, the club for a club team.
team_b_short_name character Short name of team B: the country code for a national team, the club's short name for a club.
team_a_score integer Final score of team A.
team_b_score integer Final score of team B.
is_live logical True while the game is being played.
current_period character Last period reached ('Q4', 'OT1').
chrono character Game clock of the current period, 'mm:ss' ('00:00' when finished).
live_game_status integer Live state code: 999 on every finished game; 5 seen on a finished 2024 youth game; mapping unverified.
current_period_status character State of the current period: E = ended (the only value sampled).
host_city character City of the venue.
host_country character Country of the venue (name; a FIBA code in getgdapgameswithleaderdetailsbyteamid).
host_country_code character FIBA code of the venue's country.
venue_id integer Venue id (GDAP key space; 0 = unknown).
venue_name character Name of the arena the game is played in.
game_date_time character Tip-off in venue-local wall-clock time, ISO 8601 without offset (T00:00:00 when hasTimeGameDateTime is false).
game_date_time_utc character Tip-off in UTC, ISO 8601 without the Z.
has_time_game_date_time logical False when only the date is known (the time part is then 00:00:00).
iana_time_zone character IANA time zone of the venue.
utc_offset double Venue UTC offset at tip-off, in hours (Float64: a half-hour zone such as India +5.5 or Adelaide +9.5 is a fraction; whole hours in every sample).
is_postponed logical True when the game was postponed.
is_played_behind_closed_doors logical True when played without spectators.
venue_capacity integer Venue capacity (0 = unknown).
spectators integer Attendance at the game, as recorded by FIBA.
statistic_system character Live-stats system that scored the game: OVR (FIBA's Olympic/World Cup system), FLS (FIBA LiveStats), null before about 2006.
group_id character Group id (GDAP key space).
group_pairing_code character Group letter (group play) or pairing number (knockout bracket slot).
round_round_id integer Round id (GDAP key space, unique across competitions); the first segment of gameName.
round_round_code character Round code (GP group phase, QF, SF, F final, RS regular season, CL17-32 classification...).
round_round_name character Round label (Group Phase, Quarter-Finals, Final...).
round_round_number integer Round number within the competition (1-based).
round_round_type character Round type label: Group Round, Non Group Round, Super Round (getgdapgamesbycompetitionid uses the code G/NG here).
round_round_status_code character Round status: COMPL completed, PROGR in progress, CLOS closed.
round_game_system character Pairing system label (Single, Home and Away, Best of 3).
round_game_system_code character Pairing system code: S single game, HA home and away, BOF3 best of three.
round_start_date character Round start, local date-time.
round_end_date character Round end, local date-time (23:59:59.9999999 on the last day).
round_round_kind character Standard Round or Qualifiers.
round_round_order integer Display order of the round.
competition_competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_competition_code character Competition code (WMM men's World Cup, WOLYM, BCL, ELW...).
competition_season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
competition_official_name character Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
competition_start character First day, YYYY-MM-DD.
competition_end character Last day, YYYY-MM-DD.
competition_status character Competition status: In Progress, Completed, Closed.
competition_age_category character Age category (Senior, Under 16...).
competition_gender character Men or Women: the gender of the competition.
competition_fiba_zone character FIBA zone the competition belongs to (World, Europe, Americas...).
competition_zone_information_zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
competition_zone_information_zone_official_name character Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
competition_zone_information_zone_code character Zone code (W, E, AF, AM, AS, OC).
competition_zone_information_top_zone_id integer Parent zone id; null for top zones.
competition_zone_information_top_zone_official_name character Parent zone name; always null in the samples, values unverified.
competition_zone_information_top_zone_code character Parent zone code; always null in the samples, values unverified.
competition_competition_type character National Teams or Clubs.
competition_competition_category_is_league logical True for league-format club competitions.
competition_competition_category_age_type character Age type code: S senior, U16.
competition_competition_category_code character Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_competition_category_name character Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
competition_official_flag_item_code character Official-status code: O = official.
competition_official_flag_item_name character Official-status label.
competition_official character Official-status label.
competition_discipline character Discipline (Basketball; 3x3 is a separate platform).
competition_competition_marketing_name_competition_marketing_name_id integer Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the ⁠<histId>⁠ of /en/history/ pages.
competition_competition_marketing_name_marketing_name character Competition family name; slugified it is the ⁠<histSlug>⁠ of /en/history/ pages.
competition_competition_marketing_name_code character Family code; null in every sample.
game_statistic_status_code character Box-score validation status: VALID.
game_play_by_play_status_code character Play-by-play availability flag: VALID or EMPTY. UNRELIABLE: World Cup 2014 and EuroBasket 2017 say EMPTY but their game pages carry full play-by-play; always check the page.
game_result_status_code character Result validation status: VALID.
game_result_additional_information character Free-text result note (forfeit, overtime remark); null when none.
window_code character Qualifier window code; null otherwise.
window_name character Qualifier window name; null otherwise.
team_a_from character How team A qualified for this slot ('Winner of Game 87', '1st of group C'); null in group play.
team_b_from character How team B qualified for this slot ('Winner of Game 88', '2nd of group A'); null in group play.

fiba_elw_standings()

The columns of fiba_gdap_final_standings():

col_name type description
competition_id integer FIBA competition id (Int64) the final ranking belongs to; the comp argument.
final_rank integer Final rank in the competition.
team_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_team_code character Team abbreviation (FIBA country code or club abbreviation).
team_short_name character Short team name: the country code for a national team, the club's short name for a club.
team_profile character Team profile; null in this route.
team_status_code character Team entry status; always null in the samples, values unverified.
team_status_name character Team entry status label; always null in the samples, values unverified.
team_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.

fiba_elw_teams()

The columns of fiba_gdap_teams():

col_name type description
team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_code character Team abbreviation (FIBA country code or club abbreviation).
short_name character Short team name: the country code for a national team, the club's short name for a club.
profile_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
profile_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
profile_name character Team name as registered for the competition.
profile_code character Team code (FIBA country code or club abbreviation).
profile_country_name character Country of the team, in English.
profile_country_code character Country FIBA code.
profile_gender character Men or Women: the gender of the team's competition.
profile_facebook character Facebook handle or URL; always null in the samples, values unverified.
profile_twitter character X/Twitter handle; always null in the samples, values unverified.
profile_instagram character Instagram handle; always null in the samples, values unverified.
profile_website character The team's website address.
profile_you_tube character YouTube handle; always null in the samples, values unverified.
profile_final_ranking integer Final rank in the competition.
profile_points_per_game double The team's average points per game played.
profile_rebounds_per_game double The team's average rebounds per game played.
profile_assists_per_game double The team's average assists per game played.
profile_rank_points_per_game double Rank in the competition by points per game (1 = highest).
profile_rank_rebounds_per_game double Rank in the competition by rebounds per game (1 = highest).
profile_rank_assists_per_game double Rank in the competition by assists per game (1 = highest).
profile_total_games_won integer The team's total games won over the games played.
profile_total_games_lost integer The team's total games lost over the games played.
profile_social_networks character Social-network handles. Stored as a JSON string.
profile_competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
status_code character Team entry status: APPR approved.
status_name character Team entry status label (Approved).
organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.

fiba_elw_player_box()

The columns of fiba_gamepage_box_players():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
first_name character Given name(s) as registered with FIBA.
last_name character Last name as registered with FIBA.
jersey character Jersey number as a string.
position character Playing position code from the lineup card (PG, SG, SF, PF, C).
is_captain logical True for the team captain.
is_starter logical True for the starting five.
has_played logical True when the player got on the court.
minutes character Minutes played as an 'm:ss' string ('0:0' = did not play).
seconds_played integer Seconds played, derived from minutes.
points integer Points scored in the game.
fg_made integer Field goals made (2 + 3 points).
fg_attempted integer Field goals attempted (2 + 3 points).
fg_pct double Field-goal percentage, 0-100.
fg2_made integer Two-point field goals made.
fg2_attempted integer Two-point field goals attempted.
fg2_pct double Two-point field-goal percentage, 0-100.
fg3_made integer Three-point field goals made.
fg3_attempted integer Three-point field goals attempted.
fg3_pct double Three-point field-goal percentage, 0-100.
ft_made integer Free throws made.
ft_attempted integer Free throws attempted.
ft_pct double Free-throw percentage, 0-100.
reb_offensive integer Offensive rebounds.
reb_defensive integer Defensive rebounds.
reb_total integer Total rebounds (a team row includes the team rebounds team_reb_total).
assists integer Assists credited in the game.
steals integer Steals credited in the game.
blocks integer Blocked shots (blocks made).
blocks_received integer Own shots blocked by the opponent (blocks received).
turnovers integer Turnovers (a team row includes the team turnovers team_turnovers).
fouls integer Personal fouls (a team row includes the team fouls team_fouls).
fouls_drawn integer Fouls drawn in the game.
paint_fg_made integer Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game).
paint_fg_attempted integer Field goals attempted in the paint.
paint_fg_pct double Field-goal percentage in the paint, 0-100.
efficiency integer Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers).
plus_minus integer Plus/minus: the team's point differential while the player was on the court.
cb logical Boolean flag, false on every sampled player; meaning unverified.

fiba_elw_team_box()

The columns of fiba_gamepage_box_teams():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
score integer Team final score.
points integer Points scored in the game.
fg_made integer Field goals made (2 + 3 points).
fg_attempted integer Field goals attempted (2 + 3 points).
fg_pct double Field-goal percentage, 0-100.
fg2_made integer Two-point field goals made.
fg2_attempted integer Two-point field goals attempted.
fg2_pct double Two-point field-goal percentage, 0-100.
fg3_made integer Three-point field goals made.
fg3_attempted integer Three-point field goals attempted.
fg3_pct double Three-point field-goal percentage, 0-100.
ft_made integer Free throws made.
ft_attempted integer Free throws attempted.
ft_pct double Free-throw percentage, 0-100.
reb_offensive integer Offensive rebounds.
reb_defensive integer Defensive rebounds.
reb_total integer Total rebounds (a team row includes the team rebounds team_reb_total).
assists integer Assists credited in the game.
steals integer Steals credited in the game.
blocks integer Blocked shots (blocks made).
blocks_received integer Own shots blocked by the opponent (blocks received).
turnovers integer Turnovers (a team row includes the team turnovers team_turnovers).
fouls integer Personal fouls (a team row includes the team fouls team_fouls).
fouls_drawn integer Fouls drawn in the game.
paint_fg_made integer Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game).
paint_fg_attempted integer Field goals attempted in the paint.
paint_fg_pct double Field-goal percentage in the paint, 0-100.
efficiency integer Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers).
biggest_lead integer Biggest lead, points.
biggest_lead_score character Score when the biggest lead was reached, 'A-B' string (spacing varies; empty when the team never led).
biggest_run integer Biggest scoring run, points.
biggest_run_score character Score of the biggest scoring run, 'x-y' string; exact meaning unverified.
fast_break_points integer Fast-break points.
points_off_turnovers integer Points scored after turnovers.
bench_points integer Points from the bench (the sum of the non-starters' points).
points_in_paint integer Points in the paint (2 x paint_fg_made).
second_chance_points integer Second-chance points.
a_act integer Always 0 in the samples; meaning unverified (FIBA stat code A_ACT).
a_foul integer Always 0 in the samples; meaning unverified (FIBA stat code A_FOUL).
a_tod integer Always 0 in the samples; meaning unverified (FIBA stat code A_TOD).
a_tot integer Always 0 in the samples; meaning unverified (FIBA stat code A_TOT).
team_reb_offensive integer Team offensive rebounds, credited to no player.
team_reb_defensive integer Team defensive rebounds, credited to no player.
team_reb_total integer Team rebounds (total rebounds minus the players' sum).
team_fouls integer Team (bench/coach) fouls (personal fouls minus the players' sum).
team_turnovers integer Team turnovers (turnovers minus the players' sum).
team_bench_points_flag integer Bench points in FLS games (equal to bench_points); 0 in OVR games (FIBA stat code T_PFB).
time_led character Time the team led, 'mm:ss' string.
lead_changes integer Lead changes in the game (game-level; repeats on both team rows).
times_tied integer Times the score was tied (game-level; repeats on both team rows).
duration character Game duration as an 'h:mm' string (game-level; repeats on both team rows).
attendance integer Attendance (game-level; repeats on both team rows).

fiba_elw_pbp()

The columns of fiba_gamepage_pbp():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
period character Period name: Q1..Q4, then OT1, OT2...
period_number integer 1-based position of the period in the game.
action_id character Action id (String): '⁠<n>⁠:⁠<seq>⁠' in OVR games (3:0015), a sequence number in FLS games; unique within the game.
order integer Sort key within the period (OVR: 1, 2, ...; FLS: 1000, 2000, ...); null on some period events.
clock character Game clock: time REMAINING in the period, 'm:ss', counting down from 10:00 (5:00 in overtime).
clock_seconds integer Seconds remaining in the period, derived from clock.
wall_time_ms double Wall-clock time of the action, Unix epoch milliseconds. (Int64 in sdv-py; numeric here, the values exceed R's 32-bit integer range)
score_a integer Team A score after the action.
score_b integer Team B score after the action.
action_code character Action code: P2 two-point shot, P3 three-point shot, FT free throw, REB rebound, TREB team rebound, ASS assist, ST steal, BS block, TO turnover, TTO team turnover, FOUL foul, RFOUL foul drawn, SUBST substitution, TIMO timeout, plus period events (STARTG, STARTP, ENDP, ENDG).
action_family character Action family: shot, subst, timeout, periods, and 'unknwown' (FIBA's spelling) for every other action.
description character English action text ('3pt jump shot missed', 'defensive rebound'); null on most OVR actions.
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
player2_id integer FIBA person id (Int64) of the second player on a substitution; null when the game does not record it (the refs note FLS only, but the Paris 2024 final, an OVR game, carries it and the FLS games sampled leave it null).
sub_direction character Substitution direction: IN or OUT; null on other actions.
made logical True when the shot went in (two-pointers, three-pointers and free throws only; null otherwise).
points_attempted integer Points the attempt was worth (2, 3 or 1), made or not; null on other actions.
shot_type character Shot type derived from action_code: 2PT, 3PT or FT; null on other actions.
shot_x integer Shot x, integer pixels on a half-court image across the court width (observed 0-278, basket near x = 139). Present only on shots; free throws are 0. Which sideline is x = 0 and the scale are UNVERIFIED.
shot_y integer Shot y, integer pixels from the baseline (y = 0) towards midcourt (observed 0-224, basket near y = 25); both teams' shots are drawn on one basket. Free throws are 0. Scale UNVERIFIED.
has_location logical True when shot_x / shot_y locate the shot (two- and three-pointers); False for free throws (always 0, 0); null on other actions.

fiba_elw_shots()

The columns of fiba_gamepage_shots():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
period character Period name: Q1..Q4, then OT1, OT2...
period_number integer 1-based position of the period in the game.
action_id character Action id (String): '⁠<n>⁠:⁠<seq>⁠' in OVR games (3:0015), a sequence number in FLS games; unique within the game.
order integer Sort key within the period (OVR: 1, 2, ...; FLS: 1000, 2000, ...); null on some period events.
clock character Game clock: time REMAINING in the period, 'm:ss', counting down from 10:00 (5:00 in overtime).
clock_seconds integer Seconds remaining in the period, derived from clock.
action_code character Action code: P2 two-point shot, P3 three-point shot, FT free throw, REB rebound, TREB team rebound, ASS assist, ST steal, BS block, TO turnover, TTO team turnover, FOUL foul, RFOUL foul drawn, SUBST substitution, TIMO timeout, plus period events (STARTG, STARTP, ENDP, ENDG).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
shot_type character Shot type derived from action_code: 2PT, 3PT or FT; null on other actions.
points_attempted integer Points the attempt was worth (2, 3 or 1), made or not; null on other actions.
made logical True when the shot went in (two-pointers, three-pointers and free throws only; null otherwise).
shot_x integer Shot x, integer pixels on a half-court image across the court width (observed 0-278, basket near x = 139). Present only on shots; free throws are 0. Which sideline is x = 0 and the scale are UNVERIFIED.
shot_y integer Shot y, integer pixels from the baseline (y = 0) towards midcourt (observed 0-224, basket near y = 25); both teams' shots are drawn on one basket. Free throws are 0. Scale UNVERIFIED.
has_location logical True when shot_x / shot_y locate the shot (two- and three-pointers); False for free throws (always 0, 0); null on other actions.

See Also

Other FIBA Competition Functions: fiba_ecw_competition, fiba_wafrobasket_competition, fiba_wamericup_competition, fiba_wasiacup_competition, fiba_weurobasket_competition, fiba_woly_competition, fiba_wwc_competition


FIBA GAMEPAGE: box players

Description

Player box score of one FIBA game.

Endpoint: ⁠GET https://www.fiba.basketball/en/games/{game_id}⁠

Usage

fiba_gamepage_box_players(game_id, comp, return_parsed = TRUE)

Arguments

game_id

(integer, required) FIBA game id (global): gameId of a gdap schedule row, e.g. 100720 = the World Cup 2023 final.

comp

(integer, required) Required. FIBA competition id (GDAP key space), one per edition: competition.competitionId of any game row (208182 = World Cup 2023, 208722 = Paris 2024 men, 208850 = BCL 2024-25). The game must belong to it. Find it with fiba_gdap_editions or fiba_gdap_games_between.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list (the game-page objects game, playByPlay, gameDetails, playersTeamA, playersTeamB).

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

The wrapper takes the game id and its competition (comp) and builds the real page URL from GDAP (the competition's marketing name gives the history slug, its schedule gives the two team codes; a competition with an event page is tried at its event URL when the archive URL answers the not-found shell, and the Champions League host last).

Box scores start about 2006; play-by-play with shot x/y about 2012 (OVR events) and 2017-18 (FLS club competitions). A game with no box score raises wehoop_no_data; a game still live raises wehoop_asset_fetch. The page request sends a browser User-Agent (sdv-py answers fiba.basketball's HTTP 403 to plain clients with Chrome TLS; libcurl with a browser User-Agent was served on 2026-10-18). Shot x/y are image pixels with an unverified scale.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id, a game page with no box score, a listed game whose teams are not drawn yet); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season, a game of another competition than comp, the HTTP 200 not-found shell of a wrong game page, a live game). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
first_name character Given name(s) as registered with FIBA.
last_name character Last name as registered with FIBA.
jersey character Jersey number as a string.
position character Playing position code from the lineup card (PG, SG, SF, PF, C).
is_captain logical True for the team captain.
is_starter logical True for the starting five.
has_played logical True when the player got on the court.
minutes character Minutes played as an 'm:ss' string ('0:0' = did not play).
seconds_played integer Seconds played, derived from minutes.
points integer Points scored in the game.
fg_made integer Field goals made (2 + 3 points).
fg_attempted integer Field goals attempted (2 + 3 points).
fg_pct double Field-goal percentage, 0-100.
fg2_made integer Two-point field goals made.
fg2_attempted integer Two-point field goals attempted.
fg2_pct double Two-point field-goal percentage, 0-100.
fg3_made integer Three-point field goals made.
fg3_attempted integer Three-point field goals attempted.
fg3_pct double Three-point field-goal percentage, 0-100.
ft_made integer Free throws made.
ft_attempted integer Free throws attempted.
ft_pct double Free-throw percentage, 0-100.
reb_offensive integer Offensive rebounds.
reb_defensive integer Defensive rebounds.
reb_total integer Total rebounds (a team row includes the team rebounds team_reb_total).
assists integer Assists credited in the game.
steals integer Steals credited in the game.
blocks integer Blocked shots (blocks made).
blocks_received integer Own shots blocked by the opponent (blocks received).
turnovers integer Turnovers (a team row includes the team turnovers team_turnovers).
fouls integer Personal fouls (a team row includes the team fouls team_fouls).
fouls_drawn integer Fouls drawn in the game.
paint_fg_made integer Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game).
paint_fg_attempted integer Field goals attempted in the paint.
paint_fg_pct double Field-goal percentage in the paint, 0-100.
efficiency integer Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers).
plus_minus integer Plus/minus: the team's point differential while the player was on the court.
cb logical Boolean flag, false on every sampled player; meaning unverified.

See Also

Other FIBA Functions: fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()

Examples

try(fiba_gamepage_box_players(game_id = 100720, comp = 208182))

FIBA GAMEPAGE: box teams

Description

Team box score of one FIBA game, with the game-level figures.

Endpoint: ⁠GET https://www.fiba.basketball/en/games/{game_id}⁠

Usage

fiba_gamepage_box_teams(game_id, comp, return_parsed = TRUE)

Arguments

game_id

(integer, required) FIBA game id (global): gameId of a gdap schedule row, e.g. 100720 = the World Cup 2023 final.

comp

(integer, required) Required. FIBA competition id (GDAP key space), one per edition: competition.competitionId of any game row (208182 = World Cup 2023, 208722 = Paris 2024 men, 208850 = BCL 2024-25). The game must belong to it. Find it with fiba_gdap_editions or fiba_gdap_games_between.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list (the game-page objects game, playByPlay, gameDetails, playersTeamA, playersTeamB).

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

The wrapper takes the game id and its competition (comp) and builds the real page URL from GDAP (the competition's marketing name gives the history slug, its schedule gives the two team codes; a competition with an event page is tried at its event URL when the archive URL answers the not-found shell, and the Champions League host last).

Box scores start about 2006; play-by-play with shot x/y about 2012 (OVR events) and 2017-18 (FLS club competitions). A game with no box score raises wehoop_no_data; a game still live raises wehoop_asset_fetch. The page request sends a browser User-Agent (sdv-py answers fiba.basketball's HTTP 403 to plain clients with Chrome TLS; libcurl with a browser User-Agent was served on 2026-10-18). Shot x/y are image pixels with an unverified scale.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id, a game page with no box score, a listed game whose teams are not drawn yet); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season, a game of another competition than comp, the HTTP 200 not-found shell of a wrong game page, a live game). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
score integer Team final score.
points integer Points scored in the game.
fg_made integer Field goals made (2 + 3 points).
fg_attempted integer Field goals attempted (2 + 3 points).
fg_pct double Field-goal percentage, 0-100.
fg2_made integer Two-point field goals made.
fg2_attempted integer Two-point field goals attempted.
fg2_pct double Two-point field-goal percentage, 0-100.
fg3_made integer Three-point field goals made.
fg3_attempted integer Three-point field goals attempted.
fg3_pct double Three-point field-goal percentage, 0-100.
ft_made integer Free throws made.
ft_attempted integer Free throws attempted.
ft_pct double Free-throw percentage, 0-100.
reb_offensive integer Offensive rebounds.
reb_defensive integer Defensive rebounds.
reb_total integer Total rebounds (a team row includes the team rebounds team_reb_total).
assists integer Assists credited in the game.
steals integer Steals credited in the game.
blocks integer Blocked shots (blocks made).
blocks_received integer Own shots blocked by the opponent (blocks received).
turnovers integer Turnovers (a team row includes the team turnovers team_turnovers).
fouls integer Personal fouls (a team row includes the team fouls team_fouls).
fouls_drawn integer Fouls drawn in the game.
paint_fg_made integer Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game).
paint_fg_attempted integer Field goals attempted in the paint.
paint_fg_pct double Field-goal percentage in the paint, 0-100.
efficiency integer Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers).
biggest_lead integer Biggest lead, points.
biggest_lead_score character Score when the biggest lead was reached, 'A-B' string (spacing varies; empty when the team never led).
biggest_run integer Biggest scoring run, points.
biggest_run_score character Score of the biggest scoring run, 'x-y' string; exact meaning unverified.
fast_break_points integer Fast-break points.
points_off_turnovers integer Points scored after turnovers.
bench_points integer Points from the bench (the sum of the non-starters' points).
points_in_paint integer Points in the paint (2 x paint_fg_made).
second_chance_points integer Second-chance points.
a_act integer Always 0 in the samples; meaning unverified (FIBA stat code A_ACT).
a_foul integer Always 0 in the samples; meaning unverified (FIBA stat code A_FOUL).
a_tod integer Always 0 in the samples; meaning unverified (FIBA stat code A_TOD).
a_tot integer Always 0 in the samples; meaning unverified (FIBA stat code A_TOT).
team_reb_offensive integer Team offensive rebounds, credited to no player.
team_reb_defensive integer Team defensive rebounds, credited to no player.
team_reb_total integer Team rebounds (total rebounds minus the players' sum).
team_fouls integer Team (bench/coach) fouls (personal fouls minus the players' sum).
team_turnovers integer Team turnovers (turnovers minus the players' sum).
team_bench_points_flag integer Bench points in FLS games (equal to bench_points); 0 in OVR games (FIBA stat code T_PFB).
time_led character Time the team led, 'mm:ss' string.
lead_changes integer Lead changes in the game (game-level; repeats on both team rows).
times_tied integer Times the score was tied (game-level; repeats on both team rows).
duration character Game duration as an 'h:mm' string (game-level; repeats on both team rows).
attendance integer Attendance (game-level; repeats on both team rows).

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()

Examples

try(fiba_gamepage_box_teams(game_id = 100720, comp = 208182))

FIBA GAMEPAGE: lineup

Description

Lineup card (the players who were registered for the game) of both teams of one FIBA game.

Endpoint: ⁠GET https://www.fiba.basketball/en/games/{game_id}⁠

Usage

fiba_gamepage_lineup(game_id, comp, return_parsed = TRUE)

Arguments

game_id

(integer, required) FIBA game id (global): gameId of a gdap schedule row, e.g. 100720 = the World Cup 2023 final.

comp

(integer, required) Required. FIBA competition id (GDAP key space), one per edition: competition.competitionId of any game row (208182 = World Cup 2023, 208722 = Paris 2024 men, 208850 = BCL 2024-25). The game must belong to it. Find it with fiba_gdap_editions or fiba_gdap_games_between.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list (the game-page objects game, playByPlay, gameDetails, playersTeamA, playersTeamB).

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

The wrapper takes the game id and its competition (comp) and builds the real page URL from GDAP (the competition's marketing name gives the history slug, its schedule gives the two team codes; a competition with an event page is tried at its event URL when the archive URL answers the not-found shell, and the Champions League host last).

Box scores start about 2006; play-by-play with shot x/y about 2012 (OVR events) and 2017-18 (FLS club competitions). A game with no box score raises wehoop_no_data; a game still live raises wehoop_asset_fetch. The page request sends a browser User-Agent (sdv-py answers fiba.basketball's HTTP 403 to plain clients with Chrome TLS; libcurl with a browser User-Agent was served on 2026-10-18). Shot x/y are image pixels with an unverified scale.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id, a game page with no box score, a listed game whose teams are not drawn yet); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season, a game of another competition than comp, the HTTP 200 not-found shell of a wrong game page, a live game). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

 fiba_gamepage_lineup(game_id = 100720, comp = 208182)

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
first_name character Given name(s) as registered with FIBA.
last_name character Last name as registered with FIBA.
jersey character Jersey number as a string.
position character Playing position code from the lineup card (PG, SG, SF, PF, C).
is_captain logical True for the team captain.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()


FIBA GAMEPAGE: pbp

Description

Play-by-play of one FIBA game: every action with period, clock, running score, actor and shot x/y.

Endpoint: ⁠GET https://www.fiba.basketball/en/games/{game_id}⁠

Usage

fiba_gamepage_pbp(game_id, comp, return_parsed = TRUE)

Arguments

game_id

(integer, required) FIBA game id (global): gameId of a gdap schedule row, e.g. 100720 = the World Cup 2023 final.

comp

(integer, required) Required. FIBA competition id (GDAP key space), one per edition: competition.competitionId of any game row (208182 = World Cup 2023, 208722 = Paris 2024 men, 208850 = BCL 2024-25). The game must belong to it. Find it with fiba_gdap_editions or fiba_gdap_games_between.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list (the game-page objects game, playByPlay, gameDetails, playersTeamA, playersTeamB).

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

The wrapper takes the game id and its competition (comp) and builds the real page URL from GDAP (the competition's marketing name gives the history slug, its schedule gives the two team codes; a competition with an event page is tried at its event URL when the archive URL answers the not-found shell, and the Champions League host last).

Box scores start about 2006; play-by-play with shot x/y about 2012 (OVR events) and 2017-18 (FLS club competitions). A game with no box score raises wehoop_no_data; a game still live raises wehoop_asset_fetch. The page request sends a browser User-Agent (sdv-py answers fiba.basketball's HTTP 403 to plain clients with Chrome TLS; libcurl with a browser User-Agent was served on 2026-10-18). Shot x/y are image pixels with an unverified scale.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id, a game page with no box score, a listed game whose teams are not drawn yet); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season, a game of another competition than comp, the HTTP 200 not-found shell of a wrong game page, a live game). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
period character Period name: Q1..Q4, then OT1, OT2...
period_number integer 1-based position of the period in the game.
action_id character Action id (String): '⁠<n>⁠:⁠<seq>⁠' in OVR games (3:0015), a sequence number in FLS games; unique within the game.
order integer Sort key within the period (OVR: 1, 2, ...; FLS: 1000, 2000, ...); null on some period events.
clock character Game clock: time REMAINING in the period, 'm:ss', counting down from 10:00 (5:00 in overtime).
clock_seconds integer Seconds remaining in the period, derived from clock.
wall_time_ms double Wall-clock time of the action, Unix epoch milliseconds. (Int64 in sdv-py; numeric here, the values exceed R's 32-bit integer range)
score_a integer Team A score after the action.
score_b integer Team B score after the action.
action_code character Action code: P2 two-point shot, P3 three-point shot, FT free throw, REB rebound, TREB team rebound, ASS assist, ST steal, BS block, TO turnover, TTO team turnover, FOUL foul, RFOUL foul drawn, SUBST substitution, TIMO timeout, plus period events (STARTG, STARTP, ENDP, ENDG).
action_family character Action family: shot, subst, timeout, periods, and 'unknwown' (FIBA's spelling) for every other action.
description character English action text ('3pt jump shot missed', 'defensive rebound'); null on most OVR actions.
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
player2_id integer FIBA person id (Int64) of the second player on a substitution; null when the game does not record it (the refs note FLS only, but the Paris 2024 final, an OVR game, carries it and the FLS games sampled leave it null).
sub_direction character Substitution direction: IN or OUT; null on other actions.
made logical True when the shot went in (two-pointers, three-pointers and free throws only; null otherwise).
points_attempted integer Points the attempt was worth (2, 3 or 1), made or not; null on other actions.
shot_type character Shot type derived from action_code: 2PT, 3PT or FT; null on other actions.
shot_x integer Shot x, integer pixels on a half-court image across the court width (observed 0-278, basket near x = 139). Present only on shots; free throws are 0. Which sideline is x = 0 and the scale are UNVERIFIED.
shot_y integer Shot y, integer pixels from the baseline (y = 0) towards midcourt (observed 0-224, basket near y = 25); both teams' shots are drawn on one basket. Free throws are 0. Scale UNVERIFIED.
has_location logical True when shot_x / shot_y locate the shot (two- and three-pointers); False for free throws (always 0, 0); null on other actions.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()

Examples

try(fiba_gamepage_pbp(game_id = 100720, comp = 208182))

FIBA GAMEPAGE: period scores

Description

Points by period of both teams of one FIBA game.

Endpoint: ⁠GET https://www.fiba.basketball/en/games/{game_id}⁠

Usage

fiba_gamepage_period_scores(game_id, comp, return_parsed = TRUE)

Arguments

game_id

(integer, required) FIBA game id (global): gameId of a gdap schedule row, e.g. 100720 = the World Cup 2023 final.

comp

(integer, required) Required. FIBA competition id (GDAP key space), one per edition: competition.competitionId of any game row (208182 = World Cup 2023, 208722 = Paris 2024 men, 208850 = BCL 2024-25). The game must belong to it. Find it with fiba_gdap_editions or fiba_gdap_games_between.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list (the game-page objects game, playByPlay, gameDetails, playersTeamA, playersTeamB).

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

The wrapper takes the game id and its competition (comp) and builds the real page URL from GDAP (the competition's marketing name gives the history slug, its schedule gives the two team codes; a competition with an event page is tried at its event URL when the archive URL answers the not-found shell, and the Champions League host last).

Box scores start about 2006; play-by-play with shot x/y about 2012 (OVR events) and 2017-18 (FLS club competitions). A game with no box score raises wehoop_no_data; a game still live raises wehoop_asset_fetch. The page request sends a browser User-Agent (sdv-py answers fiba.basketball's HTTP 403 to plain clients with Chrome TLS; libcurl with a browser User-Agent was served on 2026-10-18). Shot x/y are image pixels with an unverified scale.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id, a game page with no box score, a listed game whose teams are not drawn yet); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season, a game of another competition than comp, the HTTP 200 not-found shell of a wrong game page, a live game). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
period character Period name: Q1..Q4, then OT1, OT2...
period_number integer 1-based position of the period in the game.
points integer Points the team scored in the period.
points_first_five_min integer Points the team scored in the first five minutes of the period (matches the play-by-play except free throws on the 5:00 boundary); null when absent.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()

Examples

try(fiba_gamepage_period_scores(game_id = 100720, comp = 208182))

FIBA GAMEPAGE: shots

Description

Shot attempts of one FIBA game (two- and three-pointers and free throws) with their x/y.

Endpoint: ⁠GET https://www.fiba.basketball/en/games/{game_id}⁠

Usage

fiba_gamepage_shots(game_id, comp, return_parsed = TRUE)

Arguments

game_id

(integer, required) FIBA game id (global): gameId of a gdap schedule row, e.g. 100720 = the World Cup 2023 final.

comp

(integer, required) Required. FIBA competition id (GDAP key space), one per edition: competition.competitionId of any game row (208182 = World Cup 2023, 208722 = Paris 2024 men, 208850 = BCL 2024-25). The game must belong to it. Find it with fiba_gdap_editions or fiba_gdap_games_between.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list (the game-page objects game, playByPlay, gameDetails, playersTeamA, playersTeamB).

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

The wrapper takes the game id and its competition (comp) and builds the real page URL from GDAP (the competition's marketing name gives the history slug, its schedule gives the two team codes; a competition with an event page is tried at its event URL when the archive URL answers the not-found shell, and the Champions League host last).

Box scores start about 2006; play-by-play with shot x/y about 2012 (OVR events) and 2017-18 (FLS club competitions). A game with no box score raises wehoop_no_data; a game still live raises wehoop_asset_fetch. The page request sends a browser User-Agent (sdv-py answers fiba.basketball's HTTP 403 to plain clients with Chrome TLS; libcurl with a browser User-Agent was served on 2026-10-18). Shot x/y are image pixels with an unverified scale.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id, a game page with no box score, a listed game whose teams are not drawn yet); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season, a game of another competition than comp, the HTTP 200 not-found shell of a wrong game page, a live game). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
period character Period name: Q1..Q4, then OT1, OT2...
period_number integer 1-based position of the period in the game.
action_id character Action id (String): '⁠<n>⁠:⁠<seq>⁠' in OVR games (3:0015), a sequence number in FLS games; unique within the game.
order integer Sort key within the period (OVR: 1, 2, ...; FLS: 1000, 2000, ...); null on some period events.
clock character Game clock: time REMAINING in the period, 'm:ss', counting down from 10:00 (5:00 in overtime).
clock_seconds integer Seconds remaining in the period, derived from clock.
action_code character Action code: P2 two-point shot, P3 three-point shot, FT free throw, REB rebound, TREB team rebound, ASS assist, ST steal, BS block, TO turnover, TTO team turnover, FOUL foul, RFOUL foul drawn, SUBST substitution, TIMO timeout, plus period events (STARTG, STARTP, ENDP, ENDG).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
shot_type character Shot type derived from action_code: 2PT, 3PT or FT; null on other actions.
points_attempted integer Points the attempt was worth (2, 3 or 1), made or not; null on other actions.
made logical True when the shot went in (two-pointers, three-pointers and free throws only; null otherwise).
shot_x integer Shot x, integer pixels on a half-court image across the court width (observed 0-278, basket near x = 139). Present only on shots; free throws are 0. Which sideline is x = 0 and the scale are UNVERIFIED.
shot_y integer Shot y, integer pixels from the baseline (y = 0) towards midcourt (observed 0-224, basket near y = 25); both teams' shots are drawn on one basket. Free throws are 0. Scale UNVERIFIED.
has_location logical True when shot_x / shot_y locate the shot (two- and three-pointers); False for free throws (always 0, 0); null on other actions.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()

Examples

try(fiba_gamepage_shots(game_id = 100720, comp = 208182))

FIBA GDAP: awards

Description

Awards of a competition (MVP, All-Star Five...).

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapcompetitionawardsbyid⁠

Usage

fiba_gdap_awards(comp, discipline_format = NULL, return_parsed = TRUE)

Arguments

comp

(integer, required) Required. FIBA competition id (GDAP key space), one per edition: competition.competitionId of any game row (208182 = World Cup 2023, 208722 = Paris 2024 men, 208850 = BCL 2024-25). Find it with fiba_gdap_editions or fiba_gdap_games_between.

discipline_format

(character, optional) Optional; the site passes its discipline format. 5x5 answers the same as omitting it (verified on awards and rosters)

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

 fiba_gdap_awards(comp = 208182)

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_end_date character Last day of the competition, YYYY-MM-DD.
award_date character Date awarded, YYYY-MM-DD.
competition_season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
competition_official_name character Official name of the competition edition the award was given in.
award_name character Award name (All-Star 5, MVP...).
award_code character Award code (ALLSTAR, MVP...).
award_level_id integer Id of the object the award is attached to: the competitionId when awardLevel is Competition.
award_level character Level the award is given at: Competition.
award_label character Extra label; null in every sample.
player_id integer FIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_⁠<id>⁠ = gdapPlayerId.
player_first_name character Awarded player's first name.
player_last_name character Awarded player's last name.
player_date_of_birth character Awarded player's date of birth, YYYY-MM-DD.
player_nationality character Awarded player's nationality, FIBA code.
teams character Teams the awarded player played for in the competition. Stored as a JSON string.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()


FIBA GDAP: competition

Description

One competition (edition): season, dates, hosts, zone, category and competition family.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getGdapCompetitionById⁠

Usage

fiba_gdap_competition(comp, return_parsed = TRUE)

Arguments

comp

(integer, required) Required. FIBA competition id (GDAP key space), one per edition: competition.competitionId of any game row (208182 = World Cup 2023, 208722 = Paris 2024 men, 208850 = BCL 2024-25). Find it with fiba_gdap_editions or fiba_gdap_games_between.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
hosts character Host countries with their cities. Stored as a JSON string.
competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_code character Competition code (WMM men's World Cup, WOLYM, BCL, ELW...).
season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
official_name character Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
start character First day, YYYY-MM-DD.
end character Last day, YYYY-MM-DD.
status character Competition status: In Progress, Completed, Closed.
age_category character Age category (Senior, Under 16...).
gender character Men or Women: the gender of the competition.
fiba_zone character FIBA zone the competition belongs to (World, Europe, Americas...).
zone_information_zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
zone_information_zone_official_name character Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
zone_information_zone_code character Zone code (W, E, AF, AM, AS, OC).
zone_information_top_zone_id integer Parent zone id; null for top zones.
zone_information_top_zone_official_name character Parent zone name; always null in the samples, values unverified.
zone_information_top_zone_code character Parent zone code; always null in the samples, values unverified.
competition_type character National Teams or Clubs.
competition_category_is_league logical True for league-format club competitions.
competition_category_age_type character Age type code: S senior, U16.
competition_category_code character Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_category_name character Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
official_flag_item_code character Official-status code: O = official.
official_flag_item_name character Official-status label.
official character Official-status label.
discipline character Discipline (Basketball; 3x3 is a separate platform).
competition_marketing_name_competition_marketing_name_id integer Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the ⁠<histId>⁠ of /en/history/ pages.
competition_marketing_name_marketing_name character Competition family name; slugified it is the ⁠<histSlug>⁠ of /en/history/ pages.
competition_marketing_name_code character Family code; null in every sample.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()

Examples

try(fiba_gdap_competition(comp = 208182))

FIBA GDAP: editions

Description

Every edition of a competition family between two seasons.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapcompetitionsbyseasonsandcompetitionmarketingname⁠

Usage

fiba_gdap_editions(
  family_id,
  season = NULL,
  to_season = NULL,
  return_parsed = TRUE
)

Arguments

family_id

(integer, required) Required. Competition family id (competitionMarketingName.competitionMarketingNameId): 201 = World Cup, 320 = men's Olympics, 306 = Women's World Cup, 112 = BCL tier 1, 211 = EuroLeague Women.

season

(integer, optional) Season key: the END year for club competitions (BCL 2024-25 = 2025), the event year for national-team events (World Cup 2023 = 2023); qualifiers carry the TARGET tournament year (World Cup 2027 qualifiers played in 2025 = 2027). Sent unchanged. First season, inclusive; omitted = no lower bound.

to_season

(integer, optional) Last season, inclusive (same key as season). Omitted with season given = the same season.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
hosts character Host countries with their cities. Stored as a JSON string.
competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_code character Competition code (WMM men's World Cup, WOLYM, BCL, ELW...).
season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
official_name character Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
start character First day, YYYY-MM-DD.
end character Last day, YYYY-MM-DD.
status character Competition status: In Progress, Completed, Closed.
age_category character Age category (Senior, Under 16...).
gender character Men or Women: the gender of the competition.
fiba_zone character FIBA zone the competition belongs to (World, Europe, Americas...).
zone_information_zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
zone_information_zone_official_name character Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
zone_information_zone_code character Zone code (W, E, AF, AM, AS, OC).
zone_information_top_zone_id integer Parent zone id; null for top zones.
zone_information_top_zone_official_name character Parent zone name; always null in the samples, values unverified.
zone_information_top_zone_code character Parent zone code; always null in the samples, values unverified.
competition_type character National Teams or Clubs.
competition_category_is_league logical True for league-format club competitions.
competition_category_age_type character Age type code: S senior, U16.
competition_category_code character Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_category_name character Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
official_flag_item_code character Official-status code: O = official.
official_flag_item_name character Official-status label.
official character Official-status label.
discipline character Discipline (Basketball; 3x3 is a separate platform).
competition_marketing_name_competition_marketing_name_id integer Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the ⁠<histId>⁠ of /en/history/ pages.
competition_marketing_name_marketing_name character Competition family name; slugified it is the ⁠<histSlug>⁠ of /en/history/ pages.
competition_marketing_name_code character Family code; null in every sample.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()

Examples

try(fiba_gdap_editions(family_id = 201, season = 2023))

FIBA GDAP: federation games

Description

A federation's recent and upcoming national-team games.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapfederationgamesbyfederationid⁠

Usage

fiba_gdap_federation_games(federation_id, return_parsed = TRUE)

Arguments

federation_id

(integer, required) Required. Federation organisationId, stable across competitions (64 = Germany; teamA.organisationId)

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

 fiba_gdap_federation_games(federation_id = 64)

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
game_id integer FIBA game id, global across competitions (GDAP key space): gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
game_name character Technical game name '⁠<roundId>⁠-⁠<groupPairingCode>⁠-⁠<gameNumber>⁠'.
game_number character Game number within the round or pairing (a string: '1', 'A').
status_code character Game status code: VALID (validated result), CLOS (closed, pre-2000 rows).
team_a_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_a_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_a_code character Team code (national: FIBA country code; club: a club abbreviation such as OOST).
team_a_official_name character Official name of team A: the country for a national team, the club for a club team.
team_a_short_name character Short name of team A: the country code for a national team, the club's short name for a club.
team_b_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_b_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_b_code character Team code (national: FIBA country code; club: a club abbreviation such as NANT).
team_b_official_name character Official name of team B: the country for a national team, the club for a club team.
team_b_short_name character Short name of team B: the country code for a national team, the club's short name for a club.
team_a_score integer Final score of team A.
team_b_score integer Final score of team B.
is_live logical True while the game is being played.
current_period character Last period reached ('Q4', 'OT1').
chrono character Game clock of the current period, 'mm:ss' ('00:00' when finished).
live_game_status integer Live state code: 999 on every finished game; 5 seen on a finished 2024 youth game; mapping unverified.
current_period_status character State of the current period: E = ended (the only value sampled).
host_city character City of the venue.
host_country character Country of the venue (name; a FIBA code in getgdapgameswithleaderdetailsbyteamid).
host_country_code character FIBA code of the venue's country.
venue_id integer Venue id (GDAP key space; 0 = unknown).
venue_name character Name of the arena the game is played in.
game_date_time character Tip-off in venue-local wall-clock time, ISO 8601 without offset (T00:00:00 when hasTimeGameDateTime is false).
game_date_time_utc character Tip-off in UTC, ISO 8601 without the Z.
has_time_game_date_time logical False when only the date is known (the time part is then 00:00:00).
iana_time_zone character IANA time zone of the venue.
utc_offset double Venue UTC offset at tip-off, in hours (Float64: a half-hour zone such as India +5.5 or Adelaide +9.5 is a fraction; whole hours in every sample).
is_postponed logical True when the game was postponed.
is_played_behind_closed_doors logical True when played without spectators.
venue_capacity integer Venue capacity (0 = unknown).
spectators integer Attendance at the game, as recorded by FIBA.
statistic_system character Live-stats system that scored the game: OVR (FIBA's Olympic/World Cup system), FLS (FIBA LiveStats), null before about 2006.
group_id character Group id (GDAP key space).
group_pairing_code character Group letter (group play) or pairing number (knockout bracket slot).
round_round_id integer Round id (GDAP key space, unique across competitions); the first segment of gameName.
round_round_code character Round code (GP group phase, QF, SF, F final, RS regular season, CL17-32 classification...).
round_round_name character Round label (Group Phase, Quarter-Finals, Final...).
round_round_number integer Round number within the competition (1-based).
round_round_type character Round type label: Group Round, Non Group Round, Super Round (getgdapgamesbycompetitionid uses the code G/NG here).
round_round_status_code character Round status: COMPL completed, PROGR in progress, CLOS closed.
round_game_system character Pairing system label (Single, Home and Away, Best of 3).
round_game_system_code character Pairing system code: S single game, HA home and away, BOF3 best of three.
round_start_date character Round start, local date-time.
round_end_date character Round end, local date-time (23:59:59.9999999 on the last day).
round_round_kind character Standard Round or Qualifiers.
round_round_order integer Display order of the round.
competition_competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_competition_code character Competition code (WMM men's World Cup, WOLYM, BCL, ELW...).
competition_season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
competition_official_name character Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
competition_start character First day, YYYY-MM-DD.
competition_end character Last day, YYYY-MM-DD.
competition_status character Competition status: In Progress, Completed, Closed.
competition_age_category character Age category (Senior, Under 16...).
competition_gender character Men or Women: the gender of the competition.
competition_fiba_zone character FIBA zone the competition belongs to (World, Europe, Americas...).
competition_zone_information_zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
competition_zone_information_zone_official_name character Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
competition_zone_information_zone_code character Zone code (W, E, AF, AM, AS, OC).
competition_zone_information_top_zone_id integer Parent zone id; null for top zones.
competition_zone_information_top_zone_official_name character Parent zone name; always null in the samples, values unverified.
competition_zone_information_top_zone_code character Parent zone code; always null in the samples, values unverified.
competition_competition_type character National Teams or Clubs.
competition_competition_category_is_league logical True for league-format club competitions.
competition_competition_category_age_type character Age type code: S senior, U16.
competition_competition_category_code character Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_competition_category_name character Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
competition_official_flag_item_code character Official-status code: O = official.
competition_official_flag_item_name character Official-status label.
competition_official character Official-status label.
competition_discipline character Discipline (Basketball; 3x3 is a separate platform).
competition_competition_marketing_name character Competition family, shared by every edition; always null in the samples, values unverified.
game_statistic_status_code character Box-score validation status: VALID.
game_play_by_play_status_code character Play-by-play availability flag: VALID or EMPTY. UNRELIABLE: World Cup 2014 and EuroBasket 2017 say EMPTY but their game pages carry full play-by-play; always check the page.
game_result_status_code character Result validation status: VALID.
game_result_additional_information character Free-text result note (forfeit, overtime remark); null when none.
window_code character Qualifier window code; null otherwise.
window_name character Qualifier window name; null otherwise.
team_a_from character How team A qualified for this slot ('Winner of Game 87', '1st of group C'); null in group play.
team_b_from character How team B qualified for this slot ('Winner of Game 88', '2nd of group A'); null in group play.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()


FIBA GDAP: federation ranking

Description

FIBA world ranking of national teams.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapfederationsranking⁠

Usage

fiba_gdap_federation_ranking(
  category = "women",
  zone_id = 1L,
  as_of_date = NULL,
  return_parsed = TRUE
)

Arguments

category

(character, default "women" in wehoop; sdv-py and hoopR default "men") Ranking category: men or women (the site also knows boys/girls)

zone_id

(integer, default 1L) Ranking zone id from getgdaprankingzones (1 = World, 2 = Africa, 3 = Americas, 4 = Asia, 5 = Europe)

as_of_date

(character, optional) Ranking as of this date, ISO 8601: the latest ranking published on or before it (2026-03-10 answers the 2026-03-03 ranking). Omitted = the latest ranking

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

 fiba_gdap_federation_ranking(category = "women", zone_id = 1, as_of_date = "2025-09-15")

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
as_of_date character Date of the ranking returned: the latest ranking published on or before the requested date.
zone_ranking_code character Ranking zone code (WORLD, AFRICA...).
zone_ranking_official_name character Ranking zone official name.
world_rank integer Position in the FIBA world ranking (1 = best).
country_name character Country name in English.
zone_rank integer Rank within the zone.
ioc_code character IOC country code.
fiba_code character FIBA three-letter country code (GER, USA; historic URS, YUG).
current_points double Ranking points (one decimal).
world_rank_variation integer Change in world rank since the previous release (positive = up).
comments character Ranking note; null in every sample.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()


FIBA GDAP: final standings

Description

Final ranking of a competition.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapcompetitionfinalstandingbycompetitionid⁠

Usage

fiba_gdap_final_standings(comp, return_parsed = TRUE)

Arguments

comp

(integer, required) Required. FIBA competition id (GDAP key space), one per edition: competition.competitionId of any game row (208182 = World Cup 2023, 208722 = Paris 2024 men, 208850 = BCL 2024-25). Find it with fiba_gdap_editions or fiba_gdap_games_between.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
competition_id integer FIBA competition id (Int64) the final ranking belongs to; the comp argument.
final_rank integer Final rank in the competition.
team_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_team_code character Team abbreviation (FIBA country code or club abbreviation).
team_short_name character Short team name: the country code for a national team, the club's short name for a club.
team_profile character Team profile; null in this route.
team_status_code character Team entry status; always null in the samples, values unverified.
team_status_name character Team entry status label; always null in the samples, values unverified.
team_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()

Examples

try(fiba_gdap_final_standings(comp = 208182))

FIBA GDAP: game

Description

One game's header: teams, score, venue, attendance and status codes (no box score or play-by-play: see fiba_gamepage).

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapgamebyid⁠

Usage

fiba_gdap_game(game_id, return_parsed = TRUE)

Arguments

game_id

(integer, required) Required. FIBA game id (global GDAP key space): gameId of a schedule row; the ⁠<gameId>⁠ of a game page URL

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
game_id integer FIBA game id, global across competitions (GDAP key space): gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
round_name character Round label (Group Phase, Quarter-Finals, Final...).
technical_name character Technical game name '⁠<roundId>⁠-⁠<groupPairingCode>⁠-⁠<gameNumber>⁠'.
round_type character Round type label: Group Round, Non Group Round, Super Round (getgdapgamesbycompetitionid uses the code G/NG here).
group_pairing_code character Group letter (group play) or pairing number (knockout bracket slot).
game_number character Game number within the round or pairing (a string: '1', 'A').
status_code character Game status code: VALID (validated result), CLOS (closed, pre-2000 rows).
game_day integer Game day number within the round.
team_a_from character How team A qualified for this slot ('Winner of Game 87', '1st of group C'); null in group play.
team_b_from character How team B qualified for this slot ('Winner of Game 88', '2nd of group A'); null in group play.
team_a_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_a_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_a_code character Team code (national: FIBA country code; club: a club abbreviation such as OOST).
team_a_official_name character Official name of team A: the country for a national team, the club for a club team.
team_a_short_name character Short name of team A: the country code for a national team, the club's short name for a club.
team_b_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_b_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_b_code character Team code (national: FIBA country code; club: a club abbreviation such as NANT).
team_b_official_name character Official name of team B: the country for a national team, the club for a club team.
team_b_short_name character Short name of team B: the country code for a national team, the club's short name for a club.
team_a_score integer Final score of team A.
team_b_score integer Final score of team B.
team_a_aggregated_score integer Two-leg aggregate score of team A (0 when not a two-leg tie).
team_b_aggregated_score integer Two-leg aggregate score of team B (0 when not a two-leg tie).
host_city character City of the venue.
host_country character Country of the venue (name; a FIBA code in getgdapgameswithleaderdetailsbyteamid).
host_country_code character FIBA code of the venue's country.
venue_id integer Venue id (GDAP key space; 0 = unknown).
venue_name character Name of the arena the game is played in.
game_date_time character Tip-off in venue-local wall-clock time, ISO 8601 without offset (T00:00:00 when hasTimeGameDateTime is false).
game_date_time_utc character Tip-off in UTC, ISO 8601 without the Z.
has_time_game_date_time logical False when only the date is known (the time part is then 00:00:00).
iana_time_zone character IANA time zone of the venue.
utc_offset double Venue UTC offset at tip-off, in hours (Float64: a half-hour zone such as India +5.5 or Adelaide +9.5 is a fraction; whole hours in every sample).
is_postponed logical True when the game was postponed.
is_played_behind_closed_doors logical True when played without spectators.
venue_capacity integer Venue capacity (0 = unknown).
spectators integer Attendance at the game, as recorded by FIBA.
is_live logical True while the game is being played.
current_period character Last period reached ('Q4', 'OT1').
chrono character Game clock of the current period, 'mm:ss' ('00:00' when finished).
live_game_status integer Live state code: 999 on every finished game; 5 seen on a finished 2024 youth game; mapping unverified.
current_period_status character State of the current period: E = ended (the only value sampled).
game_statistic_status_code character Box-score validation status: VALID.
game_play_by_play_status_code character Play-by-play availability flag: VALID or EMPTY. UNRELIABLE: World Cup 2014 and EuroBasket 2017 say EMPTY but their game pages carry full play-by-play; always check the page.
game_result_status_code character Result validation status: VALID.
game_result_additional_information character Free-text result note (forfeit, overtime remark); null when none.
window_id integer Qualifier window id; null otherwise.
window_code character Qualifier window code; null otherwise.
window_name character Qualifier window name; null otherwise.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()

Examples

try(fiba_gdap_game(game_id = 100720))

FIBA GDAP: game officials

Description

Officials nominated to one game (referees, table officials, commissioner).

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapgamebyid⁠

Usage

fiba_gdap_game_officials(game_id, return_parsed = TRUE)

Arguments

game_id

(integer, required) Required. FIBA game id (global GDAP key space): gameId of a schedule row; the ⁠<gameId>⁠ of a game page URL

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

 fiba_gdap_game_officials(game_id = 100720)

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
game_id integer FIBA game id (Int64) of the game the official was nominated to.
person_id integer FIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_⁠<id>⁠ = gdapPlayerId.
first_name character Given name(s) as registered with FIBA.
last_name character Last name (officials: upper case).
gender character Sex of the person: M or F (Male/Female on getgdapcompetitionnominationsbyid).
role_code character Role code (REF, FIBATDEL...).
role_name character Role name on the game (Crew chief, Umpire, Commissioner, Assistant scorer...).
role_order character Order within the role; a numeric string or null.
default_nationality character FIBA code of the official's main nationality.
license_nationality character FIBA code of the federation that licenses the official.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()


FIBA GDAP: game periods

Description

Period scores of one game.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapgamebyid⁠

Usage

fiba_gdap_game_periods(game_id, return_parsed = TRUE)

Arguments

game_id

(integer, required) Required. FIBA game id (global GDAP key space): gameId of a schedule row; the ⁠<gameId>⁠ of a game page URL

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
game_id integer FIBA game id (Int64) of the game the period belongs to.
name character Period name ('Q1'...'OT1').
number integer Period number (1-based).
team_a_score integer Team A points in the period.
team_b_score integer Team B points in the period.
team_a_from character How team A qualified for this slot ('Winner of Game 87', '1st of group C'); null in group play.
team_b_from character How team B qualified for this slot ('Winner of Game 88', '2nd of group A'); null in group play.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()

Examples

try(fiba_gdap_game_periods(game_id = 100720))

FIBA GDAP: games between

Description

Games of EVERY FIBA competition in a local-time window (how competitions and games are discovered).

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapgamesbetweentwodates⁠

Usage

fiba_gdap_games_between(date_from, date_to, return_parsed = TRUE)

Arguments

date_from

(character, required) Required. Window start as YYYY-MM-DD, compared with the venue-local gameDateTime (not UTC).

date_to

(character, required) Required. Window end as YYYY-MM-DD, EXCLUSIVE (date_from = date_to returns nothing).

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

 fiba_gdap_games_between(date_from = "2023-09-08", date_to = "2023-09-11")

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
game_id integer FIBA game id, global across competitions (GDAP key space): gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
game_name character Technical game name '⁠<roundId>⁠-⁠<groupPairingCode>⁠-⁠<gameNumber>⁠'.
game_number character Game number within the round or pairing (a string: '1', 'A').
status_code character Game status code: VALID (validated result), CLOS (closed, pre-2000 rows).
team_a_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_a_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_a_code character Team code (national: FIBA country code; club: a club abbreviation such as OOST).
team_a_official_name character Official name of team A: the country for a national team, the club for a club team.
team_a_short_name character Short name of team A: the country code for a national team, the club's short name for a club.
team_b_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_b_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_b_code character Team code (national: FIBA country code; club: a club abbreviation such as NANT).
team_b_official_name character Official name of team B: the country for a national team, the club for a club team.
team_b_short_name character Short name of team B: the country code for a national team, the club's short name for a club.
team_a_score integer Final score of team A.
team_b_score integer Final score of team B.
is_live logical True while the game is being played.
current_period character Last period reached ('Q4', 'OT1').
chrono character Game clock of the current period, 'mm:ss' ('00:00' when finished).
live_game_status integer Live state code: 999 on every finished game; 5 seen on a finished 2024 youth game; mapping unverified.
current_period_status character State of the current period: E = ended (the only value sampled).
host_city character City of the venue.
host_country character Country of the venue (name; a FIBA code in getgdapgameswithleaderdetailsbyteamid).
host_country_code character FIBA code of the venue's country.
venue_id integer Venue id (GDAP key space; 0 = unknown).
venue_name character Name of the arena the game is played in.
game_date_time character Tip-off in venue-local wall-clock time, ISO 8601 without offset (T00:00:00 when hasTimeGameDateTime is false).
game_date_time_utc character Tip-off in UTC, ISO 8601 without the Z.
has_time_game_date_time logical False when only the date is known (the time part is then 00:00:00).
iana_time_zone character IANA time zone of the venue.
utc_offset double Venue UTC offset at tip-off, in hours (Float64: a half-hour zone such as India +5.5 or Adelaide +9.5 is a fraction; whole hours in every sample).
is_postponed logical True when the game was postponed.
is_played_behind_closed_doors logical True when played without spectators.
venue_capacity integer Venue capacity (0 = unknown).
spectators integer Attendance at the game, as recorded by FIBA.
statistic_system character Live-stats system that scored the game: OVR (FIBA's Olympic/World Cup system), FLS (FIBA LiveStats), null before about 2006.
group_id character Group id (GDAP key space).
group_pairing_code character Group letter (group play) or pairing number (knockout bracket slot).
round_round_id integer Round id (GDAP key space, unique across competitions); the first segment of gameName.
round_round_code character Round code (GP group phase, QF, SF, F final, RS regular season, CL17-32 classification...).
round_round_name character Round label (Group Phase, Quarter-Finals, Final...).
round_round_number integer Round number within the competition (1-based).
round_round_type character Round type label: Group Round, Non Group Round, Super Round (getgdapgamesbycompetitionid uses the code G/NG here).
round_round_status_code character Round status: COMPL completed, PROGR in progress, CLOS closed.
round_game_system character Pairing system label (Single, Home and Away, Best of 3).
round_game_system_code character Pairing system code: S single game, HA home and away, BOF3 best of three.
round_start_date character Round start, local date-time.
round_end_date character Round end, local date-time (23:59:59.9999999 on the last day).
round_round_kind character Standard Round or Qualifiers.
round_round_order integer Display order of the round.
competition_competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_competition_code character Competition code (WMM men's World Cup, WOLYM, BCL, ELW...).
competition_season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
competition_official_name character Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
competition_start character First day, YYYY-MM-DD.
competition_end character Last day, YYYY-MM-DD.
competition_status character Competition status: In Progress, Completed, Closed.
competition_age_category character Age category (Senior, Under 16...).
competition_gender character Men or Women: the gender of the competition.
competition_fiba_zone character FIBA zone the competition belongs to (World, Europe, Americas...).
competition_zone_information_zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
competition_zone_information_zone_official_name character Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
competition_zone_information_zone_code character Zone code (W, E, AF, AM, AS, OC).
competition_zone_information_top_zone_id integer Parent zone id; null for top zones.
competition_zone_information_top_zone_official_name character Parent zone name; always null in the samples, values unverified.
competition_zone_information_top_zone_code character Parent zone code; always null in the samples, values unverified.
competition_competition_type character National Teams or Clubs.
competition_competition_category_is_league logical True for league-format club competitions.
competition_competition_category_age_type character Age type code: S senior, U16.
competition_competition_category_code character Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_competition_category_name character Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
competition_official_flag_item_code character Official-status code: O = official.
competition_official_flag_item_name character Official-status label.
competition_official character Official-status label.
competition_discipline character Discipline (Basketball; 3x3 is a separate platform).
competition_competition_marketing_name character Competition family, shared by every edition; always null in the samples, values unverified.
game_statistic_status_code character Box-score validation status: VALID.
game_play_by_play_status_code character Play-by-play availability flag: VALID or EMPTY. UNRELIABLE: World Cup 2014 and EuroBasket 2017 say EMPTY but their game pages carry full play-by-play; always check the page.
game_result_status_code character Result validation status: VALID.
game_result_additional_information character Free-text result note (forfeit, overtime remark); null when none.
window_code character Qualifier window code; null otherwise.
window_name character Qualifier window name; null otherwise.
team_a_from character How team A qualified for this slot ('Winner of Game 87', '1st of group C'); null in group play.
team_b_from character How team B qualified for this slot ('Winner of Game 88', '2nd of group A'); null in group play.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()


FIBA GDAP: gateway competition ids

Description

Ids of the competitions that run in a date window.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getcustomgateway⁠

Usage

fiba_gdap_gateway_competition_ids(start_date, end_date, return_parsed = TRUE)

Arguments

start_date

(character, required) Required. Window start as YYYY-MM-DD.

end_date

(character, required) Required. Window end as YYYY-MM-DD.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

 fiba_gdap_gateway_competition_ids(start_date = "2025-01-14", end_date = "2025-01-16")

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
competition_id integer FIBA competition id (Int64, GDAP key space) of a competition that runs in the window.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()


FIBA GDAP: gateway federation ranking

Description

FIBA world ranking from the server-side gateway (same items as fiba_gdap_federation_ranking).

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getcustomgateway⁠

Usage

fiba_gdap_gateway_federation_ranking(
  gender = "women",
  zone_id = 1L,
  as_of_date = NULL,
  return_parsed = TRUE
)

Arguments

gender

(character, default "women" in wehoop; sdv-py and hoopR default "men") federationRanking: men or women (= gdapCategory)

zone_id

(integer, default 1L) federationRanking: ranking zone id (= zoneRankingId)

as_of_date

(character, optional) Ranking as of this date, ISO 8601: the latest ranking published on or before it (2026-03-10 answers the 2026-03-03 ranking). Omitted = the latest ranking

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

 fiba_gdap_gateway_federation_ranking(gender = "women", zone_id = 1, as_of_date = "2025-09-15")

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
as_of_date character Date of the ranking returned: the latest ranking published on or before the requested date.
zone_ranking_code character Ranking zone code (WORLD, AFRICA...).
zone_ranking_official_name character Ranking zone official name.
world_rank integer Position in the FIBA world ranking (1 = best).
country_name character Country name in English.
zone_rank integer Rank within the zone.
ioc_code character IOC country code.
fiba_code character FIBA three-letter country code (GER, USA; historic URS, YUG).
current_points double Ranking points (one decimal).
world_rank_variation integer Change in world rank since the previous release (positive = up).
comments character Ranking note; null in every sample.
organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
organisation_status_code character Organisation status: ACT active.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()


FIBA GDAP: medal count

Description

All-time medal table of a competition family.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapmedalcount⁠

Usage

fiba_gdap_medal_count(family_id, return_parsed = TRUE)

Arguments

family_id

(integer, required) Required. Competition family id (competitionMarketingName.competitionMarketingNameId): 201 = World Cup, 320 = men's Olympics, 306 = Women's World Cup, 112 = BCL tier 1, 211 = EuroLeague Women.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

 fiba_gdap_medal_count(family_id = 201)

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
team_name character Team name (country or club).
organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
fiba_code character FIBA three-letter country code (GER, USA; historic URS, YUG).
team_zone_code character Zone code of the team (E Europe, NAM Americas north...).
rank integer Rank (1 = first).
total_first_rank integer Gold medals (first places).
total_second_rank integer Number of silver medals the federation has won in the competition family.
total_third_rank integer Number of bronze medals the federation has won in the competition family.
total_participations integer Editions played.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()


FIBA GDAP: national teams

Description

Every national federation FIBA lists.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapnationalteams⁠

Usage

fiba_gdap_national_teams(return_parsed = TRUE)

Arguments

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

 fiba_gdap_national_teams()

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
national_federation_id integer Federation organisation id (organisationId key space: 64 = Germany).
display_name character English display name of the federation (the country), as the FIBA site shows it.
official_name character Federation's official name.
country_id integer FIBA country id (country table key space; not an organisationId).
country_name character Country name in English.
country_fiba_code character FIBA code of the federation's country.
zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
zone_name character FIBA zone (Europe, Africa...).
organisation_status_code character Organisation status: ACT active.
membership_status_code character FIBA membership status: ACT active.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()


FIBA GDAP: nominations

Description

Officials nominated for a competition.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapcompetitionnominationsbyid⁠

Usage

fiba_gdap_nominations(comp, level = "competition", return_parsed = TRUE)

Arguments

comp

(integer, required) Required. FIBA competition id (GDAP key space), one per edition: competition.competitionId of any game row (208182 = World Cup 2023, 208722 = Paris 2024 men, 208850 = BCL 2024-25). Find it with fiba_gdap_editions or fiba_gdap_games_between.

level

(character, default "competition") competition = officials nominated for the whole competition (the only value the site sends)

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

 fiba_gdap_nominations(comp = 208182)

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
competition_level character Level the nomination is attached to: Competition.
competition_level_id integer Id of the object the nomination is attached to: the competitionId when competitionLevel is Competition.
competition_role character Role label at competition level; null in every sample.
role character Role: Referee, FIBA Table Officials, FIBA Certified Statisticians, FIBA Technical Delegate, FIBA Referee Instructor.
role_code character Role code (REF, FIBATDEL...).
game_assignment_role character Role on a game assignment; null at competition level.
game_assignment_role_code character Code of gameAssignmentRole; null at competition level.
game_assignment_role_order character Order of gameAssignmentRole; null at competition level.
person_id integer FIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_⁠<id>⁠ = gdapPlayerId.
first_name character Given name(s) as registered with FIBA.
last_name character Last name (officials: upper case).
gender character Sex of the person: M or F (Male/Female on getgdapcompetitionnominationsbyid).
nationalities character Nationalities (FIBA codes on player info; country objects on rosters and officials). Stored as a JSON string.
license_nationality character FIBA code of the federation that licenses the official.
affiliated_national_federation_country_code character FIBA code of the federation the official is affiliated to.
affiliated_national_federation_country_name character Country of the federation the official is affiliated to.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()


FIBA GDAP: player game stats

Description

A player's game log (full box lines) at a competition.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapplayergamestatisticsbyplayerid⁠

Usage

fiba_gdap_player_game_stats(player_id, comp, return_parsed = TRUE)

Arguments

player_id

(integer, required) Required. FIBA person id (global): personId of a roster row, pId in play-by-play, P_⁠<id>⁠ in the game-page box

comp

(integer, required) Required. FIBA competition id (GDAP key space), one per edition: competition.competitionId of any game row (208182 = World Cup 2023, 208722 = Paris 2024 men, 208850 = BCL 2024-25). Find it with fiba_gdap_editions or fiba_gdap_games_between.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
player_id integer FIBA person id (Int64), global; the player_id argument.
competition_id integer FIBA competition id (Int64) the game log belongs to; the comp argument.
game_id integer FIBA game id, global across competitions (GDAP key space): gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
game_day integer Game day number within the round.
round_id integer Round id (GDAP key space, unique across competitions); the first segment of gameName.
round_code character Round code (GP group phase, QF, SF, F final, RS regular season, CL17-32 classification...).
round_name character Round label (Group Phase, Quarter-Finals, Final...).
team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_name character Player's team name.
team_code character Player's team code.
team_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
versus_team_id integer Opponent's competition team id (see teamId).
versus_team_name character Opponent's name.
versus_team_code character Opponent's code.
versus_team_organisation_id integer Opponent's organisation id (see organisationId).
play_duration_in_seconds integer Playing time in seconds in the game.
points integer Points in the game.
field_goals_made integer Field goals made in the game.
field_goals_attempted integer Field goals attempted in the game.
field_goals_percentage double Field-goal percentage, 0-100 (in the game; full float precision in averages).
two_points_made integer Two-point field goals made in the game.
two_points_attempted integer Two-point field goals attempted in the game.
two_points_percentage double Two-point field-goal percentage, 0-100 (in the game; full float precision in averages).
three_points_made integer Three-point field goals made in the game.
three_points_attempted integer Three-point field goals attempted in the game.
three_points_percentage double Three-point field-goal percentage, 0-100 (in the game; full float precision in averages).
free_throws_made integer Free throws made in the game.
free_throws_attempted integer Free throws attempted in the game.
free_throws_percentage double Free-throw percentage, 0-100 (in the game; full float precision in averages).
offensive_rebounds integer Offensive rebounds in the game.
defensive_rebounds integer Defensive rebounds in the game.
rebounds integer Rebounds in the game.
assists integer Assists in the game.
personal_fouls integer Personal fouls in the game.
turnovers integer Turnovers in the game.
steals integer Steals in the game.
blocked_shots integer Blocked shots in the game.
plus_minus integer Plus/minus (point differential while on court) in the game.
efficiency integer Efficiency (FIBA EFF) in the game.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()

Examples

try(fiba_gdap_player_game_stats(player_id = 211501, comp = 208182))

FIBA GDAP: player info

Description

A player's bio and per-game averages with ranks at a competition.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapplayerinfobycompetitionid⁠

Usage

fiba_gdap_player_info(player_id, comp, return_parsed = TRUE)

Arguments

player_id

(integer, required) Required. FIBA person id (global): personId of a roster row, pId in play-by-play, P_⁠<id>⁠ in the game-page box

comp

(integer, required) Required. FIBA competition id (GDAP key space), one per edition: competition.competitionId of any game row (208182 = World Cup 2023, 208722 = Paris 2024 men, 208850 = BCL 2024-25). Find it with fiba_gdap_editions or fiba_gdap_games_between.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

 fiba_gdap_player_info(player_id = 211501, comp = 208182)

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
player_id integer FIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_⁠<id>⁠ = gdapPlayerId.
competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
first_name character Given name(s) as registered with FIBA.
last_name character Last name (officials: upper case).
height_cm integer Height in centimetres.
height_ft_in character Height, feet and inches string.
club_name character Club at the time of the competition.
club_code character Club abbreviation; always null in the samples, values unverified.
is_player_free_agent logical True when the player had no club.
points_per_game double The player's average points per game played.
rank_points_per_game double Rank in the competition by points per game (1 = highest).
rebounds_per_game double The player's average rebounds per game played.
rank_rebounds_per_game double Rank in the competition by rebounds per game (1 = highest).
assists_per_game double The player's average assists per game played.
rank_assists_per_game double Rank in the competition by assists per game (1 = highest).
points_per_game_per_competition_category double Average points per game across the competition category, the comparison baseline (unverified).
rebounds_per_game_per_competition_category double Average rebounds per game across the competition category, the comparison baseline (unverified).
assists_per_game_per_competition_category double Average assists per game across the competition category, the comparison baseline (unverified).
birth_date character Date of birth, YYYY-MM-DD.
nationalities character Nationalities (FIBA codes on player info; country objects on rosters and officials). Stored as a JSON string.
social_media_website character Website URL; always null in the samples, values unverified.
social_media_twitter character X/Twitter handle; always null in the samples, values unverified.
social_media_facebook character Facebook handle or URL; always null in the samples, values unverified.
social_media_instagram character Instagram handle; always null in the samples, values unverified.
social_media_youtube character YouTube handle; always null in the samples, values unverified.
social_networks character Social-network handles. Stored as a JSON string.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()


FIBA GDAP: player stats

Description

A player's per-game averages, totals and highs at a competition.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapplayercompetitionstatisticsbyplayerid⁠

Usage

fiba_gdap_player_stats(player_id, comp, return_parsed = TRUE)

Arguments

player_id

(integer, required) Required. FIBA person id (global): personId of a roster row, pId in play-by-play, P_⁠<id>⁠ in the game-page box

comp

(integer, required) Required. FIBA competition id (GDAP key space), one per edition: competition.competitionId of any game row (208182 = World Cup 2023, 208722 = Paris 2024 men, 208850 = BCL 2024-25). Find it with fiba_gdap_editions or fiba_gdap_games_between.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
player_id integer FIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_⁠<id>⁠ = gdapPlayerId.
competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
points_per_game double The player's average points per game played.
rebounds_per_game double The player's average rebounds per game played.
rebounds_offensive_per_game double The player's average offensive rebounds per game played.
rebounds_defensive_per_game double The player's average defensive rebounds per game played.
assists_per_game double The player's average assists per game played.
blocks_per_game double The player's average blocked shots per game played.
turnovers_per_game double The player's average turnovers per game played.
fouls_per_game double The player's average personal fouls per game played.
plus_minus_per_game double The player's average plus/minus (point differential while on court) per game played.
efficiency_per_game double The player's average efficiency (FIBA EFF) per game played.
play_time_in_seconds_per_game double The player's average playing time in seconds per game played.
field_goals_made_per_game double The player's average field goals made per game played.
field_goals_attempted_per_game double The player's average field goals attempted per game played.
two_points_made_per_game double The player's average two-point field goals made per game played.
two_points_attempted_per_game double The player's average two-point field goals attempted per game played.
three_points_made_per_game double The player's average three-point field goals made per game played.
three_points_attempted_per_game double The player's average three-point field goals attempted per game played.
free_throws_made_per_game double The player's average free throws made per game played.
free_throws_attempted_per_game double The player's average free throws attempted per game played.
points_from_turnovers_per_game double The player's average points from turnovers per game played.
fast_break_points_per_game double The player's average fast-break points per game played.
second_chance_points_per_game double The player's average second-chance points per game played.
points_in_the_paint_per_game double The player's average points in the paint per game played.
steals_per_game double The player's average steals per game played.
total_games_played integer The player's total games played over the games played.
total_games_won integer The player's total games won over the games played.
total_games_lost integer The player's total games lost over the games played.
total_rebounds integer The player's total rebounds over the games played.
total_rebounds_offensive integer The player's total offensive rebounds over the games played.
total_rebounds_defensive integer The player's total defensive rebounds over the games played.
total_blocks integer The player's total blocked shots over the games played.
total_turnovers integer The player's total turnovers over the games played.
total_fouls integer The player's total personal fouls over the games played.
total_assists integer The player's total assists over the games played.
total_plus_minus integer The player's total plus/minus (point differential while on court) over the games played.
total_efficiency integer The player's total efficiency (FIBA EFF) over the games played.
total_play_time_in_seconds integer The player's total playing time in seconds over the games played.
total_points integer The player's total points over the games played.
total_field_goals_made integer The player's total field goals made over the games played.
total_field_goals_attempted integer The player's total field goals attempted over the games played.
field_goals_percentage double Field-goal percentage, 0-100 (over the competition; full float precision in averages).
total_two_points_made integer The player's total two-point field goals made over the games played.
total_two_points_attempted integer The player's total two-point field goals attempted over the games played.
two_points_percentage double Two-point field-goal percentage, 0-100 (over the competition; full float precision in averages).
total_three_points_made integer The player's total three-point field goals made over the games played.
total_three_points_attempted integer The player's total three-point field goals attempted over the games played.
three_points_percentage double Three-point field-goal percentage, 0-100 (over the competition; full float precision in averages).
total_free_throws_made integer The player's total free throws made over the games played.
total_free_throws_attempted integer The player's total free throws attempted over the games played.
free_throws_percentage double Free-throw percentage, 0-100 (over the competition; full float precision in averages).
total_double_doubles integer The player's total double-doubles over the games played.
total_triple_doubles integer The player's total triple-doubles over the games played.
total_quadruple_doubles integer The player's total quadruple-doubles over the games played.
total_quintuple_doubles integer The player's total quintuple-doubles over the games played.
total_points_from_turnovers integer The player's total points from turnovers over the games played.
total_fast_break_points integer The player's total fast-break points over the games played.
total_second_chance_points integer The player's total second-chance points over the games played.
total_points_in_the_paint integer The player's total points in the paint over the games played.
total_steals integer The player's total steals over the games played.
rank_points_per_game double Rank in the competition by points per game (1 = highest).
rank_rebounds_per_game double Rank in the competition by rebounds per game (1 = highest).
rank_assists_per_game double Rank in the competition by assists per game (1 = highest).

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()

Examples

try(fiba_gdap_player_stats(player_id = 211501, comp = 208182))

FIBA GDAP: ranking zones

Description

FIBA world-ranking zones.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdaprankingzones⁠

Usage

fiba_gdap_ranking_zones(return_parsed = TRUE)

Arguments

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

 fiba_gdap_ranking_zones()

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
zone_ranking_id integer Ranking zone id (getgdaprankingzones key space: 1 = World ... 5 = Europe).
code character Ranking zone code (W, AF, AM, AS, EU).
official_name character Official name of the ranking zone (World, FIBA Europe, FIBA Americas...).

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()


FIBA GDAP: roster

Description

A team's roster at a competition.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapcompetitionteamrosterbyteamid⁠

Usage

fiba_gdap_roster(team_id, discipline_format = NULL, return_parsed = TRUE)

Arguments

team_id

(integer, required) Required. Competition team id: one per team per competition (teamA.teamId of a game row; Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024). Not the federation organisationId

discipline_format

(character, optional) Optional; the site passes its discipline format. 5x5 answers the same as omitting it (verified on awards and rosters)

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_code character Team code (FIBA country code or club abbreviation).
team_name character Team name (the country for a national team, the club for a club team).
organisation_id integer Stable federation or club id (Int64), the same in every competition and season (64 = Germany).
competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
person_id integer FIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_⁠<id>⁠ = gdapPlayerId.
first_name character Given name(s) as registered with FIBA.
last_name character Last name (officials: upper case).
gender character Sex of the person: M or F (Male/Female on getgdapcompetitionnominationsbyid).
date_of_birth character Date of birth, YYYY-MM-DD.
uniform_number character Jersey number (a string).
uniform_name character Name printed on the jersey.
position character Playing position (roster: Point Guard...; game page: PG, SG, SF, PF, C).
height_in_cm integer Player height in centimetres.
height_in_feet_inches character Height, feet and inches string (6'7").
nationality character FIBA code of the main nationality.
is_on_final_roster logical True when on the final (12-player) roster.
games_played integer Games played in the competition.
club_id integer Organisation id of the player's club (organisationId key space).
club_name character Club at the time of the competition.
country_fiba_code character FIBA code of the country the person represents.
club_country_fiba_code character FIBA code of the club's country.
is_captain logical True for the team captain.
is_player_free_agent logical True when the player had no club.
final_roster_member_status_code character Roster entry status: VALID, PARTIAL (incomplete registration).

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()

Examples

try(fiba_gdap_roster(team_id = 279569))

FIBA GDAP: roster coaches

Description

A team's coaches on its roster at a competition.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapcompetitionteamrosterbyteamid⁠

Usage

fiba_gdap_roster_coaches(
  team_id,
  discipline_format = NULL,
  return_parsed = TRUE
)

Arguments

team_id

(integer, required) Required. Competition team id: one per team per competition (teamA.teamId of a game row; Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024). Not the federation organisationId

discipline_format

(character, optional) Optional; the site passes its discipline format. 5x5 answers the same as omitting it (verified on awards and rosters)

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

 fiba_gdap_roster_coaches(team_id = 279569)

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_code character Team code (FIBA country code or club abbreviation).
team_name character Team name (the country for a national team, the club for a club team).
organisation_id integer Stable federation or club id (Int64), the same in every competition and season (64 = Germany).
competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
person_id integer FIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_⁠<id>⁠ = gdapPlayerId.
first_name character Given name(s) as registered with FIBA.
last_name character Last name (officials: upper case).
gender character Sex of the person: M or F (Male/Female on getgdapcompetitionnominationsbyid).
function character Role: Head Coach, Coach, Assistant Coach.
is_head_coach integer 1 for the head coach, 0 otherwise (an integer flag, not a boolean).
is_assistant_coach integer 1 for an assistant coach, else null (integer flag).
is_accompanying_coach logical Accompanying-coach flag; always null in the samples, values unverified.
coach_display_order integer Display order; null when unset.
is_on_final_roster logical True when on the final (12-player) roster.
nationalities character Nationalities (FIBA codes on player info; country objects on rosters and officials). Stored as a JSON string.
coach_license_organisation_name character Federation that issued the coaching licence.
coach_license_country_code character FIBA code of the licensing federation's country.
final_roster_member_status_code character Roster entry status: VALID, PARTIAL (incomplete registration).

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()


FIBA GDAP: roster latest

Description

A team's latest roster (same shape as the roster).

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapcompetitionteamlatestrosterbyteamid⁠

Usage

fiba_gdap_roster_latest(team_id, return_parsed = TRUE)

Arguments

team_id

(integer, required) Required. Competition team id: one per team per competition (teamA.teamId of a game row; Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024). Not the federation organisationId

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

 fiba_gdap_roster_latest(team_id = 282183)

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_code character Team code (FIBA country code or club abbreviation).
team_name character Team name (the country for a national team, the club for a club team).
organisation_id integer Stable federation or club id (Int64), the same in every competition and season (64 = Germany).
competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
person_id integer FIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_⁠<id>⁠ = gdapPlayerId.
first_name character Given name(s) as registered with FIBA.
last_name character Last name (officials: upper case).
gender character Sex of the person: M or F (Male/Female on getgdapcompetitionnominationsbyid).
date_of_birth character Date of birth, YYYY-MM-DD.
uniform_number character Jersey number (a string).
uniform_name character Name printed on the jersey.
position character Playing position (roster: Point Guard...; game page: PG, SG, SF, PF, C).
height_in_cm integer Player height in centimetres.
height_in_feet_inches character Height, feet and inches string (6'7").
nationality character FIBA code of the main nationality.
is_on_final_roster logical True when on the final (12-player) roster.
games_played integer Games played in the competition.
club_id integer Organisation id of the player's club (organisationId key space).
club_name character Club at the time of the competition.
country_fiba_code character FIBA code of the country the person represents.
club_country_fiba_code character FIBA code of the club's country.
is_captain logical True for the team captain.
is_player_free_agent logical True when the player had no club.
final_roster_member_status_code character Roster entry status: VALID, PARTIAL (incomplete registration).

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()


FIBA GDAP: round gamedays

Description

Rounds of a competition with their game days.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapcompetitionroundgamedaysbyid⁠

Usage

fiba_gdap_round_gamedays(comp, return_parsed = TRUE)

Arguments

comp

(integer, required) Required. FIBA competition id (GDAP key space), one per edition: competition.competitionId of any game row (208182 = World Cup 2023, 208722 = Paris 2024 men, 208850 = BCL 2024-25). Find it with fiba_gdap_editions or fiba_gdap_games_between.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

 fiba_gdap_round_gamedays(comp = 208182)

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
competition_id integer FIBA competition id (Int64) the rounds belong to; the comp argument.
round_game_system character Pairing system label (Single, Home and Away, Best of 3).
round_game_system_code character Pairing system code: S single game, HA home and away, BOF3 best of three.
round_parent_round_id integer roundId of the round this one belongs to; null for a top-level round.
round_round_code character Round code (GP group phase, QF, SF, F final, RS regular season, CL17-32 classification...).
round_round_id integer Round id (GDAP key space, unique across competitions); the first segment of gameName.
round_round_name character Round label (Group Phase, Quarter-Finals, Final...).
round_round_number integer Round number within the competition (1-based).
round_round_type character Round type label: Group Round, Non Group Round, Super Round (getgdapgamesbycompetitionid uses the code G/NG here).
round_round_type_code character Round type code: G group, NG non-group (knockout), S super round.
round_round_status_code character Round status: COMPL completed, PROGR in progress, CLOS closed.
round_start_date character Round start, local date-time.
round_end_date character Round end, local date-time (23:59:59.9999999 on the last day).
round_has_teams_assigned logical True once the round's teams are known.
round_round_kind character Standard Round or Qualifiers.
round_standing_header_code character Code of the standings table the round feeds.
round_standing_header_name character Name of the standings table the round feeds.
round_qualified_team_information character Qualification note of the round; null in every sample.
round_round_order integer Display order of the round.
gamedays character Game days of the round as a JSON string; empty (null) for the competitions sampled.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()


FIBA GDAP: round standings

Description

Group standings of every round of a competition.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdaproundsbycompetitionid⁠

Usage

fiba_gdap_round_standings(comp, return_parsed = TRUE)

Arguments

comp

(integer, required) Required. FIBA competition id (GDAP key space), one per edition: competition.competitionId of any game row (208182 = World Cup 2023, 208722 = Paris 2024 men, 208850 = BCL 2024-25). Find it with fiba_gdap_editions or fiba_gdap_games_between.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
round_id integer Round id (Int64) the group belongs to.
round_name character Round name (Preliminary Round, Final Round...).
round_code character Round code (a short code such as G or F).
group_name character Group name within the round (A, B...).
group_status_code character Group status code (COMPL when the group is complete).
rank integer Rank in the group.
team_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_code character Team code (FIBA country code or club abbreviation).
team_official_name character Official team name (the country for a national team, the club for a club team).
team_short_name character Short team name: the country code for a national team, the club's short name for a club.
games_played integer Games played in the group.
games_lost integer Losses in the group.
games_won integer Wins in the group.
points integer Standing points (2 per win, 1 per loss).
points_against integer Points conceded.
points_for integer Points the team scored in the group's games.
starting_position integer Seed / draw position in the group.
final_position integer Final position in the group.
plus_minus integer Point differential (pointsFor - pointsAgainst).
penalty_points integer Standing points deducted.
draw_points integer Points for a draw (0); null when not applicable.
group_game_results character This team's games in the group. Stored as a JSON string.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()

Examples

try(fiba_gdap_round_standings(comp = 208182))

FIBA GDAP: rounds

Description

Rounds of a competition (group stage, knockout rounds).

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdaproundsbycompetitionid⁠

Usage

fiba_gdap_rounds(comp, return_parsed = TRUE)

Arguments

comp

(integer, required) Required. FIBA competition id (GDAP key space), one per edition: competition.competitionId of any game row (208182 = World Cup 2023, 208722 = Paris 2024 men, 208850 = BCL 2024-25). Find it with fiba_gdap_editions or fiba_gdap_games_between.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
game_system character Pairing system label (Single, Home and Away, Best of 3).
game_system_code character Pairing system code: S single game, HA home and away, BOF3 best of three.
parent_round_id integer roundId of the round this one belongs to; null for a top-level round.
round_code character Round code (GP group phase, QF, SF, F final, RS regular season, CL17-32 classification...).
round_id integer Round id (GDAP key space, unique across competitions); the first segment of gameName.
round_name character Round label (Group Phase, Quarter-Finals, Final...).
round_number integer Round number within the competition (1-based).
round_type character Round type label: Group Round, Non Group Round, Super Round (getgdapgamesbycompetitionid uses the code G/NG here).
round_type_code character Round type code: G group, NG non-group (knockout), S super round.
round_status_code character Round status: COMPL completed, PROGR in progress, CLOS closed.
start_date character Round start, local date-time.
end_date character Round end, local date-time (23:59:59.9999999 on the last day).
has_teams_assigned logical True once the round's teams are known.
round_kind character Standard Round or Qualifiers.
standing_header_code character Code of the standings table the round feeds.
standing_header_name character Name of the standings table the round feeds.
qualified_team_information character Qualification note of the round; null in every sample.
round_order integer Display order of the round.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()

Examples

try(fiba_gdap_rounds(comp = 208182))

FIBA GDAP: schedule

Description

Schedule and results of one competition (edition): one row per game.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapgamesbycompetitionid⁠

Usage

fiba_gdap_schedule(comp, return_parsed = TRUE)

Arguments

comp

(integer, required) Required. FIBA competition id (GDAP key space), one per edition: competition.competitionId of any game row (208182 = World Cup 2023, 208722 = Paris 2024 men, 208850 = BCL 2024-25). Find it with fiba_gdap_editions or fiba_gdap_games_between.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
game_id integer FIBA game id, global across competitions (GDAP key space): gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
game_name character Technical game name '⁠<roundId>⁠-⁠<groupPairingCode>⁠-⁠<gameNumber>⁠'.
game_number character Game number within the round or pairing (a string: '1', 'A').
status_code character Game status code: VALID (validated result), CLOS (closed, pre-2000 rows).
team_a_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_a_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_a_code character Team code (national: FIBA country code; club: a club abbreviation such as OOST).
team_a_official_name character Official name of team A: the country for a national team, the club for a club team.
team_a_short_name character Short name of team A: the country code for a national team, the club's short name for a club.
team_b_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_b_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_b_code character Team code (national: FIBA country code; club: a club abbreviation such as NANT).
team_b_official_name character Official name of team B: the country for a national team, the club for a club team.
team_b_short_name character Short name of team B: the country code for a national team, the club's short name for a club.
team_a_score integer Final score of team A.
team_b_score integer Final score of team B.
is_live logical True while the game is being played.
current_period character Last period reached ('Q4', 'OT1').
chrono character Game clock of the current period, 'mm:ss' ('00:00' when finished).
live_game_status integer Live state code: 999 on every finished game; 5 seen on a finished 2024 youth game; mapping unverified.
current_period_status character State of the current period: E = ended (the only value sampled).
host_city character City of the venue.
host_country character Country of the venue (name; a FIBA code in getgdapgameswithleaderdetailsbyteamid).
host_country_code character FIBA code of the venue's country.
venue_id integer Venue id (GDAP key space; 0 = unknown).
venue_name character Name of the arena the game is played in.
game_date_time character Tip-off in venue-local wall-clock time, ISO 8601 without offset (T00:00:00 when hasTimeGameDateTime is false).
game_date_time_utc character Tip-off in UTC, ISO 8601 without the Z.
has_time_game_date_time logical False when only the date is known (the time part is then 00:00:00).
iana_time_zone character IANA time zone of the venue.
utc_offset double Venue UTC offset at tip-off, in hours (Float64: a half-hour zone such as India +5.5 or Adelaide +9.5 is a fraction; whole hours in every sample).
is_postponed logical True when the game was postponed.
is_played_behind_closed_doors logical True when played without spectators.
venue_capacity integer Venue capacity (0 = unknown).
spectators integer Attendance at the game, as recorded by FIBA.
statistic_system character Live-stats system that scored the game: OVR (FIBA's Olympic/World Cup system), FLS (FIBA LiveStats), null before about 2006.
group_id character Group id (GDAP key space).
group_pairing_code character Group letter (group play) or pairing number (knockout bracket slot).
round_round_id integer Round id (GDAP key space, unique across competitions); the first segment of gameName.
round_round_code character Round code (GP group phase, QF, SF, F final, RS regular season, CL17-32 classification...).
round_round_name character Round label (Group Phase, Quarter-Finals, Final...).
round_round_number integer Round number within the competition (1-based).
round_round_type character Round type label: Group Round, Non Group Round, Super Round (getgdapgamesbycompetitionid uses the code G/NG here).
round_round_status_code character Round status: COMPL completed, PROGR in progress, CLOS closed.
round_game_system character Pairing system label (Single, Home and Away, Best of 3).
round_game_system_code character Pairing system code: S single game, HA home and away, BOF3 best of three.
round_start_date character Round start, local date-time.
round_end_date character Round end, local date-time (23:59:59.9999999 on the last day).
round_round_kind character Standard Round or Qualifiers.
round_round_order integer Display order of the round.
competition_competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_competition_code character Competition code (WMM men's World Cup, WOLYM, BCL, ELW...).
competition_season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
competition_official_name character Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
competition_start character First day, YYYY-MM-DD.
competition_end character Last day, YYYY-MM-DD.
competition_status character Competition status: In Progress, Completed, Closed.
competition_age_category character Age category (Senior, Under 16...).
competition_gender character Men or Women: the gender of the competition.
competition_fiba_zone character FIBA zone the competition belongs to (World, Europe, Americas...).
competition_zone_information_zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
competition_zone_information_zone_official_name character Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
competition_zone_information_zone_code character Zone code (W, E, AF, AM, AS, OC).
competition_zone_information_top_zone_id integer Parent zone id; null for top zones.
competition_zone_information_top_zone_official_name character Parent zone name; always null in the samples, values unverified.
competition_zone_information_top_zone_code character Parent zone code; always null in the samples, values unverified.
competition_competition_type character National Teams or Clubs.
competition_competition_category_is_league logical True for league-format club competitions.
competition_competition_category_age_type character Age type code: S senior, U16.
competition_competition_category_code character Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_competition_category_name character Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
competition_official_flag_item_code character Official-status code: O = official.
competition_official_flag_item_name character Official-status label.
competition_official character Official-status label.
competition_discipline character Discipline (Basketball; 3x3 is a separate platform).
competition_competition_marketing_name_competition_marketing_name_id integer Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the ⁠<histId>⁠ of /en/history/ pages.
competition_competition_marketing_name_marketing_name character Competition family name; slugified it is the ⁠<histSlug>⁠ of /en/history/ pages.
competition_competition_marketing_name_code character Family code; null in every sample.
game_statistic_status_code character Box-score validation status: VALID.
game_play_by_play_status_code character Play-by-play availability flag: VALID or EMPTY. UNRELIABLE: World Cup 2014 and EuroBasket 2017 say EMPTY but their game pages carry full play-by-play; always check the page.
game_result_status_code character Result validation status: VALID.
game_result_additional_information character Free-text result note (forfeit, overtime remark); null when none.
window_code character Qualifier window code; null otherwise.
window_name character Qualifier window name; null otherwise.
team_a_from character How team A qualified for this slot ('Winner of Game 87', '1st of group C'); null in group play.
team_b_from character How team B qualified for this slot ('Winner of Game 88', '2nd of group A'); null in group play.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()

Examples

try(fiba_gdap_schedule(comp = 208182))

FIBA GDAP: team games

Description

A team's games with each team's leaders.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapgameswithleaderdetailsbyteamid⁠

Usage

fiba_gdap_team_games(team_id, return_parsed = TRUE)

Arguments

team_id

(integer, required) Required. Competition team id: one per team per competition (teamA.teamId of a game row; Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024). Not the federation organisationId

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
game_id integer FIBA game id, global across competitions (GDAP key space): gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
round_name character Round label (Group Phase, Quarter-Finals, Final...).
game_number character Game number within the round or pairing (a string: '1', 'A').
status character Game status label (Validated).
status_code character Game status code: VALID (validated result), CLOS (closed, pre-2000 rows).
game_day integer Game day number within the round.
team_a_from character How team A qualified for this slot; null in group play.
team_b_from character How team B qualified for this slot; null in group play.
team_a_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_a_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_a_code character Team code (national: FIBA country code; club: a club abbreviation such as OOST).
team_a_official_name character Official name of team A: the country for a national team, the club for a club team.
team_a_short_name character Short name of team A: the country code for a national team, the club's short name for a club.
team_b_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_b_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_b_code character Team code (national: FIBA country code; club: a club abbreviation such as NANT).
team_b_official_name character Official name of team B: the country for a national team, the club for a club team.
team_b_short_name character Short name of team B: the country code for a national team, the club's short name for a club.
team_a_score integer Team A points in the period.
team_b_score integer Team B points in the period.
host_city character City of the venue.
host_country character Country of the venue (name; a FIBA code in getgdapgameswithleaderdetailsbyteamid).
host_country_code character FIBA code of the venue's country; always null in the samples, values unverified.
venue_id integer Venue id (GDAP key space; 0 = unknown).
venue_name character Name of the arena the game is played in.
game_date_time character Tip-off in venue-local wall-clock time, ISO 8601 without offset (T00:00:00 when hasTimeGameDateTime is false).
game_date_time_utc character Tip-off in UTC, ISO 8601 without the Z.
has_time_game_date_time logical False when only the date is known (the time part is then 00:00:00).
iana_time_zone character IANA time zone of the venue.
utc_offset double Venue UTC offset at tip-off, in hours (Float64: a half-hour zone such as India +5.5 or Adelaide +9.5 is a fraction; whole hours in every sample).
buy_tickets_url character Ticket link; always '' in the samples.
watch_url character Stream link; always '' in the samples.
is_postponed logical True when the game was postponed.
is_played_behind_closed_doors logical True when played without spectators.
venue_capacity integer Venue capacity (0 = unknown).
spectators integer Attendance at the game, as recorded by FIBA.
is_live logical True while the game is being played.
leaders_team_a_points_leader_player_id integer FIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_⁠<id>⁠ = gdapPlayerId.
leaders_team_a_points_leader_first_name character Given name(s) as registered with FIBA.
leaders_team_a_points_leader_last_name character Last name (officials: upper case).
leaders_team_a_points_leader_statistics_value integer Leader's value for the statistic.
leaders_team_a_points_leader_nationality character FIBA code of the main nationality.
leaders_team_a_points_leader_rank integer Rank (1 = first).
leaders_team_a_rebounds_leader_player_id integer FIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_⁠<id>⁠ = gdapPlayerId.
leaders_team_a_rebounds_leader_first_name character Given name(s) as registered with FIBA.
leaders_team_a_rebounds_leader_last_name character Last name (officials: upper case).
leaders_team_a_rebounds_leader_statistics_value integer Leader's value for the statistic.
leaders_team_a_rebounds_leader_nationality character FIBA code of the main nationality.
leaders_team_a_rebounds_leader_rank integer Rank (1 = first).
leaders_team_a_assists_leader_player_id integer FIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_⁠<id>⁠ = gdapPlayerId.
leaders_team_a_assists_leader_first_name character Given name(s) as registered with FIBA.
leaders_team_a_assists_leader_last_name character Last name (officials: upper case).
leaders_team_a_assists_leader_statistics_value integer Leader's value for the statistic.
leaders_team_a_assists_leader_nationality character FIBA code of the main nationality.
leaders_team_a_assists_leader_rank integer Rank (1 = first).
leaders_team_b_points_leader_player_id integer FIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_⁠<id>⁠ = gdapPlayerId.
leaders_team_b_points_leader_first_name character Given name(s) as registered with FIBA.
leaders_team_b_points_leader_last_name character Last name (officials: upper case).
leaders_team_b_points_leader_statistics_value integer Leader's value for the statistic.
leaders_team_b_points_leader_nationality character FIBA code of the main nationality.
leaders_team_b_points_leader_rank integer Rank (1 = first).
leaders_team_b_rebounds_leader_player_id integer FIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_⁠<id>⁠ = gdapPlayerId.
leaders_team_b_rebounds_leader_first_name character Given name(s) as registered with FIBA.
leaders_team_b_rebounds_leader_last_name character Last name (officials: upper case).
leaders_team_b_rebounds_leader_statistics_value integer Leader's value for the statistic.
leaders_team_b_rebounds_leader_nationality character FIBA code of the main nationality.
leaders_team_b_rebounds_leader_rank integer Rank (1 = first).
leaders_team_b_assists_leader_player_id integer FIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_⁠<id>⁠ = gdapPlayerId.
leaders_team_b_assists_leader_first_name character Given name(s) as registered with FIBA.
leaders_team_b_assists_leader_last_name character Last name (officials: upper case).
leaders_team_b_assists_leader_statistics_value integer Leader's value for the statistic.
leaders_team_b_assists_leader_nationality character FIBA code of the main nationality.
leaders_team_b_assists_leader_rank integer Rank (1 = first).
periods character Score by period. Stored as a JSON string.
game_statistic_status_code character Box-score validation status: VALID.
game_play_by_play_status_code character Play-by-play availability flag: VALID or EMPTY. UNRELIABLE: World Cup 2014 and EuroBasket 2017 say EMPTY but their game pages carry full play-by-play; always check the page.
game_result_status_code character Result validation status: VALID.
game_result_additional_information character Free-text result note (forfeit, overtime remark); null when none.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()

Examples

try(fiba_gdap_team_games(team_id = 279569))

FIBA GDAP: team player stats

Description

Per-game averages of every player of a team at a competition.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapcompetitionteamstatisticsbyteamid⁠

Usage

fiba_gdap_team_player_stats(team_id, return_parsed = TRUE)

Arguments

team_id

(integer, required) Required. Competition team id: one per team per competition (teamA.teamId of a game row; Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024). Not the federation organisationId

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

 fiba_gdap_team_player_stats(team_id = 279569)

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
competition_id integer FIBA competition id (Int64) the averages belong to.
player_id integer FIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_⁠<id>⁠ = gdapPlayerId.
first_name character Given name(s) as registered with FIBA.
last_name character Last name (officials: upper case).
uniform_number character Jersey number (a string).
team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
points_per_game double The player's average points per game played.
rebounds_per_game double The player's average rebounds per game played.
rebounds_offensive_per_game double The player's average offensive rebounds per game played.
rebounds_defensive_per_game double The player's average defensive rebounds per game played.
assists_per_game double The player's average assists per game played.
blocks_per_game double The player's average blocked shots per game played.
turnovers_per_game double The player's average turnovers per game played.
fouls_per_game double The player's average personal fouls per game played.
plus_minus_per_game double The player's average plus/minus (point differential while on court) per game played.
efficiency_per_game double The player's average efficiency (FIBA EFF) per game played.
play_time_in_seconds_per_game double The player's average playing time in seconds per game played.
field_goals_made_per_game double The player's average field goals made per game played.
field_goals_attempted_per_game double The player's average field goals attempted per game played.
two_points_made_per_game double The player's average two-point field goals made per game played.
two_points_attempted_per_game double The player's average two-point field goals attempted per game played.
three_points_made_per_game double The player's average three-point field goals made per game played.
three_points_attempted_per_game double The player's average three-point field goals attempted per game played.
free_throws_made_per_game double The player's average free throws made per game played.
free_throws_attempted_per_game double The player's average free throws attempted per game played.
points_from_turnovers_per_game double The player's average points from turnovers per game played.
fast_break_points_per_game double The player's average fast-break points per game played.
second_chance_points_per_game double The player's average second-chance points per game played.
points_in_the_paint_per_game double The player's average points in the paint per game played.
steals_per_game double The player's average steals per game played.
total_games_played integer The player's total games played over the games played.
total_games_won integer The player's total games won over the games played.
total_games_lost integer The player's total games lost over the games played.
total_rebounds integer The player's total rebounds over the games played.
total_rebounds_offensive integer The player's total offensive rebounds over the games played.
total_rebounds_defensive integer The player's total defensive rebounds over the games played.
total_blocks integer The player's total blocked shots over the games played.
total_turnovers integer The player's total turnovers over the games played.
total_fouls integer The player's total personal fouls over the games played.
total_assists integer The player's total assists over the games played.
total_plus_minus integer The player's total plus/minus (point differential while on court) over the games played.
total_efficiency integer The player's total efficiency (FIBA EFF) over the games played.
total_play_time_in_seconds integer The player's total playing time in seconds over the games played.
total_points integer The player's total points over the games played.
total_field_goals_made integer The player's total field goals made over the games played.
total_field_goals_attempted integer The player's total field goals attempted over the games played.
field_goals_percentage double Field-goal percentage, 0-100 (over the competition; full float precision in averages).
total_two_points_made integer The player's total two-point field goals made over the games played.
total_two_points_attempted integer The player's total two-point field goals attempted over the games played.
two_points_percentage double Two-point field-goal percentage, 0-100 (over the competition; full float precision in averages).
total_three_points_made integer The player's total three-point field goals made over the games played.
total_three_points_attempted integer The player's total three-point field goals attempted over the games played.
three_points_percentage double Three-point field-goal percentage, 0-100 (over the competition; full float precision in averages).
total_free_throws_made integer The player's total free throws made over the games played.
total_free_throws_attempted integer The player's total free throws attempted over the games played.
free_throws_percentage double Free-throw percentage, 0-100 (over the competition; full float precision in averages).
total_double_doubles integer The player's total double-doubles over the games played.
total_triple_doubles integer The player's total triple-doubles over the games played.
total_quadruple_doubles integer The player's total quadruple-doubles over the games played.
total_quintuple_doubles integer The player's total quintuple-doubles over the games played.
total_points_from_turnovers integer The player's total points from turnovers over the games played.
total_fast_break_points integer The player's total fast-break points over the games played.
total_second_chance_points integer The player's total second-chance points over the games played.
total_points_in_the_paint integer The player's total points in the paint over the games played.
total_steals integer The player's total steals over the games played.
rank integer Rank (1 = first).

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()


FIBA GDAP: team staff

Description

Coaches of every team of a competition.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapteamstaffbycompetitionid⁠

Usage

fiba_gdap_team_staff(comp, return_parsed = TRUE)

Arguments

comp

(integer, required) Required. FIBA competition id (GDAP key space), one per edition: competition.competitionId of any game row (208182 = World Cup 2023, 208722 = Paris 2024 men, 208850 = BCL 2024-25). Find it with fiba_gdap_editions or fiba_gdap_games_between.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

 fiba_gdap_team_staff(comp = 208182)

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
team_id integer FIBA team id (Int64), one per team per competition; the team the coach is registered with.
team_name character Team name the coach is registered with.
team_code character Team code (GER, USA...) the coach is registered with.
person_id integer FIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_⁠<id>⁠ = gdapPlayerId.
first_name character Given name(s) as registered with FIBA.
last_name character Last name (officials: upper case).
gender character Sex of the person: M or F (Male/Female on getgdapcompetitionnominationsbyid).
function character Role: Head Coach, Coach, Assistant Coach.
is_head_coach integer 1 for the head coach, 0 otherwise (an integer flag, not a boolean).
is_assistant_coach integer 1 for an assistant coach, else null (integer flag).
is_accompanying_coach logical Accompanying-coach flag; always null in the samples, values unverified.
coach_display_order integer Display order; null when unset.
is_on_final_roster logical True when on the final (12-player) roster.
nationalities character Nationalities (FIBA codes on player info; country objects on rosters and officials). Stored as a JSON string.
coach_license_organisation_name character Federation that issued the coaching licence.
coach_license_country_code character FIBA code of the licensing federation's country.
final_roster_member_status_code character Roster entry status; always null in the samples, values unverified.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_stats(), fiba_gdap_teams()


FIBA GDAP: team stats

Description

A team's per-game averages and totals at a competition, with the bench totals.

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapcompetitionteamstatisticsbyteamid⁠

Usage

fiba_gdap_team_stats(team_id, return_parsed = TRUE)

Arguments

team_id

(integer, required) Required. Competition team id: one per team per competition (teamA.teamId of a game row; Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024). Not the federation organisationId

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
points_per_game double The team's average points per game played.
rebounds_per_game double The bench players' average rebounds per game played.
rebounds_offensive_per_game double The bench players' average offensive rebounds per game played.
rebounds_defensive_per_game double The bench players' average defensive rebounds per game played.
assists_per_game double The team's average assists per game played.
blocks_per_game double The team's average blocked shots per game played.
turnovers_per_game double The bench players' average turnovers per game played.
fouls_per_game double The bench players' average personal fouls per game played.
plus_minus_per_game double The team's average plus/minus (point differential while on court) per game played.
efficiency_per_game double The team's average efficiency (FIBA EFF) per game played.
play_time_in_seconds_per_game double The team's average playing time in seconds per game played.
field_goals_made_per_game double The team's average field goals made per game played.
field_goals_attempted_per_game double The team's average field goals attempted per game played.
two_points_made_per_game double The team's average two-point field goals made per game played.
two_points_attempted_per_game double The team's average two-point field goals attempted per game played.
three_points_made_per_game double The team's average three-point field goals made per game played.
three_points_attempted_per_game double The team's average three-point field goals attempted per game played.
free_throws_made_per_game double The team's average free throws made per game played.
free_throws_attempted_per_game double The team's average free throws attempted per game played.
points_from_turnovers_per_game double The team's average points from turnovers per game played.
fast_break_points_per_game double The team's average fast-break points per game played.
second_chance_points_per_game double The team's average second-chance points per game played.
points_in_the_paint_per_game double The team's average points in the paint per game played.
from_bench_points_per_game double The team's average points by bench players per game played.
steals_per_game double The team's average steals per game played.
total_games_played integer The bench players' total games played over the games played.
total_games_won integer The team's total games won over the games played.
total_games_lost integer The team's total games lost over the games played.
total_rebounds integer The bench players' total rebounds over the games played.
total_rebounds_offensive integer The bench players' total offensive rebounds over the games played.
total_rebounds_defensive integer The bench players' total defensive rebounds over the games played.
total_blocks integer The team's total blocked shots over the games played.
total_turnovers integer The bench players' total turnovers over the games played.
total_fouls integer The bench players' total personal fouls over the games played.
total_assists integer The team's total assists over the games played.
total_plus_minus integer The team's total plus/minus (point differential while on court) over the games played.
total_efficiency integer The team's total efficiency (FIBA EFF) over the games played.
total_play_time_in_seconds integer The team's total playing time in seconds over the games played.
total_points integer The team's total points over the games played.
total_field_goals_made integer The team's total field goals made over the games played.
total_field_goals_attempted integer The team's total field goals attempted over the games played.
field_goals_percentage double Field-goal percentage, 0-100 (over the competition; full float precision in averages).
total_two_points_made integer The team's total two-point field goals made over the games played.
total_two_points_attempted integer The team's total two-point field goals attempted over the games played.
two_points_percentage double Two-point field-goal percentage, 0-100 (over the competition; full float precision in averages).
total_three_points_made integer The team's total three-point field goals made over the games played.
total_three_points_attempted integer The team's total three-point field goals attempted over the games played.
three_points_percentage double Three-point field-goal percentage, 0-100 (over the competition; full float precision in averages).
total_free_throws_made integer The team's total free throws made over the games played.
total_free_throws_attempted integer The team's total free throws attempted over the games played.
free_throws_percentage double Free-throw percentage, 0-100 (over the competition; full float precision in averages).
total_double_doubles integer The team's total double-doubles over the games played.
total_triple_doubles integer The team's total triple-doubles over the games played.
total_quadruple_doubles integer The team's total quadruple-doubles over the games played.
total_quintuple_doubles integer The team's total quintuple-doubles over the games played.
total_points_from_turnovers integer The team's total points from turnovers over the games played.
total_fast_break_points integer The team's total fast-break points over the games played.
total_second_chance_points integer The team's total second-chance points over the games played.
total_points_in_the_paint integer The team's total points in the paint over the games played.
total_from_bench_points integer The team's total points by bench players over the games played.
total_steals integer The team's total steals over the games played.
biggest_lead integer Team's biggest lead in any game of the competition, points.
bench_total_games_played integer The bench players' total games played over the games played.
bench_rebounds_per_game double The bench players' average rebounds per game played.
bench_rebounds_offensive_per_game double The bench players' average offensive rebounds per game played.
bench_rebounds_defensive_per_game double The bench players' average defensive rebounds per game played.
bench_turnovers_per_game double The bench players' average turnovers per game played.
bench_fouls_per_game double The bench players' average personal fouls per game played.
bench_total_rebounds integer The bench players' total rebounds over the games played.
bench_total_rebounds_offensive integer The bench players' total offensive rebounds over the games played.
bench_total_rebounds_defensive integer The bench players' total defensive rebounds over the games played.
bench_total_turnovers integer The bench players' total turnovers over the games played.
bench_total_fouls integer The bench players' total personal fouls over the games played.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_teams()

Examples

try(fiba_gdap_team_stats(team_id = 279569))

FIBA GDAP: teams

Description

Teams of a competition with their profile (final ranking, per-game averages).

Endpoint: ⁠GET https://digital-api.fiba.basketball/hapi/getgdapcompetitionteamsbycompetitionid⁠

Usage

fiba_gdap_teams(comp, return_parsed = TRUE)

Arguments

comp

(integer, required) Required. FIBA competition id (GDAP key space), one per edition: competition.competitionId of any game row (208182 = World Cup 2023, 208722 = Paris 2024 men, 208850 = BCL 2024-25). Find it with fiba_gdap_editions or fiba_gdap_games_between.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.

The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.

Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across competitions (the ⁠<gameId>⁠ of a game-page URL). team_id is per team per competition (Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 = Germany, every year); the game page's T_⁠<id>⁠ and the play-by-play oId are organisation ids, not team ids.

Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404, or GDAP answers {} / ⁠[]⁠ for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id, season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player, federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club competitions, the event year for national-team events, the target tournament year for qualifiers.

Value

A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name type description
team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_code character Team abbreviation (FIBA country code or club abbreviation).
short_name character Short team name: the country code for a national team, the club's short name for a club.
profile_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
profile_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
profile_name character Team name as registered for the competition.
profile_code character Team code (FIBA country code or club abbreviation).
profile_country_name character Country of the team, in English.
profile_country_code character Country FIBA code.
profile_gender character Men or Women: the gender of the team's competition.
profile_facebook character Facebook handle or URL; always null in the samples, values unverified.
profile_twitter character X/Twitter handle; always null in the samples, values unverified.
profile_instagram character Instagram handle; always null in the samples, values unverified.
profile_website character The team's website address.
profile_you_tube character YouTube handle; always null in the samples, values unverified.
profile_final_ranking integer Final rank in the competition.
profile_points_per_game double The team's average points per game played.
profile_rebounds_per_game double The team's average rebounds per game played.
profile_assists_per_game double The team's average assists per game played.
profile_rank_points_per_game double Rank in the competition by points per game (1 = highest).
profile_rank_rebounds_per_game double Rank in the competition by rebounds per game (1 = highest).
profile_rank_assists_per_game double Rank in the competition by assists per game (1 = highest).
profile_total_games_won integer The team's total games won over the games played.
profile_total_games_lost integer The team's total games lost over the games played.
profile_social_networks character Social-network handles. Stored as a JSON string.
profile_competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
status_code character Team entry status: APPR approved.
status_name character Team entry status label (Approved).
organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.

See Also

Other FIBA Functions: fiba_gamepage_box_players(), fiba_gamepage_box_teams(), fiba_gamepage_lineup(), fiba_gamepage_pbp(), fiba_gamepage_period_scores(), fiba_gamepage_shots(), fiba_gdap_awards(), fiba_gdap_competition(), fiba_gdap_editions(), fiba_gdap_federation_games(), fiba_gdap_federation_ranking(), fiba_gdap_final_standings(), fiba_gdap_game(), fiba_gdap_game_officials(), fiba_gdap_game_periods(), fiba_gdap_games_between(), fiba_gdap_gateway_competition_ids(), fiba_gdap_gateway_federation_ranking(), fiba_gdap_medal_count(), fiba_gdap_national_teams(), fiba_gdap_nominations(), fiba_gdap_player_game_stats(), fiba_gdap_player_info(), fiba_gdap_player_stats(), fiba_gdap_ranking_zones(), fiba_gdap_roster(), fiba_gdap_roster_coaches(), fiba_gdap_roster_latest(), fiba_gdap_round_gamedays(), fiba_gdap_round_standings(), fiba_gdap_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats()

Examples

try(fiba_gdap_teams(comp = 208182))

FIBA competition: FIBA Women's AfroBasket

Description

Per-competition aliases of the FIBA wrappers for FIBA Women's AfroBasket (GDAP competition family 302), named as in sdv-py. Season rule: event year (2025 = 2025).

Usage

fiba_wafrobasket_editions(season = NULL, to_season = NULL, return_parsed = TRUE)

fiba_wafrobasket_schedule(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wafrobasket_standings(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wafrobasket_teams(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wafrobasket_player_box(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wafrobasket_team_box(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wafrobasket_pbp(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wafrobasket_shots(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

Arguments

game_id

FIBA game id (game_id in the schedule).

season

Edition season key (event year (2025 = 2025)). Omitted = the newest edition that has started; a game function needs season or comp. For fiba_wafrobasket_editions(): the first season (inclusive), omitted = every edition.

to_season

Last season, inclusive (fiba_wafrobasket_editions() only).

comp

FIBA competition id (one per edition); skips the edition lookup and is needed when a season lists several editions. Checked to be an edition of this competition (one cached getGdapCompetitionById request).

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source: the GDAP developer-portal terms limit API use to 'Authorized Users' and the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers. See fiba_gdap_awards() for the shared notes.

A comp of another competition family, or one GDAP gives no family, is wehoop_asset_fetch; a season with no edition is wehoop_no_data; a season listing several editions, or a game function called with neither season nor comp, is wehoop_bad_request.

 fiba_wafrobasket_editions(season = 2025)
 fiba_wafrobasket_schedule(season = 2025)

Value

A wehoop_data tibble with the columns of the base wrapper (the raw JSON list when return_parsed = FALSE), one table per function:

fiba_wafrobasket_editions()

The columns of fiba_gdap_editions():

col_name type description
hosts character Host countries with their cities. Stored as a JSON string.
competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_code character Competition code (WMM men's World Cup, WOLYM, BCL, ELW...).
season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
official_name character Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
start character First day, YYYY-MM-DD.
end character Last day, YYYY-MM-DD.
status character Competition status: In Progress, Completed, Closed.
age_category character Age category (Senior, Under 16...).
gender character Men or Women: the gender of the competition.
fiba_zone character FIBA zone the competition belongs to (World, Europe, Americas...).
zone_information_zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
zone_information_zone_official_name character Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
zone_information_zone_code character Zone code (W, E, AF, AM, AS, OC).
zone_information_top_zone_id integer Parent zone id; null for top zones.
zone_information_top_zone_official_name character Parent zone name; always null in the samples, values unverified.
zone_information_top_zone_code character Parent zone code; always null in the samples, values unverified.
competition_type character National Teams or Clubs.
competition_category_is_league logical True for league-format club competitions.
competition_category_age_type character Age type code: S senior, U16.
competition_category_code character Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_category_name character Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
official_flag_item_code character Official-status code: O = official.
official_flag_item_name character Official-status label.
official character Official-status label.
discipline character Discipline (Basketball; 3x3 is a separate platform).
competition_marketing_name_competition_marketing_name_id integer Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the ⁠<histId>⁠ of /en/history/ pages.
competition_marketing_name_marketing_name character Competition family name; slugified it is the ⁠<histSlug>⁠ of /en/history/ pages.
competition_marketing_name_code character Family code; null in every sample.

fiba_wafrobasket_schedule()

The columns of fiba_gdap_schedule():

col_name type description
game_id integer FIBA game id, global across competitions (GDAP key space): gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
game_name character Technical game name '⁠<roundId>⁠-⁠<groupPairingCode>⁠-⁠<gameNumber>⁠'.
game_number character Game number within the round or pairing (a string: '1', 'A').
status_code character Game status code: VALID (validated result), CLOS (closed, pre-2000 rows).
team_a_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_a_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_a_code character Team code (national: FIBA country code; club: a club abbreviation such as OOST).
team_a_official_name character Official name of team A: the country for a national team, the club for a club team.
team_a_short_name character Short name of team A: the country code for a national team, the club's short name for a club.
team_b_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_b_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_b_code character Team code (national: FIBA country code; club: a club abbreviation such as NANT).
team_b_official_name character Official name of team B: the country for a national team, the club for a club team.
team_b_short_name character Short name of team B: the country code for a national team, the club's short name for a club.
team_a_score integer Final score of team A.
team_b_score integer Final score of team B.
is_live logical True while the game is being played.
current_period character Last period reached ('Q4', 'OT1').
chrono character Game clock of the current period, 'mm:ss' ('00:00' when finished).
live_game_status integer Live state code: 999 on every finished game; 5 seen on a finished 2024 youth game; mapping unverified.
current_period_status character State of the current period: E = ended (the only value sampled).
host_city character City of the venue.
host_country character Country of the venue (name; a FIBA code in getgdapgameswithleaderdetailsbyteamid).
host_country_code character FIBA code of the venue's country.
venue_id integer Venue id (GDAP key space; 0 = unknown).
venue_name character Name of the arena the game is played in.
game_date_time character Tip-off in venue-local wall-clock time, ISO 8601 without offset (T00:00:00 when hasTimeGameDateTime is false).
game_date_time_utc character Tip-off in UTC, ISO 8601 without the Z.
has_time_game_date_time logical False when only the date is known (the time part is then 00:00:00).
iana_time_zone character IANA time zone of the venue.
utc_offset double Venue UTC offset at tip-off, in hours (Float64: a half-hour zone such as India +5.5 or Adelaide +9.5 is a fraction; whole hours in every sample).
is_postponed logical True when the game was postponed.
is_played_behind_closed_doors logical True when played without spectators.
venue_capacity integer Venue capacity (0 = unknown).
spectators integer Attendance at the game, as recorded by FIBA.
statistic_system character Live-stats system that scored the game: OVR (FIBA's Olympic/World Cup system), FLS (FIBA LiveStats), null before about 2006.
group_id character Group id (GDAP key space).
group_pairing_code character Group letter (group play) or pairing number (knockout bracket slot).
round_round_id integer Round id (GDAP key space, unique across competitions); the first segment of gameName.
round_round_code character Round code (GP group phase, QF, SF, F final, RS regular season, CL17-32 classification...).
round_round_name character Round label (Group Phase, Quarter-Finals, Final...).
round_round_number integer Round number within the competition (1-based).
round_round_type character Round type label: Group Round, Non Group Round, Super Round (getgdapgamesbycompetitionid uses the code G/NG here).
round_round_status_code character Round status: COMPL completed, PROGR in progress, CLOS closed.
round_game_system character Pairing system label (Single, Home and Away, Best of 3).
round_game_system_code character Pairing system code: S single game, HA home and away, BOF3 best of three.
round_start_date character Round start, local date-time.
round_end_date character Round end, local date-time (23:59:59.9999999 on the last day).
round_round_kind character Standard Round or Qualifiers.
round_round_order integer Display order of the round.
competition_competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_competition_code character Competition code (WMM men's World Cup, WOLYM, BCL, ELW...).
competition_season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
competition_official_name character Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
competition_start character First day, YYYY-MM-DD.
competition_end character Last day, YYYY-MM-DD.
competition_status character Competition status: In Progress, Completed, Closed.
competition_age_category character Age category (Senior, Under 16...).
competition_gender character Men or Women: the gender of the competition.
competition_fiba_zone character FIBA zone the competition belongs to (World, Europe, Americas...).
competition_zone_information_zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
competition_zone_information_zone_official_name character Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
competition_zone_information_zone_code character Zone code (W, E, AF, AM, AS, OC).
competition_zone_information_top_zone_id integer Parent zone id; null for top zones.
competition_zone_information_top_zone_official_name character Parent zone name; always null in the samples, values unverified.
competition_zone_information_top_zone_code character Parent zone code; always null in the samples, values unverified.
competition_competition_type character National Teams or Clubs.
competition_competition_category_is_league logical True for league-format club competitions.
competition_competition_category_age_type character Age type code: S senior, U16.
competition_competition_category_code character Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_competition_category_name character Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
competition_official_flag_item_code character Official-status code: O = official.
competition_official_flag_item_name character Official-status label.
competition_official character Official-status label.
competition_discipline character Discipline (Basketball; 3x3 is a separate platform).
competition_competition_marketing_name_competition_marketing_name_id integer Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the ⁠<histId>⁠ of /en/history/ pages.
competition_competition_marketing_name_marketing_name character Competition family name; slugified it is the ⁠<histSlug>⁠ of /en/history/ pages.
competition_competition_marketing_name_code character Family code; null in every sample.
game_statistic_status_code character Box-score validation status: VALID.
game_play_by_play_status_code character Play-by-play availability flag: VALID or EMPTY. UNRELIABLE: World Cup 2014 and EuroBasket 2017 say EMPTY but their game pages carry full play-by-play; always check the page.
game_result_status_code character Result validation status: VALID.
game_result_additional_information character Free-text result note (forfeit, overtime remark); null when none.
window_code character Qualifier window code; null otherwise.
window_name character Qualifier window name; null otherwise.
team_a_from character How team A qualified for this slot ('Winner of Game 87', '1st of group C'); null in group play.
team_b_from character How team B qualified for this slot ('Winner of Game 88', '2nd of group A'); null in group play.

fiba_wafrobasket_standings()

The columns of fiba_gdap_final_standings():

col_name type description
competition_id integer FIBA competition id (Int64) the final ranking belongs to; the comp argument.
final_rank integer Final rank in the competition.
team_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_team_code character Team abbreviation (FIBA country code or club abbreviation).
team_short_name character Short team name: the country code for a national team, the club's short name for a club.
team_profile character Team profile; null in this route.
team_status_code character Team entry status; always null in the samples, values unverified.
team_status_name character Team entry status label; always null in the samples, values unverified.
team_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.

fiba_wafrobasket_teams()

The columns of fiba_gdap_teams():

col_name type description
team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_code character Team abbreviation (FIBA country code or club abbreviation).
short_name character Short team name: the country code for a national team, the club's short name for a club.
profile_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
profile_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
profile_name character Team name as registered for the competition.
profile_code character Team code (FIBA country code or club abbreviation).
profile_country_name character Country of the team, in English.
profile_country_code character Country FIBA code.
profile_gender character Men or Women: the gender of the team's competition.
profile_facebook character Facebook handle or URL; always null in the samples, values unverified.
profile_twitter character X/Twitter handle; always null in the samples, values unverified.
profile_instagram character Instagram handle; always null in the samples, values unverified.
profile_website character The team's website address.
profile_you_tube character YouTube handle; always null in the samples, values unverified.
profile_final_ranking integer Final rank in the competition.
profile_points_per_game double The team's average points per game played.
profile_rebounds_per_game double The team's average rebounds per game played.
profile_assists_per_game double The team's average assists per game played.
profile_rank_points_per_game double Rank in the competition by points per game (1 = highest).
profile_rank_rebounds_per_game double Rank in the competition by rebounds per game (1 = highest).
profile_rank_assists_per_game double Rank in the competition by assists per game (1 = highest).
profile_total_games_won integer The team's total games won over the games played.
profile_total_games_lost integer The team's total games lost over the games played.
profile_social_networks character Social-network handles. Stored as a JSON string.
profile_competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
status_code character Team entry status: APPR approved.
status_name character Team entry status label (Approved).
organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.

fiba_wafrobasket_player_box()

The columns of fiba_gamepage_box_players():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
first_name character Given name(s) as registered with FIBA.
last_name character Last name as registered with FIBA.
jersey character Jersey number as a string.
position character Playing position code from the lineup card (PG, SG, SF, PF, C).
is_captain logical True for the team captain.
is_starter logical True for the starting five.
has_played logical True when the player got on the court.
minutes character Minutes played as an 'm:ss' string ('0:0' = did not play).
seconds_played integer Seconds played, derived from minutes.
points integer Points scored in the game.
fg_made integer Field goals made (2 + 3 points).
fg_attempted integer Field goals attempted (2 + 3 points).
fg_pct double Field-goal percentage, 0-100.
fg2_made integer Two-point field goals made.
fg2_attempted integer Two-point field goals attempted.
fg2_pct double Two-point field-goal percentage, 0-100.
fg3_made integer Three-point field goals made.
fg3_attempted integer Three-point field goals attempted.
fg3_pct double Three-point field-goal percentage, 0-100.
ft_made integer Free throws made.
ft_attempted integer Free throws attempted.
ft_pct double Free-throw percentage, 0-100.
reb_offensive integer Offensive rebounds.
reb_defensive integer Defensive rebounds.
reb_total integer Total rebounds (a team row includes the team rebounds team_reb_total).
assists integer Assists credited in the game.
steals integer Steals credited in the game.
blocks integer Blocked shots (blocks made).
blocks_received integer Own shots blocked by the opponent (blocks received).
turnovers integer Turnovers (a team row includes the team turnovers team_turnovers).
fouls integer Personal fouls (a team row includes the team fouls team_fouls).
fouls_drawn integer Fouls drawn in the game.
paint_fg_made integer Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game).
paint_fg_attempted integer Field goals attempted in the paint.
paint_fg_pct double Field-goal percentage in the paint, 0-100.
efficiency integer Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers).
plus_minus integer Plus/minus: the team's point differential while the player was on the court.
cb logical Boolean flag, false on every sampled player; meaning unverified.

fiba_wafrobasket_team_box()

The columns of fiba_gamepage_box_teams():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
score integer Team final score.
points integer Points scored in the game.
fg_made integer Field goals made (2 + 3 points).
fg_attempted integer Field goals attempted (2 + 3 points).
fg_pct double Field-goal percentage, 0-100.
fg2_made integer Two-point field goals made.
fg2_attempted integer Two-point field goals attempted.
fg2_pct double Two-point field-goal percentage, 0-100.
fg3_made integer Three-point field goals made.
fg3_attempted integer Three-point field goals attempted.
fg3_pct double Three-point field-goal percentage, 0-100.
ft_made integer Free throws made.
ft_attempted integer Free throws attempted.
ft_pct double Free-throw percentage, 0-100.
reb_offensive integer Offensive rebounds.
reb_defensive integer Defensive rebounds.
reb_total integer Total rebounds (a team row includes the team rebounds team_reb_total).
assists integer Assists credited in the game.
steals integer Steals credited in the game.
blocks integer Blocked shots (blocks made).
blocks_received integer Own shots blocked by the opponent (blocks received).
turnovers integer Turnovers (a team row includes the team turnovers team_turnovers).
fouls integer Personal fouls (a team row includes the team fouls team_fouls).
fouls_drawn integer Fouls drawn in the game.
paint_fg_made integer Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game).
paint_fg_attempted integer Field goals attempted in the paint.
paint_fg_pct double Field-goal percentage in the paint, 0-100.
efficiency integer Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers).
biggest_lead integer Biggest lead, points.
biggest_lead_score character Score when the biggest lead was reached, 'A-B' string (spacing varies; empty when the team never led).
biggest_run integer Biggest scoring run, points.
biggest_run_score character Score of the biggest scoring run, 'x-y' string; exact meaning unverified.
fast_break_points integer Fast-break points.
points_off_turnovers integer Points scored after turnovers.
bench_points integer Points from the bench (the sum of the non-starters' points).
points_in_paint integer Points in the paint (2 x paint_fg_made).
second_chance_points integer Second-chance points.
a_act integer Always 0 in the samples; meaning unverified (FIBA stat code A_ACT).
a_foul integer Always 0 in the samples; meaning unverified (FIBA stat code A_FOUL).
a_tod integer Always 0 in the samples; meaning unverified (FIBA stat code A_TOD).
a_tot integer Always 0 in the samples; meaning unverified (FIBA stat code A_TOT).
team_reb_offensive integer Team offensive rebounds, credited to no player.
team_reb_defensive integer Team defensive rebounds, credited to no player.
team_reb_total integer Team rebounds (total rebounds minus the players' sum).
team_fouls integer Team (bench/coach) fouls (personal fouls minus the players' sum).
team_turnovers integer Team turnovers (turnovers minus the players' sum).
team_bench_points_flag integer Bench points in FLS games (equal to bench_points); 0 in OVR games (FIBA stat code T_PFB).
time_led character Time the team led, 'mm:ss' string.
lead_changes integer Lead changes in the game (game-level; repeats on both team rows).
times_tied integer Times the score was tied (game-level; repeats on both team rows).
duration character Game duration as an 'h:mm' string (game-level; repeats on both team rows).
attendance integer Attendance (game-level; repeats on both team rows).

fiba_wafrobasket_pbp()

The columns of fiba_gamepage_pbp():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
period character Period name: Q1..Q4, then OT1, OT2...
period_number integer 1-based position of the period in the game.
action_id character Action id (String): '⁠<n>⁠:⁠<seq>⁠' in OVR games (3:0015), a sequence number in FLS games; unique within the game.
order integer Sort key within the period (OVR: 1, 2, ...; FLS: 1000, 2000, ...); null on some period events.
clock character Game clock: time REMAINING in the period, 'm:ss', counting down from 10:00 (5:00 in overtime).
clock_seconds integer Seconds remaining in the period, derived from clock.
wall_time_ms double Wall-clock time of the action, Unix epoch milliseconds. (Int64 in sdv-py; numeric here, the values exceed R's 32-bit integer range)
score_a integer Team A score after the action.
score_b integer Team B score after the action.
action_code character Action code: P2 two-point shot, P3 three-point shot, FT free throw, REB rebound, TREB team rebound, ASS assist, ST steal, BS block, TO turnover, TTO team turnover, FOUL foul, RFOUL foul drawn, SUBST substitution, TIMO timeout, plus period events (STARTG, STARTP, ENDP, ENDG).
action_family character Action family: shot, subst, timeout, periods, and 'unknwown' (FIBA's spelling) for every other action.
description character English action text ('3pt jump shot missed', 'defensive rebound'); null on most OVR actions.
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
player2_id integer FIBA person id (Int64) of the second player on a substitution; null when the game does not record it (the refs note FLS only, but the Paris 2024 final, an OVR game, carries it and the FLS games sampled leave it null).
sub_direction character Substitution direction: IN or OUT; null on other actions.
made logical True when the shot went in (two-pointers, three-pointers and free throws only; null otherwise).
points_attempted integer Points the attempt was worth (2, 3 or 1), made or not; null on other actions.
shot_type character Shot type derived from action_code: 2PT, 3PT or FT; null on other actions.
shot_x integer Shot x, integer pixels on a half-court image across the court width (observed 0-278, basket near x = 139). Present only on shots; free throws are 0. Which sideline is x = 0 and the scale are UNVERIFIED.
shot_y integer Shot y, integer pixels from the baseline (y = 0) towards midcourt (observed 0-224, basket near y = 25); both teams' shots are drawn on one basket. Free throws are 0. Scale UNVERIFIED.
has_location logical True when shot_x / shot_y locate the shot (two- and three-pointers); False for free throws (always 0, 0); null on other actions.

fiba_wafrobasket_shots()

The columns of fiba_gamepage_shots():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
period character Period name: Q1..Q4, then OT1, OT2...
period_number integer 1-based position of the period in the game.
action_id character Action id (String): '⁠<n>⁠:⁠<seq>⁠' in OVR games (3:0015), a sequence number in FLS games; unique within the game.
order integer Sort key within the period (OVR: 1, 2, ...; FLS: 1000, 2000, ...); null on some period events.
clock character Game clock: time REMAINING in the period, 'm:ss', counting down from 10:00 (5:00 in overtime).
clock_seconds integer Seconds remaining in the period, derived from clock.
action_code character Action code: P2 two-point shot, P3 three-point shot, FT free throw, REB rebound, TREB team rebound, ASS assist, ST steal, BS block, TO turnover, TTO team turnover, FOUL foul, RFOUL foul drawn, SUBST substitution, TIMO timeout, plus period events (STARTG, STARTP, ENDP, ENDG).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
shot_type character Shot type derived from action_code: 2PT, 3PT or FT; null on other actions.
points_attempted integer Points the attempt was worth (2, 3 or 1), made or not; null on other actions.
made logical True when the shot went in (two-pointers, three-pointers and free throws only; null otherwise).
shot_x integer Shot x, integer pixels on a half-court image across the court width (observed 0-278, basket near x = 139). Present only on shots; free throws are 0. Which sideline is x = 0 and the scale are UNVERIFIED.
shot_y integer Shot y, integer pixels from the baseline (y = 0) towards midcourt (observed 0-224, basket near y = 25); both teams' shots are drawn on one basket. Free throws are 0. Scale UNVERIFIED.
has_location logical True when shot_x / shot_y locate the shot (two- and three-pointers); False for free throws (always 0, 0); null on other actions.

See Also

Other FIBA Competition Functions: fiba_ecw_competition, fiba_elw_competition, fiba_wamericup_competition, fiba_wasiacup_competition, fiba_weurobasket_competition, fiba_woly_competition, fiba_wwc_competition


FIBA competition: FIBA Women's AmeriCup

Description

Per-competition aliases of the FIBA wrappers for FIBA Women's AmeriCup (GDAP competition family 303), named as in sdv-py. Season rule: event year (2025 = 2025).

Usage

fiba_wamericup_editions(season = NULL, to_season = NULL, return_parsed = TRUE)

fiba_wamericup_schedule(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wamericup_standings(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wamericup_teams(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wamericup_player_box(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wamericup_team_box(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wamericup_pbp(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wamericup_shots(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

Arguments

game_id

FIBA game id (game_id in the schedule).

season

Edition season key (event year (2025 = 2025)). Omitted = the newest edition that has started; a game function needs season or comp. For fiba_wamericup_editions(): the first season (inclusive), omitted = every edition.

to_season

Last season, inclusive (fiba_wamericup_editions() only).

comp

FIBA competition id (one per edition); skips the edition lookup and is needed when a season lists several editions. Checked to be an edition of this competition (one cached getGdapCompetitionById request).

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source: the GDAP developer-portal terms limit API use to 'Authorized Users' and the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers. See fiba_gdap_awards() for the shared notes.

A comp of another competition family, or one GDAP gives no family, is wehoop_asset_fetch; a season with no edition is wehoop_no_data; a season listing several editions, or a game function called with neither season nor comp, is wehoop_bad_request.

 fiba_wamericup_editions(season = 2025)
 fiba_wamericup_schedule(season = 2025)

Value

A wehoop_data tibble with the columns of the base wrapper (the raw JSON list when return_parsed = FALSE), one table per function:

fiba_wamericup_editions()

The columns of fiba_gdap_editions():

col_name type description
hosts character Host countries with their cities. Stored as a JSON string.
competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_code character Competition code (WMM men's World Cup, WOLYM, BCL, ELW...).
season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
official_name character Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
start character First day, YYYY-MM-DD.
end character Last day, YYYY-MM-DD.
status character Competition status: In Progress, Completed, Closed.
age_category character Age category (Senior, Under 16...).
gender character Men or Women: the gender of the competition.
fiba_zone character FIBA zone the competition belongs to (World, Europe, Americas...).
zone_information_zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
zone_information_zone_official_name character Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
zone_information_zone_code character Zone code (W, E, AF, AM, AS, OC).
zone_information_top_zone_id integer Parent zone id; null for top zones.
zone_information_top_zone_official_name character Parent zone name; always null in the samples, values unverified.
zone_information_top_zone_code character Parent zone code; always null in the samples, values unverified.
competition_type character National Teams or Clubs.
competition_category_is_league logical True for league-format club competitions.
competition_category_age_type character Age type code: S senior, U16.
competition_category_code character Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_category_name character Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
official_flag_item_code character Official-status code: O = official.
official_flag_item_name character Official-status label.
official character Official-status label.
discipline character Discipline (Basketball; 3x3 is a separate platform).
competition_marketing_name_competition_marketing_name_id integer Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the ⁠<histId>⁠ of /en/history/ pages.
competition_marketing_name_marketing_name character Competition family name; slugified it is the ⁠<histSlug>⁠ of /en/history/ pages.
competition_marketing_name_code character Family code; null in every sample.

fiba_wamericup_schedule()

The columns of fiba_gdap_schedule():

col_name type description
game_id integer FIBA game id, global across competitions (GDAP key space): gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
game_name character Technical game name '⁠<roundId>⁠-⁠<groupPairingCode>⁠-⁠<gameNumber>⁠'.
game_number character Game number within the round or pairing (a string: '1', 'A').
status_code character Game status code: VALID (validated result), CLOS (closed, pre-2000 rows).
team_a_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_a_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_a_code character Team code (national: FIBA country code; club: a club abbreviation such as OOST).
team_a_official_name character Official name of team A: the country for a national team, the club for a club team.
team_a_short_name character Short name of team A: the country code for a national team, the club's short name for a club.
team_b_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_b_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_b_code character Team code (national: FIBA country code; club: a club abbreviation such as NANT).
team_b_official_name character Official name of team B: the country for a national team, the club for a club team.
team_b_short_name character Short name of team B: the country code for a national team, the club's short name for a club.
team_a_score integer Final score of team A.
team_b_score integer Final score of team B.
is_live logical True while the game is being played.
current_period character Last period reached ('Q4', 'OT1').
chrono character Game clock of the current period, 'mm:ss' ('00:00' when finished).
live_game_status integer Live state code: 999 on every finished game; 5 seen on a finished 2024 youth game; mapping unverified.
current_period_status character State of the current period: E = ended (the only value sampled).
host_city character City of the venue.
host_country character Country of the venue (name; a FIBA code in getgdapgameswithleaderdetailsbyteamid).
host_country_code character FIBA code of the venue's country.
venue_id integer Venue id (GDAP key space; 0 = unknown).
venue_name character Name of the arena the game is played in.
game_date_time character Tip-off in venue-local wall-clock time, ISO 8601 without offset (T00:00:00 when hasTimeGameDateTime is false).
game_date_time_utc character Tip-off in UTC, ISO 8601 without the Z.
has_time_game_date_time logical False when only the date is known (the time part is then 00:00:00).
iana_time_zone character IANA time zone of the venue.
utc_offset double Venue UTC offset at tip-off, in hours (Float64: a half-hour zone such as India +5.5 or Adelaide +9.5 is a fraction; whole hours in every sample).
is_postponed logical True when the game was postponed.
is_played_behind_closed_doors logical True when played without spectators.
venue_capacity integer Venue capacity (0 = unknown).
spectators integer Attendance at the game, as recorded by FIBA.
statistic_system character Live-stats system that scored the game: OVR (FIBA's Olympic/World Cup system), FLS (FIBA LiveStats), null before about 2006.
group_id character Group id (GDAP key space).
group_pairing_code character Group letter (group play) or pairing number (knockout bracket slot).
round_round_id integer Round id (GDAP key space, unique across competitions); the first segment of gameName.
round_round_code character Round code (GP group phase, QF, SF, F final, RS regular season, CL17-32 classification...).
round_round_name character Round label (Group Phase, Quarter-Finals, Final...).
round_round_number integer Round number within the competition (1-based).
round_round_type character Round type label: Group Round, Non Group Round, Super Round (getgdapgamesbycompetitionid uses the code G/NG here).
round_round_status_code character Round status: COMPL completed, PROGR in progress, CLOS closed.
round_game_system character Pairing system label (Single, Home and Away, Best of 3).
round_game_system_code character Pairing system code: S single game, HA home and away, BOF3 best of three.
round_start_date character Round start, local date-time.
round_end_date character Round end, local date-time (23:59:59.9999999 on the last day).
round_round_kind character Standard Round or Qualifiers.
round_round_order integer Display order of the round.
competition_competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_competition_code character Competition code (WMM men's World Cup, WOLYM, BCL, ELW...).
competition_season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
competition_official_name character Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
competition_start character First day, YYYY-MM-DD.
competition_end character Last day, YYYY-MM-DD.
competition_status character Competition status: In Progress, Completed, Closed.
competition_age_category character Age category (Senior, Under 16...).
competition_gender character Men or Women: the gender of the competition.
competition_fiba_zone character FIBA zone the competition belongs to (World, Europe, Americas...).
competition_zone_information_zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
competition_zone_information_zone_official_name character Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
competition_zone_information_zone_code character Zone code (W, E, AF, AM, AS, OC).
competition_zone_information_top_zone_id integer Parent zone id; null for top zones.
competition_zone_information_top_zone_official_name character Parent zone name; always null in the samples, values unverified.
competition_zone_information_top_zone_code character Parent zone code; always null in the samples, values unverified.
competition_competition_type character National Teams or Clubs.
competition_competition_category_is_league logical True for league-format club competitions.
competition_competition_category_age_type character Age type code: S senior, U16.
competition_competition_category_code character Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_competition_category_name character Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
competition_official_flag_item_code character Official-status code: O = official.
competition_official_flag_item_name character Official-status label.
competition_official character Official-status label.
competition_discipline character Discipline (Basketball; 3x3 is a separate platform).
competition_competition_marketing_name_competition_marketing_name_id integer Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the ⁠<histId>⁠ of /en/history/ pages.
competition_competition_marketing_name_marketing_name character Competition family name; slugified it is the ⁠<histSlug>⁠ of /en/history/ pages.
competition_competition_marketing_name_code character Family code; null in every sample.
game_statistic_status_code character Box-score validation status: VALID.
game_play_by_play_status_code character Play-by-play availability flag: VALID or EMPTY. UNRELIABLE: World Cup 2014 and EuroBasket 2017 say EMPTY but their game pages carry full play-by-play; always check the page.
game_result_status_code character Result validation status: VALID.
game_result_additional_information character Free-text result note (forfeit, overtime remark); null when none.
window_code character Qualifier window code; null otherwise.
window_name character Qualifier window name; null otherwise.
team_a_from character How team A qualified for this slot ('Winner of Game 87', '1st of group C'); null in group play.
team_b_from character How team B qualified for this slot ('Winner of Game 88', '2nd of group A'); null in group play.

fiba_wamericup_standings()

The columns of fiba_gdap_final_standings():

col_name type description
competition_id integer FIBA competition id (Int64) the final ranking belongs to; the comp argument.
final_rank integer Final rank in the competition.
team_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_team_code character Team abbreviation (FIBA country code or club abbreviation).
team_short_name character Short team name: the country code for a national team, the club's short name for a club.
team_profile character Team profile; null in this route.
team_status_code character Team entry status; always null in the samples, values unverified.
team_status_name character Team entry status label; always null in the samples, values unverified.
team_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.

fiba_wamericup_teams()

The columns of fiba_gdap_teams():

col_name type description
team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_code character Team abbreviation (FIBA country code or club abbreviation).
short_name character Short team name: the country code for a national team, the club's short name for a club.
profile_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
profile_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
profile_name character Team name as registered for the competition.
profile_code character Team code (FIBA country code or club abbreviation).
profile_country_name character Country of the team, in English.
profile_country_code character Country FIBA code.
profile_gender character Men or Women: the gender of the team's competition.
profile_facebook character Facebook handle or URL; always null in the samples, values unverified.
profile_twitter character X/Twitter handle; always null in the samples, values unverified.
profile_instagram character Instagram handle; always null in the samples, values unverified.
profile_website character The team's website address.
profile_you_tube character YouTube handle; always null in the samples, values unverified.
profile_final_ranking integer Final rank in the competition.
profile_points_per_game double The team's average points per game played.
profile_rebounds_per_game double The team's average rebounds per game played.
profile_assists_per_game double The team's average assists per game played.
profile_rank_points_per_game double Rank in the competition by points per game (1 = highest).
profile_rank_rebounds_per_game double Rank in the competition by rebounds per game (1 = highest).
profile_rank_assists_per_game double Rank in the competition by assists per game (1 = highest).
profile_total_games_won integer The team's total games won over the games played.
profile_total_games_lost integer The team's total games lost over the games played.
profile_social_networks character Social-network handles. Stored as a JSON string.
profile_competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
status_code character Team entry status: APPR approved.
status_name character Team entry status label (Approved).
organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.

fiba_wamericup_player_box()

The columns of fiba_gamepage_box_players():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
first_name character Given name(s) as registered with FIBA.
last_name character Last name as registered with FIBA.
jersey character Jersey number as a string.
position character Playing position code from the lineup card (PG, SG, SF, PF, C).
is_captain logical True for the team captain.
is_starter logical True for the starting five.
has_played logical True when the player got on the court.
minutes character Minutes played as an 'm:ss' string ('0:0' = did not play).
seconds_played integer Seconds played, derived from minutes.
points integer Points scored in the game.
fg_made integer Field goals made (2 + 3 points).
fg_attempted integer Field goals attempted (2 + 3 points).
fg_pct double Field-goal percentage, 0-100.
fg2_made integer Two-point field goals made.
fg2_attempted integer Two-point field goals attempted.
fg2_pct double Two-point field-goal percentage, 0-100.
fg3_made integer Three-point field goals made.
fg3_attempted integer Three-point field goals attempted.
fg3_pct double Three-point field-goal percentage, 0-100.
ft_made integer Free throws made.
ft_attempted integer Free throws attempted.
ft_pct double Free-throw percentage, 0-100.
reb_offensive integer Offensive rebounds.
reb_defensive integer Defensive rebounds.
reb_total integer Total rebounds (a team row includes the team rebounds team_reb_total).
assists integer Assists credited in the game.
steals integer Steals credited in the game.
blocks integer Blocked shots (blocks made).
blocks_received integer Own shots blocked by the opponent (blocks received).
turnovers integer Turnovers (a team row includes the team turnovers team_turnovers).
fouls integer Personal fouls (a team row includes the team fouls team_fouls).
fouls_drawn integer Fouls drawn in the game.
paint_fg_made integer Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game).
paint_fg_attempted integer Field goals attempted in the paint.
paint_fg_pct double Field-goal percentage in the paint, 0-100.
efficiency integer Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers).
plus_minus integer Plus/minus: the team's point differential while the player was on the court.
cb logical Boolean flag, false on every sampled player; meaning unverified.

fiba_wamericup_team_box()

The columns of fiba_gamepage_box_teams():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
score integer Team final score.
points integer Points scored in the game.
fg_made integer Field goals made (2 + 3 points).
fg_attempted integer Field goals attempted (2 + 3 points).
fg_pct double Field-goal percentage, 0-100.
fg2_made integer Two-point field goals made.
fg2_attempted integer Two-point field goals attempted.
fg2_pct double Two-point field-goal percentage, 0-100.
fg3_made integer Three-point field goals made.
fg3_attempted integer Three-point field goals attempted.
fg3_pct double Three-point field-goal percentage, 0-100.
ft_made integer Free throws made.
ft_attempted integer Free throws attempted.
ft_pct double Free-throw percentage, 0-100.
reb_offensive integer Offensive rebounds.
reb_defensive integer Defensive rebounds.
reb_total integer Total rebounds (a team row includes the team rebounds team_reb_total).
assists integer Assists credited in the game.
steals integer Steals credited in the game.
blocks integer Blocked shots (blocks made).
blocks_received integer Own shots blocked by the opponent (blocks received).
turnovers integer Turnovers (a team row includes the team turnovers team_turnovers).
fouls integer Personal fouls (a team row includes the team fouls team_fouls).
fouls_drawn integer Fouls drawn in the game.
paint_fg_made integer Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game).
paint_fg_attempted integer Field goals attempted in the paint.
paint_fg_pct double Field-goal percentage in the paint, 0-100.
efficiency integer Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers).
biggest_lead integer Biggest lead, points.
biggest_lead_score character Score when the biggest lead was reached, 'A-B' string (spacing varies; empty when the team never led).
biggest_run integer Biggest scoring run, points.
biggest_run_score character Score of the biggest scoring run, 'x-y' string; exact meaning unverified.
fast_break_points integer Fast-break points.
points_off_turnovers integer Points scored after turnovers.
bench_points integer Points from the bench (the sum of the non-starters' points).
points_in_paint integer Points in the paint (2 x paint_fg_made).
second_chance_points integer Second-chance points.
a_act integer Always 0 in the samples; meaning unverified (FIBA stat code A_ACT).
a_foul integer Always 0 in the samples; meaning unverified (FIBA stat code A_FOUL).
a_tod integer Always 0 in the samples; meaning unverified (FIBA stat code A_TOD).
a_tot integer Always 0 in the samples; meaning unverified (FIBA stat code A_TOT).
team_reb_offensive integer Team offensive rebounds, credited to no player.
team_reb_defensive integer Team defensive rebounds, credited to no player.
team_reb_total integer Team rebounds (total rebounds minus the players' sum).
team_fouls integer Team (bench/coach) fouls (personal fouls minus the players' sum).
team_turnovers integer Team turnovers (turnovers minus the players' sum).
team_bench_points_flag integer Bench points in FLS games (equal to bench_points); 0 in OVR games (FIBA stat code T_PFB).
time_led character Time the team led, 'mm:ss' string.
lead_changes integer Lead changes in the game (game-level; repeats on both team rows).
times_tied integer Times the score was tied (game-level; repeats on both team rows).
duration character Game duration as an 'h:mm' string (game-level; repeats on both team rows).
attendance integer Attendance (game-level; repeats on both team rows).

fiba_wamericup_pbp()

The columns of fiba_gamepage_pbp():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
period character Period name: Q1..Q4, then OT1, OT2...
period_number integer 1-based position of the period in the game.
action_id character Action id (String): '⁠<n>⁠:⁠<seq>⁠' in OVR games (3:0015), a sequence number in FLS games; unique within the game.
order integer Sort key within the period (OVR: 1, 2, ...; FLS: 1000, 2000, ...); null on some period events.
clock character Game clock: time REMAINING in the period, 'm:ss', counting down from 10:00 (5:00 in overtime).
clock_seconds integer Seconds remaining in the period, derived from clock.
wall_time_ms double Wall-clock time of the action, Unix epoch milliseconds. (Int64 in sdv-py; numeric here, the values exceed R's 32-bit integer range)
score_a integer Team A score after the action.
score_b integer Team B score after the action.
action_code character Action code: P2 two-point shot, P3 three-point shot, FT free throw, REB rebound, TREB team rebound, ASS assist, ST steal, BS block, TO turnover, TTO team turnover, FOUL foul, RFOUL foul drawn, SUBST substitution, TIMO timeout, plus period events (STARTG, STARTP, ENDP, ENDG).
action_family character Action family: shot, subst, timeout, periods, and 'unknwown' (FIBA's spelling) for every other action.
description character English action text ('3pt jump shot missed', 'defensive rebound'); null on most OVR actions.
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
player2_id integer FIBA person id (Int64) of the second player on a substitution; null when the game does not record it (the refs note FLS only, but the Paris 2024 final, an OVR game, carries it and the FLS games sampled leave it null).
sub_direction character Substitution direction: IN or OUT; null on other actions.
made logical True when the shot went in (two-pointers, three-pointers and free throws only; null otherwise).
points_attempted integer Points the attempt was worth (2, 3 or 1), made or not; null on other actions.
shot_type character Shot type derived from action_code: 2PT, 3PT or FT; null on other actions.
shot_x integer Shot x, integer pixels on a half-court image across the court width (observed 0-278, basket near x = 139). Present only on shots; free throws are 0. Which sideline is x = 0 and the scale are UNVERIFIED.
shot_y integer Shot y, integer pixels from the baseline (y = 0) towards midcourt (observed 0-224, basket near y = 25); both teams' shots are drawn on one basket. Free throws are 0. Scale UNVERIFIED.
has_location logical True when shot_x / shot_y locate the shot (two- and three-pointers); False for free throws (always 0, 0); null on other actions.

fiba_wamericup_shots()

The columns of fiba_gamepage_shots():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
period character Period name: Q1..Q4, then OT1, OT2...
period_number integer 1-based position of the period in the game.
action_id character Action id (String): '⁠<n>⁠:⁠<seq>⁠' in OVR games (3:0015), a sequence number in FLS games; unique within the game.
order integer Sort key within the period (OVR: 1, 2, ...; FLS: 1000, 2000, ...); null on some period events.
clock character Game clock: time REMAINING in the period, 'm:ss', counting down from 10:00 (5:00 in overtime).
clock_seconds integer Seconds remaining in the period, derived from clock.
action_code character Action code: P2 two-point shot, P3 three-point shot, FT free throw, REB rebound, TREB team rebound, ASS assist, ST steal, BS block, TO turnover, TTO team turnover, FOUL foul, RFOUL foul drawn, SUBST substitution, TIMO timeout, plus period events (STARTG, STARTP, ENDP, ENDG).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
shot_type character Shot type derived from action_code: 2PT, 3PT or FT; null on other actions.
points_attempted integer Points the attempt was worth (2, 3 or 1), made or not; null on other actions.
made logical True when the shot went in (two-pointers, three-pointers and free throws only; null otherwise).
shot_x integer Shot x, integer pixels on a half-court image across the court width (observed 0-278, basket near x = 139). Present only on shots; free throws are 0. Which sideline is x = 0 and the scale are UNVERIFIED.
shot_y integer Shot y, integer pixels from the baseline (y = 0) towards midcourt (observed 0-224, basket near y = 25); both teams' shots are drawn on one basket. Free throws are 0. Scale UNVERIFIED.
has_location logical True when shot_x / shot_y locate the shot (two- and three-pointers); False for free throws (always 0, 0); null on other actions.

See Also

Other FIBA Competition Functions: fiba_ecw_competition, fiba_elw_competition, fiba_wafrobasket_competition, fiba_wasiacup_competition, fiba_weurobasket_competition, fiba_woly_competition, fiba_wwc_competition


FIBA competition: FIBA Women's Asia Cup (Division A)

Description

Per-competition aliases of the FIBA wrappers for FIBA Women's Asia Cup (Division A) (GDAP competition family 305), named as in sdv-py. Season rule: event year (2025 = 2025).

Usage

fiba_wasiacup_editions(season = NULL, to_season = NULL, return_parsed = TRUE)

fiba_wasiacup_schedule(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wasiacup_standings(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wasiacup_teams(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wasiacup_player_box(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wasiacup_team_box(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wasiacup_pbp(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wasiacup_shots(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

Arguments

game_id

FIBA game id (game_id in the schedule).

season

Edition season key (event year (2025 = 2025)). Omitted = the newest edition that has started; a game function needs season or comp. For fiba_wasiacup_editions(): the first season (inclusive), omitted = every edition.

to_season

Last season, inclusive (fiba_wasiacup_editions() only).

comp

FIBA competition id (one per edition); skips the edition lookup and is needed when a season lists several editions. Checked to be an edition of this competition (one cached getGdapCompetitionById request).

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source: the GDAP developer-portal terms limit API use to 'Authorized Users' and the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers. See fiba_gdap_awards() for the shared notes.

A comp of another competition family, or one GDAP gives no family, is wehoop_asset_fetch; a season with no edition is wehoop_no_data; a season listing several editions, or a game function called with neither season nor comp, is wehoop_bad_request.

 fiba_wasiacup_editions(season = 2025)
 fiba_wasiacup_schedule(season = 2025)

Value

A wehoop_data tibble with the columns of the base wrapper (the raw JSON list when return_parsed = FALSE), one table per function:

fiba_wasiacup_editions()

The columns of fiba_gdap_editions():

col_name type description
hosts character Host countries with their cities. Stored as a JSON string.
competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_code character Competition code (WMM men's World Cup, WOLYM, BCL, ELW...).
season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
official_name character Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
start character First day, YYYY-MM-DD.
end character Last day, YYYY-MM-DD.
status character Competition status: In Progress, Completed, Closed.
age_category character Age category (Senior, Under 16...).
gender character Men or Women: the gender of the competition.
fiba_zone character FIBA zone the competition belongs to (World, Europe, Americas...).
zone_information_zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
zone_information_zone_official_name character Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
zone_information_zone_code character Zone code (W, E, AF, AM, AS, OC).
zone_information_top_zone_id integer Parent zone id; null for top zones.
zone_information_top_zone_official_name character Parent zone name; always null in the samples, values unverified.
zone_information_top_zone_code character Parent zone code; always null in the samples, values unverified.
competition_type character National Teams or Clubs.
competition_category_is_league logical True for league-format club competitions.
competition_category_age_type character Age type code: S senior, U16.
competition_category_code character Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_category_name character Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
official_flag_item_code character Official-status code: O = official.
official_flag_item_name character Official-status label.
official character Official-status label.
discipline character Discipline (Basketball; 3x3 is a separate platform).
competition_marketing_name_competition_marketing_name_id integer Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the ⁠<histId>⁠ of /en/history/ pages.
competition_marketing_name_marketing_name character Competition family name; slugified it is the ⁠<histSlug>⁠ of /en/history/ pages.
competition_marketing_name_code character Family code; null in every sample.

fiba_wasiacup_schedule()

The columns of fiba_gdap_schedule():

col_name type description
game_id integer FIBA game id, global across competitions (GDAP key space): gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
game_name character Technical game name '⁠<roundId>⁠-⁠<groupPairingCode>⁠-⁠<gameNumber>⁠'.
game_number character Game number within the round or pairing (a string: '1', 'A').
status_code character Game status code: VALID (validated result), CLOS (closed, pre-2000 rows).
team_a_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_a_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_a_code character Team code (national: FIBA country code; club: a club abbreviation such as OOST).
team_a_official_name character Official name of team A: the country for a national team, the club for a club team.
team_a_short_name character Short name of team A: the country code for a national team, the club's short name for a club.
team_b_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_b_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_b_code character Team code (national: FIBA country code; club: a club abbreviation such as NANT).
team_b_official_name character Official name of team B: the country for a national team, the club for a club team.
team_b_short_name character Short name of team B: the country code for a national team, the club's short name for a club.
team_a_score integer Final score of team A.
team_b_score integer Final score of team B.
is_live logical True while the game is being played.
current_period character Last period reached ('Q4', 'OT1').
chrono character Game clock of the current period, 'mm:ss' ('00:00' when finished).
live_game_status integer Live state code: 999 on every finished game; 5 seen on a finished 2024 youth game; mapping unverified.
current_period_status character State of the current period: E = ended (the only value sampled).
host_city character City of the venue.
host_country character Country of the venue (name; a FIBA code in getgdapgameswithleaderdetailsbyteamid).
host_country_code character FIBA code of the venue's country.
venue_id integer Venue id (GDAP key space; 0 = unknown).
venue_name character Name of the arena the game is played in.
game_date_time character Tip-off in venue-local wall-clock time, ISO 8601 without offset (T00:00:00 when hasTimeGameDateTime is false).
game_date_time_utc character Tip-off in UTC, ISO 8601 without the Z.
has_time_game_date_time logical False when only the date is known (the time part is then 00:00:00).
iana_time_zone character IANA time zone of the venue.
utc_offset double Venue UTC offset at tip-off, in hours (Float64: a half-hour zone such as India +5.5 or Adelaide +9.5 is a fraction; whole hours in every sample).
is_postponed logical True when the game was postponed.
is_played_behind_closed_doors logical True when played without spectators.
venue_capacity integer Venue capacity (0 = unknown).
spectators integer Attendance at the game, as recorded by FIBA.
statistic_system character Live-stats system that scored the game: OVR (FIBA's Olympic/World Cup system), FLS (FIBA LiveStats), null before about 2006.
group_id character Group id (GDAP key space).
group_pairing_code character Group letter (group play) or pairing number (knockout bracket slot).
round_round_id integer Round id (GDAP key space, unique across competitions); the first segment of gameName.
round_round_code character Round code (GP group phase, QF, SF, F final, RS regular season, CL17-32 classification...).
round_round_name character Round label (Group Phase, Quarter-Finals, Final...).
round_round_number integer Round number within the competition (1-based).
round_round_type character Round type label: Group Round, Non Group Round, Super Round (getgdapgamesbycompetitionid uses the code G/NG here).
round_round_status_code character Round status: COMPL completed, PROGR in progress, CLOS closed.
round_game_system character Pairing system label (Single, Home and Away, Best of 3).
round_game_system_code character Pairing system code: S single game, HA home and away, BOF3 best of three.
round_start_date character Round start, local date-time.
round_end_date character Round end, local date-time (23:59:59.9999999 on the last day).
round_round_kind character Standard Round or Qualifiers.
round_round_order integer Display order of the round.
competition_competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_competition_code character Competition code (WMM men's World Cup, WOLYM, BCL, ELW...).
competition_season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
competition_official_name character Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
competition_start character First day, YYYY-MM-DD.
competition_end character Last day, YYYY-MM-DD.
competition_status character Competition status: In Progress, Completed, Closed.
competition_age_category character Age category (Senior, Under 16...).
competition_gender character Men or Women: the gender of the competition.
competition_fiba_zone character FIBA zone the competition belongs to (World, Europe, Americas...).
competition_zone_information_zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
competition_zone_information_zone_official_name character Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
competition_zone_information_zone_code character Zone code (W, E, AF, AM, AS, OC).
competition_zone_information_top_zone_id integer Parent zone id; null for top zones.
competition_zone_information_top_zone_official_name character Parent zone name; always null in the samples, values unverified.
competition_zone_information_top_zone_code character Parent zone code; always null in the samples, values unverified.
competition_competition_type character National Teams or Clubs.
competition_competition_category_is_league logical True for league-format club competitions.
competition_competition_category_age_type character Age type code: S senior, U16.
competition_competition_category_code character Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_competition_category_name character Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
competition_official_flag_item_code character Official-status code: O = official.
competition_official_flag_item_name character Official-status label.
competition_official character Official-status label.
competition_discipline character Discipline (Basketball; 3x3 is a separate platform).
competition_competition_marketing_name_competition_marketing_name_id integer Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the ⁠<histId>⁠ of /en/history/ pages.
competition_competition_marketing_name_marketing_name character Competition family name; slugified it is the ⁠<histSlug>⁠ of /en/history/ pages.
competition_competition_marketing_name_code character Family code; null in every sample.
game_statistic_status_code character Box-score validation status: VALID.
game_play_by_play_status_code character Play-by-play availability flag: VALID or EMPTY. UNRELIABLE: World Cup 2014 and EuroBasket 2017 say EMPTY but their game pages carry full play-by-play; always check the page.
game_result_status_code character Result validation status: VALID.
game_result_additional_information character Free-text result note (forfeit, overtime remark); null when none.
window_code character Qualifier window code; null otherwise.
window_name character Qualifier window name; null otherwise.
team_a_from character How team A qualified for this slot ('Winner of Game 87', '1st of group C'); null in group play.
team_b_from character How team B qualified for this slot ('Winner of Game 88', '2nd of group A'); null in group play.

fiba_wasiacup_standings()

The columns of fiba_gdap_final_standings():

col_name type description
competition_id integer FIBA competition id (Int64) the final ranking belongs to; the comp argument.
final_rank integer Final rank in the competition.
team_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_team_code character Team abbreviation (FIBA country code or club abbreviation).
team_short_name character Short team name: the country code for a national team, the club's short name for a club.
team_profile character Team profile; null in this route.
team_status_code character Team entry status; always null in the samples, values unverified.
team_status_name character Team entry status label; always null in the samples, values unverified.
team_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.

fiba_wasiacup_teams()

The columns of fiba_gdap_teams():

col_name type description
team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_code character Team abbreviation (FIBA country code or club abbreviation).
short_name character Short team name: the country code for a national team, the club's short name for a club.
profile_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
profile_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
profile_name character Team name as registered for the competition.
profile_code character Team code (FIBA country code or club abbreviation).
profile_country_name character Country of the team, in English.
profile_country_code character Country FIBA code.
profile_gender character Men or Women: the gender of the team's competition.
profile_facebook character Facebook handle or URL; always null in the samples, values unverified.
profile_twitter character X/Twitter handle; always null in the samples, values unverified.
profile_instagram character Instagram handle; always null in the samples, values unverified.
profile_website character The team's website address.
profile_you_tube character YouTube handle; always null in the samples, values unverified.
profile_final_ranking integer Final rank in the competition.
profile_points_per_game double The team's average points per game played.
profile_rebounds_per_game double The team's average rebounds per game played.
profile_assists_per_game double The team's average assists per game played.
profile_rank_points_per_game double Rank in the competition by points per game (1 = highest).
profile_rank_rebounds_per_game double Rank in the competition by rebounds per game (1 = highest).
profile_rank_assists_per_game double Rank in the competition by assists per game (1 = highest).
profile_total_games_won integer The team's total games won over the games played.
profile_total_games_lost integer The team's total games lost over the games played.
profile_social_networks character Social-network handles. Stored as a JSON string.
profile_competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
status_code character Team entry status: APPR approved.
status_name character Team entry status label (Approved).
organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.

fiba_wasiacup_player_box()

The columns of fiba_gamepage_box_players():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
first_name character Given name(s) as registered with FIBA.
last_name character Last name as registered with FIBA.
jersey character Jersey number as a string.
position character Playing position code from the lineup card (PG, SG, SF, PF, C).
is_captain logical True for the team captain.
is_starter logical True for the starting five.
has_played logical True when the player got on the court.
minutes character Minutes played as an 'm:ss' string ('0:0' = did not play).
seconds_played integer Seconds played, derived from minutes.
points integer Points scored in the game.
fg_made integer Field goals made (2 + 3 points).
fg_attempted integer Field goals attempted (2 + 3 points).
fg_pct double Field-goal percentage, 0-100.
fg2_made integer Two-point field goals made.
fg2_attempted integer Two-point field goals attempted.
fg2_pct double Two-point field-goal percentage, 0-100.
fg3_made integer Three-point field goals made.
fg3_attempted integer Three-point field goals attempted.
fg3_pct double Three-point field-goal percentage, 0-100.
ft_made integer Free throws made.
ft_attempted integer Free throws attempted.
ft_pct double Free-throw percentage, 0-100.
reb_offensive integer Offensive rebounds.
reb_defensive integer Defensive rebounds.
reb_total integer Total rebounds (a team row includes the team rebounds team_reb_total).
assists integer Assists credited in the game.
steals integer Steals credited in the game.
blocks integer Blocked shots (blocks made).
blocks_received integer Own shots blocked by the opponent (blocks received).
turnovers integer Turnovers (a team row includes the team turnovers team_turnovers).
fouls integer Personal fouls (a team row includes the team fouls team_fouls).
fouls_drawn integer Fouls drawn in the game.
paint_fg_made integer Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game).
paint_fg_attempted integer Field goals attempted in the paint.
paint_fg_pct double Field-goal percentage in the paint, 0-100.
efficiency integer Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers).
plus_minus integer Plus/minus: the team's point differential while the player was on the court.
cb logical Boolean flag, false on every sampled player; meaning unverified.

fiba_wasiacup_team_box()

The columns of fiba_gamepage_box_teams():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
score integer Team final score.
points integer Points scored in the game.
fg_made integer Field goals made (2 + 3 points).
fg_attempted integer Field goals attempted (2 + 3 points).
fg_pct double Field-goal percentage, 0-100.
fg2_made integer Two-point field goals made.
fg2_attempted integer Two-point field goals attempted.
fg2_pct double Two-point field-goal percentage, 0-100.
fg3_made integer Three-point field goals made.
fg3_attempted integer Three-point field goals attempted.
fg3_pct double Three-point field-goal percentage, 0-100.
ft_made integer Free throws made.
ft_attempted integer Free throws attempted.
ft_pct double Free-throw percentage, 0-100.
reb_offensive integer Offensive rebounds.
reb_defensive integer Defensive rebounds.
reb_total integer Total rebounds (a team row includes the team rebounds team_reb_total).
assists integer Assists credited in the game.
steals integer Steals credited in the game.
blocks integer Blocked shots (blocks made).
blocks_received integer Own shots blocked by the opponent (blocks received).
turnovers integer Turnovers (a team row includes the team turnovers team_turnovers).
fouls integer Personal fouls (a team row includes the team fouls team_fouls).
fouls_drawn integer Fouls drawn in the game.
paint_fg_made integer Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game).
paint_fg_attempted integer Field goals attempted in the paint.
paint_fg_pct double Field-goal percentage in the paint, 0-100.
efficiency integer Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers).
biggest_lead integer Biggest lead, points.
biggest_lead_score character Score when the biggest lead was reached, 'A-B' string (spacing varies; empty when the team never led).
biggest_run integer Biggest scoring run, points.
biggest_run_score character Score of the biggest scoring run, 'x-y' string; exact meaning unverified.
fast_break_points integer Fast-break points.
points_off_turnovers integer Points scored after turnovers.
bench_points integer Points from the bench (the sum of the non-starters' points).
points_in_paint integer Points in the paint (2 x paint_fg_made).
second_chance_points integer Second-chance points.
a_act integer Always 0 in the samples; meaning unverified (FIBA stat code A_ACT).
a_foul integer Always 0 in the samples; meaning unverified (FIBA stat code A_FOUL).
a_tod integer Always 0 in the samples; meaning unverified (FIBA stat code A_TOD).
a_tot integer Always 0 in the samples; meaning unverified (FIBA stat code A_TOT).
team_reb_offensive integer Team offensive rebounds, credited to no player.
team_reb_defensive integer Team defensive rebounds, credited to no player.
team_reb_total integer Team rebounds (total rebounds minus the players' sum).
team_fouls integer Team (bench/coach) fouls (personal fouls minus the players' sum).
team_turnovers integer Team turnovers (turnovers minus the players' sum).
team_bench_points_flag integer Bench points in FLS games (equal to bench_points); 0 in OVR games (FIBA stat code T_PFB).
time_led character Time the team led, 'mm:ss' string.
lead_changes integer Lead changes in the game (game-level; repeats on both team rows).
times_tied integer Times the score was tied (game-level; repeats on both team rows).
duration character Game duration as an 'h:mm' string (game-level; repeats on both team rows).
attendance integer Attendance (game-level; repeats on both team rows).

fiba_wasiacup_pbp()

The columns of fiba_gamepage_pbp():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
period character Period name: Q1..Q4, then OT1, OT2...
period_number integer 1-based position of the period in the game.
action_id character Action id (String): '⁠<n>⁠:⁠<seq>⁠' in OVR games (3:0015), a sequence number in FLS games; unique within the game.
order integer Sort key within the period (OVR: 1, 2, ...; FLS: 1000, 2000, ...); null on some period events.
clock character Game clock: time REMAINING in the period, 'm:ss', counting down from 10:00 (5:00 in overtime).
clock_seconds integer Seconds remaining in the period, derived from clock.
wall_time_ms double Wall-clock time of the action, Unix epoch milliseconds. (Int64 in sdv-py; numeric here, the values exceed R's 32-bit integer range)
score_a integer Team A score after the action.
score_b integer Team B score after the action.
action_code character Action code: P2 two-point shot, P3 three-point shot, FT free throw, REB rebound, TREB team rebound, ASS assist, ST steal, BS block, TO turnover, TTO team turnover, FOUL foul, RFOUL foul drawn, SUBST substitution, TIMO timeout, plus period events (STARTG, STARTP, ENDP, ENDG).
action_family character Action family: shot, subst, timeout, periods, and 'unknwown' (FIBA's spelling) for every other action.
description character English action text ('3pt jump shot missed', 'defensive rebound'); null on most OVR actions.
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
player2_id integer FIBA person id (Int64) of the second player on a substitution; null when the game does not record it (the refs note FLS only, but the Paris 2024 final, an OVR game, carries it and the FLS games sampled leave it null).
sub_direction character Substitution direction: IN or OUT; null on other actions.
made logical True when the shot went in (two-pointers, three-pointers and free throws only; null otherwise).
points_attempted integer Points the attempt was worth (2, 3 or 1), made or not; null on other actions.
shot_type character Shot type derived from action_code: 2PT, 3PT or FT; null on other actions.
shot_x integer Shot x, integer pixels on a half-court image across the court width (observed 0-278, basket near x = 139). Present only on shots; free throws are 0. Which sideline is x = 0 and the scale are UNVERIFIED.
shot_y integer Shot y, integer pixels from the baseline (y = 0) towards midcourt (observed 0-224, basket near y = 25); both teams' shots are drawn on one basket. Free throws are 0. Scale UNVERIFIED.
has_location logical True when shot_x / shot_y locate the shot (two- and three-pointers); False for free throws (always 0, 0); null on other actions.

fiba_wasiacup_shots()

The columns of fiba_gamepage_shots():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
period character Period name: Q1..Q4, then OT1, OT2...
period_number integer 1-based position of the period in the game.
action_id character Action id (String): '⁠<n>⁠:⁠<seq>⁠' in OVR games (3:0015), a sequence number in FLS games; unique within the game.
order integer Sort key within the period (OVR: 1, 2, ...; FLS: 1000, 2000, ...); null on some period events.
clock character Game clock: time REMAINING in the period, 'm:ss', counting down from 10:00 (5:00 in overtime).
clock_seconds integer Seconds remaining in the period, derived from clock.
action_code character Action code: P2 two-point shot, P3 three-point shot, FT free throw, REB rebound, TREB team rebound, ASS assist, ST steal, BS block, TO turnover, TTO team turnover, FOUL foul, RFOUL foul drawn, SUBST substitution, TIMO timeout, plus period events (STARTG, STARTP, ENDP, ENDG).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
shot_type character Shot type derived from action_code: 2PT, 3PT or FT; null on other actions.
points_attempted integer Points the attempt was worth (2, 3 or 1), made or not; null on other actions.
made logical True when the shot went in (two-pointers, three-pointers and free throws only; null otherwise).
shot_x integer Shot x, integer pixels on a half-court image across the court width (observed 0-278, basket near x = 139). Present only on shots; free throws are 0. Which sideline is x = 0 and the scale are UNVERIFIED.
shot_y integer Shot y, integer pixels from the baseline (y = 0) towards midcourt (observed 0-224, basket near y = 25); both teams' shots are drawn on one basket. Free throws are 0. Scale UNVERIFIED.
has_location logical True when shot_x / shot_y locate the shot (two- and three-pointers); False for free throws (always 0, 0); null on other actions.

See Also

Other FIBA Competition Functions: fiba_ecw_competition, fiba_elw_competition, fiba_wafrobasket_competition, fiba_wamericup_competition, fiba_weurobasket_competition, fiba_woly_competition, fiba_wwc_competition


FIBA competition: FIBA Women's EuroBasket

Description

Per-competition aliases of the FIBA wrappers for FIBA Women's EuroBasket (GDAP competition family 297), named as in sdv-py. Season rule: event year (2025 = 2025).

Usage

fiba_weurobasket_editions(season = NULL, to_season = NULL, return_parsed = TRUE)

fiba_weurobasket_schedule(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_weurobasket_standings(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_weurobasket_teams(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_weurobasket_player_box(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_weurobasket_team_box(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_weurobasket_pbp(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_weurobasket_shots(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

Arguments

game_id

FIBA game id (game_id in the schedule).

season

Edition season key (event year (2025 = 2025)). Omitted = the newest edition that has started; a game function needs season or comp. For fiba_weurobasket_editions(): the first season (inclusive), omitted = every edition.

to_season

Last season, inclusive (fiba_weurobasket_editions() only).

comp

FIBA competition id (one per edition); skips the edition lookup and is needed when a season lists several editions. Checked to be an edition of this competition (one cached getGdapCompetitionById request).

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source: the GDAP developer-portal terms limit API use to 'Authorized Users' and the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers. See fiba_gdap_awards() for the shared notes.

A comp of another competition family, or one GDAP gives no family, is wehoop_asset_fetch; a season with no edition is wehoop_no_data; a season listing several editions, or a game function called with neither season nor comp, is wehoop_bad_request.

 fiba_weurobasket_editions(season = 2025)
 fiba_weurobasket_schedule(season = 2025)

Value

A wehoop_data tibble with the columns of the base wrapper (the raw JSON list when return_parsed = FALSE), one table per function:

fiba_weurobasket_editions()

The columns of fiba_gdap_editions():

col_name type description
hosts character Host countries with their cities. Stored as a JSON string.
competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_code character Competition code (WMM men's World Cup, WOLYM, BCL, ELW...).
season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
official_name character Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
start character First day, YYYY-MM-DD.
end character Last day, YYYY-MM-DD.
status character Competition status: In Progress, Completed, Closed.
age_category character Age category (Senior, Under 16...).
gender character Men or Women: the gender of the competition.
fiba_zone character FIBA zone the competition belongs to (World, Europe, Americas...).
zone_information_zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
zone_information_zone_official_name character Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
zone_information_zone_code character Zone code (W, E, AF, AM, AS, OC).
zone_information_top_zone_id integer Parent zone id; null for top zones.
zone_information_top_zone_official_name character Parent zone name; always null in the samples, values unverified.
zone_information_top_zone_code character Parent zone code; always null in the samples, values unverified.
competition_type character National Teams or Clubs.
competition_category_is_league logical True for league-format club competitions.
competition_category_age_type character Age type code: S senior, U16.
competition_category_code character Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_category_name character Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
official_flag_item_code character Official-status code: O = official.
official_flag_item_name character Official-status label.
official character Official-status label.
discipline character Discipline (Basketball; 3x3 is a separate platform).
competition_marketing_name_competition_marketing_name_id integer Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the ⁠<histId>⁠ of /en/history/ pages.
competition_marketing_name_marketing_name character Competition family name; slugified it is the ⁠<histSlug>⁠ of /en/history/ pages.
competition_marketing_name_code character Family code; null in every sample.

fiba_weurobasket_schedule()

The columns of fiba_gdap_schedule():

col_name type description
game_id integer FIBA game id, global across competitions (GDAP key space): gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
game_name character Technical game name '⁠<roundId>⁠-⁠<groupPairingCode>⁠-⁠<gameNumber>⁠'.
game_number character Game number within the round or pairing (a string: '1', 'A').
status_code character Game status code: VALID (validated result), CLOS (closed, pre-2000 rows).
team_a_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_a_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_a_code character Team code (national: FIBA country code; club: a club abbreviation such as OOST).
team_a_official_name character Official name of team A: the country for a national team, the club for a club team.
team_a_short_name character Short name of team A: the country code for a national team, the club's short name for a club.
team_b_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_b_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_b_code character Team code (national: FIBA country code; club: a club abbreviation such as NANT).
team_b_official_name character Official name of team B: the country for a national team, the club for a club team.
team_b_short_name character Short name of team B: the country code for a national team, the club's short name for a club.
team_a_score integer Final score of team A.
team_b_score integer Final score of team B.
is_live logical True while the game is being played.
current_period character Last period reached ('Q4', 'OT1').
chrono character Game clock of the current period, 'mm:ss' ('00:00' when finished).
live_game_status integer Live state code: 999 on every finished game; 5 seen on a finished 2024 youth game; mapping unverified.
current_period_status character State of the current period: E = ended (the only value sampled).
host_city character City of the venue.
host_country character Country of the venue (name; a FIBA code in getgdapgameswithleaderdetailsbyteamid).
host_country_code character FIBA code of the venue's country.
venue_id integer Venue id (GDAP key space; 0 = unknown).
venue_name character Name of the arena the game is played in.
game_date_time character Tip-off in venue-local wall-clock time, ISO 8601 without offset (T00:00:00 when hasTimeGameDateTime is false).
game_date_time_utc character Tip-off in UTC, ISO 8601 without the Z.
has_time_game_date_time logical False when only the date is known (the time part is then 00:00:00).
iana_time_zone character IANA time zone of the venue.
utc_offset double Venue UTC offset at tip-off, in hours (Float64: a half-hour zone such as India +5.5 or Adelaide +9.5 is a fraction; whole hours in every sample).
is_postponed logical True when the game was postponed.
is_played_behind_closed_doors logical True when played without spectators.
venue_capacity integer Venue capacity (0 = unknown).
spectators integer Attendance at the game, as recorded by FIBA.
statistic_system character Live-stats system that scored the game: OVR (FIBA's Olympic/World Cup system), FLS (FIBA LiveStats), null before about 2006.
group_id character Group id (GDAP key space).
group_pairing_code character Group letter (group play) or pairing number (knockout bracket slot).
round_round_id integer Round id (GDAP key space, unique across competitions); the first segment of gameName.
round_round_code character Round code (GP group phase, QF, SF, F final, RS regular season, CL17-32 classification...).
round_round_name character Round label (Group Phase, Quarter-Finals, Final...).
round_round_number integer Round number within the competition (1-based).
round_round_type character Round type label: Group Round, Non Group Round, Super Round (getgdapgamesbycompetitionid uses the code G/NG here).
round_round_status_code character Round status: COMPL completed, PROGR in progress, CLOS closed.
round_game_system character Pairing system label (Single, Home and Away, Best of 3).
round_game_system_code character Pairing system code: S single game, HA home and away, BOF3 best of three.
round_start_date character Round start, local date-time.
round_end_date character Round end, local date-time (23:59:59.9999999 on the last day).
round_round_kind character Standard Round or Qualifiers.
round_round_order integer Display order of the round.
competition_competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_competition_code character Competition code (WMM men's World Cup, WOLYM, BCL, ELW...).
competition_season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
competition_official_name character Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
competition_start character First day, YYYY-MM-DD.
competition_end character Last day, YYYY-MM-DD.
competition_status character Competition status: In Progress, Completed, Closed.
competition_age_category character Age category (Senior, Under 16...).
competition_gender character Men or Women: the gender of the competition.
competition_fiba_zone character FIBA zone the competition belongs to (World, Europe, Americas...).
competition_zone_information_zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
competition_zone_information_zone_official_name character Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
competition_zone_information_zone_code character Zone code (W, E, AF, AM, AS, OC).
competition_zone_information_top_zone_id integer Parent zone id; null for top zones.
competition_zone_information_top_zone_official_name character Parent zone name; always null in the samples, values unverified.
competition_zone_information_top_zone_code character Parent zone code; always null in the samples, values unverified.
competition_competition_type character National Teams or Clubs.
competition_competition_category_is_league logical True for league-format club competitions.
competition_competition_category_age_type character Age type code: S senior, U16.
competition_competition_category_code character Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_competition_category_name character Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
competition_official_flag_item_code character Official-status code: O = official.
competition_official_flag_item_name character Official-status label.
competition_official character Official-status label.
competition_discipline character Discipline (Basketball; 3x3 is a separate platform).
competition_competition_marketing_name_competition_marketing_name_id integer Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the ⁠<histId>⁠ of /en/history/ pages.
competition_competition_marketing_name_marketing_name character Competition family name; slugified it is the ⁠<histSlug>⁠ of /en/history/ pages.
competition_competition_marketing_name_code character Family code; null in every sample.
game_statistic_status_code character Box-score validation status: VALID.
game_play_by_play_status_code character Play-by-play availability flag: VALID or EMPTY. UNRELIABLE: World Cup 2014 and EuroBasket 2017 say EMPTY but their game pages carry full play-by-play; always check the page.
game_result_status_code character Result validation status: VALID.
game_result_additional_information character Free-text result note (forfeit, overtime remark); null when none.
window_code character Qualifier window code; null otherwise.
window_name character Qualifier window name; null otherwise.
team_a_from character How team A qualified for this slot ('Winner of Game 87', '1st of group C'); null in group play.
team_b_from character How team B qualified for this slot ('Winner of Game 88', '2nd of group A'); null in group play.

fiba_weurobasket_standings()

The columns of fiba_gdap_final_standings():

col_name type description
competition_id integer FIBA competition id (Int64) the final ranking belongs to; the comp argument.
final_rank integer Final rank in the competition.
team_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_team_code character Team abbreviation (FIBA country code or club abbreviation).
team_short_name character Short team name: the country code for a national team, the club's short name for a club.
team_profile character Team profile; null in this route.
team_status_code character Team entry status; always null in the samples, values unverified.
team_status_name character Team entry status label; always null in the samples, values unverified.
team_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.

fiba_weurobasket_teams()

The columns of fiba_gdap_teams():

col_name type description
team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_code character Team abbreviation (FIBA country code or club abbreviation).
short_name character Short team name: the country code for a national team, the club's short name for a club.
profile_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
profile_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
profile_name character Team name as registered for the competition.
profile_code character Team code (FIBA country code or club abbreviation).
profile_country_name character Country of the team, in English.
profile_country_code character Country FIBA code.
profile_gender character Men or Women: the gender of the team's competition.
profile_facebook character Facebook handle or URL; always null in the samples, values unverified.
profile_twitter character X/Twitter handle; always null in the samples, values unverified.
profile_instagram character Instagram handle; always null in the samples, values unverified.
profile_website character The team's website address.
profile_you_tube character YouTube handle; always null in the samples, values unverified.
profile_final_ranking integer Final rank in the competition.
profile_points_per_game double The team's average points per game played.
profile_rebounds_per_game double The team's average rebounds per game played.
profile_assists_per_game double The team's average assists per game played.
profile_rank_points_per_game double Rank in the competition by points per game (1 = highest).
profile_rank_rebounds_per_game double Rank in the competition by rebounds per game (1 = highest).
profile_rank_assists_per_game double Rank in the competition by assists per game (1 = highest).
profile_total_games_won integer The team's total games won over the games played.
profile_total_games_lost integer The team's total games lost over the games played.
profile_social_networks character Social-network handles. Stored as a JSON string.
profile_competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
status_code character Team entry status: APPR approved.
status_name character Team entry status label (Approved).
organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.

fiba_weurobasket_player_box()

The columns of fiba_gamepage_box_players():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
first_name character Given name(s) as registered with FIBA.
last_name character Last name as registered with FIBA.
jersey character Jersey number as a string.
position character Playing position code from the lineup card (PG, SG, SF, PF, C).
is_captain logical True for the team captain.
is_starter logical True for the starting five.
has_played logical True when the player got on the court.
minutes character Minutes played as an 'm:ss' string ('0:0' = did not play).
seconds_played integer Seconds played, derived from minutes.
points integer Points scored in the game.
fg_made integer Field goals made (2 + 3 points).
fg_attempted integer Field goals attempted (2 + 3 points).
fg_pct double Field-goal percentage, 0-100.
fg2_made integer Two-point field goals made.
fg2_attempted integer Two-point field goals attempted.
fg2_pct double Two-point field-goal percentage, 0-100.
fg3_made integer Three-point field goals made.
fg3_attempted integer Three-point field goals attempted.
fg3_pct double Three-point field-goal percentage, 0-100.
ft_made integer Free throws made.
ft_attempted integer Free throws attempted.
ft_pct double Free-throw percentage, 0-100.
reb_offensive integer Offensive rebounds.
reb_defensive integer Defensive rebounds.
reb_total integer Total rebounds (a team row includes the team rebounds team_reb_total).
assists integer Assists credited in the game.
steals integer Steals credited in the game.
blocks integer Blocked shots (blocks made).
blocks_received integer Own shots blocked by the opponent (blocks received).
turnovers integer Turnovers (a team row includes the team turnovers team_turnovers).
fouls integer Personal fouls (a team row includes the team fouls team_fouls).
fouls_drawn integer Fouls drawn in the game.
paint_fg_made integer Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game).
paint_fg_attempted integer Field goals attempted in the paint.
paint_fg_pct double Field-goal percentage in the paint, 0-100.
efficiency integer Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers).
plus_minus integer Plus/minus: the team's point differential while the player was on the court.
cb logical Boolean flag, false on every sampled player; meaning unverified.

fiba_weurobasket_team_box()

The columns of fiba_gamepage_box_teams():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
score integer Team final score.
points integer Points scored in the game.
fg_made integer Field goals made (2 + 3 points).
fg_attempted integer Field goals attempted (2 + 3 points).
fg_pct double Field-goal percentage, 0-100.
fg2_made integer Two-point field goals made.
fg2_attempted integer Two-point field goals attempted.
fg2_pct double Two-point field-goal percentage, 0-100.
fg3_made integer Three-point field goals made.
fg3_attempted integer Three-point field goals attempted.
fg3_pct double Three-point field-goal percentage, 0-100.
ft_made integer Free throws made.
ft_attempted integer Free throws attempted.
ft_pct double Free-throw percentage, 0-100.
reb_offensive integer Offensive rebounds.
reb_defensive integer Defensive rebounds.
reb_total integer Total rebounds (a team row includes the team rebounds team_reb_total).
assists integer Assists credited in the game.
steals integer Steals credited in the game.
blocks integer Blocked shots (blocks made).
blocks_received integer Own shots blocked by the opponent (blocks received).
turnovers integer Turnovers (a team row includes the team turnovers team_turnovers).
fouls integer Personal fouls (a team row includes the team fouls team_fouls).
fouls_drawn integer Fouls drawn in the game.
paint_fg_made integer Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game).
paint_fg_attempted integer Field goals attempted in the paint.
paint_fg_pct double Field-goal percentage in the paint, 0-100.
efficiency integer Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers).
biggest_lead integer Biggest lead, points.
biggest_lead_score character Score when the biggest lead was reached, 'A-B' string (spacing varies; empty when the team never led).
biggest_run integer Biggest scoring run, points.
biggest_run_score character Score of the biggest scoring run, 'x-y' string; exact meaning unverified.
fast_break_points integer Fast-break points.
points_off_turnovers integer Points scored after turnovers.
bench_points integer Points from the bench (the sum of the non-starters' points).
points_in_paint integer Points in the paint (2 x paint_fg_made).
second_chance_points integer Second-chance points.
a_act integer Always 0 in the samples; meaning unverified (FIBA stat code A_ACT).
a_foul integer Always 0 in the samples; meaning unverified (FIBA stat code A_FOUL).
a_tod integer Always 0 in the samples; meaning unverified (FIBA stat code A_TOD).
a_tot integer Always 0 in the samples; meaning unverified (FIBA stat code A_TOT).
team_reb_offensive integer Team offensive rebounds, credited to no player.
team_reb_defensive integer Team defensive rebounds, credited to no player.
team_reb_total integer Team rebounds (total rebounds minus the players' sum).
team_fouls integer Team (bench/coach) fouls (personal fouls minus the players' sum).
team_turnovers integer Team turnovers (turnovers minus the players' sum).
team_bench_points_flag integer Bench points in FLS games (equal to bench_points); 0 in OVR games (FIBA stat code T_PFB).
time_led character Time the team led, 'mm:ss' string.
lead_changes integer Lead changes in the game (game-level; repeats on both team rows).
times_tied integer Times the score was tied (game-level; repeats on both team rows).
duration character Game duration as an 'h:mm' string (game-level; repeats on both team rows).
attendance integer Attendance (game-level; repeats on both team rows).

fiba_weurobasket_pbp()

The columns of fiba_gamepage_pbp():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
period character Period name: Q1..Q4, then OT1, OT2...
period_number integer 1-based position of the period in the game.
action_id character Action id (String): '⁠<n>⁠:⁠<seq>⁠' in OVR games (3:0015), a sequence number in FLS games; unique within the game.
order integer Sort key within the period (OVR: 1, 2, ...; FLS: 1000, 2000, ...); null on some period events.
clock character Game clock: time REMAINING in the period, 'm:ss', counting down from 10:00 (5:00 in overtime).
clock_seconds integer Seconds remaining in the period, derived from clock.
wall_time_ms double Wall-clock time of the action, Unix epoch milliseconds. (Int64 in sdv-py; numeric here, the values exceed R's 32-bit integer range)
score_a integer Team A score after the action.
score_b integer Team B score after the action.
action_code character Action code: P2 two-point shot, P3 three-point shot, FT free throw, REB rebound, TREB team rebound, ASS assist, ST steal, BS block, TO turnover, TTO team turnover, FOUL foul, RFOUL foul drawn, SUBST substitution, TIMO timeout, plus period events (STARTG, STARTP, ENDP, ENDG).
action_family character Action family: shot, subst, timeout, periods, and 'unknwown' (FIBA's spelling) for every other action.
description character English action text ('3pt jump shot missed', 'defensive rebound'); null on most OVR actions.
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
player2_id integer FIBA person id (Int64) of the second player on a substitution; null when the game does not record it (the refs note FLS only, but the Paris 2024 final, an OVR game, carries it and the FLS games sampled leave it null).
sub_direction character Substitution direction: IN or OUT; null on other actions.
made logical True when the shot went in (two-pointers, three-pointers and free throws only; null otherwise).
points_attempted integer Points the attempt was worth (2, 3 or 1), made or not; null on other actions.
shot_type character Shot type derived from action_code: 2PT, 3PT or FT; null on other actions.
shot_x integer Shot x, integer pixels on a half-court image across the court width (observed 0-278, basket near x = 139). Present only on shots; free throws are 0. Which sideline is x = 0 and the scale are UNVERIFIED.
shot_y integer Shot y, integer pixels from the baseline (y = 0) towards midcourt (observed 0-224, basket near y = 25); both teams' shots are drawn on one basket. Free throws are 0. Scale UNVERIFIED.
has_location logical True when shot_x / shot_y locate the shot (two- and three-pointers); False for free throws (always 0, 0); null on other actions.

fiba_weurobasket_shots()

The columns of fiba_gamepage_shots():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
period character Period name: Q1..Q4, then OT1, OT2...
period_number integer 1-based position of the period in the game.
action_id character Action id (String): '⁠<n>⁠:⁠<seq>⁠' in OVR games (3:0015), a sequence number in FLS games; unique within the game.
order integer Sort key within the period (OVR: 1, 2, ...; FLS: 1000, 2000, ...); null on some period events.
clock character Game clock: time REMAINING in the period, 'm:ss', counting down from 10:00 (5:00 in overtime).
clock_seconds integer Seconds remaining in the period, derived from clock.
action_code character Action code: P2 two-point shot, P3 three-point shot, FT free throw, REB rebound, TREB team rebound, ASS assist, ST steal, BS block, TO turnover, TTO team turnover, FOUL foul, RFOUL foul drawn, SUBST substitution, TIMO timeout, plus period events (STARTG, STARTP, ENDP, ENDG).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
shot_type character Shot type derived from action_code: 2PT, 3PT or FT; null on other actions.
points_attempted integer Points the attempt was worth (2, 3 or 1), made or not; null on other actions.
made logical True when the shot went in (two-pointers, three-pointers and free throws only; null otherwise).
shot_x integer Shot x, integer pixels on a half-court image across the court width (observed 0-278, basket near x = 139). Present only on shots; free throws are 0. Which sideline is x = 0 and the scale are UNVERIFIED.
shot_y integer Shot y, integer pixels from the baseline (y = 0) towards midcourt (observed 0-224, basket near y = 25); both teams' shots are drawn on one basket. Free throws are 0. Scale UNVERIFIED.
has_location logical True when shot_x / shot_y locate the shot (two- and three-pointers); False for free throws (always 0, 0); null on other actions.

See Also

Other FIBA Competition Functions: fiba_ecw_competition, fiba_elw_competition, fiba_wafrobasket_competition, fiba_wamericup_competition, fiba_wasiacup_competition, fiba_woly_competition, fiba_wwc_competition


FIBA competition: Women's Olympic Basketball Tournament

Description

Per-competition aliases of the FIBA wrappers for Women's Olympic Basketball Tournament (GDAP competition family 352), named as in sdv-py. Season rule: event year (Paris 2024 = 2024).

Usage

fiba_woly_editions(season = NULL, to_season = NULL, return_parsed = TRUE)

fiba_woly_schedule(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_woly_standings(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_woly_teams(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_woly_player_box(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_woly_team_box(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_woly_pbp(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_woly_shots(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

Arguments

game_id

FIBA game id (game_id in the schedule).

season

Edition season key (event year (Paris 2024 = 2024)). Omitted = the newest edition that has started; a game function needs season or comp. For fiba_woly_editions(): the first season (inclusive), omitted = every edition.

to_season

Last season, inclusive (fiba_woly_editions() only).

comp

FIBA competition id (one per edition); skips the edition lookup and is needed when a season lists several editions. Checked to be an edition of this competition (one cached getGdapCompetitionById request).

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source: the GDAP developer-portal terms limit API use to 'Authorized Users' and the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers. See fiba_gdap_awards() for the shared notes.

A comp of another competition family, or one GDAP gives no family, is wehoop_asset_fetch; a season with no edition is wehoop_no_data; a season listing several editions, or a game function called with neither season nor comp, is wehoop_bad_request.

 fiba_woly_editions(season = 2024)
 fiba_woly_schedule(season = 2024)

Value

A wehoop_data tibble with the columns of the base wrapper (the raw JSON list when return_parsed = FALSE), one table per function:

fiba_woly_editions()

The columns of fiba_gdap_editions():

col_name type description
hosts character Host countries with their cities. Stored as a JSON string.
competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_code character Competition code (WMM men's World Cup, WOLYM, BCL, ELW...).
season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
official_name character Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
start character First day, YYYY-MM-DD.
end character Last day, YYYY-MM-DD.
status character Competition status: In Progress, Completed, Closed.
age_category character Age category (Senior, Under 16...).
gender character Men or Women: the gender of the competition.
fiba_zone character FIBA zone the competition belongs to (World, Europe, Americas...).
zone_information_zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
zone_information_zone_official_name character Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
zone_information_zone_code character Zone code (W, E, AF, AM, AS, OC).
zone_information_top_zone_id integer Parent zone id; null for top zones.
zone_information_top_zone_official_name character Parent zone name; always null in the samples, values unverified.
zone_information_top_zone_code character Parent zone code; always null in the samples, values unverified.
competition_type character National Teams or Clubs.
competition_category_is_league logical True for league-format club competitions.
competition_category_age_type character Age type code: S senior, U16.
competition_category_code character Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_category_name character Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
official_flag_item_code character Official-status code: O = official.
official_flag_item_name character Official-status label.
official character Official-status label.
discipline character Discipline (Basketball; 3x3 is a separate platform).
competition_marketing_name_competition_marketing_name_id integer Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the ⁠<histId>⁠ of /en/history/ pages.
competition_marketing_name_marketing_name character Competition family name; slugified it is the ⁠<histSlug>⁠ of /en/history/ pages.
competition_marketing_name_code character Family code; null in every sample.

fiba_woly_schedule()

The columns of fiba_gdap_schedule():

col_name type description
game_id integer FIBA game id, global across competitions (GDAP key space): gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
game_name character Technical game name '⁠<roundId>⁠-⁠<groupPairingCode>⁠-⁠<gameNumber>⁠'.
game_number character Game number within the round or pairing (a string: '1', 'A').
status_code character Game status code: VALID (validated result), CLOS (closed, pre-2000 rows).
team_a_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_a_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_a_code character Team code (national: FIBA country code; club: a club abbreviation such as OOST).
team_a_official_name character Official name of team A: the country for a national team, the club for a club team.
team_a_short_name character Short name of team A: the country code for a national team, the club's short name for a club.
team_b_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_b_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_b_code character Team code (national: FIBA country code; club: a club abbreviation such as NANT).
team_b_official_name character Official name of team B: the country for a national team, the club for a club team.
team_b_short_name character Short name of team B: the country code for a national team, the club's short name for a club.
team_a_score integer Final score of team A.
team_b_score integer Final score of team B.
is_live logical True while the game is being played.
current_period character Last period reached ('Q4', 'OT1').
chrono character Game clock of the current period, 'mm:ss' ('00:00' when finished).
live_game_status integer Live state code: 999 on every finished game; 5 seen on a finished 2024 youth game; mapping unverified.
current_period_status character State of the current period: E = ended (the only value sampled).
host_city character City of the venue.
host_country character Country of the venue (name; a FIBA code in getgdapgameswithleaderdetailsbyteamid).
host_country_code character FIBA code of the venue's country.
venue_id integer Venue id (GDAP key space; 0 = unknown).
venue_name character Name of the arena the game is played in.
game_date_time character Tip-off in venue-local wall-clock time, ISO 8601 without offset (T00:00:00 when hasTimeGameDateTime is false).
game_date_time_utc character Tip-off in UTC, ISO 8601 without the Z.
has_time_game_date_time logical False when only the date is known (the time part is then 00:00:00).
iana_time_zone character IANA time zone of the venue.
utc_offset double Venue UTC offset at tip-off, in hours (Float64: a half-hour zone such as India +5.5 or Adelaide +9.5 is a fraction; whole hours in every sample).
is_postponed logical True when the game was postponed.
is_played_behind_closed_doors logical True when played without spectators.
venue_capacity integer Venue capacity (0 = unknown).
spectators integer Attendance at the game, as recorded by FIBA.
statistic_system character Live-stats system that scored the game: OVR (FIBA's Olympic/World Cup system), FLS (FIBA LiveStats), null before about 2006.
group_id character Group id (GDAP key space).
group_pairing_code character Group letter (group play) or pairing number (knockout bracket slot).
round_round_id integer Round id (GDAP key space, unique across competitions); the first segment of gameName.
round_round_code character Round code (GP group phase, QF, SF, F final, RS regular season, CL17-32 classification...).
round_round_name character Round label (Group Phase, Quarter-Finals, Final...).
round_round_number integer Round number within the competition (1-based).
round_round_type character Round type label: Group Round, Non Group Round, Super Round (getgdapgamesbycompetitionid uses the code G/NG here).
round_round_status_code character Round status: COMPL completed, PROGR in progress, CLOS closed.
round_game_system character Pairing system label (Single, Home and Away, Best of 3).
round_game_system_code character Pairing system code: S single game, HA home and away, BOF3 best of three.
round_start_date character Round start, local date-time.
round_end_date character Round end, local date-time (23:59:59.9999999 on the last day).
round_round_kind character Standard Round or Qualifiers.
round_round_order integer Display order of the round.
competition_competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_competition_code character Competition code (WMM men's World Cup, WOLYM, BCL, ELW...).
competition_season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
competition_official_name character Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
competition_start character First day, YYYY-MM-DD.
competition_end character Last day, YYYY-MM-DD.
competition_status character Competition status: In Progress, Completed, Closed.
competition_age_category character Age category (Senior, Under 16...).
competition_gender character Men or Women: the gender of the competition.
competition_fiba_zone character FIBA zone the competition belongs to (World, Europe, Americas...).
competition_zone_information_zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
competition_zone_information_zone_official_name character Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
competition_zone_information_zone_code character Zone code (W, E, AF, AM, AS, OC).
competition_zone_information_top_zone_id integer Parent zone id; null for top zones.
competition_zone_information_top_zone_official_name character Parent zone name; always null in the samples, values unverified.
competition_zone_information_top_zone_code character Parent zone code; always null in the samples, values unverified.
competition_competition_type character National Teams or Clubs.
competition_competition_category_is_league logical True for league-format club competitions.
competition_competition_category_age_type character Age type code: S senior, U16.
competition_competition_category_code character Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_competition_category_name character Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
competition_official_flag_item_code character Official-status code: O = official.
competition_official_flag_item_name character Official-status label.
competition_official character Official-status label.
competition_discipline character Discipline (Basketball; 3x3 is a separate platform).
competition_competition_marketing_name_competition_marketing_name_id integer Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the ⁠<histId>⁠ of /en/history/ pages.
competition_competition_marketing_name_marketing_name character Competition family name; slugified it is the ⁠<histSlug>⁠ of /en/history/ pages.
competition_competition_marketing_name_code character Family code; null in every sample.
game_statistic_status_code character Box-score validation status: VALID.
game_play_by_play_status_code character Play-by-play availability flag: VALID or EMPTY. UNRELIABLE: World Cup 2014 and EuroBasket 2017 say EMPTY but their game pages carry full play-by-play; always check the page.
game_result_status_code character Result validation status: VALID.
game_result_additional_information character Free-text result note (forfeit, overtime remark); null when none.
window_code character Qualifier window code; null otherwise.
window_name character Qualifier window name; null otherwise.
team_a_from character How team A qualified for this slot ('Winner of Game 87', '1st of group C'); null in group play.
team_b_from character How team B qualified for this slot ('Winner of Game 88', '2nd of group A'); null in group play.

fiba_woly_standings()

The columns of fiba_gdap_final_standings():

col_name type description
competition_id integer FIBA competition id (Int64) the final ranking belongs to; the comp argument.
final_rank integer Final rank in the competition.
team_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_team_code character Team abbreviation (FIBA country code or club abbreviation).
team_short_name character Short team name: the country code for a national team, the club's short name for a club.
team_profile character Team profile; null in this route.
team_status_code character Team entry status; always null in the samples, values unverified.
team_status_name character Team entry status label; always null in the samples, values unverified.
team_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.

fiba_woly_teams()

The columns of fiba_gdap_teams():

col_name type description
team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_code character Team abbreviation (FIBA country code or club abbreviation).
short_name character Short team name: the country code for a national team, the club's short name for a club.
profile_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
profile_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
profile_name character Team name as registered for the competition.
profile_code character Team code (FIBA country code or club abbreviation).
profile_country_name character Country of the team, in English.
profile_country_code character Country FIBA code.
profile_gender character Men or Women: the gender of the team's competition.
profile_facebook character Facebook handle or URL; always null in the samples, values unverified.
profile_twitter character X/Twitter handle; always null in the samples, values unverified.
profile_instagram character Instagram handle; always null in the samples, values unverified.
profile_website character The team's website address.
profile_you_tube character YouTube handle; always null in the samples, values unverified.
profile_final_ranking integer Final rank in the competition.
profile_points_per_game double The team's average points per game played.
profile_rebounds_per_game double The team's average rebounds per game played.
profile_assists_per_game double The team's average assists per game played.
profile_rank_points_per_game double Rank in the competition by points per game (1 = highest).
profile_rank_rebounds_per_game double Rank in the competition by rebounds per game (1 = highest).
profile_rank_assists_per_game double Rank in the competition by assists per game (1 = highest).
profile_total_games_won integer The team's total games won over the games played.
profile_total_games_lost integer The team's total games lost over the games played.
profile_social_networks character Social-network handles. Stored as a JSON string.
profile_competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
status_code character Team entry status: APPR approved.
status_name character Team entry status label (Approved).
organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.

fiba_woly_player_box()

The columns of fiba_gamepage_box_players():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
first_name character Given name(s) as registered with FIBA.
last_name character Last name as registered with FIBA.
jersey character Jersey number as a string.
position character Playing position code from the lineup card (PG, SG, SF, PF, C).
is_captain logical True for the team captain.
is_starter logical True for the starting five.
has_played logical True when the player got on the court.
minutes character Minutes played as an 'm:ss' string ('0:0' = did not play).
seconds_played integer Seconds played, derived from minutes.
points integer Points scored in the game.
fg_made integer Field goals made (2 + 3 points).
fg_attempted integer Field goals attempted (2 + 3 points).
fg_pct double Field-goal percentage, 0-100.
fg2_made integer Two-point field goals made.
fg2_attempted integer Two-point field goals attempted.
fg2_pct double Two-point field-goal percentage, 0-100.
fg3_made integer Three-point field goals made.
fg3_attempted integer Three-point field goals attempted.
fg3_pct double Three-point field-goal percentage, 0-100.
ft_made integer Free throws made.
ft_attempted integer Free throws attempted.
ft_pct double Free-throw percentage, 0-100.
reb_offensive integer Offensive rebounds.
reb_defensive integer Defensive rebounds.
reb_total integer Total rebounds (a team row includes the team rebounds team_reb_total).
assists integer Assists credited in the game.
steals integer Steals credited in the game.
blocks integer Blocked shots (blocks made).
blocks_received integer Own shots blocked by the opponent (blocks received).
turnovers integer Turnovers (a team row includes the team turnovers team_turnovers).
fouls integer Personal fouls (a team row includes the team fouls team_fouls).
fouls_drawn integer Fouls drawn in the game.
paint_fg_made integer Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game).
paint_fg_attempted integer Field goals attempted in the paint.
paint_fg_pct double Field-goal percentage in the paint, 0-100.
efficiency integer Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers).
plus_minus integer Plus/minus: the team's point differential while the player was on the court.
cb logical Boolean flag, false on every sampled player; meaning unverified.

fiba_woly_team_box()

The columns of fiba_gamepage_box_teams():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
score integer Team final score.
points integer Points scored in the game.
fg_made integer Field goals made (2 + 3 points).
fg_attempted integer Field goals attempted (2 + 3 points).
fg_pct double Field-goal percentage, 0-100.
fg2_made integer Two-point field goals made.
fg2_attempted integer Two-point field goals attempted.
fg2_pct double Two-point field-goal percentage, 0-100.
fg3_made integer Three-point field goals made.
fg3_attempted integer Three-point field goals attempted.
fg3_pct double Three-point field-goal percentage, 0-100.
ft_made integer Free throws made.
ft_attempted integer Free throws attempted.
ft_pct double Free-throw percentage, 0-100.
reb_offensive integer Offensive rebounds.
reb_defensive integer Defensive rebounds.
reb_total integer Total rebounds (a team row includes the team rebounds team_reb_total).
assists integer Assists credited in the game.
steals integer Steals credited in the game.
blocks integer Blocked shots (blocks made).
blocks_received integer Own shots blocked by the opponent (blocks received).
turnovers integer Turnovers (a team row includes the team turnovers team_turnovers).
fouls integer Personal fouls (a team row includes the team fouls team_fouls).
fouls_drawn integer Fouls drawn in the game.
paint_fg_made integer Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game).
paint_fg_attempted integer Field goals attempted in the paint.
paint_fg_pct double Field-goal percentage in the paint, 0-100.
efficiency integer Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers).
biggest_lead integer Biggest lead, points.
biggest_lead_score character Score when the biggest lead was reached, 'A-B' string (spacing varies; empty when the team never led).
biggest_run integer Biggest scoring run, points.
biggest_run_score character Score of the biggest scoring run, 'x-y' string; exact meaning unverified.
fast_break_points integer Fast-break points.
points_off_turnovers integer Points scored after turnovers.
bench_points integer Points from the bench (the sum of the non-starters' points).
points_in_paint integer Points in the paint (2 x paint_fg_made).
second_chance_points integer Second-chance points.
a_act integer Always 0 in the samples; meaning unverified (FIBA stat code A_ACT).
a_foul integer Always 0 in the samples; meaning unverified (FIBA stat code A_FOUL).
a_tod integer Always 0 in the samples; meaning unverified (FIBA stat code A_TOD).
a_tot integer Always 0 in the samples; meaning unverified (FIBA stat code A_TOT).
team_reb_offensive integer Team offensive rebounds, credited to no player.
team_reb_defensive integer Team defensive rebounds, credited to no player.
team_reb_total integer Team rebounds (total rebounds minus the players' sum).
team_fouls integer Team (bench/coach) fouls (personal fouls minus the players' sum).
team_turnovers integer Team turnovers (turnovers minus the players' sum).
team_bench_points_flag integer Bench points in FLS games (equal to bench_points); 0 in OVR games (FIBA stat code T_PFB).
time_led character Time the team led, 'mm:ss' string.
lead_changes integer Lead changes in the game (game-level; repeats on both team rows).
times_tied integer Times the score was tied (game-level; repeats on both team rows).
duration character Game duration as an 'h:mm' string (game-level; repeats on both team rows).
attendance integer Attendance (game-level; repeats on both team rows).

fiba_woly_pbp()

The columns of fiba_gamepage_pbp():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
period character Period name: Q1..Q4, then OT1, OT2...
period_number integer 1-based position of the period in the game.
action_id character Action id (String): '⁠<n>⁠:⁠<seq>⁠' in OVR games (3:0015), a sequence number in FLS games; unique within the game.
order integer Sort key within the period (OVR: 1, 2, ...; FLS: 1000, 2000, ...); null on some period events.
clock character Game clock: time REMAINING in the period, 'm:ss', counting down from 10:00 (5:00 in overtime).
clock_seconds integer Seconds remaining in the period, derived from clock.
wall_time_ms double Wall-clock time of the action, Unix epoch milliseconds. (Int64 in sdv-py; numeric here, the values exceed R's 32-bit integer range)
score_a integer Team A score after the action.
score_b integer Team B score after the action.
action_code character Action code: P2 two-point shot, P3 three-point shot, FT free throw, REB rebound, TREB team rebound, ASS assist, ST steal, BS block, TO turnover, TTO team turnover, FOUL foul, RFOUL foul drawn, SUBST substitution, TIMO timeout, plus period events (STARTG, STARTP, ENDP, ENDG).
action_family character Action family: shot, subst, timeout, periods, and 'unknwown' (FIBA's spelling) for every other action.
description character English action text ('3pt jump shot missed', 'defensive rebound'); null on most OVR actions.
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
player2_id integer FIBA person id (Int64) of the second player on a substitution; null when the game does not record it (the refs note FLS only, but the Paris 2024 final, an OVR game, carries it and the FLS games sampled leave it null).
sub_direction character Substitution direction: IN or OUT; null on other actions.
made logical True when the shot went in (two-pointers, three-pointers and free throws only; null otherwise).
points_attempted integer Points the attempt was worth (2, 3 or 1), made or not; null on other actions.
shot_type character Shot type derived from action_code: 2PT, 3PT or FT; null on other actions.
shot_x integer Shot x, integer pixels on a half-court image across the court width (observed 0-278, basket near x = 139). Present only on shots; free throws are 0. Which sideline is x = 0 and the scale are UNVERIFIED.
shot_y integer Shot y, integer pixels from the baseline (y = 0) towards midcourt (observed 0-224, basket near y = 25); both teams' shots are drawn on one basket. Free throws are 0. Scale UNVERIFIED.
has_location logical True when shot_x / shot_y locate the shot (two- and three-pointers); False for free throws (always 0, 0); null on other actions.

fiba_woly_shots()

The columns of fiba_gamepage_shots():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
period character Period name: Q1..Q4, then OT1, OT2...
period_number integer 1-based position of the period in the game.
action_id character Action id (String): '⁠<n>⁠:⁠<seq>⁠' in OVR games (3:0015), a sequence number in FLS games; unique within the game.
order integer Sort key within the period (OVR: 1, 2, ...; FLS: 1000, 2000, ...); null on some period events.
clock character Game clock: time REMAINING in the period, 'm:ss', counting down from 10:00 (5:00 in overtime).
clock_seconds integer Seconds remaining in the period, derived from clock.
action_code character Action code: P2 two-point shot, P3 three-point shot, FT free throw, REB rebound, TREB team rebound, ASS assist, ST steal, BS block, TO turnover, TTO team turnover, FOUL foul, RFOUL foul drawn, SUBST substitution, TIMO timeout, plus period events (STARTG, STARTP, ENDP, ENDG).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
shot_type character Shot type derived from action_code: 2PT, 3PT or FT; null on other actions.
points_attempted integer Points the attempt was worth (2, 3 or 1), made or not; null on other actions.
made logical True when the shot went in (two-pointers, three-pointers and free throws only; null otherwise).
shot_x integer Shot x, integer pixels on a half-court image across the court width (observed 0-278, basket near x = 139). Present only on shots; free throws are 0. Which sideline is x = 0 and the scale are UNVERIFIED.
shot_y integer Shot y, integer pixels from the baseline (y = 0) towards midcourt (observed 0-224, basket near y = 25); both teams' shots are drawn on one basket. Free throws are 0. Scale UNVERIFIED.
has_location logical True when shot_x / shot_y locate the shot (two- and three-pointers); False for free throws (always 0, 0); null on other actions.

See Also

Other FIBA Competition Functions: fiba_ecw_competition, fiba_elw_competition, fiba_wafrobasket_competition, fiba_wamericup_competition, fiba_wasiacup_competition, fiba_weurobasket_competition, fiba_wwc_competition


FIBA competition: FIBA Women's Basketball World Cup

Description

Per-competition aliases of the FIBA wrappers for FIBA Women's Basketball World Cup (GDAP competition family 306), named as in sdv-py. Season rule: event year (2022 = 2022).

Usage

fiba_wwc_editions(season = NULL, to_season = NULL, return_parsed = TRUE)

fiba_wwc_schedule(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wwc_standings(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wwc_teams(season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wwc_player_box(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wwc_team_box(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wwc_pbp(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

fiba_wwc_shots(game_id, season = NULL, comp = NULL, return_parsed = TRUE)

Arguments

game_id

FIBA game id (game_id in the schedule).

season

Edition season key (event year (2022 = 2022)). Omitted = the newest edition that has started; a game function needs season or comp. For fiba_wwc_editions(): the first season (inclusive), omitted = every edition.

to_season

Last season, inclusive (fiba_wwc_editions() only).

comp

FIBA competition id (one per edition); skips the edition lookup and is needed when a season lists several editions. Checked to be an edition of this competition (one cached getGdapCompetitionById request).

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Details

FIBA's terms restrict this source: the GDAP developer-portal terms limit API use to 'Authorized Users' and the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers. See fiba_gdap_awards() for the shared notes.

A comp of another competition family, or one GDAP gives no family, is wehoop_asset_fetch; a season with no edition is wehoop_no_data; a season listing several editions, or a game function called with neither season nor comp, is wehoop_bad_request.

 fiba_wwc_editions(season = 2022)
 fiba_wwc_schedule(season = 2022)

Value

A wehoop_data tibble with the columns of the base wrapper (the raw JSON list when return_parsed = FALSE), one table per function:

fiba_wwc_editions()

The columns of fiba_gdap_editions():

col_name type description
hosts character Host countries with their cities. Stored as a JSON string.
competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_code character Competition code (WMM men's World Cup, WOLYM, BCL, ELW...).
season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
official_name character Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
start character First day, YYYY-MM-DD.
end character Last day, YYYY-MM-DD.
status character Competition status: In Progress, Completed, Closed.
age_category character Age category (Senior, Under 16...).
gender character Men or Women: the gender of the competition.
fiba_zone character FIBA zone the competition belongs to (World, Europe, Americas...).
zone_information_zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
zone_information_zone_official_name character Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
zone_information_zone_code character Zone code (W, E, AF, AM, AS, OC).
zone_information_top_zone_id integer Parent zone id; null for top zones.
zone_information_top_zone_official_name character Parent zone name; always null in the samples, values unverified.
zone_information_top_zone_code character Parent zone code; always null in the samples, values unverified.
competition_type character National Teams or Clubs.
competition_category_is_league logical True for league-format club competitions.
competition_category_age_type character Age type code: S senior, U16.
competition_category_code character Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_category_name character Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
official_flag_item_code character Official-status code: O = official.
official_flag_item_name character Official-status label.
official character Official-status label.
discipline character Discipline (Basketball; 3x3 is a separate platform).
competition_marketing_name_competition_marketing_name_id integer Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the ⁠<histId>⁠ of /en/history/ pages.
competition_marketing_name_marketing_name character Competition family name; slugified it is the ⁠<histSlug>⁠ of /en/history/ pages.
competition_marketing_name_code character Family code; null in every sample.

fiba_wwc_schedule()

The columns of fiba_gdap_schedule():

col_name type description
game_id integer FIBA game id, global across competitions (GDAP key space): gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
game_name character Technical game name '⁠<roundId>⁠-⁠<groupPairingCode>⁠-⁠<gameNumber>⁠'.
game_number character Game number within the round or pairing (a string: '1', 'A').
status_code character Game status code: VALID (validated result), CLOS (closed, pre-2000 rows).
team_a_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_a_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_a_code character Team code (national: FIBA country code; club: a club abbreviation such as OOST).
team_a_official_name character Official name of team A: the country for a national team, the club for a club team.
team_a_short_name character Short name of team A: the country code for a national team, the club's short name for a club.
team_b_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_b_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
team_b_code character Team code (national: FIBA country code; club: a club abbreviation such as NANT).
team_b_official_name character Official name of team B: the country for a national team, the club for a club team.
team_b_short_name character Short name of team B: the country code for a national team, the club's short name for a club.
team_a_score integer Final score of team A.
team_b_score integer Final score of team B.
is_live logical True while the game is being played.
current_period character Last period reached ('Q4', 'OT1').
chrono character Game clock of the current period, 'mm:ss' ('00:00' when finished).
live_game_status integer Live state code: 999 on every finished game; 5 seen on a finished 2024 youth game; mapping unverified.
current_period_status character State of the current period: E = ended (the only value sampled).
host_city character City of the venue.
host_country character Country of the venue (name; a FIBA code in getgdapgameswithleaderdetailsbyteamid).
host_country_code character FIBA code of the venue's country.
venue_id integer Venue id (GDAP key space; 0 = unknown).
venue_name character Name of the arena the game is played in.
game_date_time character Tip-off in venue-local wall-clock time, ISO 8601 without offset (T00:00:00 when hasTimeGameDateTime is false).
game_date_time_utc character Tip-off in UTC, ISO 8601 without the Z.
has_time_game_date_time logical False when only the date is known (the time part is then 00:00:00).
iana_time_zone character IANA time zone of the venue.
utc_offset double Venue UTC offset at tip-off, in hours (Float64: a half-hour zone such as India +5.5 or Adelaide +9.5 is a fraction; whole hours in every sample).
is_postponed logical True when the game was postponed.
is_played_behind_closed_doors logical True when played without spectators.
venue_capacity integer Venue capacity (0 = unknown).
spectators integer Attendance at the game, as recorded by FIBA.
statistic_system character Live-stats system that scored the game: OVR (FIBA's Olympic/World Cup system), FLS (FIBA LiveStats), null before about 2006.
group_id character Group id (GDAP key space).
group_pairing_code character Group letter (group play) or pairing number (knockout bracket slot).
round_round_id integer Round id (GDAP key space, unique across competitions); the first segment of gameName.
round_round_code character Round code (GP group phase, QF, SF, F final, RS regular season, CL17-32 classification...).
round_round_name character Round label (Group Phase, Quarter-Finals, Final...).
round_round_number integer Round number within the competition (1-based).
round_round_type character Round type label: Group Round, Non Group Round, Super Round (getgdapgamesbycompetitionid uses the code G/NG here).
round_round_status_code character Round status: COMPL completed, PROGR in progress, CLOS closed.
round_game_system character Pairing system label (Single, Home and Away, Best of 3).
round_game_system_code character Pairing system code: S single game, HA home and away, BOF3 best of three.
round_start_date character Round start, local date-time.
round_end_date character Round end, local date-time (23:59:59.9999999 on the last day).
round_round_kind character Standard Round or Qualifiers.
round_round_order integer Display order of the round.
competition_competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_competition_code character Competition code (WMM men's World Cup, WOLYM, BCL, ELW...).
competition_season integer Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
competition_official_name character Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
competition_start character First day, YYYY-MM-DD.
competition_end character Last day, YYYY-MM-DD.
competition_status character Competition status: In Progress, Completed, Closed.
competition_age_category character Age category (Senior, Under 16...).
competition_gender character Men or Women: the gender of the competition.
competition_fiba_zone character FIBA zone the competition belongs to (World, Europe, Americas...).
competition_zone_information_zone_id integer FIBA zone id (1 = World, 23 = Europe; zone table key space).
competition_zone_information_zone_official_name character Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
competition_zone_information_zone_code character Zone code (W, E, AF, AM, AS, OC).
competition_zone_information_top_zone_id integer Parent zone id; null for top zones.
competition_zone_information_top_zone_official_name character Parent zone name; always null in the samples, values unverified.
competition_zone_information_top_zone_code character Parent zone code; always null in the samples, values unverified.
competition_competition_type character National Teams or Clubs.
competition_competition_category_is_league logical True for league-format club competitions.
competition_competition_category_age_type character Age type code: S senior, U16.
competition_competition_category_code character Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_competition_category_name character Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
competition_official_flag_item_code character Official-status code: O = official.
competition_official_flag_item_name character Official-status label.
competition_official character Official-status label.
competition_discipline character Discipline (Basketball; 3x3 is a separate platform).
competition_competition_marketing_name_competition_marketing_name_id integer Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the ⁠<histId>⁠ of /en/history/ pages.
competition_competition_marketing_name_marketing_name character Competition family name; slugified it is the ⁠<histSlug>⁠ of /en/history/ pages.
competition_competition_marketing_name_code character Family code; null in every sample.
game_statistic_status_code character Box-score validation status: VALID.
game_play_by_play_status_code character Play-by-play availability flag: VALID or EMPTY. UNRELIABLE: World Cup 2014 and EuroBasket 2017 say EMPTY but their game pages carry full play-by-play; always check the page.
game_result_status_code character Result validation status: VALID.
game_result_additional_information character Free-text result note (forfeit, overtime remark); null when none.
window_code character Qualifier window code; null otherwise.
window_name character Qualifier window name; null otherwise.
team_a_from character How team A qualified for this slot ('Winner of Game 87', '1st of group C'); null in group play.
team_b_from character How team B qualified for this slot ('Winner of Game 88', '2nd of group A'); null in group play.

fiba_wwc_standings()

The columns of fiba_gdap_final_standings():

col_name type description
competition_id integer FIBA competition id (Int64) the final ranking belongs to; the comp argument.
final_rank integer Final rank in the competition.
team_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_team_code character Team abbreviation (FIBA country code or club abbreviation).
team_short_name character Short team name: the country code for a national team, the club's short name for a club.
team_profile character Team profile; null in this route.
team_status_code character Team entry status; always null in the samples, values unverified.
team_status_name character Team entry status label; always null in the samples, values unverified.
team_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.

fiba_wwc_teams()

The columns of fiba_gdap_teams():

col_name type description
team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_code character Team abbreviation (FIBA country code or club abbreviation).
short_name character Short team name: the country code for a national team, the club's short name for a club.
profile_team_id integer Competition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
profile_organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.
profile_name character Team name as registered for the competition.
profile_code character Team code (FIBA country code or club abbreviation).
profile_country_name character Country of the team, in English.
profile_country_code character Country FIBA code.
profile_gender character Men or Women: the gender of the team's competition.
profile_facebook character Facebook handle or URL; always null in the samples, values unverified.
profile_twitter character X/Twitter handle; always null in the samples, values unverified.
profile_instagram character Instagram handle; always null in the samples, values unverified.
profile_website character The team's website address.
profile_you_tube character YouTube handle; always null in the samples, values unverified.
profile_final_ranking integer Final rank in the competition.
profile_points_per_game double The team's average points per game played.
profile_rebounds_per_game double The team's average rebounds per game played.
profile_assists_per_game double The team's average assists per game played.
profile_rank_points_per_game double Rank in the competition by points per game (1 = highest).
profile_rank_rebounds_per_game double Rank in the competition by rebounds per game (1 = highest).
profile_rank_assists_per_game double Rank in the competition by assists per game (1 = highest).
profile_total_games_won integer The team's total games won over the games played.
profile_total_games_lost integer The team's total games lost over the games played.
profile_social_networks character Social-network handles. Stored as a JSON string.
profile_competition_id integer FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
status_code character Team entry status: APPR approved.
status_name character Team entry status label (Approved).
organisation_id integer Organisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_⁠<id>⁠.

fiba_wwc_player_box()

The columns of fiba_gamepage_box_players():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
first_name character Given name(s) as registered with FIBA.
last_name character Last name as registered with FIBA.
jersey character Jersey number as a string.
position character Playing position code from the lineup card (PG, SG, SF, PF, C).
is_captain logical True for the team captain.
is_starter logical True for the starting five.
has_played logical True when the player got on the court.
minutes character Minutes played as an 'm:ss' string ('0:0' = did not play).
seconds_played integer Seconds played, derived from minutes.
points integer Points scored in the game.
fg_made integer Field goals made (2 + 3 points).
fg_attempted integer Field goals attempted (2 + 3 points).
fg_pct double Field-goal percentage, 0-100.
fg2_made integer Two-point field goals made.
fg2_attempted integer Two-point field goals attempted.
fg2_pct double Two-point field-goal percentage, 0-100.
fg3_made integer Three-point field goals made.
fg3_attempted integer Three-point field goals attempted.
fg3_pct double Three-point field-goal percentage, 0-100.
ft_made integer Free throws made.
ft_attempted integer Free throws attempted.
ft_pct double Free-throw percentage, 0-100.
reb_offensive integer Offensive rebounds.
reb_defensive integer Defensive rebounds.
reb_total integer Total rebounds (a team row includes the team rebounds team_reb_total).
assists integer Assists credited in the game.
steals integer Steals credited in the game.
blocks integer Blocked shots (blocks made).
blocks_received integer Own shots blocked by the opponent (blocks received).
turnovers integer Turnovers (a team row includes the team turnovers team_turnovers).
fouls integer Personal fouls (a team row includes the team fouls team_fouls).
fouls_drawn integer Fouls drawn in the game.
paint_fg_made integer Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game).
paint_fg_attempted integer Field goals attempted in the paint.
paint_fg_pct double Field-goal percentage in the paint, 0-100.
efficiency integer Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers).
plus_minus integer Plus/minus: the team's point differential while the player was on the court.
cb logical Boolean flag, false on every sampled player; meaning unverified.

fiba_wwc_team_box()

The columns of fiba_gamepage_box_teams():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
score integer Team final score.
points integer Points scored in the game.
fg_made integer Field goals made (2 + 3 points).
fg_attempted integer Field goals attempted (2 + 3 points).
fg_pct double Field-goal percentage, 0-100.
fg2_made integer Two-point field goals made.
fg2_attempted integer Two-point field goals attempted.
fg2_pct double Two-point field-goal percentage, 0-100.
fg3_made integer Three-point field goals made.
fg3_attempted integer Three-point field goals attempted.
fg3_pct double Three-point field-goal percentage, 0-100.
ft_made integer Free throws made.
ft_attempted integer Free throws attempted.
ft_pct double Free-throw percentage, 0-100.
reb_offensive integer Offensive rebounds.
reb_defensive integer Defensive rebounds.
reb_total integer Total rebounds (a team row includes the team rebounds team_reb_total).
assists integer Assists credited in the game.
steals integer Steals credited in the game.
blocks integer Blocked shots (blocks made).
blocks_received integer Own shots blocked by the opponent (blocks received).
turnovers integer Turnovers (a team row includes the team turnovers team_turnovers).
fouls integer Personal fouls (a team row includes the team fouls team_fouls).
fouls_drawn integer Fouls drawn in the game.
paint_fg_made integer Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game).
paint_fg_attempted integer Field goals attempted in the paint.
paint_fg_pct double Field-goal percentage in the paint, 0-100.
efficiency integer Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers).
biggest_lead integer Biggest lead, points.
biggest_lead_score character Score when the biggest lead was reached, 'A-B' string (spacing varies; empty when the team never led).
biggest_run integer Biggest scoring run, points.
biggest_run_score character Score of the biggest scoring run, 'x-y' string; exact meaning unverified.
fast_break_points integer Fast-break points.
points_off_turnovers integer Points scored after turnovers.
bench_points integer Points from the bench (the sum of the non-starters' points).
points_in_paint integer Points in the paint (2 x paint_fg_made).
second_chance_points integer Second-chance points.
a_act integer Always 0 in the samples; meaning unverified (FIBA stat code A_ACT).
a_foul integer Always 0 in the samples; meaning unverified (FIBA stat code A_FOUL).
a_tod integer Always 0 in the samples; meaning unverified (FIBA stat code A_TOD).
a_tot integer Always 0 in the samples; meaning unverified (FIBA stat code A_TOT).
team_reb_offensive integer Team offensive rebounds, credited to no player.
team_reb_defensive integer Team defensive rebounds, credited to no player.
team_reb_total integer Team rebounds (total rebounds minus the players' sum).
team_fouls integer Team (bench/coach) fouls (personal fouls minus the players' sum).
team_turnovers integer Team turnovers (turnovers minus the players' sum).
team_bench_points_flag integer Bench points in FLS games (equal to bench_points); 0 in OVR games (FIBA stat code T_PFB).
time_led character Time the team led, 'mm:ss' string.
lead_changes integer Lead changes in the game (game-level; repeats on both team rows).
times_tied integer Times the score was tied (game-level; repeats on both team rows).
duration character Game duration as an 'h:mm' string (game-level; repeats on both team rows).
attendance integer Attendance (game-level; repeats on both team rows).

fiba_wwc_pbp()

The columns of fiba_gamepage_pbp():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
period character Period name: Q1..Q4, then OT1, OT2...
period_number integer 1-based position of the period in the game.
action_id character Action id (String): '⁠<n>⁠:⁠<seq>⁠' in OVR games (3:0015), a sequence number in FLS games; unique within the game.
order integer Sort key within the period (OVR: 1, 2, ...; FLS: 1000, 2000, ...); null on some period events.
clock character Game clock: time REMAINING in the period, 'm:ss', counting down from 10:00 (5:00 in overtime).
clock_seconds integer Seconds remaining in the period, derived from clock.
wall_time_ms double Wall-clock time of the action, Unix epoch milliseconds. (Int64 in sdv-py; numeric here, the values exceed R's 32-bit integer range)
score_a integer Team A score after the action.
score_b integer Team B score after the action.
action_code character Action code: P2 two-point shot, P3 three-point shot, FT free throw, REB rebound, TREB team rebound, ASS assist, ST steal, BS block, TO turnover, TTO team turnover, FOUL foul, RFOUL foul drawn, SUBST substitution, TIMO timeout, plus period events (STARTG, STARTP, ENDP, ENDG).
action_family character Action family: shot, subst, timeout, periods, and 'unknwown' (FIBA's spelling) for every other action.
description character English action text ('3pt jump shot missed', 'defensive rebound'); null on most OVR actions.
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
player2_id integer FIBA person id (Int64) of the second player on a substitution; null when the game does not record it (the refs note FLS only, but the Paris 2024 final, an OVR game, carries it and the FLS games sampled leave it null).
sub_direction character Substitution direction: IN or OUT; null on other actions.
made logical True when the shot went in (two-pointers, three-pointers and free throws only; null otherwise).
points_attempted integer Points the attempt was worth (2, 3 or 1), made or not; null on other actions.
shot_type character Shot type derived from action_code: 2PT, 3PT or FT; null on other actions.
shot_x integer Shot x, integer pixels on a half-court image across the court width (observed 0-278, basket near x = 139). Present only on shots; free throws are 0. Which sideline is x = 0 and the scale are UNVERIFIED.
shot_y integer Shot y, integer pixels from the baseline (y = 0) towards midcourt (observed 0-224, basket near y = 25); both teams' shots are drawn on one basket. Free throws are 0. Scale UNVERIFIED.
has_location logical True when shot_x / shot_y locate the shot (two- and three-pointers); False for free throws (always 0, 0); null on other actions.

fiba_wwc_shots()

The columns of fiba_gamepage_shots():

col_name type description
game_id integer FIBA game id (Int64), global across competitions: gdapGameId, the ⁠<gameId>⁠ of a game-page URL.
competition_id integer FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_system character Live-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
period character Period name: Q1..Q4, then OT1, OT2...
period_number integer 1-based position of the period in the game.
action_id character Action id (String): '⁠<n>⁠:⁠<seq>⁠' in OVR games (3:0015), a sequence number in FLS games; unique within the game.
order integer Sort key within the period (OVR: 1, 2, ...; FLS: 1000, 2000, ...); null on some period events.
clock character Game clock: time REMAINING in the period, 'm:ss', counting down from 10:00 (5:00 in overtime).
clock_seconds integer Seconds remaining in the period, derived from clock.
action_code character Action code: P2 two-point shot, P3 three-point shot, FT free throw, REB rebound, TREB team rebound, ASS assist, ST steal, BS block, TO turnover, TTO team turnover, FOUL foul, RFOUL foul drawn, SUBST substitution, TIMO timeout, plus period events (STARTG, STARTP, ENDP, ENDG).
organisation_id integer Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_⁠<id>⁠ and the play-by-play oId. NOT the per-competition team_id.
team_side character A or B: whether the row is the schedule's team A or team B (null when the page does not say).
player_id integer FIBA person id (Int64), global across competitions and roles: the page's P_⁠<id>⁠, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
shot_type character Shot type derived from action_code: 2PT, 3PT or FT; null on other actions.
points_attempted integer Points the attempt was worth (2, 3 or 1), made or not; null on other actions.
made logical True when the shot went in (two-pointers, three-pointers and free throws only; null otherwise).
shot_x integer Shot x, integer pixels on a half-court image across the court width (observed 0-278, basket near x = 139). Present only on shots; free throws are 0. Which sideline is x = 0 and the scale are UNVERIFIED.
shot_y integer Shot y, integer pixels from the baseline (y = 0) towards midcourt (observed 0-224, basket near y = 25); both teams' shots are drawn on one basket. Free throws are 0. Scale UNVERIFIED.
has_location logical True when shot_x / shot_y locate the shot (two- and three-pointers); False for free throws (always 0, 0); null on other actions.

See Also

Other FIBA Competition Functions: fiba_ecw_competition, fiba_elw_competition, fiba_wafrobasket_competition, fiba_wamericup_competition, fiba_wasiacup_competition, fiba_weurobasket_competition, fiba_woly_competition


Get Fox Sports basketball statistical leaders

Description

Get Fox Sports (Bifrost) WNBA / women's college basketball (WBB) statistical leaders. fox_wnba_league_leaders() hits the wnba slug; fox_wbb_league_leaders() hits the wcbk slug.

Usage

fox_wnba_league_leaders(category = "scoring", who = "player", page = 0)

fox_wbb_league_leaders(category = "scoring", who = "player", page = 0)

Arguments

category

Stat category (default "scoring").

who

"player" or "team" (default "player").

page

0-based page index (default 0).

Value

A wehoop_data tibble of leaderboard rows (entity_id + stat columns).

See Also

Other Fox Sports Functions: fox_wbb_teams_all(), fox_wnba_pbp(), fox_wnba_team_roster()

Examples

try(fox_wnba_league_leaders("scoring"))


  try(fox_wbb_league_leaders("scoring"))

Get the full Fox Sports women's college basketball team directory

Description

Enumerate every WBB team in the Fox Sports (Bifrost) directory. A single fox_wbb_teams() call only returns the seed team's conference, so this walks unseen team ids (calling one seed per conference) and unions the results.

Usage

fox_wbb_teams_all(max_id = 500, max_calls = 60)

Arguments

max_id

Highest Fox team id to probe as a seed (default 500).

max_calls

Safety cap on the number of standings calls (default 60).

Value

A wehoop_data tibble, one row per team: fox_team_id, fox_team_name, fox_section.

See Also

Other Fox Sports Functions: fox_basketball_league_leaders, fox_wnba_pbp(), fox_wnba_team_roster()

Examples

try(fox_wbb_teams_all())

Get Fox Sports basketball play-by-play

Description

Get Fox Sports (Bifrost) WNBA / women's college basketball (WBB) play-by-play. fox_wnba_pbp() hits the wnba slug; fox_wbb_pbp() hits the wcbk slug.

Get Fox Sports (Bifrost) WNBA / women's college basketball (WBB) boxscore. fox_wnba_boxscore() hits the wnba slug; fox_wbb_boxscore() hits the wcbk slug.

Get Fox Sports (Bifrost) WNBA / women's college basketball (WBB) game odds. fox_wnba_odds() hits the wnba slug; fox_wbb_odds() hits the wcbk slug.

Usage

fox_wnba_pbp(game_id)

fox_wbb_pbp(game_id)

fox_wnba_boxscore(game_id)

fox_wbb_boxscore(game_id)

fox_wnba_odds(game_id)

fox_wbb_odds(game_id)

Arguments

game_id

Fox Bifrost event id.

Value

A wehoop_data tibble, one row per play: game_id, period, left_team, right_team, play_id, clock, team, left_score_change, right_score_change, play_text.

A wehoop_data tibble (long), one row per (player, stat): game_id, team, stat_group, player, athlete_id, stat, value.

A wehoop_data tibble, one row per team: game_id, team, plus the six-pack odds columns (spread / to-win / total). Empty when no market.

See Also

Other Fox Sports Functions: fox_basketball_league_leaders, fox_wbb_teams_all(), fox_wnba_team_roster()

Examples

try(fox_wnba_pbp("2215"))


  try(fox_wbb_pbp("388986"))


  try(fox_wnba_boxscore("2215"))


  try(fox_wbb_boxscore("388986"))


  try(fox_wnba_odds("2215"))


  try(fox_wbb_odds("388986"))

Get Fox Sports basketball team roster

Description

Get Fox Sports (Bifrost) WNBA / women's college basketball (WBB) team roster. fox_wnba_team_roster() hits the wnba slug; fox_wbb_team_roster() hits the wcbk slug.

Get Fox Sports (Bifrost) WNBA / women's college basketball (WBB) team stat leaders. fox_wnba_team_stats() hits the wnba slug; fox_wbb_team_stats() hits the wcbk slug.

Get Fox Sports (Bifrost) WNBA / women's college basketball (WBB) team game log. fox_wnba_team_gamelog() hits the wnba slug; fox_wbb_team_gamelog() hits the wcbk slug.

Get Fox Sports (Bifrost) WNBA / women's college basketball (WBB) standings. fox_wnba_standings() hits the wnba slug; fox_wbb_standings() hits the wcbk slug.

Get the Fox Sports (Bifrost) WNBA / women's college basketball (WBB) team directory, derived from the standings endpoint. fox_wnba_teams() hits the wnba slug; fox_wbb_teams() hits the wcbk slug.

Usage

fox_wnba_team_roster(team_id)

fox_wbb_team_roster(team_id)

fox_wnba_team_stats(team_id)

fox_wbb_team_stats(team_id)

fox_wnba_team_gamelog(team_id)

fox_wbb_team_gamelog(team_id)

fox_wnba_standings(team_id)

fox_wbb_standings(team_id)

fox_wnba_teams(team_id = "3")

fox_wbb_teams(team_id = "11")

Arguments

team_id

Fox Bifrost seed team id used to fetch league standings (default "3"). The standings response enumerates every team in the seed's league sections.

Value

A wehoop_data tibble, one row per player: team_id, position_group, player, position/age/etc. columns, athlete_id.

A wehoop_data tibble: team_id, category, stat, stat_abbreviation, player, value.

A wehoop_data tibble (long): team_id, season_type, category, game_id, game_date, opponent, stat, value.

A wehoop_data tibble of standings rows (team_id, section, the standings columns, entity_id).

A wehoop_data tibble, one row per team: fox_team_id, fox_team_name, fox_section.

See Also

Other Fox Sports Functions: fox_basketball_league_leaders, fox_wbb_teams_all(), fox_wnba_pbp()

Examples

try(fox_wnba_team_roster("1"))


  try(fox_wbb_team_roster("11"))


  try(fox_wnba_team_stats("1"))


  try(fox_wbb_team_stats("11"))


  try(fox_wnba_team_gamelog("1"))


  try(fox_wbb_team_gamelog("11"))


  try(fox_wnba_standings("1"))


  try(fox_wbb_standings("11"))


  try(fox_wnba_teams())


  try(fox_wbb_teams("11"))

Genius Competition Games

Description

The recent-games window of a competition, with the global Genius team ids.

Endpoint: ⁠GET https://fibalivestats.dcd.shared.geniussports.com/data/competition/{comp_id}.json⁠

A few recent or upcoming games, not the season. Scores are cast to integer (NA before tip-off). match_time is local (zone not stated), match_time_utc UTC.

Usage

genius_competition_games(comp_id, return_parsed = TRUE)

Arguments

comp_id

Genius competition id: one per org competition-season (comp_id of genius_competitions()), e.g. 49915.

return_parsed

Parse into a tibble (default TRUE); FALSE returns the parsed body or page record (a list): data.json as served plus ⁠_request⁠ (the ids asked for), or the sdv-internal-refs capture shape of a page.

Details

Access. The Genius hosts publish no robots.txt and no terms. CloudFront refuses datacenter IPs on the LiveStats and hosted hosts: from a server set options(wehoop.proxy = ...) or the GENIUS_PROXY environment variable to an http(s) proxy URL (never printed or logged). Requests are spaced at least one second apart per host; keep crawls slow and incremental. Some league sites (the NZ NBL) forbid AI crawlers in their own robots.txt, which does not cover these hosts. Unofficial use of a public source: payloads are not redistributed as release assets.

Org and season. Every competition is an ORG code plus a competition id (comp_id): genius_competitions() lists an org's competitions with the sdv END-year season (a START-year org lists 2025-26 as season 2026), genius_match_competition() maps a game to its competition, and data.json itself names no date, competition or season. The hosted ORG can differ from the LiveStats ORG of ⁠/u/⁠ (NZNBL vs NZN). Match ids are one global sequence across every Genius customer. data.json carries no global team or player id: tno (1 or 2) and pno are in-game numbers; only finished games are read.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when Genius has nothing for the request (HTTP 404, the S3 AccessDenied 403, an empty 200 from the hosted host, an empty recent-games window, a schedule or widget with no matches); wehoop_bad_request for HTTP 400 / 422 or a URL that is not a Genius route (e.g. a non-numeric id); wehoop_asset_fetch when the answer is unknown: the CloudFront "Request blocked" 403, a rate limit or 5xx, the intermittent HTTP 500 "A website error has occurred" page (transient = TRUE: retry later), a dead connection, an error envelope, a cut-off page, an unfinished game, or a body for another match, competition or ORG.

Value

A wehoop_data tibble (a zero-row tibble with these columns when Genius answers an empty valid page), or the raw list when return_parsed = FALSE:

col_name type description
league_id integer Genius league id of the org (ESAKE = 115); the leagueId column of the hosted chooser
competition_id integer Genius competition id (compId): one per org competition-season; the {compId} of hosted and data/competition paths
match_id integer Genius match id: the {matchId} of data.json and /u/; one global sequence across every Genius customer (~0.3 M in 2016, ~2.9 M in Oct 2026)
match_status character Match status: COMPLETE, SCHEDULED, IN_PROGRESS, ... (upper case)
match_time character Local tip-off time, 'YYYY-MM-DD HH:MM:SS' (venue time zone, not stated)
match_time_utc character Tip-off time in UTC, 'YYYY-MM-DD HH:MM:SS'
live integer 1 while the game is live, else 0
period integer Current period of a live or finished game (present on some rows only)
period_type character Current period type: REGULAR or OVERTIME (present on some rows only)
clock character Period clock of a live or finished game, 'mm:ss' remaining (present on some rows only)
home_team_id integer Home team: Genius team id (warehouse key space, global across orgs and seasons; the /team/{id} of hosted pages, the tid of the widget, the teamId of data/competition). data.json carries no team id: join on name/code
home_name character Home team full name, in the competition's own script when the org enters one.
home_name_international character Home team name in Latin script
home_code character Home team short code, in the competition's own script when the org enters one.
home_score integer Home points: a string on most rows, an integer on some ('' before tip-off); cast it
away_team_id integer Away team: Genius team id (warehouse key space, global across orgs and seasons; the /team/{id} of hosted pages, the tid of the widget, the teamId of data/competition). data.json carries no team id: join on name/code
away_name character Away team full name, in the competition's own script when the org enters one.
away_name_international character Away team name in Latin script
away_code character Away team short code, in the competition's own script when the org enters one.
away_score integer Away points: a string on most rows, an integer on some ('' before tip-off); cast it

See Also

Other Genius Functions: genius_competitions(), genius_game(), genius_game_crosswalk(), genius_match_competition(), genius_pbp(), genius_player_box(), genius_schedule(), genius_schedule_embed(), genius_shots(), genius_team_box(), genius_team_crosswalk(), genius_widget_games(), lfb_competition, wbbl_competition

Examples

try(genius_competition_games(comp_id = 49915))

Genius Competitions

Description

Every competition of an org from the hosted WebStats chooser, with its END-year season.

Endpoint: ⁠GET https://hosted.dcd.shared.geniussports.com/{org}/en/schedule⁠

One row per competition-season. year is the Genius year (START year for a two-year org, the year itself for a calendar org) and season the sdv END year: a two-year span in the label wins (2019 - 20 is 2020), else the Genius year plus one for a split org, else the year itself; season_rule names the rule (NA season when none applies). selected marks the competition the chooser pre-selects.

Usage

genius_competitions(org, return_parsed = TRUE)

Arguments

org

Genius ORG code of the league (ESAKE, CEBL, BNXT, SLB, ...); see genius_competitions().

return_parsed

Parse into a tibble (default TRUE); FALSE returns the parsed body or page record (a list): data.json as served plus ⁠_request⁠ (the ids asked for), or the sdv-internal-refs capture shape of a page.

Details

Access. The Genius hosts publish no robots.txt and no terms. CloudFront refuses datacenter IPs on the LiveStats and hosted hosts: from a server set options(wehoop.proxy = ...) or the GENIUS_PROXY environment variable to an http(s) proxy URL (never printed or logged). Requests are spaced at least one second apart per host; keep crawls slow and incremental. Some league sites (the NZ NBL) forbid AI crawlers in their own robots.txt, which does not cover these hosts. Unofficial use of a public source: payloads are not redistributed as release assets.

Org and season. Every competition is an ORG code plus a competition id (comp_id): genius_competitions() lists an org's competitions with the sdv END-year season (a START-year org lists 2025-26 as season 2026), genius_match_competition() maps a game to its competition, and data.json itself names no date, competition or season. The hosted ORG can differ from the LiveStats ORG of ⁠/u/⁠ (NZNBL vs NZN). Match ids are one global sequence across every Genius customer. data.json carries no global team or player id: tno (1 or 2) and pno are in-game numbers; only finished games are read.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when Genius has nothing for the request (HTTP 404, the S3 AccessDenied 403, an empty 200 from the hosted host, an empty recent-games window, a schedule or widget with no matches); wehoop_bad_request for HTTP 400 / 422 or a URL that is not a Genius route (e.g. a non-numeric id); wehoop_asset_fetch when the answer is unknown: the CloudFront "Request blocked" 403, a rate limit or 5xx, the intermittent HTTP 500 "A website error has occurred" page (transient = TRUE: retry later), a dead connection, an error envelope, a cut-off page, an unfinished game, or a body for another match, competition or ORG.

Value

A wehoop_data tibble (a zero-row tibble with these columns when Genius answers an empty valid page), or the raw list when return_parsed = FALSE:

col_name type description
org character ORG code the request used (the hosted ORG, or the LiveStats ORG for the /u/ shell).
comp_id integer Genius competition id (compId): one per org competition-season; the {compId} of hosted and data/competition paths
label character Competition label as the org typed it, free text in any language: may or may not carry a season ('BASKET LEAGUE 2019 - 20', '1st division', 'Kypello Elladas' (in Greek script) = Greek Cup, 'Mavroskoufeia' (in Greek script) = Mavroskoufeia youth tournament)
league_id integer Genius league id of the org (ESAKE = 115; IBBA has two: 187 and 549)
year integer Genius season year of the competition: the START year of a two-year season (BNXT '2023-2024' = 2023), the year itself for a calendar season. null when the page gives none
season integer sdv END-year season of the competition (2026 = 2025-26) from the label span, else the Genius year; null when no rule applies. See season_rule.
season_rule character Which rule produced season: 'label span', 'genius year + 1 (split)', 'genius year (calendar)', 'label year (calendar)' or 'unknown'.
selected logical True for the competition the hosted chooser pre-selects (the org's default, not always the newest).

See Also

Other Genius Functions: genius_competition_games(), genius_game(), genius_game_crosswalk(), genius_match_competition(), genius_pbp(), genius_player_box(), genius_schedule(), genius_schedule_embed(), genius_shots(), genius_team_box(), genius_team_crosswalk(), genius_widget_games(), lfb_competition, wbbl_competition

Examples

try(genius_competitions(org = "ESAKE"))

Genius Game

Description

One row per finished game: period and clock state, both teams' names, codes and scores, officials.

Endpoint: ⁠GET https://fibalivestats.dcd.shared.geniussports.com/data/{match_id}/data.json⁠

team1 is the team listed first. referee1 ... commissioner read ⁠officials.<role>⁠ (current feeds) or the flat officials_refereeN strings (older feeds); NA when absent.

Usage

genius_game(match_id, return_parsed = TRUE)

Arguments

match_id

Genius match id (match_id of genius_schedule(), genius_widget_games() or genius_competition_games()), e.g. 2902690.

return_parsed

Parse into a tibble (default TRUE); FALSE returns the parsed body or page record (a list): data.json as served plus ⁠_request⁠ (the ids asked for), or the sdv-internal-refs capture shape of a page.

Details

Access. The Genius hosts publish no robots.txt and no terms. CloudFront refuses datacenter IPs on the LiveStats and hosted hosts: from a server set options(wehoop.proxy = ...) or the GENIUS_PROXY environment variable to an http(s) proxy URL (never printed or logged). Requests are spaced at least one second apart per host; keep crawls slow and incremental. Some league sites (the NZ NBL) forbid AI crawlers in their own robots.txt, which does not cover these hosts. Unofficial use of a public source: payloads are not redistributed as release assets.

Org and season. Every competition is an ORG code plus a competition id (comp_id): genius_competitions() lists an org's competitions with the sdv END-year season (a START-year org lists 2025-26 as season 2026), genius_match_competition() maps a game to its competition, and data.json itself names no date, competition or season. The hosted ORG can differ from the LiveStats ORG of ⁠/u/⁠ (NZNBL vs NZN). Match ids are one global sequence across every Genius customer. data.json carries no global team or player id: tno (1 or 2) and pno are in-game numbers; only finished games are read.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when Genius has nothing for the request (HTTP 404, the S3 AccessDenied 403, an empty 200 from the hosted host, an empty recent-games window, a schedule or widget with no matches); wehoop_bad_request for HTTP 400 / 422 or a URL that is not a Genius route (e.g. a non-numeric id); wehoop_asset_fetch when the answer is unknown: the CloudFront "Request blocked" 403, a rate limit or 5xx, the intermittent HTTP 500 "A website error has occurred" page (transient = TRUE: retry later), a dead connection, an error envelope, a cut-off page, an unfinished game, or a body for another match, competition or ORG.

Value

A wehoop_data tibble (a zero-row tibble with these columns when Genius answers an empty valid page), or the raw list when return_parsed = FALSE:

col_name type description
match_id integer Genius match id of the game. data.json does not carry it: it is the match_id asked for, stamped by the runtime (the global match sequence shared by every Genius customer).
period integer Current (or last) period number; restarts at 1 in overtime
period_type character Current period type: REGULAR or OVERTIME
in_ot integer 1 when the game is (or ended) in overtime, else 0
clock character Clock of the current period at capture time, 'mm:ss' remaining ('00:00' once the game is over)
periods_max integer Number of regulation periods (4)
period_length_regular integer Length of a regulation period, minutes (10 under FIBA rules, 12 in some leagues)
period_length_overtime integer Length of an overtime period, minutes
attendance integer Attendance as entered by the org; 0 when not entered
disable_match integer 1 when the org disabled the public feed for this game, else 0
total_time_added integer Clock time added by corrections, seconds (unverified; 0 in every sample)
team1_name character Full name of team 1, the team listed first (the home team on the hosted schedule and widget).
team1_code character Short code of team 1, in the competition's own script when the org enters one.
team1_score integer Final points of team 1 (cast to an integer; the 2014-15 feed sends a string).
team2_name character Full name of team 2, the team listed second.
team2_code character Short code of team 2, in the competition's own script when the org enters one.
team2_score integer Final points of team 2 (cast to an integer; the 2014-15 feed sends a string).
referee1 character First referee's name, from officials.referee1 (international form) or the flat officials_referee1 text.
referee2 character Second referee's name, from officials.referee2 (international form) or the flat officials_referee2 text.
referee3 character Third referee's name when the feed lists one; null otherwise.
commissioner character Commissioner (game supervisor) name when the feed lists one; null otherwise.

See Also

Other Genius Functions: genius_competition_games(), genius_competitions(), genius_game_crosswalk(), genius_match_competition(), genius_pbp(), genius_player_box(), genius_schedule(), genius_schedule_embed(), genius_shots(), genius_team_box(), genius_team_crosswalk(), genius_widget_games(), lfb_competition, wbbl_competition

Examples

try(genius_game(match_id = 2902690))

Genius Game Crosswalk

Description

Provider game key <-> Genius LiveStats match id, from a frame that carries both.

Reads a frame you already have (no request is made), checks the id types and returns the distinct id pairs, one-to-one both ways. Rows without a Genius id (older seasons, upcoming games) are dropped.

Usage

genius_game_crosswalk(df, source)

Arguments

df

A data frame from the wrapper named for source.

source

One of "sportpress", "cebl", "tbf", "kzs", "sportality".

Details

Sources: sportpress (BNXT sportpress_game_slider: game_id / genius_id), cebl (game_id / genius_match_id), tbf (match_id / genius_id), kzs (match_id / genius_match_id) and sportality (game_uuid / game_id, the Genius match id). The provider key is integer for every source but sportality (a character uuid); the Genius id is integer. A wrong source, a missing column, a wrong id type or a key that maps to two ids raises wehoop_bad_request.

Value

A wehoop_data tibble, one row per game:

col_name type description
game_key integer or character Provider's own game key: the BNXT, CEBL, TBF or KZS integer game id, or the Sportality platform game uuid (a string) for source sportality.
genius_match_id integer Genius Sports LiveStats match id of the same game (the match_id every genius_* wrapper takes).

See Also

Other Genius Functions: genius_competition_games(), genius_competitions(), genius_game(), genius_match_competition(), genius_pbp(), genius_player_box(), genius_schedule(), genius_schedule_embed(), genius_shots(), genius_team_box(), genius_team_crosswalk(), genius_widget_games(), lfb_competition, wbbl_competition

Examples

slider <- data.frame(game_id = c(1L, 2L), genius_id = c(2902690L, NA))
  genius_game_crosswalk(slider, "sportpress")

Genius Match Competition

Description

The competition (comp_id and name) a game belongs to, from its LiveStats HTML shell.

Endpoint: ⁠GET https://fibalivestats.dcd.shared.geniussports.com/u/{org}/{match_id}/⁠

A one-row tibble: the only way to map a data.json game to its competition (comp_id) and, through genius_competitions(), to a season. org is the ORG the request used.

Usage

genius_match_competition(org, match_id, return_parsed = TRUE)

Arguments

org

LiveStats ORG of the game's shell (can differ from the hosted ORG: NZN vs NZNBL).

match_id

Genius match id (match_id of genius_schedule(), genius_widget_games() or genius_competition_games()), e.g. 2902690.

return_parsed

Parse into a tibble (default TRUE); FALSE returns the parsed body or page record (a list): data.json as served plus ⁠_request⁠ (the ids asked for), or the sdv-internal-refs capture shape of a page.

Details

Access. The Genius hosts publish no robots.txt and no terms. CloudFront refuses datacenter IPs on the LiveStats and hosted hosts: from a server set options(wehoop.proxy = ...) or the GENIUS_PROXY environment variable to an http(s) proxy URL (never printed or logged). Requests are spaced at least one second apart per host; keep crawls slow and incremental. Some league sites (the NZ NBL) forbid AI crawlers in their own robots.txt, which does not cover these hosts. Unofficial use of a public source: payloads are not redistributed as release assets.

Org and season. Every competition is an ORG code plus a competition id (comp_id): genius_competitions() lists an org's competitions with the sdv END-year season (a START-year org lists 2025-26 as season 2026), genius_match_competition() maps a game to its competition, and data.json itself names no date, competition or season. The hosted ORG can differ from the LiveStats ORG of ⁠/u/⁠ (NZNBL vs NZN). Match ids are one global sequence across every Genius customer. data.json carries no global team or player id: tno (1 or 2) and pno are in-game numbers; only finished games are read.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when Genius has nothing for the request (HTTP 404, the S3 AccessDenied 403, an empty 200 from the hosted host, an empty recent-games window, a schedule or widget with no matches); wehoop_bad_request for HTTP 400 / 422 or a URL that is not a Genius route (e.g. a non-numeric id); wehoop_asset_fetch when the answer is unknown: the CloudFront "Request blocked" 403, a rate limit or 5xx, the intermittent HTTP 500 "A website error has occurred" page (transient = TRUE: retry later), a dead connection, an error envelope, a cut-off page, an unfinished game, or a body for another match, competition or ORG.

 genius_match_competition(org = "ESAKE", match_id = 2902690)

Value

A wehoop_data tibble (a zero-row tibble with these columns when Genius answers an empty valid page), or the raw list when return_parsed = FALSE:

col_name type description
match_id integer Match id from the page's hidden input #matchId (equals the {matchId} asked for). Genius match id: the {matchId} of data.json and /u/; one global sequence across every Genius customer (~0.3 M in 2016, ~2.9 M in Oct 2026)
comp_id integer Competition id from the hidden input #compId. Genius competition id (compId): one per org competition-season; the {compId} of hosted and data/competition paths. The way to map a data.json game to its competition and season
competition_name character Competition label from #competitionName, free text ('Stoiximan GBL 2026-2027'); carries the season only when the org writes it in
org_label character First item of og:description: the org's display code (ESAKE)
og_description character The page's og:description: ⁠<ORG> , <competition>, Check out the full statistics here⁠
org character ORG code the request used (the hosted ORG, or the LiveStats ORG for the /u/ shell).

See Also

Other Genius Functions: genius_competition_games(), genius_competitions(), genius_game(), genius_game_crosswalk(), genius_pbp(), genius_player_box(), genius_schedule(), genius_schedule_embed(), genius_shots(), genius_team_box(), genius_team_crosswalk(), genius_widget_games(), lfb_competition, wbbl_competition


Genius Play-by-Play

Description

Play-by-play of a finished game, newest action first, with the running score and lead.

Endpoint: ⁠GET https://fibalivestats.dcd.shared.geniussports.com/data/{match_id}/data.json⁠

Rows in the feed's order: newest first by game time, so row_index 0 is the last action (normally the game end row); sort on action_number for entry order. score_1 / score_2 are always integer. qualifier joins the qualifier codes with commas. clock, action_number and previous_action are NA in the 2014-15 feed. Overtime restarts period at 1: read it with period_type.

Usage

genius_pbp(match_id, return_parsed = TRUE)

Arguments

match_id

Genius match id (match_id of genius_schedule(), genius_widget_games() or genius_competition_games()), e.g. 2902690.

return_parsed

Parse into a tibble (default TRUE); FALSE returns the parsed body or page record (a list): data.json as served plus ⁠_request⁠ (the ids asked for), or the sdv-internal-refs capture shape of a page.

Details

Access. The Genius hosts publish no robots.txt and no terms. CloudFront refuses datacenter IPs on the LiveStats and hosted hosts: from a server set options(wehoop.proxy = ...) or the GENIUS_PROXY environment variable to an http(s) proxy URL (never printed or logged). Requests are spaced at least one second apart per host; keep crawls slow and incremental. Some league sites (the NZ NBL) forbid AI crawlers in their own robots.txt, which does not cover these hosts. Unofficial use of a public source: payloads are not redistributed as release assets.

Org and season. Every competition is an ORG code plus a competition id (comp_id): genius_competitions() lists an org's competitions with the sdv END-year season (a START-year org lists 2025-26 as season 2026), genius_match_competition() maps a game to its competition, and data.json itself names no date, competition or season. The hosted ORG can differ from the LiveStats ORG of ⁠/u/⁠ (NZNBL vs NZN). Match ids are one global sequence across every Genius customer. data.json carries no global team or player id: tno (1 or 2) and pno are in-game numbers; only finished games are read.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when Genius has nothing for the request (HTTP 404, the S3 AccessDenied 403, an empty 200 from the hosted host, an empty recent-games window, a schedule or widget with no matches); wehoop_bad_request for HTTP 400 / 422 or a URL that is not a Genius route (e.g. a non-numeric id); wehoop_asset_fetch when the answer is unknown: the CloudFront "Request blocked" 403, a rate limit or 5xx, the intermittent HTTP 500 "A website error has occurred" page (transient = TRUE: retry later), a dead connection, an error envelope, a cut-off page, an unfinished game, or a body for another match, competition or ORG.

Value

A wehoop_data tibble (a zero-row tibble with these columns when Genius answers an empty valid page), or the raw list when return_parsed = FALSE:

col_name type description
match_id integer Genius match id of the game. data.json does not carry it: it is the match_id asked for, stamped by the runtime (the global match sequence shared by every Genius customer).
row_index integer Position of the action in the feed order, 0 = the newest action by game time (normally the game end row). The feed is not strictly sorted by action_number, so sort on action_number for entry order.
action_number integer Action sequence number, unique within the game (gaps where actions were deleted); a shot joins its play-by-play row on it. Null in the 2014-15 feed.
previous_action integer action_number of the linked earlier action (the shot an assist or rebound belongs to); null when the feed sends an empty string.
period integer Period number; restarts at 1 for the first overtime (read it with period_type).
period_type character Period type: REGULAR or OVERTIME.
gt character Game clock, 'mm:ss' remaining in the period
clock character Game clock with hundredths, 'mm:ss:cc' remaining in the period; absent in older feeds (the 2014-15 WBBL sample has gt only)
tno integer Team number within this game: 1 = the team listed first (home on the hosted schedule and widget), 2 = the other, 0 = no team. In-game only: not a team id.
pno integer Player number within this game, the key of the team's player map; 0 = no player. In-game only: not a person id and not the shirt number.
player character Player display name; '' when no player
shirt_number character Player shirt number (string); '' when no player
first_name character Given name in the competition's own script and spelling (Greek, Hebrew, Czech, ... as entered)
family_name character Family name in the competition's own script
international_first_name character Given name in Latin script
international_family_name character Family name in Latin script (often upper case)
scoreboard_name character Short display name ('T. Nichols'), in the local script when the org enters one
action_type character Action type: 2pt, 3pt, freethrow, rebound, assist, turnover, steal, block, foul, foulon (foul drawn), substitution, timeout, jumpball, period, game, headcoachchallenge
sub_type character Action subtype, free-text code per actionType: shot type for 2pt/3pt (layup, drivinglayup, jumpshot, pullupjumpshot, turnaroundjumpshot, ...), 'in'/'out' for substitutions, 'start'/'end' for period and game, foul kind for fouls; empty string when none
qualifier character Qualifier codes of the action joined with commas (pointsinthepaint, fromturnover, 2ndchance, fastbreak, blocked, ...); null when none.
success integer 1 = made / successful, 0 = missed (shots, free throws); 1 for other actions
scoring integer 1 when the action is a scoring attempt (shot or free throw), else 0
score_1 integer Team 1 score after the action, always an integer (the feed sends a string in most games).
score_2 integer Team 2 score after the action, always an integer (the feed sends a string in most games).
lead integer Score margin after the action, team 1 minus team 2 (negative when team 2 leads)

See Also

Other Genius Functions: genius_competition_games(), genius_competitions(), genius_game(), genius_game_crosswalk(), genius_match_competition(), genius_player_box(), genius_schedule(), genius_schedule_embed(), genius_shots(), genius_team_box(), genius_team_crosswalk(), genius_widget_games(), lfb_competition, wbbl_competition

Examples

try(genius_pbp(match_id = 2902690))

Genius Player Box Score

Description

Player box score of a finished game: minutes, shooting, rebounds, assists and the efficiency formulas.

Endpoint: ⁠GET https://fibalivestats.dcd.shared.geniussports.com/data/{match_id}/data.json⁠

Rows keyed by (tno, pno), both in-game numbers; pno is not the shirt number and the feed has no global player id (join across games on name, team code and shirt_number). Percentages are numeric 0-100; minutes is the printed mm:ss and seconds_played its seconds.

Usage

genius_player_box(match_id, return_parsed = TRUE)

Arguments

match_id

Genius match id (match_id of genius_schedule(), genius_widget_games() or genius_competition_games()), e.g. 2902690.

return_parsed

Parse into a tibble (default TRUE); FALSE returns the parsed body or page record (a list): data.json as served plus ⁠_request⁠ (the ids asked for), or the sdv-internal-refs capture shape of a page.

Details

Access. The Genius hosts publish no robots.txt and no terms. CloudFront refuses datacenter IPs on the LiveStats and hosted hosts: from a server set options(wehoop.proxy = ...) or the GENIUS_PROXY environment variable to an http(s) proxy URL (never printed or logged). Requests are spaced at least one second apart per host; keep crawls slow and incremental. Some league sites (the NZ NBL) forbid AI crawlers in their own robots.txt, which does not cover these hosts. Unofficial use of a public source: payloads are not redistributed as release assets.

Org and season. Every competition is an ORG code plus a competition id (comp_id): genius_competitions() lists an org's competitions with the sdv END-year season (a START-year org lists 2025-26 as season 2026), genius_match_competition() maps a game to its competition, and data.json itself names no date, competition or season. The hosted ORG can differ from the LiveStats ORG of ⁠/u/⁠ (NZNBL vs NZN). Match ids are one global sequence across every Genius customer. data.json carries no global team or player id: tno (1 or 2) and pno are in-game numbers; only finished games are read.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when Genius has nothing for the request (HTTP 404, the S3 AccessDenied 403, an empty 200 from the hosted host, an empty recent-games window, a schedule or widget with no matches); wehoop_bad_request for HTTP 400 / 422 or a URL that is not a Genius route (e.g. a non-numeric id); wehoop_asset_fetch when the answer is unknown: the CloudFront "Request blocked" 403, a rate limit or 5xx, the intermittent HTTP 500 "A website error has occurred" page (transient = TRUE: retry later), a dead connection, an error envelope, a cut-off page, an unfinished game, or a body for another match, competition or ORG.

Value

A wehoop_data tibble (a zero-row tibble with these columns when Genius answers an empty valid page), or the raw list when return_parsed = FALSE:

col_name type description
match_id integer Genius match id of the game. data.json does not carry it: it is the match_id asked for, stamped by the runtime (the global match sequence shared by every Genius customer).
tno integer Team number within this game: 1 = the team listed first (home on the hosted schedule and widget), 2 = the other, 0 = no team. In-game only: not a team id.
pno integer Player number within this game, the key of the team's player map; 0 = no player. In-game only: not a person id and not the shirt number.
name character Display name ('T. Nichols')
first_name character Given name in the competition's own script and spelling (Greek, Hebrew, Czech, ... as entered)
family_name character Family name in the competition's own script
international_first_name character Given name in Latin script
international_family_name character Family name in Latin script (often upper case)
scoreboard_name character Short display name ('T. Nichols'), in the local script when the org enters one
shirt_number character Shirt number as a string ('0' and '00' differ)
playing_position character Playing position code (PG, SG, SF, PF, C, G, F, ...); empty string when not entered
starter integer 1 when the player started the game, else 0
captain integer 1 for the team captain, else 0; absent in some orgs
active integer 1 when the player is on court now (at game end: on court at the final whistle), else 0
minutes character Minutes as the feed prints them, an 'mm:ss' text (can exceed 59 for a team; '199:60' happens); the text of an integer when the feed sends one.
seconds_played integer Seconds played parsed from the printed mm:ss text as minutes * 60 + seconds (so '224:60' gives 13500); null when the feed sent an integer, whose unit is unknown.
field_goals_made integer Field goals the player made in the game (two- and three-pointers together; a count).
field_goals_attempted integer Field goals the player attempted in the game (two- and three-pointers together; a count).
field_goals_percentage double Field-goal percentage, 0-100, rounded to an integer by the feed
three_pointers_made integer Three-pointers made
three_pointers_attempted integer Three-pointers attempted
three_pointers_percentage double Three-point percentage, 0-100, rounded to an integer
two_pointers_made integer Two-pointers made
two_pointers_attempted integer Two-pointers attempted
two_pointers_percentage double Two-point percentage, 0-100, rounded to an integer
free_throws_made integer Free throws the player made in the game (a count).
free_throws_attempted integer Free throws the player attempted in the game (a count).
free_throws_percentage double Free-throw percentage, 0-100, rounded to an integer
rebounds_defensive integer Defensive rebounds
rebounds_offensive integer Offensive rebounds
rebounds_total integer Total rebounds (offensive plus defensive) the player collected in the game.
assists integer Assists credited to the player in the game.
turnovers integer Turnovers committed by the player in the game.
steals integer Steals credited to the player in the game.
blocks integer Shots the player blocked in the game (blocks made, not received).
blocks_received integer Own shots blocked by an opponent
fouls_personal integer Personal fouls committed
fouls_on integer Fouls drawn: personal fouls committed against the player in the game.
points integer Points the player scored in the game, free throws included.
points_from_turnovers integer Points off turnovers
points_second_chance integer Second-chance points
points_fast_break integer Fast-break points
points_in_the_paint integer Points the player scored in the paint in the game (the feed's sPointsInThePaint).
plus_minus_points integer Plus/minus: team point margin while the player was on court
eff_1 integer Genius efficiency formula 1. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site
eff_2 integer Genius efficiency formula 2. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site
eff_3 double Genius efficiency formula 3. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site
eff_4 double Genius efficiency formula 4. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site
eff_5 integer Genius efficiency formula 5. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site
eff_6 integer Genius efficiency formula 6. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site
eff_7 integer Genius efficiency formula 7. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site. Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*

See Also

Other Genius Functions: genius_competition_games(), genius_competitions(), genius_game(), genius_game_crosswalk(), genius_match_competition(), genius_pbp(), genius_schedule(), genius_schedule_embed(), genius_shots(), genius_team_box(), genius_team_crosswalk(), genius_widget_games(), lfb_competition, wbbl_competition

Examples

try(genius_player_box(match_id = 2902690))

Genius Schedule

Description

Every match of a competition (hosted WebStats): ids, status, venue, teams and scores.

Endpoint: ⁠GET https://hosted.dcd.shared.geniussports.com/{org}/en/competition/{comp_id}/schedule?roundNumber={round_number}⁠

One row per match in page order. Scores are NA before tip-off and for some completed games whose score the page does not print. date_time is the page's text (local time, zone not stated). link_match_id is NA for orgs that hide match pages (FFBB); venue_id is NA when the venue is plain text. An unfilled play-off slot ('To be determined', no team or match link) takes the scope the page's other blocks prove; a page of nothing but such slots is refused.

Usage

genius_schedule(org, comp_id, round_number = -1, return_parsed = TRUE)

Arguments

org

Genius ORG code of the league (ESAKE, CEBL, BNXT, SLB, ...); see genius_competitions().

comp_id

Genius competition id: one per org competition-season (comp_id of genius_competitions()), e.g. 49915.

round_number

Round to list; -1 (default) lists every round of the competition.

return_parsed

Parse into a tibble (default TRUE); FALSE returns the parsed body or page record (a list): data.json as served plus ⁠_request⁠ (the ids asked for), or the sdv-internal-refs capture shape of a page.

Details

Access. The Genius hosts publish no robots.txt and no terms. CloudFront refuses datacenter IPs on the LiveStats and hosted hosts: from a server set options(wehoop.proxy = ...) or the GENIUS_PROXY environment variable to an http(s) proxy URL (never printed or logged). Requests are spaced at least one second apart per host; keep crawls slow and incremental. Some league sites (the NZ NBL) forbid AI crawlers in their own robots.txt, which does not cover these hosts. Unofficial use of a public source: payloads are not redistributed as release assets.

Org and season. Every competition is an ORG code plus a competition id (comp_id): genius_competitions() lists an org's competitions with the sdv END-year season (a START-year org lists 2025-26 as season 2026), genius_match_competition() maps a game to its competition, and data.json itself names no date, competition or season. The hosted ORG can differ from the LiveStats ORG of ⁠/u/⁠ (NZNBL vs NZN). Match ids are one global sequence across every Genius customer. data.json carries no global team or player id: tno (1 or 2) and pno are in-game numbers; only finished games are read.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when Genius has nothing for the request (HTTP 404, the S3 AccessDenied 403, an empty 200 from the hosted host, an empty recent-games window, a schedule or widget with no matches); wehoop_bad_request for HTTP 400 / 422 or a URL that is not a Genius route (e.g. a non-numeric id); wehoop_asset_fetch when the answer is unknown: the CloudFront "Request blocked" 403, a rate limit or 5xx, the intermittent HTTP 500 "A website error has occurred" page (transient = TRUE: retry later), a dead connection, an error envelope, a cut-off page, an unfinished game, or a body for another match, competition or ORG.

Value

A wehoop_data tibble (a zero-row tibble with these columns when Genius answers an empty valid page), or the raw list when return_parsed = FALSE:

col_name type description
match_id integer From the block id ⁠extfix_<id>⁠. Genius match id: the {matchId} of data.json and /u/; one global sequence across every Genius customer (~0.3 M in 2016, ~2.9 M in Oct 2026)
link_match_id integer Match id of the block's ⁠/match/<id>/summary⁠ link; equals match_id (the capture refuses a page where it does not); null when the org hides match pages (FFBB)
comp_id integer CompId of the match link, or of the team links when the org hides match pages (FFBB); equals the {compId} asked for. A 'To be determined' slot (no team or match link) takes the {compId} the page's other blocks prove
org character ORG code of the match link (or the team links, as comp_id)
status character Status from the block class STATUS_*: COMPLETE, SCHEDULED, POSTPONED, ...
date_time character Tip-off as displayed, 'Mon D, YYYY, h:mm AM' (local time, zone not stated); null when unscheduled
venue_id integer Genius venue id (the /venue/{id} of hosted pages); null when the venue is plain text (FFBB)
venue_name character Venue name as entered (local script)
home_team_id integer Home team: Genius team id (warehouse key space, global across orgs and seasons; the /team/{id} of hosted pages, the tid of the widget, the teamId of data/competition). data.json carries no team id: join on name/code
home_team_name character Home team full name
home_team_code character Home team code (local script possible)
home_score integer Home points; null before tip-off (typed integer only on a route whose 3 sampled rows were all played)
away_team_id integer Away team: Genius team id (warehouse key space, global across orgs and seasons; the /team/{id} of hosted pages, the tid of the widget, the teamId of data/competition). data.json carries no team id: join on name/code
away_team_name character Away team full name
away_team_code character Away team code (local script possible)
away_score integer Away points; null before tip-off (typed integer only on a route whose 3 sampled rows were all played)

See Also

Other Genius Functions: genius_competition_games(), genius_competitions(), genius_game(), genius_game_crosswalk(), genius_match_competition(), genius_pbp(), genius_player_box(), genius_schedule_embed(), genius_shots(), genius_team_box(), genius_team_crosswalk(), genius_widget_games(), lfb_competition, wbbl_competition

Examples

try(genius_schedule(org = "CEBL", comp_id = 47852))

Genius Schedule (Embed)

Description

Every match of a competition from the JSON-wrapped embed page (orgs whose plain pages answer 500).

Endpoint: ⁠GET https://hosted.dcd.shared.geniussports.com/embednf/{org}/en/competition/{comp_id}/schedule?roundNumber={round_number}⁠

The same columns and rules as genius_schedule(), read from the ⁠/embednf/⁠ ⁠{css, js, html}⁠ envelope.

Usage

genius_schedule_embed(org, comp_id, round_number = -1, return_parsed = TRUE)

Arguments

org

Genius ORG code of the league (ESAKE, CEBL, BNXT, SLB, ...); see genius_competitions().

comp_id

Genius competition id: one per org competition-season (comp_id of genius_competitions()), e.g. 49915.

round_number

Round to list; -1 (default) lists every round of the competition.

return_parsed

Parse into a tibble (default TRUE); FALSE returns the parsed body or page record (a list): data.json as served plus ⁠_request⁠ (the ids asked for), or the sdv-internal-refs capture shape of a page.

Details

Access. The Genius hosts publish no robots.txt and no terms. CloudFront refuses datacenter IPs on the LiveStats and hosted hosts: from a server set options(wehoop.proxy = ...) or the GENIUS_PROXY environment variable to an http(s) proxy URL (never printed or logged). Requests are spaced at least one second apart per host; keep crawls slow and incremental. Some league sites (the NZ NBL) forbid AI crawlers in their own robots.txt, which does not cover these hosts. Unofficial use of a public source: payloads are not redistributed as release assets.

Org and season. Every competition is an ORG code plus a competition id (comp_id): genius_competitions() lists an org's competitions with the sdv END-year season (a START-year org lists 2025-26 as season 2026), genius_match_competition() maps a game to its competition, and data.json itself names no date, competition or season. The hosted ORG can differ from the LiveStats ORG of ⁠/u/⁠ (NZNBL vs NZN). Match ids are one global sequence across every Genius customer. data.json carries no global team or player id: tno (1 or 2) and pno are in-game numbers; only finished games are read.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when Genius has nothing for the request (HTTP 404, the S3 AccessDenied 403, an empty 200 from the hosted host, an empty recent-games window, a schedule or widget with no matches); wehoop_bad_request for HTTP 400 / 422 or a URL that is not a Genius route (e.g. a non-numeric id); wehoop_asset_fetch when the answer is unknown: the CloudFront "Request blocked" 403, a rate limit or 5xx, the intermittent HTTP 500 "A website error has occurred" page (transient = TRUE: retry later), a dead connection, an error envelope, a cut-off page, an unfinished game, or a body for another match, competition or ORG.

 genius_schedule_embed(org = "HKS", comp_id = 49946)

Value

A wehoop_data tibble (a zero-row tibble with these columns when Genius answers an empty valid page), or the raw list when return_parsed = FALSE:

col_name type description
match_id integer From the block id ⁠extfix_<id>⁠. Genius match id: the {matchId} of data.json and /u/; one global sequence across every Genius customer (~0.3 M in 2016, ~2.9 M in Oct 2026)
link_match_id integer Match id of the block's ⁠/match/<id>/summary⁠ link; equals match_id (the capture refuses a page where it does not); null when the org hides match pages (FFBB)
comp_id integer CompId of the match link, or of the team links when the org hides match pages (FFBB); equals the {compId} asked for. A 'To be determined' slot (no team or match link) takes the {compId} the page's other blocks prove
org character ORG code of the match link (or the team links, as comp_id)
status character Status from the block class STATUS_*: COMPLETE, SCHEDULED, POSTPONED, ...
date_time character Tip-off as displayed, 'Mon D, YYYY, h:mm AM' (local time, zone not stated); null when unscheduled
venue_id integer Genius venue id (the /venue/{id} of hosted pages); null when the venue is plain text (FFBB)
venue_name character Venue name as entered (local script)
home_team_id integer Home team: Genius team id (warehouse key space, global across orgs and seasons; the /team/{id} of hosted pages, the tid of the widget, the teamId of data/competition). data.json carries no team id: join on name/code
home_team_name character Home team full name
home_team_code character Home team code (local script possible)
home_score integer Home points; null before tip-off (typed integer only on a route whose 3 sampled rows were all played)
away_team_id integer Away team: Genius team id (warehouse key space, global across orgs and seasons; the /team/{id} of hosted pages, the tid of the widget, the teamId of data/competition). data.json carries no team id: join on name/code
away_team_name character Away team full name
away_team_code character Away team code (local script possible)
away_score integer Away points; null before tip-off (typed integer only on a route whose 3 sampled rows were all played)

See Also

Other Genius Functions: genius_competition_games(), genius_competitions(), genius_game(), genius_game_crosswalk(), genius_match_competition(), genius_pbp(), genius_player_box(), genius_schedule(), genius_shots(), genius_team_box(), genius_team_crosswalk(), genius_widget_games(), lfb_competition, wbbl_competition


Genius Shot Chart

Description

Shot chart of a finished game: court x/y (percent of the full court), result and shooter.

Endpoint: ⁠GET https://fibalivestats.dcd.shared.geniussports.com/data/{match_id}/data.json⁠

x and y are percentages (0-100) of the full court length and width, NOT normalised to one basket (a team attacks one end in periods 1-2 and the other in 3-4); the origin corner is unverified. result is 1 for a made shot, 0 for a miss; action_number joins the play-by-play row.

Usage

genius_shots(match_id, return_parsed = TRUE)

Arguments

match_id

Genius match id (match_id of genius_schedule(), genius_widget_games() or genius_competition_games()), e.g. 2902690.

return_parsed

Parse into a tibble (default TRUE); FALSE returns the parsed body or page record (a list): data.json as served plus ⁠_request⁠ (the ids asked for), or the sdv-internal-refs capture shape of a page.

Details

Access. The Genius hosts publish no robots.txt and no terms. CloudFront refuses datacenter IPs on the LiveStats and hosted hosts: from a server set options(wehoop.proxy = ...) or the GENIUS_PROXY environment variable to an http(s) proxy URL (never printed or logged). Requests are spaced at least one second apart per host; keep crawls slow and incremental. Some league sites (the NZ NBL) forbid AI crawlers in their own robots.txt, which does not cover these hosts. Unofficial use of a public source: payloads are not redistributed as release assets.

Org and season. Every competition is an ORG code plus a competition id (comp_id): genius_competitions() lists an org's competitions with the sdv END-year season (a START-year org lists 2025-26 as season 2026), genius_match_competition() maps a game to its competition, and data.json itself names no date, competition or season. The hosted ORG can differ from the LiveStats ORG of ⁠/u/⁠ (NZNBL vs NZN). Match ids are one global sequence across every Genius customer. data.json carries no global team or player id: tno (1 or 2) and pno are in-game numbers; only finished games are read.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when Genius has nothing for the request (HTTP 404, the S3 AccessDenied 403, an empty 200 from the hosted host, an empty recent-games window, a schedule or widget with no matches); wehoop_bad_request for HTTP 400 / 422 or a URL that is not a Genius route (e.g. a non-numeric id); wehoop_asset_fetch when the answer is unknown: the CloudFront "Request blocked" 403, a rate limit or 5xx, the intermittent HTTP 500 "A website error has occurred" page (transient = TRUE: retry later), a dead connection, an error envelope, a cut-off page, an unfinished game, or a body for another match, competition or ORG.

 genius_shots(match_id = 2902690)

Value

A wehoop_data tibble (a zero-row tibble with these columns when Genius answers an empty valid page), or the raw list when return_parsed = FALSE:

col_name type description
match_id integer Genius match id of the game. data.json does not carry it: it is the match_id asked for, stamped by the runtime (the global match sequence shared by every Genius customer).
tno integer Team number within this game: 1 = the team listed first (home on the hosted schedule and widget), 2 = the other, 0 = no team. In-game only: not a team id.
pno integer Player number within this game, the key of the team's player map; 0 = no player. In-game only: not a person id and not the shirt number.
action_number integer Action sequence number, unique within the game (gaps where actions were deleted); a shot joins its play-by-play row on it. Null in the 2014-15 feed.
period integer Period number; restarts at 1 for the first overtime (read it with period_type).
period_type character Period type: REGULAR or OVERTIME.
action_type character Shot value: 2pt or 3pt
sub_type character Shot type (layup, drivinglayup, jumpshot, pullupjumpshot, dunk, ...)
result integer Shot result: 1 = made, 0 = missed.
x double Court x, PERCENT of the full court length (0-100, float), along the long axis. Not normalised to one basket: a team attacks one end in periods 1-2 and the other end in periods 3-4 (ESAKE 2902690: team 1 mean x 90 and 86 in P1-P2, 11 and 19 in P3-P4). Which end x = 0 is, and which end team 1 starts at, are unverified
y double Court y, PERCENT of the full court width (0-100, float), across the court (observed 1.7-97.2). Origin side unverified
player character Shooter's display name as the org enters it, in the local script when it uses one.
shirt_number character Shooter's shirt number (string)

See Also

Other Genius Functions: genius_competition_games(), genius_competitions(), genius_game(), genius_game_crosswalk(), genius_match_competition(), genius_pbp(), genius_player_box(), genius_schedule(), genius_schedule_embed(), genius_team_box(), genius_team_crosswalk(), genius_widget_games(), lfb_competition, wbbl_competition


Genius Team Box Score

Description

Team box score of a finished game: score by period, fouls, timeouts and the team totals.

Endpoint: ⁠GET https://fibalivestats.dcd.shared.geniussports.com/data/{match_id}/data.json⁠

One row per team (tno 1 and 2; the feed has no team id). Percentages are numeric 0-100. ot_score is the points in overtime (NA without overtime).

Usage

genius_team_box(match_id, return_parsed = TRUE)

Arguments

match_id

Genius match id (match_id of genius_schedule(), genius_widget_games() or genius_competition_games()), e.g. 2902690.

return_parsed

Parse into a tibble (default TRUE); FALSE returns the parsed body or page record (a list): data.json as served plus ⁠_request⁠ (the ids asked for), or the sdv-internal-refs capture shape of a page.

Details

Access. The Genius hosts publish no robots.txt and no terms. CloudFront refuses datacenter IPs on the LiveStats and hosted hosts: from a server set options(wehoop.proxy = ...) or the GENIUS_PROXY environment variable to an http(s) proxy URL (never printed or logged). Requests are spaced at least one second apart per host; keep crawls slow and incremental. Some league sites (the NZ NBL) forbid AI crawlers in their own robots.txt, which does not cover these hosts. Unofficial use of a public source: payloads are not redistributed as release assets.

Org and season. Every competition is an ORG code plus a competition id (comp_id): genius_competitions() lists an org's competitions with the sdv END-year season (a START-year org lists 2025-26 as season 2026), genius_match_competition() maps a game to its competition, and data.json itself names no date, competition or season. The hosted ORG can differ from the LiveStats ORG of ⁠/u/⁠ (NZNBL vs NZN). Match ids are one global sequence across every Genius customer. data.json carries no global team or player id: tno (1 or 2) and pno are in-game numbers; only finished games are read.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when Genius has nothing for the request (HTTP 404, the S3 AccessDenied 403, an empty 200 from the hosted host, an empty recent-games window, a schedule or widget with no matches); wehoop_bad_request for HTTP 400 / 422 or a URL that is not a Genius route (e.g. a non-numeric id); wehoop_asset_fetch when the answer is unknown: the CloudFront "Request blocked" 403, a rate limit or 5xx, the intermittent HTTP 500 "A website error has occurred" page (transient = TRUE: retry later), a dead connection, an error envelope, a cut-off page, an unfinished game, or a body for another match, competition or ORG.

 genius_team_box(match_id = 2902690)

Value

A wehoop_data tibble (a zero-row tibble with these columns when Genius answers an empty valid page), or the raw list when return_parsed = FALSE:

col_name type description
match_id integer Genius match id of the game. data.json does not carry it: it is the match_id asked for, stamped by the runtime (the global match sequence shared by every Genius customer).
tno integer Team number within this game: 1 = the team listed first (home on the hosted schedule and widget), 2 = the other, 0 = no team. In-game only: not a team id.
name character Team name as the org enters it
name_international character Team name in Latin script
short_name character Short team name (shortName in the feed), in the competition's own script when the org enters one.
code character Team code, three letters as entered (may be in the local script, e.g. Greek 'AEK' in Greek script)
code_international character Team code in Latin script
coach character Head coach display name
score integer Team points (current or final); a numeric string in the 2014-15 era sample (WBBL 12248), an integer since
full_score integer Team points including overtime; equal to score in every sample (a numeric string in the 2014-15 era)
p1_score integer Points scored in period 1 (a numeric string in the 2014-15 era)
p2_score integer Points scored in period 2 (a numeric string in the 2014-15 era)
p3_score integer Points scored in period 3 (a numeric string in the 2014-15 era)
p4_score integer Points scored in period 4 (a numeric string in the 2014-15 era)
ot_score integer Points the team scored in overtime; null without overtime. Whether several overtimes are summed is unverified.
fouls integer Team fouls in the current (last) period
timeouts integer Timeouts counter of the current period (unverified: remaining vs taken); 0 in every sampled (finished) game
minutes character Minutes as the feed prints them, an 'mm:ss' text (can exceed 59 for a team; '199:60' happens); the text of an integer when the feed sends one.
seconds_played integer Seconds played parsed from the printed mm:ss text as minutes * 60 + seconds (so '224:60' gives 13500); null when the feed sent an integer, whose unit is unknown.
field_goals_made integer Team total: field goals made
field_goals_attempted integer Team total: field goals attempted
field_goals_percentage double Team total: field-goal percentage, 0-100, rounded to an integer by the feed
three_pointers_made integer Team total: three-pointers made
three_pointers_attempted integer Team total: three-pointers attempted
three_pointers_percentage double Team total: three-point percentage, 0-100, rounded to an integer
two_pointers_made integer Team total: two-pointers made
two_pointers_attempted integer Team total: two-pointers attempted
two_pointers_percentage double Team total: two-point percentage, 0-100, rounded to an integer
free_throws_made integer Team total: free throws made
free_throws_attempted integer Team total: free throws attempted
free_throws_percentage double Team total: free-throw percentage, 0-100, rounded to an integer
rebounds_defensive integer Team total: defensive rebounds
rebounds_offensive integer Team total: offensive rebounds
rebounds_total integer Team total: total rebounds
assists integer Team total: assists
turnovers integer Team total: turnovers
steals integer Team total: steals
blocks integer Team total: blocks made
blocks_received integer Team total: own shots blocked by an opponent
fouls_personal integer Team total: personal fouls committed
fouls_on integer Team total: fouls drawn
points integer Team total: points
points_from_turnovers integer Team total: points off turnovers
points_second_chance integer Team total: second-chance points
points_fast_break integer Team total: fast-break points
points_in_the_paint integer Team total: points in the paint
eff_1 integer Genius efficiency formula 1. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site (team total). Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*
eff_2 integer Genius efficiency formula 2. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site (team total). Team tot_eff_2 is 2 in every 2016+ sample (a constant, not a stat). Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*
eff_3 double Genius efficiency formula 3. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site (team total). Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*
eff_4 double Genius efficiency formula 4. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site (team total). Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*
eff_5 integer Genius efficiency formula 5. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site (team total). Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*
eff_6 integer Genius efficiency formula 6. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site (team total). Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*
eff_7 integer Genius efficiency formula 7. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site (team total). Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*
bench_points integer Team total: points scored by non-starters
biggest_lead integer Team total: biggest lead, points
biggest_scoring_run integer Team total: biggest unanswered scoring run, points
lead_changes integer Team total: lead changes in the game (same value on both teams)
times_scores_level integer Team total: times the score was tied (same value on both teams)
time_leading double Team total: minutes the team led, decimal minutes (33.58 = 33 min 35 s)
fouls_team integer Team total: team (bench) fouls
fouls_total integer Team total: all fouls committed (personal + technical + team bench)
rebounds_team integer Team total: team rebounds (credited to no player)
rebounds_team_defensive integer Team total: team defensive rebounds
rebounds_team_offensive integer Team total: team offensive rebounds
turnovers_team integer Team total: team turnovers (credited to no player, e.g. shot clock)

See Also

Other Genius Functions: genius_competition_games(), genius_competitions(), genius_game(), genius_game_crosswalk(), genius_match_competition(), genius_pbp(), genius_player_box(), genius_schedule(), genius_schedule_embed(), genius_shots(), genius_team_crosswalk(), genius_widget_games(), lfb_competition, wbbl_competition


Genius Team Crosswalk

Description

Sportality platform team uuid <-> Genius team id, from a Sportality frame that carries both.

The Genius ids are the ones the genius schedule frames call home_team_id / away_team_id. No request is made.

Usage

genius_team_crosswalk(df, source)

Arguments

df

A Sportality data frame.

source

One of "sportality_standings", "sportality_teams", "sportality_players".

Details

Sources: sportality_standings (team_uuid / team_id), sportality_teams (info_uuid / info_team_id) and sportality_players (info_team_uuid / info_team_id). A wrong source, a missing column, a wrong id type or a key that maps to two ids raises wehoop_bad_request.

Value

A wehoop_data tibble, one row per team:

col_name type description
team_uuid character Sportality platform team uuid.
genius_team_id integer Genius team id of the same team (home_team_id / away_team_id of the genius schedule frames).

See Also

Other Genius Functions: genius_competition_games(), genius_competitions(), genius_game(), genius_game_crosswalk(), genius_match_competition(), genius_pbp(), genius_player_box(), genius_schedule(), genius_schedule_embed(), genius_shots(), genius_team_box(), genius_widget_games(), lfb_competition, wbbl_competition

Examples

standings <- data.frame(team_uuid = c("a1", "b2"), team_id = c(101L, 102L))
  genius_team_crosswalk(standings, "sportality_standings")

Genius Widget Games

Description

The latest games a league site's results widget shows (needs no proxy).

Endpoint: ⁠GET https://widget.wh.geniussports.com/widget/?{widget_key}⁠

About 5 to 50 games, newest competition first. webcast_org is the LiveStats ORG of the webcast link (NZN for the hosted NZNBL); a known widget key must return its own ORG's games.

Usage

genius_widget_games(widget_key, return_parsed = TRUE)

Arguments

widget_key

The league site's public widget key (the bare query string of ⁠widget.wh.geniussports.com/widget/⁠), e.g. "RFJIN037I07QV520B7WEXKV1GYNA31" (ESAKE).

return_parsed

Parse into a tibble (default TRUE); FALSE returns the parsed body or page record (a list): data.json as served plus ⁠_request⁠ (the ids asked for), or the sdv-internal-refs capture shape of a page.

Details

Access. The Genius hosts publish no robots.txt and no terms. CloudFront refuses datacenter IPs on the LiveStats and hosted hosts: from a server set options(wehoop.proxy = ...) or the GENIUS_PROXY environment variable to an http(s) proxy URL (never printed or logged). Requests are spaced at least one second apart per host; keep crawls slow and incremental. Some league sites (the NZ NBL) forbid AI crawlers in their own robots.txt, which does not cover these hosts. Unofficial use of a public source: payloads are not redistributed as release assets.

Org and season. Every competition is an ORG code plus a competition id (comp_id): genius_competitions() lists an org's competitions with the sdv END-year season (a START-year org lists 2025-26 as season 2026), genius_match_competition() maps a game to its competition, and data.json itself names no date, competition or season. The hosted ORG can differ from the LiveStats ORG of ⁠/u/⁠ (NZNBL vs NZN). Match ids are one global sequence across every Genius customer. data.json carries no global team or player id: tno (1 or 2) and pno are in-game numbers; only finished games are read.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when Genius has nothing for the request (HTTP 404, the S3 AccessDenied 403, an empty 200 from the hosted host, an empty recent-games window, a schedule or widget with no matches); wehoop_bad_request for HTTP 400 / 422 or a URL that is not a Genius route (e.g. a non-numeric id); wehoop_asset_fetch when the answer is unknown: the CloudFront "Request blocked" 403, a rate limit or 5xx, the intermittent HTTP 500 "A website error has occurred" page (transient = TRUE: retry later), a dead connection, an error envelope, a cut-off page, an unfinished game, or a body for another match, competition or ORG.

 genius_widget_games(widget_key = "RFJIN037I07QV520B7WEXKV1GYNA31")

Value

A wehoop_data tibble (a zero-row tibble with these columns when Genius answers an empty valid page), or the raw list when return_parsed = FALSE:

col_name type description
match_id integer From the webcast link. Genius match id: the {matchId} of data.json and /u/; one global sequence across every Genius customer (~0.3 M in 2016, ~2.9 M in Oct 2026)
webcast_org character ORG code of the webcast link; can differ from the hosted ORG (NZNBL games link /webcast/NZN/)
competition_name character Competition label, free text
status character Status text as shown ('Final', 'Live', a tip-off time)
date character Date as shown, 'DD/MM/YYYY' in samples (format follows the widget locale; unverified for others)
home_team_id integer Home team from the ⁠tid<N>⁠ class. Genius team id (warehouse key space, global across orgs and seasons; the /team/{id} of hosted pages, the tid of the widget, the teamId of data/competition). data.json carries no team id: join on name/code
home_team_code character Home team short code from the widget, in the local script when the org enters one.
home_score integer Home points; null before tip-off (typed integer only on a route whose 3 sampled rows were all played)
away_team_id integer Away team from the ⁠tid<N>⁠ class. Genius team id (warehouse key space, global across orgs and seasons; the /team/{id} of hosted pages, the tid of the widget, the teamId of data/competition). data.json carries no team id: join on name/code
away_team_code character Away team short code from the widget, in the local script when the org enters one.
away_score integer Away points; null before tip-off (typed integer only on a route whose 3 sampled rows were all played)

See Also

Other Genius Functions: genius_competition_games(), genius_competitions(), genius_game(), genius_game_crosswalk(), genius_match_competition(), genius_pbp(), genius_player_box(), genius_schedule(), genius_schedule_embed(), genius_shots(), genius_team_box(), genius_team_crosswalk(), lfb_competition, wbbl_competition


Parse ESPN WBB PBP, helper function

Description

Parse ESPN WBB PBP, helper function

Parse ESPN WBB Team Box, helper function

Parse ESPN WBB Player Box, helper function

Usage

helper_espn_wbb_pbp(resp)

helper_espn_wbb_team_box(resp)

helper_espn_wbb_player_box(resp)

Arguments

resp

Response object from the ESPN WBB game summary endpoint

Value

For helper_espn_wbb_pbp(): a tibble with the columns of espn_basketball_game_all_plays_plays_schema, or NULL when the game has no play-by-play. home_score / away_score are rebuilt from the scoring plays when that reproduces the header's official final, otherwise they are ESPN's per-play values; the last column, score_source ("rebuilt" / "espn"), says which.

Returns a tibble

Returns a tibble


Parse ESPN WNBA PBP, helper function

Description

Parse ESPN WNBA PBP, helper function

Parse ESPN WNBA Team Box, helper function

Parse ESPN WNBA Player Box, helper function

Usage

helper_espn_wnba_pbp(resp)

helper_espn_wnba_team_box(resp)

helper_espn_wnba_player_box(resp)

Arguments

resp

Response object from the ESPN WNBA game summary endpoint

Value

For helper_espn_wnba_pbp(): a tibble with the columns of espn_basketball_game_all_plays_schema, or NULL when the game has no play-by-play. home_score / away_score are rebuilt from the scoring plays when that reproduces the header's official final, otherwise they are ESPN's per-play values; the last column, score_source ("rebuilt" / "espn"), says which.

Returns a tibble

Returns a tibble


Her Hoop Stats Team Roster

Description

Get a team's player roster + stats from Her Hoop Stats.

Requires a Her Hoop Stats subscription (see hhs_teams()).

Usage

hhs_team_roster(team_link, email = NULL, password = NULL)

Arguments

team_link

A team page path or URL (the team_link column from hhs_teams()).

email, password

Optional explicit subscription credentials.

Value

A wehoop_data tibble, one row per player.

Note

Requires a Her Hoop Stats subscription. Member-table layout may change.

See Also

Other Her Hoop Stats Functions: hhs_team_stats(), hhs_teams()

Examples

## Not run: 
  teams <- hhs_teams(2024, 2024, 1)
  hhs_team_roster(team_link = teams$team_link[1])

## End(Not run)

Her Hoop Stats Team Statistics

Description

Get a team's statistics page from Her Hoop Stats.

Requires a Her Hoop Stats subscription (see hhs_teams()).

Usage

hhs_team_stats(team_link, email = NULL, password = NULL)

Arguments

team_link

A team page path or URL, e.g. the team_link column returned by hhs_teams().

email, password

Optional explicit subscription credentials.

Value

A wehoop_data tibble of the team's primary statistics table.

Note

Requires a Her Hoop Stats subscription. Member-table layout may change.

See Also

Other Her Hoop Stats Functions: hhs_team_roster(), hhs_teams()

Examples

## Not run: 
  teams <- hhs_teams(2024, 2024, 1)
  hhs_team_stats(team_link = teams$team_link[1])

## End(Not run)

Her Hoop Stats NCAA Team Single-Season Index

Description

Get the NCAA women's team single-season summary table from Her Hoop Stats.

Her Hoop Stats is a subscription service; this logs in with your own credentials (read from the email/password arguments, the wehoop.herhoopstats_email/..._password options, or the HERHOOPSTATS_EMAIL/HERHOOPSTATS_PW environment variables) and returns one row per team-season, with a team_link column for hhs_team_stats() / hhs_team_roster().

Usage

hhs_teams(
  min_season = most_recent_wbb_season(),
  max_season = most_recent_wbb_season(),
  division = 1,
  email = NULL,
  password = NULL
)

Arguments

min_season, max_season

Season range (4-digit ending year; 2024 = 2023-24). Default both to most_recent_wbb_season().

division

NCAA division: 1 (default), 2 or 3.

email, password

Optional explicit subscription credentials.

Value

A wehoop_data tibble, one row per team-season (record, scoring and per-100-possession columns), plus a team_link column and the requested min_season / max_season / division.

Note

Requires a Her Hoop Stats subscription. The member-table layout may change over time; selectors here are a starting point.

See Also

Other Her Hoop Stats Functions: hhs_team_roster(), hhs_team_stats()

Examples

## Not run: 
  # requires HERHOOPSTATS_EMAIL / HERHOOPSTATS_PW
  hhs_teams(min_season = 2024, max_season = 2024, division = 1)

## End(Not run)

Ligue Feminine de Basket (France, FFBB) (Genius LiveStats)

Description

Convenience wrappers binding the Genius family to the Ligue Feminine de Basket (France, FFBB) (women's; Genius ORG FFBB, LiveStats ORG FFBB). Season rule: END year; Genius year + 1 (2018-19 = 2019); Genius hosts only 2018 and 2019.

Usage

lfb_competitions(return_parsed = TRUE)

lfb_schedule(season = NULL, comp_id = NULL, round_number = -1, return_parsed = TRUE)

lfb_team_box(match_id, return_parsed = TRUE)

lfb_player_box(match_id, return_parsed = TRUE)

lfb_pbp(match_id, return_parsed = TRUE)

lfb_shots(match_id, return_parsed = TRUE)

Arguments

season

END-year season (see the season rule). NULL (default) = the newest season the org lists.

comp_id

Genius competition id; skips the season lookup (needed when the label rule matches several competitions).

round_number

Round to list; -1 (default) lists every round.

match_id

Genius match id (match_id of lfb_schedule()) of a game of this competition.

return_parsed

Parse into a tibble (default TRUE); FALSE returns the raw list.

Details

The season's competition is picked from the FFBB chooser by the label rule include = ⁠^ligue feminine( de basket)?$⁠, exclude = ⁠^$⁠ (case-insensitive); cups and play-offs have their own comp_id. Several matching competitions raise wehoop_bad_request (pass comp_id); none raises wehoop_no_data.

Genius match ids are one global sequence shared by every customer and data.json names no competition, so each game alias checks the id on the game's LiveStats shell (⁠/u/FFBB/<match_id>/⁠: one extra request per game, cached per process for an hour): its competition name must pass the label rule. Another org's game, a cup or play-off game of FFBB, or a shell request that fails twice (or names no competition) raises wehoop_asset_fetch. The base ⁠genius_*()⁠ function reads any game unchecked.

Access, proxy and error notes: see genius_game().

 lfb_competitions()
 lfb_schedule()

Value

The base function's wehoop_data tibble, same columns and types (the raw list when return_parsed = FALSE), one table per function:

lfb_competitions()

The columns of genius_competitions():

col_name type description
org character ORG code the request used (the hosted ORG, or the LiveStats ORG for the /u/ shell).
comp_id integer Genius competition id (compId): one per org competition-season; the {compId} of hosted and data/competition paths
label character Competition label as the org typed it, free text in any language: may or may not carry a season ('BASKET LEAGUE 2019 - 20', '1st division', 'Kypello Elladas' (in Greek script) = Greek Cup, 'Mavroskoufeia' (in Greek script) = Mavroskoufeia youth tournament)
league_id integer Genius league id of the org (ESAKE = 115; IBBA has two: 187 and 549)
year integer Genius season year of the competition: the START year of a two-year season (BNXT '2023-2024' = 2023), the year itself for a calendar season. null when the page gives none
season integer sdv END-year season of the competition (2026 = 2025-26) from the label span, else the Genius year; null when no rule applies. See season_rule.
season_rule character Which rule produced season: 'label span', 'genius year + 1 (split)', 'genius year (calendar)', 'label year (calendar)' or 'unknown'.
selected logical True for the competition the hosted chooser pre-selects (the org's default, not always the newest).

lfb_schedule()

The columns of genius_schedule():

col_name type description
match_id integer From the block id ⁠extfix_<id>⁠. Genius match id: the {matchId} of data.json and /u/; one global sequence across every Genius customer (~0.3 M in 2016, ~2.9 M in Oct 2026)
link_match_id integer Match id of the block's ⁠/match/<id>/summary⁠ link; equals match_id (the capture refuses a page where it does not); null when the org hides match pages (FFBB)
comp_id integer CompId of the match link, or of the team links when the org hides match pages (FFBB); equals the {compId} asked for. A 'To be determined' slot (no team or match link) takes the {compId} the page's other blocks prove
org character ORG code of the match link (or the team links, as comp_id)
status character Status from the block class STATUS_*: COMPLETE, SCHEDULED, POSTPONED, ...
date_time character Tip-off as displayed, 'Mon D, YYYY, h:mm AM' (local time, zone not stated); null when unscheduled
venue_id integer Genius venue id (the /venue/{id} of hosted pages); null when the venue is plain text (FFBB)
venue_name character Venue name as entered (local script)
home_team_id integer Home team: Genius team id (warehouse key space, global across orgs and seasons; the /team/{id} of hosted pages, the tid of the widget, the teamId of data/competition). data.json carries no team id: join on name/code
home_team_name character Home team full name
home_team_code character Home team code (local script possible)
home_score integer Home points; null before tip-off (typed integer only on a route whose 3 sampled rows were all played)
away_team_id integer Away team: Genius team id (warehouse key space, global across orgs and seasons; the /team/{id} of hosted pages, the tid of the widget, the teamId of data/competition). data.json carries no team id: join on name/code
away_team_name character Away team full name
away_team_code character Away team code (local script possible)
away_score integer Away points; null before tip-off (typed integer only on a route whose 3 sampled rows were all played)

lfb_team_box()

The columns of genius_team_box():

col_name type description
match_id integer Genius match id of the game. data.json does not carry it: it is the match_id asked for, stamped by the runtime (the global match sequence shared by every Genius customer).
tno integer Team number within this game: 1 = the team listed first (home on the hosted schedule and widget), 2 = the other, 0 = no team. In-game only: not a team id.
name character Team name as the org enters it
name_international character Team name in Latin script
short_name character Short team name (shortName in the feed), in the competition's own script when the org enters one.
code character Team code, three letters as entered (may be in the local script, e.g. Greek 'AEK' in Greek script)
code_international character Team code in Latin script
coach character Head coach display name
score integer Team points (current or final); a numeric string in the 2014-15 era sample (WBBL 12248), an integer since
full_score integer Team points including overtime; equal to score in every sample (a numeric string in the 2014-15 era)
p1_score integer Points scored in period 1 (a numeric string in the 2014-15 era)
p2_score integer Points scored in period 2 (a numeric string in the 2014-15 era)
p3_score integer Points scored in period 3 (a numeric string in the 2014-15 era)
p4_score integer Points scored in period 4 (a numeric string in the 2014-15 era)
ot_score integer Points the team scored in overtime; null without overtime. Whether several overtimes are summed is unverified.
fouls integer Team fouls in the current (last) period
timeouts integer Timeouts counter of the current period (unverified: remaining vs taken); 0 in every sampled (finished) game
minutes character Minutes as the feed prints them, an 'mm:ss' text (can exceed 59 for a team; '199:60' happens); the text of an integer when the feed sends one.
seconds_played integer Seconds played parsed from the printed mm:ss text as minutes * 60 + seconds (so '224:60' gives 13500); null when the feed sent an integer, whose unit is unknown.
field_goals_made integer Team total: field goals made
field_goals_attempted integer Team total: field goals attempted
field_goals_percentage double Team total: field-goal percentage, 0-100, rounded to an integer by the feed
three_pointers_made integer Team total: three-pointers made
three_pointers_attempted integer Team total: three-pointers attempted
three_pointers_percentage double Team total: three-point percentage, 0-100, rounded to an integer
two_pointers_made integer Team total: two-pointers made
two_pointers_attempted integer Team total: two-pointers attempted
two_pointers_percentage double Team total: two-point percentage, 0-100, rounded to an integer
free_throws_made integer Team total: free throws made
free_throws_attempted integer Team total: free throws attempted
free_throws_percentage double Team total: free-throw percentage, 0-100, rounded to an integer
rebounds_defensive integer Team total: defensive rebounds
rebounds_offensive integer Team total: offensive rebounds
rebounds_total integer Team total: total rebounds
assists integer Team total: assists
turnovers integer Team total: turnovers
steals integer Team total: steals
blocks integer Team total: blocks made
blocks_received integer Team total: own shots blocked by an opponent
fouls_personal integer Team total: personal fouls committed
fouls_on integer Team total: fouls drawn
points integer Team total: points
points_from_turnovers integer Team total: points off turnovers
points_second_chance integer Team total: second-chance points
points_fast_break integer Team total: fast-break points
points_in_the_paint integer Team total: points in the paint
eff_1 integer Genius efficiency formula 1. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site (team total). Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*
eff_2 integer Genius efficiency formula 2. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site (team total). Team tot_eff_2 is 2 in every 2016+ sample (a constant, not a stat). Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*
eff_3 double Genius efficiency formula 3. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site (team total). Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*
eff_4 double Genius efficiency formula 4. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site (team total). Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*
eff_5 integer Genius efficiency formula 5. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site (team total). Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*
eff_6 integer Genius efficiency formula 6. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site (team total). Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*
eff_7 integer Genius efficiency formula 7. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site (team total). Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*
bench_points integer Team total: points scored by non-starters
biggest_lead integer Team total: biggest lead, points
biggest_scoring_run integer Team total: biggest unanswered scoring run, points
lead_changes integer Team total: lead changes in the game (same value on both teams)
times_scores_level integer Team total: times the score was tied (same value on both teams)
time_leading double Team total: minutes the team led, decimal minutes (33.58 = 33 min 35 s)
fouls_team integer Team total: team (bench) fouls
fouls_total integer Team total: all fouls committed (personal + technical + team bench)
rebounds_team integer Team total: team rebounds (credited to no player)
rebounds_team_defensive integer Team total: team defensive rebounds
rebounds_team_offensive integer Team total: team offensive rebounds
turnovers_team integer Team total: team turnovers (credited to no player, e.g. shot clock)

lfb_player_box()

The columns of genius_player_box():

col_name type description
match_id integer Genius match id of the game. data.json does not carry it: it is the match_id asked for, stamped by the runtime (the global match sequence shared by every Genius customer).
tno integer Team number within this game: 1 = the team listed first (home on the hosted schedule and widget), 2 = the other, 0 = no team. In-game only: not a team id.
pno integer Player number within this game, the key of the team's player map; 0 = no player. In-game only: not a person id and not the shirt number.
name character Display name ('T. Nichols')
first_name character Given name in the competition's own script and spelling (Greek, Hebrew, Czech, ... as entered)
family_name character Family name in the competition's own script
international_first_name character Given name in Latin script
international_family_name character Family name in Latin script (often upper case)
scoreboard_name character Short display name ('T. Nichols'), in the local script when the org enters one
shirt_number character Shirt number as a string ('0' and '00' differ)
playing_position character Playing position code (PG, SG, SF, PF, C, G, F, ...); empty string when not entered
starter integer 1 when the player started the game, else 0
captain integer 1 for the team captain, else 0; absent in some orgs
active integer 1 when the player is on court now (at game end: on court at the final whistle), else 0
minutes character Minutes as the feed prints them, an 'mm:ss' text (can exceed 59 for a team; '199:60' happens); the text of an integer when the feed sends one.
seconds_played integer Seconds played parsed from the printed mm:ss text as minutes * 60 + seconds (so '224:60' gives 13500); null when the feed sent an integer, whose unit is unknown.
field_goals_made integer Field goals the player made in the game (two- and three-pointers together; a count).
field_goals_attempted integer Field goals the player attempted in the game (two- and three-pointers together; a count).
field_goals_percentage double Field-goal percentage, 0-100, rounded to an integer by the feed
three_pointers_made integer Three-pointers made
three_pointers_attempted integer Three-pointers attempted
three_pointers_percentage double Three-point percentage, 0-100, rounded to an integer
two_pointers_made integer Two-pointers made
two_pointers_attempted integer Two-pointers attempted
two_pointers_percentage double Two-point percentage, 0-100, rounded to an integer
free_throws_made integer Free throws the player made in the game (a count).
free_throws_attempted integer Free throws the player attempted in the game (a count).
free_throws_percentage double Free-throw percentage, 0-100, rounded to an integer
rebounds_defensive integer Defensive rebounds
rebounds_offensive integer Offensive rebounds
rebounds_total integer Total rebounds (offensive plus defensive) the player collected in the game.
assists integer Assists credited to the player in the game.
turnovers integer Turnovers committed by the player in the game.
steals integer Steals credited to the player in the game.
blocks integer Shots the player blocked in the game (blocks made, not received).
blocks_received integer Own shots blocked by an opponent
fouls_personal integer Personal fouls committed
fouls_on integer Fouls drawn: personal fouls committed against the player in the game.
points integer Points the player scored in the game, free throws included.
points_from_turnovers integer Points off turnovers
points_second_chance integer Second-chance points
points_fast_break integer Fast-break points
points_in_the_paint integer Points the player scored in the paint in the game (the feed's sPointsInThePaint).
plus_minus_points integer Plus/minus: team point margin while the player was on court
eff_1 integer Genius efficiency formula 1. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site
eff_2 integer Genius efficiency formula 2. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site
eff_3 double Genius efficiency formula 3. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site
eff_4 double Genius efficiency formula 4. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site
eff_5 integer Genius efficiency formula 5. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site
eff_6 integer Genius efficiency formula 6. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site
eff_7 integer Genius efficiency formula 7. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site. Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*

lfb_pbp()

The columns of genius_pbp():

col_name type description
match_id integer Genius match id of the game. data.json does not carry it: it is the match_id asked for, stamped by the runtime (the global match sequence shared by every Genius customer).
row_index integer Position of the action in the feed order, 0 = the newest action by game time (normally the game end row). The feed is not strictly sorted by action_number, so sort on action_number for entry order.
action_number integer Action sequence number, unique within the game (gaps where actions were deleted); a shot joins its play-by-play row on it. Null in the 2014-15 feed.
previous_action integer action_number of the linked earlier action (the shot an assist or rebound belongs to); null when the feed sends an empty string.
period integer Period number; restarts at 1 for the first overtime (read it with period_type).
period_type character Period type: REGULAR or OVERTIME.
gt character Game clock, 'mm:ss' remaining in the period
clock character Game clock with hundredths, 'mm:ss:cc' remaining in the period; absent in older feeds (the 2014-15 WBBL sample has gt only)
tno integer Team number within this game: 1 = the team listed first (home on the hosted schedule and widget), 2 = the other, 0 = no team. In-game only: not a team id.
pno integer Player number within this game, the key of the team's player map; 0 = no player. In-game only: not a person id and not the shirt number.
player character Player display name; '' when no player
shirt_number character Player shirt number (string); '' when no player
first_name character Given name in the competition's own script and spelling (Greek, Hebrew, Czech, ... as entered)
family_name character Family name in the competition's own script
international_first_name character Given name in Latin script
international_family_name character Family name in Latin script (often upper case)
scoreboard_name character Short display name ('T. Nichols'), in the local script when the org enters one
action_type character Action type: 2pt, 3pt, freethrow, rebound, assist, turnover, steal, block, foul, foulon (foul drawn), substitution, timeout, jumpball, period, game, headcoachchallenge
sub_type character Action subtype, free-text code per actionType: shot type for 2pt/3pt (layup, drivinglayup, jumpshot, pullupjumpshot, turnaroundjumpshot, ...), 'in'/'out' for substitutions, 'start'/'end' for period and game, foul kind for fouls; empty string when none
qualifier character Qualifier codes of the action joined with commas (pointsinthepaint, fromturnover, 2ndchance, fastbreak, blocked, ...); null when none.
success integer 1 = made / successful, 0 = missed (shots, free throws); 1 for other actions
scoring integer 1 when the action is a scoring attempt (shot or free throw), else 0
score_1 integer Team 1 score after the action, always an integer (the feed sends a string in most games).
score_2 integer Team 2 score after the action, always an integer (the feed sends a string in most games).
lead integer Score margin after the action, team 1 minus team 2 (negative when team 2 leads)

lfb_shots()

The columns of genius_shots():

col_name type description
match_id integer Genius match id of the game. data.json does not carry it: it is the match_id asked for, stamped by the runtime (the global match sequence shared by every Genius customer).
tno integer Team number within this game: 1 = the team listed first (home on the hosted schedule and widget), 2 = the other, 0 = no team. In-game only: not a team id.
pno integer Player number within this game, the key of the team's player map; 0 = no player. In-game only: not a person id and not the shirt number.
action_number integer Action sequence number, unique within the game (gaps where actions were deleted); a shot joins its play-by-play row on it. Null in the 2014-15 feed.
period integer Period number; restarts at 1 for the first overtime (read it with period_type).
period_type character Period type: REGULAR or OVERTIME.
action_type character Shot value: 2pt or 3pt
sub_type character Shot type (layup, drivinglayup, jumpshot, pullupjumpshot, dunk, ...)
result integer Shot result: 1 = made, 0 = missed.
x double Court x, PERCENT of the full court length (0-100, float), along the long axis. Not normalised to one basket: a team attacks one end in periods 1-2 and the other end in periods 3-4 (ESAKE 2902690: team 1 mean x 90 and 86 in P1-P2, 11 and 19 in P3-P4). Which end x = 0 is, and which end team 1 starts at, are unverified
y double Court y, PERCENT of the full court width (0-100, float), across the court (observed 1.7-97.2). Origin side unverified
player character Shooter's display name as the org enters it, in the local script when it uses one.
shirt_number character Shooter's shirt number (string)

See Also

Other Genius Functions: genius_competition_games(), genius_competitions(), genius_game(), genius_game_crosswalk(), genius_match_competition(), genius_pbp(), genius_player_box(), genius_schedule(), genius_schedule_embed(), genius_shots(), genius_team_box(), genius_team_crosswalk(), genius_widget_games(), wbbl_competition


Liga Mayor de Baloncesto (El Salvador) (Atrium shortcuts)

Description

Per-competition shortcuts over the Atrium embed API for Liga Mayor de Baloncesto (El Salvador) (website_id = 13; men's and women's).

Thin bindings of the parameterised ⁠atrium_*()⁠ wrappers to this site, minted from the competition registry (sdv-py tools/codegen/basketball_competitions.yaml); the full surface stays on the ⁠atrium_*()⁠ wrappers.

Usage

lmb_seasons(locale = NULL)
lmb_schedule(season = NULL, season_id = NULL, competition_id = NULL, locale = NULL)
lmb_standings(season = NULL, season_id = NULL, competition_id = NULL, locale = NULL)
lmb_teams(season = NULL, season_id = NULL, competition_id = NULL, locale = NULL)
lmb_player_box(fixture_id, locale = NULL)
lmb_team_box(fixture_id, locale = NULL)
lmb_pbp(fixture_id, locale = NULL)
lmb_shots(fixture_id, locale = NULL)

Arguments

season

(integer optional): Season END year (season rule below). Omit season and season_id for the site's current season.

season_id

(character optional): Season UUID (season_id in the seasons listing); skips the END-year lookup.

competition_id

(character optional): Competition UUID (a site carries many: conferences, cups); needed when several share the season.

locale

(character optional): Label locale, e.g. "en-EN"; omitted = the site's own language.

fixture_id

(character required): Fixture UUID (fixture_id in the schedule).

Details

Season rule: calendar year.

Errors and terms of use are those of atrium_fixtures(): unofficial use of the public widget endpoint, at least 1 s between requests, not republished as release assets. The site also serves women's competitions (pass their competition_id).

 lmb_seasons()
 lmb_schedule()

Value

A wehoop_data tibble with the columns of the base wrapper, one table per function:

lmb_seasons()

The columns of atrium_seasons():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID; pass it as season_id to any season-scoped wrapper.
competition_id character Competition UUID; pass it as competition_id to pick one of several seasons of an END year.
competition_name character Competition name in the site's language; the same name can appear for several years.
season_name character Season name in the site's language, e.g. Betclic ELITE 2025.
abbreviation_local character Local abbreviation of the season; null in every body seen.
year integer The site's own year of the season: the START year on LNB (site 12), the calendar year elsewhere.
season_end_year integer Season END year (the sdv key): the site's year + 1 on LNB (site 12), the calendar year on the other registered sites; null when the site is unregistered, lists no seasons or the body has no season list.
is_default_season logical True for the season the body is about (the site's default when none was asked).

lmb_schedule()

The columns of atrium_fixtures():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID the page is about (the site's default season when none was asked).
competition_id character Competition UUID of the season.
competition_name character Competition name in the site's language, e.g. Betclic ELITE or LIGA CALIENTE.MX LNBP.
season_end_year integer Season END year (the sdv key): the site's year + 1 on LNB (site 12), the calendar year on the other registered sites; null when the site is unregistered, lists no seasons or the body has no season list.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
fixture_type character Kind of game as sent: REGULAR, PLAYOFF, ... (the set is open).
name character Fixture name as the site prints it (e.g. Paris - Lyon-Villeurbanne); null on LNBP.
round character Round of the game as the site words it, e.g. Journee: 30.
round_code character Round code; null in every body seen.
pool character Pool the game belongs to; null when the competition has none.
series character Playoff series the game belongs to as sent (JSON text when an object); null outside a series.
stage_code character Opaque 30-hex stage code of the game; null in every body seen.
status character Status code of the game, e.g. CONFIRMED (final), as sent.
status_label character Status of the game as the site words it in its own language (e.g. Termine, Final).
start_time_utc POSIXct Scheduled start, naive datetime in UTC (the API sends no offset).
start_time_local character Scheduled start in the venue's local time, as the API sends it (YYYY-MM-DDTHH:MM:SS, no offset; timezone gives the zone, which varies per row).
timezone character IANA time zone of the venue (e.g. Europe/Paris, Mexico/General) that start_time_local is in.
times_unconfirmed logical True while the start time is not final.
venue character Name of the arena where the game is played.
venue_id character Venue UUID; joins no other route.
attendance integer Spectators at the game; null when not reported.
home_entity_id character Team UUID of the home team.
home_code character Short code of the home team (e.g. PAB).
home_name character Name of the home team.
home_score integer Points scored by the home team (the API sends a string; Int64 here).
home_result_place integer Result place of the home team: 1 for the winner, 2 for the loser.
home_result_status character Result status of the home team's score, e.g. CONFIRMED.
home_draw logical True when the game ended level for the home team.
home_shootout_attempts character Shootout attempts of the home team as sent (an empty string becomes null).
home_secondary_score character Secondary score of the home team (unused in the samples; shown as text).
away_entity_id character Team UUID of the away team.
away_code character Short code of the away team (e.g. PAB).
away_name character Name of the away team.
away_score integer Points scored by the away team (the API sends a string; Int64 here).
away_result_place integer Result place of the away team: 1 for the winner, 2 for the loser.
away_result_status character Result status of the away team's score, e.g. CONFIRMED.
away_draw logical True when the game ended level for the away team.
away_shootout_attempts character Shootout attempts of the away team as sent (an empty string becomes null).
away_secondary_score character Secondary score of the away team (unused in the samples; shown as text).

lmb_standings()

The columns of atrium_standings():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID of the table.
season_end_year integer Season END year (the sdv key): the site's year + 1 on LNB (site 12), the calendar year on the other registered sites; null when the site is unregistered, lists no seasons or the body has no season list.
group character Label of the table when the standings hold several groups; null for a single table.
position integer League table position (1 = first).
entity_id character Team UUID of the row.
team_name character Team name as the site prints it.
is_current_team logical True for the team the page was opened for (team context); false on a plain standings request.
logo_url character URL of the team logo image.
wins integer Games won; -1 for two teams in the 2025-26 LNB table (an administrative ranking, unverified), kept as sent (team, this table).
losses integer Games lost (team, this table).
played integer Games played (LNBP and the compact standings) (team, this table).
standing_points integer League table points (LNBP) (team, this table).
win_percentage double Share of games won as a 0-1 fraction (not 0-100) (team, this table).
scored_for integer Points scored over the season (team, this table).
scored_against integer Points conceded over the season (team, this table).
point_difference integer Point differential over the season (team, this table).
result_string_home character Home results as a string of result letters in the site's language, one per game (order and letters per locale; unverified) (team, this table).
scored_for_home integer Points scored in home games (team, this table).
scored_against_home integer Points conceded in home games (team, this table).
point_difference_home integer Point differential in home games (team, this table).
result_string_away character Away results as a string of result letters in the site's language, one per game (order and letters per locale; unverified) (team, this table).
scored_for_away integer Points scored in away games (team, this table).
scored_against_away integer Points conceded in away games (team, this table).
point_difference_away integer Point differential in away games (team, this table).
streak integer Length of the current run of results (the win / loss sign convention is unverified) (team, this table).
streak_home integer Length of the current run of home results (sign convention unverified) (team, this table).
streak_away integer Length of the current run of away results (sign convention unverified) (team, this table).

lmb_teams()

The columns of atrium_teams():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID of the team list.
entity_id character Team UUID (entity): one id per club across seasons, shared by every site that shows the team.
name character Team name in the site's language.
image_url character URL of the Sportradar-hosted image (400 px).

lmb_player_box()

The columns of atrium_box_score():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
entity_id character Team UUID the player is rostered with for this game.
side character Side of the game the row belongs to: home or away (from the fixture's isHome flag).
person_id character Player UUID (person), shared across seasons and sites.
person_name character Player name as the site prints it (upper case on LNBP and NBL1).
bib character Jersey number the player wears, as text.
position character Position code on the roster (LNB, e.g. PG); null on LNBP.
starter logical True when the player started the game.
active logical True when the player is on the court in a live game.
participated logical True when the player entered the game; false rows have null statistics.
did_not_play_reason character Reason the player did not play; null in every body seen.
minutes character Time played as an ISO 8601 duration (PT7M23S); a team's is the sum over its players (PT200M) (player, this game).
seconds_played integer Time played in whole seconds, parsed from minutes (player, this game).
points integer Points scored (player, this game).
rebounds integer Total rebounds (player, this game).
rebounds_offensive integer Offensive rebounds (player, this game).
rebounds_defensive integer Defensive rebounds (player, this game).
assists integer Assists (player, this game).
steals integer Steals (player, this game).
blocks integer Shots blocked (player, this game).
blocks_received integer Own shots blocked by an opponent (LNB only) (player, this game).
turnovers integer Turnovers (player, this game).
fouls_total integer Fouls committed (player, this game).
fouls_drawn integer Fouls drawn (committed against the player or team; LNBP only) (player, this game).
plus_minus integer Plus/minus, the point differential while on court (LNB only; null in some team lines) (player, this game).
efficiency integer Efficiency rating, from the site's own formula (player, this game).
field_goals_made integer Field goals made, two- and three-pointers together (LNBP only) (player, this game).
field_goals_attempted integer Field goals attempted (LNBP only) (player, this game).
field_goals_percentage double Field-goal percentage, 0-100 (LNBP only) (player, this game).
points_two_made integer Two-point field goals made (player, this game).
points_two_attempted integer Two-point field goals attempted (player, this game).
points_two_percentage double Two-point percentage, 0-100 (player, this game).
points_three_made integer Three-point field goals made (player, this game).
points_three_attempted integer Three-point field goals attempted (player, this game).
points_three_percentage double Three-point percentage, 0-100 (player, this game).
free_throws_made integer Free throws made (player, this game).
free_throws_attempted integer Free throws attempted (player, this game).
free_throws_percentage double Free-throw percentage, 0-100 (player, this game).
points_fast_break integer Fast-break points (LNBP only) (player, this game).

lmb_team_box()

The columns of atrium_team_box_score():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
entity_id character Team UUID (from the fixture's isHome flag).
side character Side of the game the row belongs to: home or away (from the fixture's isHome flag).
minutes character Time played as an ISO 8601 duration (PT7M23S); a team's is the sum over its players (PT200M) (team, this game).
seconds_played integer Time played in whole seconds, parsed from minutes (team, this game).
points integer Points scored (team, this game).
rebounds integer Total rebounds (team, this game).
rebounds_offensive integer Offensive rebounds (team, this game).
rebounds_defensive integer Defensive rebounds (team, this game).
assists integer Assists (team, this game).
steals integer Steals (team, this game).
blocks integer Shots blocked (team, this game).
blocks_received integer Own shots blocked by an opponent (LNB only) (team, this game).
turnovers integer Turnovers (team, this game).
fouls_total integer Fouls committed (team, this game).
fouls_drawn integer Fouls drawn (committed against the player or team; LNBP only) (team, this game).
plus_minus integer Plus/minus, the point differential while on court (LNB only; null in some team lines) (team, this game).
efficiency integer Efficiency rating, from the site's own formula (team, this game).
field_goals_made integer Field goals made, two- and three-pointers together (LNBP only) (team, this game).
field_goals_attempted integer Field goals attempted (LNBP only) (team, this game).
field_goals_percentage double Field-goal percentage, 0-100 (LNBP only) (team, this game).
points_two_made integer Two-point field goals made (team, this game).
points_two_attempted integer Two-point field goals attempted (team, this game).
points_two_percentage double Two-point percentage, 0-100 (team, this game).
points_three_made integer Three-point field goals made (team, this game).
points_three_attempted integer Three-point field goals attempted (team, this game).
points_three_percentage double Three-point percentage, 0-100 (team, this game).
free_throws_made integer Free throws made (team, this game).
free_throws_attempted integer Free throws attempted (team, this game).
free_throws_percentage double Free-throw percentage, 0-100 (team, this game).
points_fast_break integer Fast-break points (LNBP only) (team, this game).
extra_fouls_total integer Fouls committed (team, credited to the team rather than a player).
extra_rebounds integer Total rebounds (team, credited to the team rather than a player).
extra_rebounds_defensive integer Defensive rebounds (team, credited to the team rather than a player).
extra_rebounds_offensive integer Offensive rebounds (team, credited to the team rather than a player).
extra_turnovers integer Turnovers (team, credited to the team rather than a player).
total_biggest_lead integer Biggest lead of the game, in points (team, game total).
total_biggest_scoring_run integer Longest unanswered scoring run of the game, in points (team, game total).
total_field_goals_percentage double Field-goal percentage, 0-100 (LNBP only) (team, game total).
total_free_throws_percentage double Free-throw percentage, 0-100 (team, game total).
total_lead_changes integer Number of lead changes in the game (team, game total).
total_points_fast_break integer Fast-break points (LNBP only) (team, game total).
total_points_from_bench integer Points scored by non-starters (LNBP only) (team, game total).
total_points_from_turnover integer Points scored off opponent turnovers (LNBP only) (team, game total).
total_time_in_lead character Time the team led, as an ISO 8601 duration (PT36M11S) (team, game total).
total_time_in_lead_seconds integer Time the team led, in whole seconds (team, game total).
total_turnovers integer Turnovers (team, game total).

lmb_pbp()

The columns of atrium_pbp():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
sequence integer 1-based position of the event in the game (periods in order, events chronological).
event_id character Event UUID, shared with the same event in atrium_shots.
period_id integer Period number: 1-4 regulation, 11, 12, ... overtimes (not 5).
clock character Time REMAINING in the period as an ISO 8601 duration (PT10M0S at the start).
clock_seconds integer Seconds remaining in the period, parsed from clock.
entity_id character Team UUID the event is credited to.
side character Side of the game the row belongs to: home or away (from the fixture's isHome flag).
person_id character Player UUID; null for team events (time-outs, team rebounds).
person_name character Player the event is credited to; null for team events (time-outs, team rebounds).
bib character Jersey number of the player, as text; null for team events.
event_type character Event type: 2pt, 3pt, freeThrow, rebound, assist, steal, block, turnover, foul, substitution, timeOut, jumpBall, ... (language-independent).
event_sub_type character Event detail: jumpShot, layup, offensive, defensive, in, out, 1Of2, personal, ...; null when none.
description character The event's text in the site's language (e.g. Entre-deux remporte).
success logical True when a shot or free throw was made, false when missed; null for other events.
success_label character The made / missed label in the site's language; sent on shot events only.
x double Shot location along the 28 m court length as percent of the court (0-100, origin at a corner); the home team attacks the low-x basket all game; null for non-shots.
y double Shot location across the 15 m width as percent of the court (0-100); which sideline is 0 is unverified; null for non-shots.
home_score integer Home team's running score after the event.
away_score integer Away team's running score after the event.

lmb_shots()

The columns of atrium_shots():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
sequence integer 1-based position of the shot among the shots of the game (not the pbp sequence).
event_id character Event UUID of the shot; the same event in atrium_pbp.
period_id integer Period number: 1-4 regulation, 11, 12, ... overtimes (not 5).
clock character Time REMAINING in the period as an ISO 8601 duration (PT10M0S at the start).
clock_seconds integer Seconds remaining in the period, parsed from clock.
entity_id character Team UUID the event is credited to.
side character Side of the game the row belongs to: home or away (from the fixture's isHome flag).
person_id character Player UUID of the shooter.
person_name character Name of the shooter.
bib character Jersey number of the player, as text; null for team events.
event_type character Event type: 2pt, 3pt, freeThrow, rebound, assist, steal, block, turnover, foul, substitution, timeOut, jumpBall, ... (language-independent).
event_sub_type character Event detail: jumpShot, layup, offensive, defensive, in, out, 1Of2, personal, ...; null when none.
description character The event's text in the site's language (e.g. Entre-deux remporte).
success logical True when the shot was made, false when missed.
success_label character The made / missed label in the site's language; sent on shot events only.
x double Shot location along the 28 m court length as percent of the court (0-100, origin at a corner); the home team attacks the low-x basket all game; LNBP and NBL1 clamp rim attempts to 5 / 95.
y double Shot location across the 15 m width as percent of the court (0-100); which sideline is 0 is unverified.
home_score integer Home team's running score after the event.
away_score integer Away team's running score after the event.

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lnbp_competition, lpb_competition, nbl1_competition


LNBP (Mexico, with COPA VALUE and LNBP FEMENIL) (Atrium shortcuts)

Description

Per-competition shortcuts over the Atrium embed API for LNBP (Mexico, with COPA VALUE and LNBP FEMENIL) (website_id = 14; men's and women's).

Thin bindings of the parameterised ⁠atrium_*()⁠ wrappers to this site, minted from the competition registry (sdv-py tools/codegen/basketball_competitions.yaml); the full surface stays on the ⁠atrium_*()⁠ wrappers.

Usage

lnbp_seasons(locale = NULL)
lnbp_schedule(season = NULL, season_id = NULL, competition_id = NULL, locale = NULL)
lnbp_standings(season = NULL, season_id = NULL, competition_id = NULL, locale = NULL)
lnbp_teams(season = NULL, season_id = NULL, competition_id = NULL, locale = NULL)
lnbp_player_box(fixture_id, locale = NULL)
lnbp_team_box(fixture_id, locale = NULL)
lnbp_pbp(fixture_id, locale = NULL)
lnbp_shots(fixture_id, locale = NULL)

Arguments

season

(integer optional): Season END year (season rule below). Omit season and season_id for the site's current season.

season_id

(character optional): Season UUID (season_id in the seasons listing); skips the END-year lookup.

competition_id

(character optional): Competition UUID (a site carries many: conferences, cups); needed when several share the season.

locale

(character optional): Label locale, e.g. "en-EN"; omitted = the site's own language.

fixture_id

(character required): Fixture UUID (fixture_id in the schedule).

Details

Season rule: calendar year.

Errors and terms of use are those of atrium_fixtures(): unofficial use of the public widget endpoint, at least 1 s between requests, not republished as release assets. The site also serves women's competitions (pass their competition_id).

 lnbp_seasons()
 lnbp_schedule()

Value

A wehoop_data tibble with the columns of the base wrapper, one table per function:

lnbp_seasons()

The columns of atrium_seasons():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID; pass it as season_id to any season-scoped wrapper.
competition_id character Competition UUID; pass it as competition_id to pick one of several seasons of an END year.
competition_name character Competition name in the site's language; the same name can appear for several years.
season_name character Season name in the site's language, e.g. Betclic ELITE 2025.
abbreviation_local character Local abbreviation of the season; null in every body seen.
year integer The site's own year of the season: the START year on LNB (site 12), the calendar year elsewhere.
season_end_year integer Season END year (the sdv key): the site's year + 1 on LNB (site 12), the calendar year on the other registered sites; null when the site is unregistered, lists no seasons or the body has no season list.
is_default_season logical True for the season the body is about (the site's default when none was asked).

lnbp_schedule()

The columns of atrium_fixtures():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID the page is about (the site's default season when none was asked).
competition_id character Competition UUID of the season.
competition_name character Competition name in the site's language, e.g. Betclic ELITE or LIGA CALIENTE.MX LNBP.
season_end_year integer Season END year (the sdv key): the site's year + 1 on LNB (site 12), the calendar year on the other registered sites; null when the site is unregistered, lists no seasons or the body has no season list.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
fixture_type character Kind of game as sent: REGULAR, PLAYOFF, ... (the set is open).
name character Fixture name as the site prints it (e.g. Paris - Lyon-Villeurbanne); null on LNBP.
round character Round of the game as the site words it, e.g. Journee: 30.
round_code character Round code; null in every body seen.
pool character Pool the game belongs to; null when the competition has none.
series character Playoff series the game belongs to as sent (JSON text when an object); null outside a series.
stage_code character Opaque 30-hex stage code of the game; null in every body seen.
status character Status code of the game, e.g. CONFIRMED (final), as sent.
status_label character Status of the game as the site words it in its own language (e.g. Termine, Final).
start_time_utc POSIXct Scheduled start, naive datetime in UTC (the API sends no offset).
start_time_local character Scheduled start in the venue's local time, as the API sends it (YYYY-MM-DDTHH:MM:SS, no offset; timezone gives the zone, which varies per row).
timezone character IANA time zone of the venue (e.g. Europe/Paris, Mexico/General) that start_time_local is in.
times_unconfirmed logical True while the start time is not final.
venue character Name of the arena where the game is played.
venue_id character Venue UUID; joins no other route.
attendance integer Spectators at the game; null when not reported.
home_entity_id character Team UUID of the home team.
home_code character Short code of the home team (e.g. PAB).
home_name character Name of the home team.
home_score integer Points scored by the home team (the API sends a string; Int64 here).
home_result_place integer Result place of the home team: 1 for the winner, 2 for the loser.
home_result_status character Result status of the home team's score, e.g. CONFIRMED.
home_draw logical True when the game ended level for the home team.
home_shootout_attempts character Shootout attempts of the home team as sent (an empty string becomes null).
home_secondary_score character Secondary score of the home team (unused in the samples; shown as text).
away_entity_id character Team UUID of the away team.
away_code character Short code of the away team (e.g. PAB).
away_name character Name of the away team.
away_score integer Points scored by the away team (the API sends a string; Int64 here).
away_result_place integer Result place of the away team: 1 for the winner, 2 for the loser.
away_result_status character Result status of the away team's score, e.g. CONFIRMED.
away_draw logical True when the game ended level for the away team.
away_shootout_attempts character Shootout attempts of the away team as sent (an empty string becomes null).
away_secondary_score character Secondary score of the away team (unused in the samples; shown as text).

lnbp_standings()

The columns of atrium_standings():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID of the table.
season_end_year integer Season END year (the sdv key): the site's year + 1 on LNB (site 12), the calendar year on the other registered sites; null when the site is unregistered, lists no seasons or the body has no season list.
group character Label of the table when the standings hold several groups; null for a single table.
position integer League table position (1 = first).
entity_id character Team UUID of the row.
team_name character Team name as the site prints it.
is_current_team logical True for the team the page was opened for (team context); false on a plain standings request.
logo_url character URL of the team logo image.
wins integer Games won; -1 for two teams in the 2025-26 LNB table (an administrative ranking, unverified), kept as sent (team, this table).
losses integer Games lost (team, this table).
played integer Games played (LNBP and the compact standings) (team, this table).
standing_points integer League table points (LNBP) (team, this table).
win_percentage double Share of games won as a 0-1 fraction (not 0-100) (team, this table).
scored_for integer Points scored over the season (team, this table).
scored_against integer Points conceded over the season (team, this table).
point_difference integer Point differential over the season (team, this table).
result_string_home character Home results as a string of result letters in the site's language, one per game (order and letters per locale; unverified) (team, this table).
scored_for_home integer Points scored in home games (team, this table).
scored_against_home integer Points conceded in home games (team, this table).
point_difference_home integer Point differential in home games (team, this table).
result_string_away character Away results as a string of result letters in the site's language, one per game (order and letters per locale; unverified) (team, this table).
scored_for_away integer Points scored in away games (team, this table).
scored_against_away integer Points conceded in away games (team, this table).
point_difference_away integer Point differential in away games (team, this table).
streak integer Length of the current run of results (the win / loss sign convention is unverified) (team, this table).
streak_home integer Length of the current run of home results (sign convention unverified) (team, this table).
streak_away integer Length of the current run of away results (sign convention unverified) (team, this table).

lnbp_teams()

The columns of atrium_teams():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID of the team list.
entity_id character Team UUID (entity): one id per club across seasons, shared by every site that shows the team.
name character Team name in the site's language.
image_url character URL of the Sportradar-hosted image (400 px).

lnbp_player_box()

The columns of atrium_box_score():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
entity_id character Team UUID the player is rostered with for this game.
side character Side of the game the row belongs to: home or away (from the fixture's isHome flag).
person_id character Player UUID (person), shared across seasons and sites.
person_name character Player name as the site prints it (upper case on LNBP and NBL1).
bib character Jersey number the player wears, as text.
position character Position code on the roster (LNB, e.g. PG); null on LNBP.
starter logical True when the player started the game.
active logical True when the player is on the court in a live game.
participated logical True when the player entered the game; false rows have null statistics.
did_not_play_reason character Reason the player did not play; null in every body seen.
minutes character Time played as an ISO 8601 duration (PT7M23S); a team's is the sum over its players (PT200M) (player, this game).
seconds_played integer Time played in whole seconds, parsed from minutes (player, this game).
points integer Points scored (player, this game).
rebounds integer Total rebounds (player, this game).
rebounds_offensive integer Offensive rebounds (player, this game).
rebounds_defensive integer Defensive rebounds (player, this game).
assists integer Assists (player, this game).
steals integer Steals (player, this game).
blocks integer Shots blocked (player, this game).
blocks_received integer Own shots blocked by an opponent (LNB only) (player, this game).
turnovers integer Turnovers (player, this game).
fouls_total integer Fouls committed (player, this game).
fouls_drawn integer Fouls drawn (committed against the player or team; LNBP only) (player, this game).
plus_minus integer Plus/minus, the point differential while on court (LNB only; null in some team lines) (player, this game).
efficiency integer Efficiency rating, from the site's own formula (player, this game).
field_goals_made integer Field goals made, two- and three-pointers together (LNBP only) (player, this game).
field_goals_attempted integer Field goals attempted (LNBP only) (player, this game).
field_goals_percentage double Field-goal percentage, 0-100 (LNBP only) (player, this game).
points_two_made integer Two-point field goals made (player, this game).
points_two_attempted integer Two-point field goals attempted (player, this game).
points_two_percentage double Two-point percentage, 0-100 (player, this game).
points_three_made integer Three-point field goals made (player, this game).
points_three_attempted integer Three-point field goals attempted (player, this game).
points_three_percentage double Three-point percentage, 0-100 (player, this game).
free_throws_made integer Free throws made (player, this game).
free_throws_attempted integer Free throws attempted (player, this game).
free_throws_percentage double Free-throw percentage, 0-100 (player, this game).
points_fast_break integer Fast-break points (LNBP only) (player, this game).

lnbp_team_box()

The columns of atrium_team_box_score():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
entity_id character Team UUID (from the fixture's isHome flag).
side character Side of the game the row belongs to: home or away (from the fixture's isHome flag).
minutes character Time played as an ISO 8601 duration (PT7M23S); a team's is the sum over its players (PT200M) (team, this game).
seconds_played integer Time played in whole seconds, parsed from minutes (team, this game).
points integer Points scored (team, this game).
rebounds integer Total rebounds (team, this game).
rebounds_offensive integer Offensive rebounds (team, this game).
rebounds_defensive integer Defensive rebounds (team, this game).
assists integer Assists (team, this game).
steals integer Steals (team, this game).
blocks integer Shots blocked (team, this game).
blocks_received integer Own shots blocked by an opponent (LNB only) (team, this game).
turnovers integer Turnovers (team, this game).
fouls_total integer Fouls committed (team, this game).
fouls_drawn integer Fouls drawn (committed against the player or team; LNBP only) (team, this game).
plus_minus integer Plus/minus, the point differential while on court (LNB only; null in some team lines) (team, this game).
efficiency integer Efficiency rating, from the site's own formula (team, this game).
field_goals_made integer Field goals made, two- and three-pointers together (LNBP only) (team, this game).
field_goals_attempted integer Field goals attempted (LNBP only) (team, this game).
field_goals_percentage double Field-goal percentage, 0-100 (LNBP only) (team, this game).
points_two_made integer Two-point field goals made (team, this game).
points_two_attempted integer Two-point field goals attempted (team, this game).
points_two_percentage double Two-point percentage, 0-100 (team, this game).
points_three_made integer Three-point field goals made (team, this game).
points_three_attempted integer Three-point field goals attempted (team, this game).
points_three_percentage double Three-point percentage, 0-100 (team, this game).
free_throws_made integer Free throws made (team, this game).
free_throws_attempted integer Free throws attempted (team, this game).
free_throws_percentage double Free-throw percentage, 0-100 (team, this game).
points_fast_break integer Fast-break points (LNBP only) (team, this game).
extra_fouls_total integer Fouls committed (team, credited to the team rather than a player).
extra_rebounds integer Total rebounds (team, credited to the team rather than a player).
extra_rebounds_defensive integer Defensive rebounds (team, credited to the team rather than a player).
extra_rebounds_offensive integer Offensive rebounds (team, credited to the team rather than a player).
extra_turnovers integer Turnovers (team, credited to the team rather than a player).
total_biggest_lead integer Biggest lead of the game, in points (team, game total).
total_biggest_scoring_run integer Longest unanswered scoring run of the game, in points (team, game total).
total_field_goals_percentage double Field-goal percentage, 0-100 (LNBP only) (team, game total).
total_free_throws_percentage double Free-throw percentage, 0-100 (team, game total).
total_lead_changes integer Number of lead changes in the game (team, game total).
total_points_fast_break integer Fast-break points (LNBP only) (team, game total).
total_points_from_bench integer Points scored by non-starters (LNBP only) (team, game total).
total_points_from_turnover integer Points scored off opponent turnovers (LNBP only) (team, game total).
total_time_in_lead character Time the team led, as an ISO 8601 duration (PT36M11S) (team, game total).
total_time_in_lead_seconds integer Time the team led, in whole seconds (team, game total).
total_turnovers integer Turnovers (team, game total).

lnbp_pbp()

The columns of atrium_pbp():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
sequence integer 1-based position of the event in the game (periods in order, events chronological).
event_id character Event UUID, shared with the same event in atrium_shots.
period_id integer Period number: 1-4 regulation, 11, 12, ... overtimes (not 5).
clock character Time REMAINING in the period as an ISO 8601 duration (PT10M0S at the start).
clock_seconds integer Seconds remaining in the period, parsed from clock.
entity_id character Team UUID the event is credited to.
side character Side of the game the row belongs to: home or away (from the fixture's isHome flag).
person_id character Player UUID; null for team events (time-outs, team rebounds).
person_name character Player the event is credited to; null for team events (time-outs, team rebounds).
bib character Jersey number of the player, as text; null for team events.
event_type character Event type: 2pt, 3pt, freeThrow, rebound, assist, steal, block, turnover, foul, substitution, timeOut, jumpBall, ... (language-independent).
event_sub_type character Event detail: jumpShot, layup, offensive, defensive, in, out, 1Of2, personal, ...; null when none.
description character The event's text in the site's language (e.g. Entre-deux remporte).
success logical True when a shot or free throw was made, false when missed; null for other events.
success_label character The made / missed label in the site's language; sent on shot events only.
x double Shot location along the 28 m court length as percent of the court (0-100, origin at a corner); the home team attacks the low-x basket all game; null for non-shots.
y double Shot location across the 15 m width as percent of the court (0-100); which sideline is 0 is unverified; null for non-shots.
home_score integer Home team's running score after the event.
away_score integer Away team's running score after the event.

lnbp_shots()

The columns of atrium_shots():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
sequence integer 1-based position of the shot among the shots of the game (not the pbp sequence).
event_id character Event UUID of the shot; the same event in atrium_pbp.
period_id integer Period number: 1-4 regulation, 11, 12, ... overtimes (not 5).
clock character Time REMAINING in the period as an ISO 8601 duration (PT10M0S at the start).
clock_seconds integer Seconds remaining in the period, parsed from clock.
entity_id character Team UUID the event is credited to.
side character Side of the game the row belongs to: home or away (from the fixture's isHome flag).
person_id character Player UUID of the shooter.
person_name character Name of the shooter.
bib character Jersey number of the player, as text; null for team events.
event_type character Event type: 2pt, 3pt, freeThrow, rebound, assist, steal, block, turnover, foul, substitution, timeOut, jumpBall, ... (language-independent).
event_sub_type character Event detail: jumpShot, layup, offensive, defensive, in, out, 1Of2, personal, ...; null when none.
description character The event's text in the site's language (e.g. Entre-deux remporte).
success logical True when the shot was made, false when missed.
success_label character The made / missed label in the site's language; sent on shot events only.
x double Shot location along the 28 m court length as percent of the court (0-100, origin at a corner); the home team attacks the low-x basket all game; LNBP and NBL1 clamp rim attempts to 5 / 95.
y double Shot location across the 15 m width as percent of the court (0-100); which sideline is 0 is unverified.
home_score integer Home team's running score after the event.
away_score integer Away team's running score after the event.

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lpb_competition, nbl1_competition


Load cleaned NCAA women's college basketball play-by-play from the data repo

Description

Loads season-level NCAA women's college basketball play-by-play. One row per event, with reconstructed 5-man lineups, possession numbering, shot context (transition/paint/second-chance), and an ESPN game-id crosswalk. Produced by the sdv-py ncaa_wbb engine (stats.ncaa.org play-by-play parsed, cleaned, and enriched); backed by the ncaa-wbb-hoops-data pipeline, published to the ncaa_wbb_pbp release tag as csv.gz/parquet/rds.

Loads shot-chart events for NCAA women's college basketball – one row per field goal attempt, with court coordinates, distance, shot zone, and made/missed result. Coordinates are only available from the 2019 season onward (stats.ncaa.org did not publish shot-location data before then), so seasons has a 2019 floor even though most sibling NCAA WBB datasets start at 2010. Produced by the sdv-py ncaa_wbb engine; backed by the ncaa-wbb-hoops-data pipeline, published to the ncaa_wbb_shots release tag as csv.gz/parquet/rds.

Loads reconstructed 5-man lineup stints for NCAA women's college basketball – one row per contiguous stretch a specific 5-player lineup was on court for a team, with on/off scoring, shooting, and rebounding splits plus the matching opponent (⁠opp_*⁠) splits. Produced by the sdv-py ncaa_wbb engine's lineup reconstructor; backed by the ncaa-wbb-hoops-data pipeline, published to the ncaa_wbb_lineups release tag as csv.gz/parquet/rds.

Loads reconstructed 10-man matchup stints (the home 5-man lineup crossed with the away 5-man lineup) for NCAA women's college basketball – one row per contiguous stretch both lineups were on court together, with the score at stint start/end and both team's lineup rosters. Produced by the sdv-py ncaa_wbb engine's lineup reconstructor; backed by the ncaa-wbb-hoops-data pipeline, published to the ncaa_wbb_matchup_stints release tag as csv.gz/parquet/rds.

Loads possession-level data for NCAA women's college basketball – one row per offensive possession, with the on-court 5-man lineups for both teams, points scored, assist/transition/garbage-time flags, and the possession's first and last event types. Produced by the sdv-py ncaa_wbb engine's possession detector; backed by the ncaa-wbb-hoops-data pipeline, published to the ncaa_wbb_possessions release tag as csv.gz/parquet/rds.

Loads within-team regularized adjusted plus-minus (RAPM) ratings for NCAA women's college basketball – one row per player-team-season, fit against teammate lineup variation within that team's own possessions (not a cross-team national RAPM). Produced by the sdv-py ncaa_wbb engine's RAPM model on top of the reconstructed lineup/possession data; backed by the ncaa-wbb-hoops-data pipeline, published to the ncaa_wbb_rapm_within_team release tag as csv.gz/parquet/rds.

Loads league-wide regularized adjusted plus-minus (RAPM) ratings for NCAA women's college basketball – one row per player-season, fit against lineup variation across all Division I stints for that season (not a within-team RAPM). Produced by the sdv-py ncaa_wbb engine's league-wide stint-ridge RAPM solver (Torvik-gated to Division I teams) on top of the reconstructed lineup/possession data; backed by the ncaa-wbb-hoops-data pipeline, published to the ncaa_wbb_rapm release tag as csv.gz/parquet/rds.

Loads advanced per-player, per-game box scores for NCAA women's college basketball – one row per player-game, with shooting splits by zone (rim/mid/3), transition and half-court splits, assisted-vs-unassisted splits, and shot-zone efficiency rates. A superset of the traditional box score (points/rebounds/assists/steals/blocks/turnovers/fouls are included alongside the advanced splits). Produced by the sdv-py ncaa_wbb engine; backed by the ncaa-wbb-hoops-data pipeline, published to the ncaa_wbb_player_box release tag as csv.gz/parquet/rds.

Loads advanced per-team, per-game box scores for NCAA women's college basketball – one row per team-game, with offensive/defensive ratings, shot-zone rates and efficiency (rim/mid/3), rebounding/assist/turnover rates, and the matching opponent (⁠d_*⁠) splits. Produced by the sdv-py ncaa_wbb engine; backed by the ncaa-wbb-hoops-data pipeline, published to the ncaa_wbb_team_box release tag as csv.gz/parquet/rds.

Loads a lightweight season roster for NCAA women's college basketball – one row per player-team-season with a games-played count. For the fuller roster (jersey, class, position, height, hometown, high school), use load_ncaa_wbb_team_rosters(). Produced by the sdv-py ncaa_wbb engine; backed by the ncaa-wbb-hoops-data pipeline, published to the ncaa_wbb_rosters release tag as csv.gz/parquet/rds.

Loads the full season roster for NCAA women's college basketball – one row per player-team-season with jersey number, class year, position, height, hometown, high school, and games played/started. Produced by the sdv-py ncaa_wbb engine; backed by the ncaa-wbb-hoops-data pipeline, published to the ncaa_wbb_team_rosters release tag as csv.gz/parquet/rds.

Loads season schedules/results for NCAA women's college basketball – one row per game with home/away teams and final scores. Produced by the sdv-py ncaa_wbb engine; backed by the ncaa-wbb-hoops-data pipeline, published to the ncaa_wbb_schedule release tag as csv.gz/parquet/rds.

Loads the season-level stats.ncaa.org team-id / conference crosswalk for NCAA women's college basketball – one row per team-season. Useful for joining ncaa_team_id columns on the other ⁠ncaa_wbb_*⁠ datasets back to a team name and conference. Produced by the sdv-py ncaa_wbb engine; backed by the ncaa-wbb-hoops-data pipeline, published to the ncaa_wbb_team_ids release tag as csv.gz/parquet/rds.

Usage

load_ncaa_wbb_pbp(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_wbb_shots(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_wbb_lineups(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_wbb_matchup_stints(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_wbb_possessions(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_wbb_rapm_within_team(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_wbb_rapm(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_wbb_player_box(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_wbb_team_box(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_wbb_rosters(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_wbb_team_rosters(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_wbb_schedule(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_wbb_team_ids(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit season-ending years for NCAA women's college basketball (e.g. 2024 for the 2023-24 season). Published coverage runs 2010 through the most recent season, with no gaps. Pass seasons = TRUE for every published season. (Min: 2010)

...

Additional arguments passed to an underlying function that writes the season data into a database.

dbConnection

A DBIConnection object, as returned by DBI::dbConnect()

tablename

The name of the data table within the database

Details

League-wide regularized adjusted plus-minus – a single ridge fit over all Division I stints per season, distinct from load_ncaa_wbb_rapm_within_team()'s within-team fit. Published coverage runs seasons 2011 through 2026.

Value

Returns a wehoop_data tibble with one row per play-by-play event.

col_name types description
game_date character Date the game was played (MM/DD/YYYY).
home character Home team name.
away character Away team name.
period integer Period of the game (1-2 halves pre-2016, 1-4 quarters 2016+).
clock character Game clock remaining in the period (MM:SS).
game_time character Elapsed game time (MM:SS).
game_seconds integer Elapsed game time in seconds from tip-off.
home_score integer Home team score after the event.
away_score integer Away team score after the event.
event_team character Team name credited with the play event.
event_description character Raw play-by-play text description.
player_1 character Primary player name involved in the event (raw, upper-cased).
player_2 character Secondary player name involved in the event (raw, upper-cased).
event_type character Play event type label (e.g. 'made Layup', 'won Jumpball').
event_result character Event result ('made', 'missed', or NA for non-shot events).
shot_value integer Point value of a shot event (2 or 3).
event_length integer Duration of the event in seconds.
poss_num integer Sequential possession number within the game.
poss_team character Team name on offense for the possession.
poss_length integer Duration of the possession in seconds.
is_transition logical Whether the play occurred in transition.
home_1 character Home lineup slot 1 player name (raw).
home_2 character Home lineup slot 2 player name (raw).
home_3 character Home lineup slot 3 player name (raw).
home_4 character Home lineup slot 4 player name (raw).
home_5 character Home lineup slot 5 player name (raw).
away_1 character Away lineup slot 1 player name (raw).
away_2 character Away lineup slot 2 player name (raw).
away_3 character Away lineup slot 3 player name (raw).
away_4 character Away lineup slot 4 player name (raw).
away_5 character Away lineup slot 5 player name (raw).
status character Row QA status flag ('CLEAN' or a data-quality note).
is_garbage_time logical Whether the event occurred in garbage time.
sub_deviate integer Substitution-inference deviation counter used by the lineup reconstructor.
contest_id character Unique stats.ncaa.org contest identifier.
home_ncaa_team_id character stats.ncaa.org team identifier for the home team.
home_espn_team_id character ESPN team identifier for the home team.
away_ncaa_team_id character stats.ncaa.org team identifier for the away team.
away_espn_team_id character ESPN team identifier for the away team.
event_team_ncaa_team_id character stats.ncaa.org team identifier for the event team.
event_team_espn_team_id character ESPN team identifier for the event team.
poss_team_ncaa_team_id character stats.ncaa.org team identifier for the possession team.
poss_team_espn_team_id character ESPN team identifier for the possession team.
player_1_id character stats.ncaa.org player identifier for player_1.
player_1_clean_name character Cleaned/title-cased display name for player_1.
player_2_id character stats.ncaa.org player identifier for player_2.
player_2_clean_name character Cleaned/title-cased display name for player_2.
home_1_player_id character stats.ncaa.org player identifier for home lineup slot 1.
home_1_clean_name character Cleaned display name for home lineup slot 1.
home_2_player_id character stats.ncaa.org player identifier for home lineup slot 2.
home_2_clean_name character Cleaned display name for home lineup slot 2.
home_3_player_id character stats.ncaa.org player identifier for home lineup slot 3.
home_3_clean_name character Cleaned display name for home lineup slot 3.
home_4_player_id character stats.ncaa.org player identifier for home lineup slot 4.
home_4_clean_name character Cleaned display name for home lineup slot 4.
home_5_player_id character stats.ncaa.org player identifier for home lineup slot 5.
home_5_clean_name character Cleaned display name for home lineup slot 5.
away_1_player_id character stats.ncaa.org player identifier for away lineup slot 1.
away_1_clean_name character Cleaned display name for away lineup slot 1.
away_2_player_id character stats.ncaa.org player identifier for away lineup slot 2.
away_2_clean_name character Cleaned display name for away lineup slot 2.
away_3_player_id character stats.ncaa.org player identifier for away lineup slot 3.
away_3_clean_name character Cleaned display name for away lineup slot 3.
away_4_player_id character stats.ncaa.org player identifier for away lineup slot 4.
away_4_clean_name character Cleaned display name for away lineup slot 4.
away_5_player_id character stats.ncaa.org player identifier for away lineup slot 5.
away_5_clean_name character Cleaned display name for away lineup slot 5.
espn_game_id character ESPN game identifier crosswalked to this contest.
is_fastbreak logical Whether the play was a fastbreak possession.
is_from_turnover logical Whether the possession began off a turnover.
is_paint logical Whether the shot was taken in the paint.
is_second_chance logical Whether the possession followed an offensive rebound.
assist_player character Cleaned display name of the player credited with the assist.
ft_number integer Free throw number within the trip to the line (1st, 2nd, ...).
ft_attempts integer Total free throws awarded on the trip to the line.
foul_class character Foul classification ('personal', 'technical', etc.).
is_shooting_foul logical Whether the foul was a shooting foul.
is_looseball_foul logical Whether the foul was a loose-ball foul.
is_one_and_one logical Whether the free throw trip was a one-and-one bonus.
is_flagrant logical Whether the foul was flagrant.
foul_tech_class character Technical foul sub-classification (e.g. 'administrative').
ft_awarded integer Total free throws awarded for the foul.
turnover_type character Turnover sub-type (e.g. 'shotclock', 'travel').
is_team_turnover logical Whether the turnover is a team turnover (no individual credited).
timeout_type character Timeout sub-type (e.g. 'short', 'full').
challenge_outcome character Replay-challenge outcome, when the event was a review.
season integer Season identifier (4-digit season-ending year).

Returns a wehoop_data tibble with one row per shot attempt.

col_name types description
season integer Season identifier (4-digit season-ending year).
team_id character Team name of the shooting team (raw scrape field; despite the column name it holds the team name string, not a numeric id -- see ncaa_team_id / espn_team_id for the crosswalked ids).
shooter_id character Raw scrape key for the shooter (see shooter_player_id for the stats.ncaa.org id).
shot_x numeric Shot chart X coordinate.
shot_y numeric Shot chart Y coordinate.
dist_ft numeric Shot distance from the basket, in feet.
shot_zone character Shot zone label (e.g. 'abovebreak3', 'rim').
shot_type character Shot type label from the source play description.
made logical Whether the shot was made.
point_value integer Point value of the shot (2 or 3).
period logical Period of the game (1-2 halves pre-2016, 1-4 quarters 2016+).
sec_left logical Seconds remaining in the period at the time of the shot.
source character Source system for the shot record (e.g. 'ncaa').
contest_id character Unique stats.ncaa.org contest identifier.
ncaa_team_id character stats.ncaa.org team identifier for the shooting team.
espn_team_id character ESPN team identifier for the shooting team.
shooter_player_id character stats.ncaa.org player identifier for the shooter.
shooter_clean_name character Cleaned display name for the shooter.
espn_game_id character ESPN game identifier crosswalked to this contest.

Returns a wehoop_data tibble with one row per lineup stint.

col_name types description
lineup_key character Hash key uniquely identifying the 5-player lineup.
date character Game date/time (ISO 8601).
location_type character Home/away designation for team in this stint ('Home' or 'Away').
team character Team name.
team_year integer Season-start calendar year for the stint.
opponent character Opponent team name.
lineup_id character Human-readable lineup identifier built from the five player codes.
start_min numeric Game-clock minute the lineup entered.
end_min numeric Game-clock minute the lineup exited.
duration_mins numeric Minutes the lineup was on court together.
player_1 character Lineup slot 1 player display name ('Last, First').
player_2 character Lineup slot 2 player display name ('Last, First').
player_3 character Lineup slot 3 player display name ('Last, First').
player_4 character Lineup slot 4 player display name ('Last, First').
player_5 character Lineup slot 5 player display name ('Last, First').
players_in character Player(s) substituted into the lineup at the start of the stint.
players_out character Player(s) substituted out of the lineup at the start of the stint.
start_scored integer Team's points scored at the moment the lineup entered.
start_allowed integer Points allowed at the moment the lineup entered.
end_scored integer Team's points scored at the moment the lineup exited.
end_allowed integer Points allowed at the moment the lineup exited.
start_diff integer Score differential at the moment the lineup entered.
end_diff integer Score differential at the moment the lineup exited.
player_count_error logical Flag set when fewer/more than 5 players were reconstructed for the stint.
poss integer Possessions played by the lineup.
pts integer Points scored.
plus_minus integer Point differential while the lineup was on court.
fga integer Field goal attempts by the lineup.
fgm integer Field goals made by the lineup.
rima integer Rim-area shot attempts.
rimm integer Rim-area shots made.
rim_ast integer Rim-area makes that came off an assist.
mida integer Mid-range shot attempts.
midm integer Mid-range shots made.
mid_ast integer Mid-range makes that came off an assist.
fg2a integer 2-point field goal attempts by the lineup.
fg2m integer 2-point field goals made by the lineup.
tpa integer 3-point field goal attempts.
tpm integer 3-point field goals made.
tp_ast integer 3-pointers made that came off an assist.
fta integer Free throw attempts by the lineup.
ftm integer Free throws made by the lineup.
orb integer Offensive rebounds.
drb integer Defensive rebounds.
to integer Turnovers by the lineup.
stl integer Steals.
blk integer Blocks.
ast integer Assists.
foul integer Personal fouls.
opp_poss integer Opponent possessions while this lineup was on court.
opp_pts integer Opponent points scored while this lineup was on court.
opp_plus_minus integer Opponent point differential while this lineup was on court (negative of plus_minus).
opp_fga integer Opponent field goal attempts.
opp_fgm integer Opponent field goals made.
opp_rima integer Opponent rim-area shot attempts.
opp_rimm integer Opponent rim-area shots made.
opp_rim_ast integer Opponent rim-area makes that came off an assist.
opp_mida integer Opponent mid-range shot attempts.
opp_midm integer Opponent mid-range shots made.
opp_mid_ast integer Opponent mid-range makes that came off an assist.
opp_fg2a integer Opponent 2-point field goal attempts.
opp_fg2m integer Opponent 2-point field goals made.
opp_tpa integer Opponent 3-point field goal attempts.
opp_tpm integer Opponent 3-point field goals made.
opp_tp_ast integer Opponent 3-pointers made that came off an assist.
opp_fta integer Opponent free throw attempts.
opp_ftm integer Opponent free throws made.
opp_orb integer Opponent offensive rebounds.
opp_drb integer Opponent defensive rebounds.
opp_to integer Opponent turnovers.
opp_stl integer Opponent steals.
opp_blk integer Opponent blocks.
opp_ast integer Opponent assists.
opp_foul integer Opponent personal fouls.
stint_num integer Sequential stint number for this lineup within the game.
contest_id character Unique stats.ncaa.org contest identifier.
season integer Season identifier (4-digit season-ending year).

Returns a wehoop_data tibble with one row per matchup stint.

col_name types description
contest_id character Unique stats.ncaa.org contest identifier.
season integer Season identifier (4-digit season-ending year).
game_date character Date the game was played (MM/DD/YYYY).
home character Home team name.
away character Away team name.
game_stint_num integer Sequential stint number within the game (all 10-man matchups).
period integer Period of the game (1-2 halves pre-2016, 1-4 quarters 2016+).
start_seconds integer Elapsed game seconds at the start of the stint.
end_seconds integer Elapsed game seconds at the end of the stint.
duration_seconds integer Duration of the stint in seconds.
matchup_key character Hash key uniquely identifying the home-lineup/away-lineup matchup.
home_lineup_key character Hash key for the home team's 5-player lineup.
away_lineup_key character Hash key for the away team's 5-player lineup.
home_lineup character Pipe-delimited list of the 5 home players on court.
away_lineup character Pipe-delimited list of the 5 away players on court.
end_home_score integer Home team score at the end of the stint.
end_away_score integer Away team score at the end of the stint.
n_events integer Number of play-by-play events within the stint.
n_possessions integer Number of possessions within the stint.
start_home_score integer Home team score at the start of the stint.
start_away_score integer Away team score at the start of the stint.
home_pts integer Points scored by the home team during the stint.
away_pts integer Points scored by the away team during the stint.
home_1 character Home lineup slot 1 player name (raw).
home_2 character Home lineup slot 2 player name (raw).
home_3 character Home lineup slot 3 player name (raw).
home_4 character Home lineup slot 4 player name (raw).
home_5 character Home lineup slot 5 player name (raw).
away_1 character Away lineup slot 1 player name (raw).
away_2 character Away lineup slot 2 player name (raw).
away_3 character Away lineup slot 3 player name (raw).
away_4 character Away lineup slot 4 player name (raw).
away_5 character Away lineup slot 5 player name (raw).

Returns a wehoop_data tibble with one row per possession.

col_name types description
game_date character Date the game was played (MM/DD/YYYY).
home character Home team name.
away character Away team name.
period integer Period of the game (1-2 halves pre-2016, 1-4 quarters 2016+).
poss_num integer Sequential possession number within the game.
poss_team character Team name on offense for the possession.
home_1 character Home lineup slot 1 player name (raw).
home_2 character Home lineup slot 2 player name (raw).
home_3 character Home lineup slot 3 player name (raw).
home_4 character Home lineup slot 4 player name (raw).
home_5 character Home lineup slot 5 player name (raw).
away_1 character Away lineup slot 1 player name (raw).
away_2 character Away lineup slot 2 player name (raw).
away_3 character Away lineup slot 3 player name (raw).
away_4 character Away lineup slot 4 player name (raw).
away_5 character Away lineup slot 5 player name (raw).
home_score integer Home team score after the event.
away_score integer Away team score after the event.
pts integer Points scored.
is_assisted integer Whether the possession ended in an assisted make.
is_transition integer Whether the play occurred in transition.
is_garbage_time integer Whether the event occurred in garbage time.
start_event_type character Event type that started the possession.
first_shot_time integer Elapsed game seconds at the possession's first shot attempt.
first_shot_type character Event type of the possession's first shot attempt.
last_event_time integer Elapsed game seconds at the possession's final event.
last_event_type character Event type of the possession's final event.
contest_id character Unique stats.ncaa.org contest identifier.
home_ncaa_team_id character stats.ncaa.org team identifier for the home team.
home_espn_team_id character ESPN team identifier for the home team.
away_ncaa_team_id character stats.ncaa.org team identifier for the away team.
away_espn_team_id character ESPN team identifier for the away team.
poss_team_ncaa_team_id character stats.ncaa.org team identifier for the possession team.
poss_team_espn_team_id character ESPN team identifier for the possession team.
home_1_player_id character stats.ncaa.org player identifier for home lineup slot 1.
home_1_clean_name character Cleaned display name for home lineup slot 1.
home_2_player_id character stats.ncaa.org player identifier for home lineup slot 2.
home_2_clean_name character Cleaned display name for home lineup slot 2.
home_3_player_id character stats.ncaa.org player identifier for home lineup slot 3.
home_3_clean_name character Cleaned display name for home lineup slot 3.
home_4_player_id character stats.ncaa.org player identifier for home lineup slot 4.
home_4_clean_name character Cleaned display name for home lineup slot 4.
home_5_player_id character stats.ncaa.org player identifier for home lineup slot 5.
home_5_clean_name character Cleaned display name for home lineup slot 5.
away_1_player_id character stats.ncaa.org player identifier for away lineup slot 1.
away_1_clean_name character Cleaned display name for away lineup slot 1.
away_2_player_id character stats.ncaa.org player identifier for away lineup slot 2.
away_2_clean_name character Cleaned display name for away lineup slot 2.
away_3_player_id character stats.ncaa.org player identifier for away lineup slot 3.
away_3_clean_name character Cleaned display name for away lineup slot 3.
away_4_player_id character stats.ncaa.org player identifier for away lineup slot 4.
away_4_clean_name character Cleaned display name for away lineup slot 4.
away_5_player_id character stats.ncaa.org player identifier for away lineup slot 5.
away_5_clean_name character Cleaned display name for away lineup slot 5.
espn_game_id character ESPN game identifier crosswalked to this contest.
season integer Season identifier (4-digit season-ending year).

Returns a wehoop_data tibble with one row per player-team-season.

col_name types description
team character Team name.
player_code character Player display name as 'Last, First' used as the RAPM join key.
rapm_off numeric Within-team offensive regularized adjusted plus-minus.
rapm_def numeric Within-team defensive regularized adjusted plus-minus.
team_off_poss numeric Team offensive possessions used in the RAPM fit.
num_players integer Number of teammates included in the within-team RAPM fit.
rapm_net numeric Within-team net regularized adjusted plus-minus (rapm_off + rapm_def).
season integer Season identifier (4-digit season-ending year).
player_id character stats.ncaa.org player identifier.
team_id character Unique team identifier.
person_id character Internal person identifier used to join across seasons/teams.

Returns a wehoop_data tibble with one row per player-season.

col_name types description
season integer Season identifier (4-digit season-ending year).
player_id character stats.ncaa.org player identifier.
person_id character Internal person identifier used to join across seasons/teams.
player character Player display name ('LAST.FIRST' format).
team character Team name.
orapm numeric League-wide offensive regularized adjusted plus-minus.
drapm numeric League-wide defensive regularized adjusted plus-minus.
rapm_net numeric League-wide net regularized adjusted plus-minus (orapm + drapm).
off_poss integer Offensive possessions used in the RAPM fit.
def_poss integer Defensive possessions used in the RAPM fit.
estimand character Estimand tag for the RAPM fit (e.g. 'league' for the Division I stint solve).

Returns a wehoop_data tibble with one row per player-game.

col_name types description
game_date character Date the game was played (MM/DD/YYYY).
home character Home team name.
away character Away team name.
team character Team name.
player character Player name (raw, upper-cased).
mins numeric Minutes played.
o_poss numeric Offensive possessions played.
pts numeric Points scored.
orb numeric Offensive rebounds.
drb numeric Defensive rebounds.
ast numeric Assists.
stl numeric Steals.
blk numeric Blocks.
tov numeric Turnovers.
pf numeric Personal fouls.
ts_pct numeric True shooting percentage.
efg_pct numeric Effective field goal percentage.
fgm numeric Field goals made by the lineup.
fga numeric Field goal attempts by the lineup.
fg_pct numeric Field goal percentage.
tpm numeric 3-point field goals made.
tpa numeric 3-point field goal attempts.
tp_pct numeric 3-point field goal percentage.
ftm numeric Free throws made by the lineup.
fta numeric Free throw attempts by the lineup.
ft_pct numeric Free throw percentage.
rimm numeric Rim-area shots made.
rima numeric Rim-area shot attempts.
rim_pct numeric Rim-area field goal percentage.
midm numeric Mid-range shots made.
mida numeric Mid-range shot attempts.
mid_pct numeric Mid-range field goal percentage.
pbackm numeric Post/back-to-basket shots made.
pbacka numeric Post/back-to-basket attempts.
pback_pct numeric Post/back-to-basket shooting percentage.
blk_rim numeric Blocked shots at the rim.
blk_mid numeric Blocked mid-range shots.
blk_three numeric Blocked 3-point attempts.
pct_fga_trans numeric Share of field goal attempts taken in transition.
pct_tpa_trans numeric Share of 3-point attempts taken in transition.
pct_rima_trans numeric Share of rim-area attempts taken in transition.
pct_fgm_trans numeric Share of field goals made in transition.
pct_tpm_trans numeric Share of 3-pointers made in transition.
pct_rimm_trans numeric Share of rim-area shots made in transition.
pct_fgm_ast numeric Share of field goals made that were assisted.
pct_tpm_ast numeric Share of 3-pointers made that were assisted.
pct_rimm_ast numeric Share of rim-area shots made that were assisted.
pts_trans numeric Points scored in transition.
orb_trans numeric Offensive rebounds in transition possessions.
drb_trans numeric Defensive rebounds in transition possessions.
ast_trans numeric Assists in transition possessions.
stl_trans numeric Steals in transition possessions.
blk_trans numeric Blocks in transition possessions.
tov_trans numeric Turnovers in transition possessions.
ts_pct_trans numeric True shooting percentage in transition possessions.
efg_pct_trans numeric Effective field goal percentage in transition possessions.
fgm_trans numeric Field goals made in transition possessions.
fga_trans numeric Field goal attempts in transition possessions.
fg_pct_trans numeric Field goal percentage in transition possessions.
tpm_trans numeric 3-point field goals made in transition possessions.
tpa_trans numeric 3-point field goal attempts in transition possessions.
tp_pct_trans numeric 3-point field goal percentage in transition possessions.
ftm_trans numeric Free throws made in transition possessions.
fta_trans numeric Free throw attempts in transition possessions.
ft_pct_trans numeric Free throw percentage in transition possessions.
rimm_trans numeric Rim-area shots made in transition possessions.
rima_trans numeric Rim-area shot attempts in transition possessions.
rim_pct_trans numeric Rim-area field goal percentage in transition possessions.
midm_trans numeric Mid-range shots made in transition possessions.
mida_trans numeric Mid-range shot attempts in transition possessions.
mid_pct_trans numeric Mid-range field goal percentage in transition possessions.
pts_half numeric Points scored in half-court possessions.
orb_half numeric Offensive rebounds in half-court possessions.
drb_half numeric Defensive rebounds in half-court possessions.
ast_half numeric Assists in half-court possessions.
stl_half numeric Steals in half-court possessions.
blk_half numeric Blocks in half-court possessions.
tov_half numeric Turnovers in half-court possessions.
ts_pct_half numeric True shooting percentage in half-court possessions.
efg_pct_half numeric Effective field goal percentage in half-court possessions.
fgm_half numeric Field goals made in half-court possessions.
fga_half numeric Field goal attempts in half-court possessions.
fg_pct_half numeric Field goal percentage in half-court possessions.
tpm_half numeric 3-point field goals made in half-court possessions.
tpa_half numeric 3-point field goal attempts in half-court possessions.
tp_pct_half numeric 3-point field goal percentage in half-court possessions.
ftm_half numeric Free throws made in half-court possessions.
fta_half numeric Free throw attempts in half-court possessions.
ft_pct_half numeric Free throw percentage in half-court possessions.
rimm_half numeric Rim-area shots made in half-court possessions.
rima_half numeric Rim-area shot attempts in half-court possessions.
rim_pct_half numeric Rim-area field goal percentage in half-court possessions.
midm_half numeric Mid-range shots made in half-court possessions.
mida_half numeric Mid-range shot attempts in half-court possessions.
mid_pct_half numeric Mid-range field goal percentage in half-court possessions.
pts_ast numeric Points scored off an assisted make.
fgm_ast numeric Field goals made that came off an assist.
tpm_ast numeric 3-point field goals made that came off an assist.
rimm_ast numeric Rim-area shots made that came off an assist.
midm_ast numeric Mid-range shots made that came off an assist.
pts_unast numeric Points scored off an unassisted make.
efg_pct_unast numeric Effective field goal percentage that were unassisted.
fgm_unast numeric Field goals made that were unassisted.
fga_unast numeric Field goal attempts that were unassisted.
fg_pct_unast numeric Field goal percentage that were unassisted.
tpm_unast numeric 3-point field goals made that were unassisted.
tpa_unast numeric 3-point field goal attempts that were unassisted.
tp_pct_unast numeric 3-point field goal percentage that were unassisted.
rimm_unast numeric Rim-area shots made that were unassisted.
rima_unast numeric Rim-area shot attempts that were unassisted.
rim_pct_unast numeric Rim-area field goal percentage that were unassisted.
midm_unast numeric Mid-range shots made that were unassisted.
mida_unast numeric Mid-range shot attempts that were unassisted.
mid_pct_unast numeric Mid-range field goal percentage that were unassisted.
contest_id character Unique stats.ncaa.org contest identifier.
home_ncaa_team_id character stats.ncaa.org team identifier for the home team.
home_espn_team_id character ESPN team identifier for the home team.
away_ncaa_team_id character stats.ncaa.org team identifier for the away team.
away_espn_team_id character ESPN team identifier for the away team.
team_ncaa_team_id character stats.ncaa.org team identifier.
team_espn_team_id character ESPN team identifier.
player_id character stats.ncaa.org player identifier.
clean_name character Cleaned/title-cased display name.
espn_game_id character ESPN game identifier crosswalked to this contest.
season integer Season identifier (4-digit season-ending year).

Returns a wehoop_data tibble with one row per team-game.

col_name types description
home character Home team name.
away character Away team name.
team character Team name.
mins numeric Minutes played.
o_mins numeric Minutes with the team on offense.
d_mins numeric Minutes with the team on defense.
o_poss numeric Offensive possessions played.
d_poss numeric Defensive possessions played.
ortg numeric Offensive rating (points per 100 possessions).
drtg numeric Defensive rating (points allowed per 100 possessions).
netrtg numeric Net rating (ortg minus drtg).
pts numeric Points scored.
d_pts numeric Points allowed.
fga numeric Field goal attempts by the lineup.
d_fga numeric Opponent field goal attempts.
fgm numeric Field goals made by the lineup.
d_fgm numeric Opponent field goals made.
tpa numeric 3-point field goal attempts.
d_tpa numeric Opponent 3-point attempts.
tpm numeric 3-point field goals made.
d_tpm numeric Opponent 3-pointers made.
fta numeric Free throw attempts by the lineup.
d_fta numeric Opponent free throw attempts.
ftm numeric Free throws made by the lineup.
d_ftm numeric Opponent free throws made.
rima numeric Rim-area shot attempts.
d_rima numeric Opponent rim-area attempts.
rimm numeric Rim-area shots made.
d_rimm numeric Opponent rim-area shots made.
orb numeric Offensive rebounds.
d_orb numeric Opponent offensive rebounds.
drb numeric Defensive rebounds.
d_drb numeric Opponent defensive rebounds.
blk numeric Blocks.
d_blk numeric Opponent blocks.
to numeric Turnovers by the lineup.
d_to numeric Opponent turnovers.
ast numeric Assists.
d_ast numeric Opponent assists.
e_poss numeric Estimated possessions (alternate possession estimator).
fg_pct numeric Field goal percentage.
d_fg_pct numeric Opponent field goal percentage.
tpp numeric 3-point field goal percentage.
d_tpp numeric Opponent 3-point percentage.
ftp numeric Free throw percentage.
d_ftp numeric Opponent free throw percentage.
efg_pct numeric Effective field goal percentage.
d_efg_pct numeric Opponent effective field goal percentage.
ts_pct numeric True shooting percentage.
d_ts_pct numeric Opponent true shooting percentage.
rim_pct numeric Rim-area field goal percentage.
d_rim_pct numeric Opponent rim-area field goal percentage.
mid_pct numeric Mid-range field goal percentage.
d_mid_pct numeric Opponent mid-range field goal percentage.
tp_rate numeric Share of shot attempts taken from 3-point range.
d_tp_rate numeric Opponent share of shot attempts from 3-point range.
rim_rate numeric Share of shot attempts taken at the rim.
d_rim_rate numeric Opponent share of shot attempts at the rim.
mid_rate numeric Share of shot attempts taken mid-range.
d_mid_rate numeric Opponent share of shot attempts mid-range.
ft_rate numeric Free throw rate (FTA per FGA).
d_ft_rate numeric Opponent free throw rate.
ast_rate numeric Assist rate.
d_ast_rate numeric Opponent assist rate.
to_rate numeric Turnover rate.
d_to_rate numeric Opponent turnover rate.
blk_rate numeric Block rate.
o_blk_rate numeric Offensive possessions ending in a block allowed, as a rate.
orb_pct numeric Offensive rebound percentage.
drb_pct numeric Defensive rebound percentage.
time_per_poss numeric Average seconds per possession.
d_time_per_poss numeric Opponent average seconds per possession.
contest_id character Unique stats.ncaa.org contest identifier.
home_ncaa_team_id character stats.ncaa.org team identifier for the home team.
home_espn_team_id character ESPN team identifier for the home team.
away_ncaa_team_id character stats.ncaa.org team identifier for the away team.
away_espn_team_id character ESPN team identifier for the away team.
team_ncaa_team_id character stats.ncaa.org team identifier.
team_espn_team_id character ESPN team identifier.
espn_game_id character ESPN game identifier crosswalked to this contest.
season integer Season identifier (4-digit season-ending year).

Returns a wehoop_data tibble with one row per player-team-season.

col_name types description
season integer Season identifier (4-digit season-ending year).
team character Team name.
player character Player name (raw, upper-cased).
games integer Games played (season total).

Returns a wehoop_data tibble with one row per player-team-season.

col_name types description
season integer Season identifier (4-digit season-ending year).
team_id character Unique team identifier.
team character Team name.
player_id character stats.ncaa.org player identifier.
player character Player name (raw, upper-cased).
clean_name character Cleaned/title-cased display name.
name character Player full display name.
jersey character Jersey number.
class character Class year (e.g. 'Fr.', 'So.', 'Jr.', 'Sr.').
position character Position abbreviation.
height character Height as a 'feet-inches' string (e.g. '6-1').
ht_inches integer Height in total inches.
hometown character Player hometown (city, state).
high_school character Player high school.
gp character Games played.
gs character Games started.

Returns a wehoop_data tibble with one row per game.

col_name types description
contest_id character Unique stats.ncaa.org contest identifier.
game_date character Date the game was played (MM/DD/YYYY).
home character Home team name.
away character Away team name.
home_score integer Home team score after the event.
away_score integer Away team score after the event.
season integer Season identifier (4-digit season-ending year).

Returns a wehoop_data tibble with one row per team-season.

col_name types description
team character Team name.
conference character Conference affiliation.
id character stats.ncaa.org team identifier.
season integer Season identifier (4-digit season-ending year).

Author(s)

Saiem Gilani

Examples

try(load_ncaa_wbb_pbp(seasons = most_recent_wbb_season()))


  try(load_ncaa_wbb_shots(seasons = most_recent_wbb_season()))


  try(load_ncaa_wbb_lineups(seasons = most_recent_wbb_season()))


  try(load_ncaa_wbb_matchup_stints(seasons = most_recent_wbb_season()))


  try(load_ncaa_wbb_possessions(seasons = most_recent_wbb_season()))


  try(load_ncaa_wbb_rapm_within_team(seasons = most_recent_wbb_season()))


  try(load_ncaa_wbb_rapm(seasons = most_recent_wbb_season()))


  try(load_ncaa_wbb_player_box(seasons = most_recent_wbb_season()))


  try(load_ncaa_wbb_team_box(seasons = most_recent_wbb_season()))


  try(load_ncaa_wbb_rosters(seasons = most_recent_wbb_season()))


  try(load_ncaa_wbb_team_rosters(seasons = most_recent_wbb_season()))


  try(load_ncaa_wbb_schedule(seasons = most_recent_wbb_season()))


  try(load_ncaa_wbb_team_ids(seasons = most_recent_wbb_season()))

Load conference and division aliases (WBB / WNBA) from the data repo

Description

Loads every name and id that a source (ESPN, NCAA, WNBA Stats, SDV) uses for a group, with the seasons each alias is valid for. Use it to map a source's conference id or name onto an SDV group_id. load_wbb_group_aliases() reads the wbb_groups release tag and load_wnba_group_aliases() the wnba_groups tag.

Usage

load_wbb_group_aliases(..., dbConnection = NULL, tablename = NULL)

load_wnba_group_aliases(..., dbConnection = NULL, tablename = NULL)

Arguments

...

Additional arguments passed to an underlying function that writes the data into a database.

dbConnection

A DBIConnection object, as returned by DBI::dbConnect()

tablename

The name of the data table within the database

Value

Returns a wehoop_data tibble with one row per alias.

col_name types description
league character League key: wbb or wnba.
group_id character SDV group id, {league}:{slug}.
source character Source that uses the alias: espn, ncaa or sdv (WBB); espn, wnba_stats or sdv (WNBA).
source_id character The source's own id for the group (e.g. ESPN group id, NCAA conference id), when it has one.
name_kind character Kind of alias: name, short_name, abbreviation, slug, or code.
value character The alias itself.
valid_from integer First season the alias applies, inclusive; NA means unbounded.
valid_to integer Last season the alias applies, inclusive; NA means unbounded.

Author(s)

Saiem Gilani

See Also

Other Conference and Division Group loader functions: load_wbb_group_seasons(), load_wbb_groups(), load_wbb_team_group_seasons()

Examples

try(load_wbb_group_aliases())


  try(load_wnba_group_aliases())

Load conference and division names by season (WBB / WNBA) from the data repo

Description

Loads one row per group per season it existed, with the group's name, short name, abbreviation, and parent group as of that season rather than today's labels, plus its member count. load_wbb_group_seasons() reads the wbb_groups release tag and load_wnba_group_seasons() the wnba_groups tag.

Usage

load_wbb_group_seasons(..., dbConnection = NULL, tablename = NULL)

load_wnba_group_seasons(..., dbConnection = NULL, tablename = NULL)

Arguments

...

Additional arguments passed to an underlying function that writes the data into a database.

dbConnection

A DBIConnection object, as returned by DBI::dbConnect()

tablename

The name of the data table within the database

Value

Returns a wehoop_data tibble with one row per group-season.

col_name types description
league character League key: wbb or wnba.
group_id character SDV group id, {league}:{slug}.
season integer Season (WBB: ending year, 2025 = 2024-25; WNBA: calendar year).
level character Group level: league, subdivision, conference, or division.
name character Group name as of that season.
short_name character Group short name as of that season.
abbreviation character Group abbreviation as of that season.
parent_group_id character Parent group id as of that season (division to conference to subdivision or league).
n_teams integer Number of member teams that season.

Author(s)

Saiem Gilani

See Also

Other Conference and Division Group loader functions: load_wbb_group_aliases(), load_wbb_groups(), load_wbb_team_group_seasons()

Examples

try(load_wbb_group_seasons())


  try(load_wnba_group_seasons())

Load conference and division lineages (WBB / WNBA) from the data repo

Description

Loads one row per group lineage – the league or subdivision, each conference, and each division – with the first and last season each had at least one member. A lineage keeps one group_id across renames that keep continuity (American Athletic to American stays wbb:american); a new body gets a new id. load_wbb_groups() reads the wbb_groups release tag and load_wnba_groups() the wnba_groups tag.

See load_wbb_group_seasons() for per-season names and parents, load_wbb_group_aliases() for the names and ids other sources use, and load_wbb_team_group_seasons() for team membership.

Usage

load_wbb_groups(..., dbConnection = NULL, tablename = NULL)

load_wnba_groups(..., dbConnection = NULL, tablename = NULL)

Arguments

...

Additional arguments passed to an underlying function that writes the data into a database.

dbConnection

A DBIConnection object, as returned by DBI::dbConnect()

tablename

The name of the data table within the database

Value

Returns a wehoop_data tibble with one row per group lineage.

col_name types description
league character League key: wbb or wnba.
group_id character SDV group id, {league}:{slug} (e.g. wbb:big-east, wnba:east); one id per lineage across renames.
level character Group level: league (WNBA), subdivision (WBB Division I), conference, or division.
first_season integer First season with at least one member (WBB: ending year; WNBA: calendar year).
last_season integer Last season with at least one member (WBB: ending year; WNBA: calendar year).
notes character Lineage decisions and source caveats.

Author(s)

Saiem Gilani

See Also

Other Conference and Division Group loader functions: load_wbb_group_aliases(), load_wbb_group_seasons(), load_wbb_team_group_seasons()

Examples

try(load_wbb_groups())


  try(load_wnba_groups())

Load cleaned women's college basketball play-by-play from the data repo

Description

helper that loads multiple seasons from the data repo either into memory or writes it into a db using some forwarded arguments in the dots

helper that loads multiple seasons from the data repo either into memory or writes it into a db using some forwarded arguments in the dots

helper that loads multiple seasons from the data repo either into memory or writes it into a db using some forwarded arguments in the dots

helper that loads multiple seasons from the data repo either into memory or writes it into a db using some forwarded arguments in the dots

load_wbb_rosters_manifest() returns the per-season manifest CSV (columns: season, row_count, generated_at_utc, source_endpoint) describing which seasons are currently published to the release tag, without downloading any season's full data.

load_wbb_player_stats_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the player season stats release tag without downloading any season's full data.

load_wbb_team_stats_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the team season stats release tag without downloading any season's full data.

load_wbb_standings_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the standings release tag without downloading any season's full data.

load_wbb_shots_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the shots release tag without downloading any season's full data.

load_wbb_game_rosters_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the game rosters release tag without downloading any season's full data.

load_wbb_officials_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the officials release tag without downloading any season's full data.

Loads season-level team rosters scraped from ESPN. One row per athlete-team-season triple. Backed by the wehoop-wbb-data pipeline that reads raw JSONs from wehoop-wbb-raw and publishes parquet/rds artifacts to the espn_womens_college_basketball_rosters release tag.

Loads season-level player statistics scraped from ESPN. One row per athlete-team-season-statistic-grouping. Backed by the wehoop-wbb-data pipeline that reads raw JSONs from wehoop-wbb-raw and publishes parquet/rds artifacts to the espn_womens_college_basketball_player_season_stats release tag.

Loads season-level team statistics scraped from ESPN. One row per team-season-statistic-grouping. Backed by the wehoop-wbb-data pipeline that reads raw JSONs from wehoop-wbb-raw and publishes parquet/rds artifacts to the espn_womens_college_basketball_team_season_stats release tag.

Loads season-level conference and overall standings scraped from ESPN. One row per team-season. Backed by the wehoop-wbb-data pipeline that reads raw JSONs from wehoop-wbb-raw and publishes parquet/rds artifacts to the espn_womens_college_basketball_standings release tag.

Loads shot events parsed from ESPN women's college basketball play-by-play feeds. One row per shot attempt (made or missed), with court coordinates and shot metadata. Backed by the wehoop-wbb-data pipeline that reads raw JSONs from wehoop-wbb-raw and publishes parquet/rds artifacts to the espn_womens_college_basketball_shots release tag.

Loads per-game rosters scraped from ESPN women's college basketball box scores. One row per athlete-team-game triple, with athlete identifiers, jersey, position, starter flag, and DNP status. Backed by the wehoop-wbb-data pipeline that reads raw JSONs from wehoop-wbb-raw and publishes parquet/rds artifacts to the espn_womens_college_basketball_game_rosters release tag.

Loads game-level officials data scraped from ESPN women's college basketball summary feeds. One row per official-game pair. Backed by the wehoop-wbb-data pipeline that reads raw JSONs from wehoop-wbb-raw and publishes parquet/rds artifacts to the espn_womens_college_basketball_officials release tag.

Loads ESPN WBB athlete core records – identity and biographical fields, one row per athlete who appeared in the season. Backed by the wehoop-wbb-data pipeline that reads raw JSONs from wehoop-wbb-raw and publishes parquet/rds artifacts to the espn_womens_college_basketball_player_core release tag.

This is the only source of athlete bio in the pipeline: the player season stats payload carries no identity at all – not even the athlete id.

Two properties of the source are worth knowing before joining:

  • current_team_id is the athlete's CURRENT team, not their team in the requested season. Season team lives in load_wbb_player_box() / load_wbb_player_stats().

  • Bio (height / weight / jersey) is a current snapshot that ESPN overwrites in place; it is not era-correct for a historical season. The season dimension here is participation, not the bio's vintage.

Field coverage is era-dependent by nature – headshots exist only for modern players, while college and date of birth thin out the other way.

Usage

load_wbb_pbp(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wbb_team_box(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wbb_player_box(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wbb_schedule(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wbb_rosters_manifest()

load_wbb_player_stats_manifest()

load_wbb_team_stats_manifest()

load_wbb_standings_manifest()

load_wbb_shots_manifest()

load_wbb_game_rosters_manifest()

load_wbb_officials_manifest()

load_wbb_rosters(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wbb_player_stats(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wbb_team_stats(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wbb_standings(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wbb_shots(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wbb_game_rosters(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wbb_officials(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wbb_player_core(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given WBB seasons. (Min: 2004)

...

Additional arguments passed to an underlying function that writes the season data into a database.

dbConnection

A DBIConnection object, as returned by DBI::dbConnect()

tablename

The name of the player core table within the database

Value

A dataframe of play-by-play events with the columns documented below:

col_name description
shooting_play Logical value (TRUE/FALSE) indicating whether the play was a shooting play
sequence_number Sequence number is supposed to represent a shot-possession, examine the last two numbers to see if there are multiple events that occur within the same shot-possession. A shot-possession is basically any sequence of plays until there is a shot, change in possession, and probably things like technical fouls and the like. So as soon as a shot goes up, a new sequence starts regardless, even if the shooting team retains possession via offensive or deadball rebound. The first portion of the number is usually time related (i.e. the numeric representation of when the sequence started, from a seconds remaining in the period perspective or so)
period_display_value Long form of period (1st quarter, 2nd Quarter, OT, etc.)
period_number The numeric period of play in the game
home_score Home score after the play. Rebuilt from the scoring plays in feed order when that reaches the official final (score_source 'rebuilt'), otherwise ESPN's per-play value (score_source 'espn')
scoring_play Logical value (TRUE/FALSE) indicating whether the play was a play on which the offense scored
clock_display_value Time left within the period
team_id Unique team identification number for the offensive team
type_id Unique play type identifcation number
type_text Play type text description, passed through verbatim from ESPN. Note: ESPN labels the free-throw play TYPE "MadeFreeThrow" for made AND missed free throws; filter makes vs. misses with scoring_play (TRUE = made), not type_text
away_score Away score after the play. Rebuilt from the scoring plays in feed order when that reaches the official final (score_source 'rebuilt'), otherwise ESPN's per-play value (score_source 'espn')
id Unique play identifcation number
text Text description of the play
score_value The points value of the shot taken (1 / 2 / 3). Set to the attempt's value even on misses (a missed free throw still carries 1); use scoring_play to identify points actually scored
participants_0_athlete_id Unique player identification number
participants_1_athlete_id Unique player identification number
season Season of the game
season_type Season type of the game, 1 is pre-season, 2 is regular season, 3 is post-season, 4 is off-season
away_team_id Unique away team identification number
away_team_name Away team name
away_team_mascot Away team mascot
away_team_abbrev Text abbreviation for the away team
away_team_name_alt Alternate versions of the away team abbreviation
home_team_id Unique home team identification number
home_team_name home team name
home_team_mascot home team mascot
home_team_abbrev Text abbreviation for the home team
home_team_name_alt Alternate versions of the home team abbreviation
home_team_spread The game spread with respect to the home team
game_spread Game spread in (-X Team) format
home_favorite Logical (TRUE/FALSE) indicating whether the home team is favored
game_spread_available Logical (TRUE/FALSE) indicating whether the spread was available from ESPN. Basically, I would just not recommend using any of the spread information, I think I defaulted a lot of them to -2.5 for the home team. Most games probably do not have spread information. This column should really be listed first
game_id Unique identifier for the game event
qtr Quarter of the game
time Time left within the period
clock_minutes Clock minutes split from seconds for developer convenience
clock_seconds Clock seconds split from minutes for developer convenience
half Half of the game
game_half Half of the game
lag_qtr A lag column on the quarter
lead_qtr A lead column on the quarter
lag_game_half A lag column on the half
lead_game_half A lead column on the half
start_quarter_seconds_remaining Quarter seconds remaining at the start of the play (these are more or less code artifacts from other sports, but may eventually be used more seriously)
start_half_seconds_remaining Game half seconds remaining at the start of the play (these are more or less code artifacts from other sports, but may eventually be used more seriously)
start_game_seconds_remaining Game seconds remaining at the start of the play (''')
game_play_number Game play number
end_quarter_seconds_remaining Quarter seconds remaining at the end of the play (''')
end_half_seconds_remaining Game half seconds remaining at the end of the play (''')
end_game_seconds_remaining Game seconds remaining at the end of the play (''')
period Period of the game
coordinate_x The entire scale is a rectangle of size 25x47, intended as a half-court representation of the basketball court (i.e. on the side of the offense), with each coordinate unit representing a foot. It appears that the basket is roughly represented as the (25, 0) point. This is a nonsensical definition when considering that the basket overhangs the court, with the backboard aligned 48 inches from the baseline, then the center of the hoop being roughly 11 inches from there. This is an idiosyncracy of either sensor placement or software and data entry. Use your best judgement in making your charts, I think you will find that making some translations will be helpful.
coordinate_y
week Apparently there are weeks
media_id Where did you come from
pregame_home_prob Pre-game win probability for the home team, constant across every play of the game
home_win_prob Home team's win probability at this play, updated play-by-play
score_source Where this game's home_score/away_score come from: 'rebuilt' (summed from the scoring plays and equal to the official final on the last play) or 'espn' (ESPN's per-play values, kept when the rebuild misses the final or the game has no final). Absent from seasons published before the repair

Returns a tibble

Returns a tibble

Returns a tibble

Returns a wehoop_data tibble with one row per athlete-team-season.

Returns a wehoop_data tibble of player season stats.

Returns a wehoop_data tibble of team season stats.

Columns as documented in the shared basketball_load_wbb_team_stats_schema table.

Returns a wehoop_data tibble of team standings.

Columns as documented in the shared basketball_load_wbb_standings_schema table.

Returns a wehoop_data tibble with one row per shot attempt.

Columns as documented in the shared basketball_load_wbb_shots_schema table.

Returns a wehoop_data tibble with one row per athlete-team-game.

Columns as documented in the shared basketball_load_wbb_game_rosters_schema table.

Returns a wehoop_data tibble with one row per official-game pair.

Columns as documented in the shared basketball_load_wbb_officials_schema table.

Returns a wehoop_data tibble of athlete core records.

Examples

try(load_wbb_pbp())


  try(load_wbb_team_box())


  try(load_wbb_player_box())


  try(load_wbb_schedule())


  try(load_wbb_rosters(seasons = most_recent_wbb_season()))


  try(load_wbb_player_stats(seasons = most_recent_wbb_season()))


  try(load_wbb_team_stats(seasons = most_recent_wbb_season()))


  try(load_wbb_standings(seasons = most_recent_wbb_season()))


  try(load_wbb_shots(seasons = most_recent_wbb_season()))


  try(load_wbb_game_rosters(seasons = most_recent_wbb_season()))


  try(load_wbb_officials(seasons = most_recent_wbb_season()))


  try(load_wbb_player_core(seasons = most_recent_wbb_season()))

Load team conference membership by season (WBB / WNBA) from the data repo

Description

Loads one row per team per season with the team's subdivision, conference, and division that season, taken from the most reliable per-season source and cross-checked against a second source where one exists. Membership is never back-filled from today's alignment. load_wbb_team_group_seasons() reads the wbb_groups release tag and load_wnba_team_group_seasons() the wnba_groups tag.

Usage

load_wbb_team_group_seasons(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_team_group_seasons(
  seasons = most_recent_wnba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit seasons: season-ending years for WBB (2025 = 2024-25), calendar years for the WNBA. Published coverage runs from 2002 (WBB) or 1997 (WNBA) through the most recent season. Pass seasons = TRUE to read every published season from one file. (Min: 2002 for WBB, 1997 for WNBA)

...

Additional arguments passed to an underlying function that writes the data into a database.

dbConnection

A DBIConnection object, as returned by DBI::dbConnect()

tablename

The name of the data table within the database

Value

Returns a wehoop_data tibble with one row per team-season.

col_name types description
league character League key: wbb or wnba.
season integer Season (WBB: ending year, 2025 = 2024-25; WNBA: calendar year).
team_id character ESPN team id.
team_id_source character Id system of team_id: espn.
team_name character Team name as of that season.
subdivision_id character SDV group id of the subdivision (wbb:d1); NA for the WNBA.
conference_id character SDV group id of the conference.
division_id character SDV group id of the division; NA where the league or conference had none.
source character Source the membership came from: espn_standings, espn_core_groups, ncaa or curated (WBB); wnba_stats or curated (WNBA).
sources_agree logical Whether a second source agrees; NA when only one source covers the season.
notes character Membership caveats.

Author(s)

Saiem Gilani

See Also

Other Conference and Division Group loader functions: load_wbb_group_aliases(), load_wbb_group_seasons(), load_wbb_groups()

Examples

try(load_wbb_team_group_seasons(seasons = most_recent_wbb_season()))


  try(load_wnba_team_group_seasons(seasons = most_recent_wnba_season()))

Load cleaned WNBA play-by-play from the data repo

Description

helper that loads multiple seasons from the data repo either into memory or writes it into a db using some forwarded arguments in the dots

helper that loads multiple seasons from the data repo either into memory or writes it into a db using some forwarded arguments in the dots

helper that loads multiple seasons from the data repo either into memory or writes it into a db using some forwarded arguments in the dots

helper that loads multiple seasons from the data repo either into memory or writes it into a db using some forwarded arguments in the dots

load_wnba_rosters_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the rosters release tag without downloading any season's full data.

load_wnba_player_stats_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the player season stats release tag without downloading any season's full data.

load_wnba_team_stats_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the team season stats release tag without downloading any season's full data.

load_wnba_standings_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the standings release tag without downloading any season's full data.

load_wnba_draft_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the draft release tag without downloading any season's full data.

load_wnba_shots_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the shots release tag without downloading any season's full data.

load_wnba_game_rosters_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the game rosters release tag without downloading any season's full data.

load_wnba_officials_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the officials release tag without downloading any season's full data.

Loads season-level WNBA team rosters scraped from ESPN. One row per athlete-team-season triple. Backed by the wehoop-wnba-data pipeline that reads raw JSONs from wehoop-wnba-raw and publishes parquet/rds artifacts to the espn_wnba_rosters release tag.

Loads season-level WNBA player statistics scraped from ESPN. One row per athlete-team-season-statistic-grouping. Backed by the wehoop-wnba-data pipeline that reads raw JSONs from wehoop-wnba-raw and publishes parquet/rds artifacts to the espn_wnba_player_season_stats release tag.

Loads season-level WNBA team statistics scraped from ESPN. One row per team-season-statistic-grouping. Backed by the wehoop-wnba-data pipeline that reads raw JSONs from wehoop-wnba-raw and publishes parquet/rds artifacts to the espn_wnba_team_season_stats release tag.

Loads season-level WNBA standings scraped from ESPN. One row per team-season. Backed by the wehoop-wnba-data pipeline that reads raw JSONs from wehoop-wnba-raw and publishes parquet/rds artifacts to the espn_wnba_standings release tag.

Loads season-level WNBA draft picks scraped from ESPN. One row per pick. Backed by the wehoop-wnba-data pipeline that reads raw JSONs from wehoop-wnba-raw and publishes parquet/rds artifacts to the espn_wnba_draft release tag.

Loads shot events parsed from ESPN WNBA play-by-play feeds. One row per shot attempt (made or missed), with court coordinates and shot metadata. Backed by the wehoop-wnba-data pipeline that reads raw JSONs from wehoop-wnba-raw and publishes parquet/rds artifacts to the espn_wnba_shots release tag.

Loads per-game rosters scraped from ESPN WNBA box scores. One row per athlete-team-game triple, with athlete identifiers, jersey, position, starter flag, and DNP status. Backed by the wehoop-wnba-data pipeline that reads raw JSONs from wehoop-wnba-raw and publishes parquet/rds artifacts to the espn_wnba_game_rosters release tag.

Loads game-level officials data scraped from ESPN WNBA summary feeds. One row per official-game pair. Backed by the wehoop-wnba-data pipeline that reads raw JSONs from wehoop-wnba-raw and publishes parquet/rds artifacts to the espn_wnba_officials release tag.

Loads ESPN WNBA athlete core records – identity and biographical fields, one row per athlete who appeared in the season. Backed by the wehoop-wnba-data pipeline that reads raw JSONs from wehoop-wnba-raw and publishes parquet/rds artifacts to the espn_wnba_player_core release tag.

This is the only source of athlete bio in the pipeline: the player season stats payload carries no identity at all – not even the athlete id.

Two properties of the source are worth knowing before joining:

  • current_team_id is the athlete's CURRENT team, not their team in the requested season. Season team lives in load_wnba_player_box() / load_wnba_player_stats().

  • Bio (height / weight / jersey) is a current snapshot that ESPN overwrites in place; it is not era-correct for a historical season. The season dimension here is participation, not the bio's vintage.

Field coverage is era-dependent by nature – headshots exist only for modern players, while college and date of birth thin out the other way.

Usage

load_wnba_pbp(
  seasons = most_recent_wnba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_team_box(
  seasons = most_recent_wnba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_player_box(
  seasons = most_recent_wnba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_schedule(
  seasons = most_recent_wnba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_rosters_manifest()

load_wnba_player_stats_manifest()

load_wnba_team_stats_manifest()

load_wnba_standings_manifest()

load_wnba_draft_manifest()

load_wnba_shots_manifest()

load_wnba_game_rosters_manifest()

load_wnba_officials_manifest()

load_wnba_rosters(
  seasons = most_recent_wnba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_player_stats(
  seasons = most_recent_wnba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_team_stats(
  seasons = most_recent_wnba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_standings(
  seasons = most_recent_wnba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_draft(
  seasons = most_recent_wnba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_shots(
  seasons = most_recent_wnba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_game_rosters(
  seasons = most_recent_wnba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_officials(
  seasons = most_recent_wnba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_player_core(
  seasons = most_recent_wnba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given WNBA seasons. (Min: 2003)

...

Additional arguments passed to an underlying function that writes the season data into a database.

dbConnection

A DBIConnection object, as returned by DBI::dbConnect()

tablename

The name of the player core table within the database

Value

A dataframe with the columns documented below:

col_name description
shooting_play Logical value (TRUE/FALSE) indicating whether the play was a shooting play
sequence_number Sequence number is supposed to represent a shot-possession, examine the last two numbers to see if there are multiple events that occur within the same shot-possession. A shot-possession is basically any sequence of plays until there is a shot, change in possession, and probably things like technical fouls and the like. So as soon as a shot goes up, a new sequence starts regardless, even if the shooting team retains possession via offensive or deadball rebound. The first portion of the number is usually time related (i.e. the numeric representation of when the sequence started, from a seconds remaining in the period perspective or so)
period_display_value Long form of period (1st quarter, 2nd Quarter, OT, etc.)
period_number The numeric period of play in the game
home_score Home score after the play. Rebuilt from the scoring plays in feed order when that reaches the official final (score_source 'rebuilt'), otherwise ESPN's per-play value (score_source 'espn')
coordinate_x The entire scale is a rectangle of size 25x47, intended as a half-court representation of the basketball court (i.e. on the side of the offense), with each coordinate unit representing a foot. It appears that the basket is roughly represented as the (25, 0) point. This is a nonsensical definition when considering that the basket overhangs the court, with the backboard aligned 48 inches from the baseline, then the center of the hoop being roughly 11 inches from there. This is an idiosyncracy of either sensor placement or software and data entry. Use your best judgement in making your charts, I think you will find that making some translations will be helpful.
coordinate_y
scoring_play Logical value (TRUE/FALSE) indicating whether the play was a play on which the offense scored
clock_display_value Time left within the period
team_id Unique team identification number for the offensive team
type_id Unique play type identifcation number
type_text Play type text description, passed through verbatim from ESPN. Note: ESPN labels the free-throw play TYPE "MadeFreeThrow" for made AND missed free throws; filter makes vs. misses with scoring_play (TRUE = made), not type_text
away_score Away score after the play. Rebuilt from the scoring plays in feed order when that reaches the official final (score_source 'rebuilt'), otherwise ESPN's per-play value (score_source 'espn')
id Unique play identifcation number
text Text description of the play
score_value The points value of the shot taken (1 / 2 / 3). Set to the attempt's value even on misses (a missed free throw still carries 1); use scoring_play to identify points actually scored
participants_0_athlete_id Unique player identification number
participants_1_athlete_id Unique player identification number
participants_2_athlete_id Unique player identification number
type_abbreviation Play type abbreviation
season Season of the game
season_type Season type of the game, 1 is pre-season, 2 is regular season, 3 is post-season, 4 is off-season
away_team_id Unique away team identification number
away_team_name Away team name
away_team_mascot Away team mascot
away_team_abbrev Text abbreviation for the away team
away_team_name_alt Alternate versions of the away team abbreviation
home_team_id Unique home team identification number
home_team_name home team name
home_team_mascot home team mascot
home_team_abbrev Text abbreviation for the home team
home_team_name_alt Alternate versions of the home team abbreviation
home_team_spread The game spread with respect to the home team
game_spread Game spread in (-X Team) format. There are almost none, I would recommend not trusting any of these three columns
home_favorite Logical (TRUE/FALSE) indicating whether the home team is favored
clock_minutes Clock minutes split from seconds for developer convenience
clock_seconds Clock seconds split from minutes for developer convenience
half Half of the game
lag_half A lag column on the half
lead_half A lead column on the half
game_play_number Game play number
game_id Unique identifier for the game event
score_source Where this game's home_score/away_score come from: 'rebuilt' (summed from the scoring plays and equal to the official final on the last play) or 'espn' (ESPN's per-play values, kept when the rebuild misses the final or the game has no final). Absent from seasons published before the repair

Returns a tibble

Returns a tibble

Returns a tibble

Returns a wehoop_data tibble with one row per athlete-team-season.

Returns a wehoop_data tibble of player season stats.

Returns a wehoop_data tibble of team season stats.

Columns as documented in the shared basketball_load_wbb_team_stats_schema table.

Returns a wehoop_data tibble of team standings.

Columns as documented in the shared basketball_load_wbb_standings_schema table.

Returns a wehoop_data tibble of WNBA draft picks.

col_name types description
season integer Season identifier (4-digit year or 'YYYY-YY' string).
round integer Tournament / playoff round.
pick integer Pick.
overall integer Overall.
team_id character Unique team identifier.
team_display_name character Full team display name.
athlete_id character Unique athlete identifier (ESPN).
athlete_display_name character Athlete display name (full).
athlete_position character Athlete position.
college_id character Unique identifier for college.
college_name character College name.

Returns a wehoop_data tibble with one row per shot attempt.

Columns as documented in the shared basketball_load_wbb_shots_schema table.

Returns a wehoop_data tibble with one row per athlete-team-game.

Columns as documented in the shared basketball_load_wbb_game_rosters_schema table.

Returns a wehoop_data tibble with one row per official-game pair.

Columns as documented in the shared basketball_load_wbb_officials_schema table.

Returns a wehoop_data tibble of athlete core records.

Examples

try(load_wnba_pbp())


  try(load_wnba_team_box())


  try(load_wnba_player_box())


  try(load_wnba_schedule())


  try(load_wnba_rosters(seasons = most_recent_wnba_season()))


  try(load_wnba_player_stats(seasons = most_recent_wnba_season()))


  try(load_wnba_team_stats(seasons = most_recent_wnba_season()))


  try(load_wnba_standings(seasons = most_recent_wnba_season()))


  try(load_wnba_draft(seasons = most_recent_wnba_season()))


  try(load_wnba_shots(seasons = most_recent_wnba_season()))


  try(load_wnba_game_rosters(seasons = most_recent_wnba_season()))


  try(load_wnba_officials(seasons = most_recent_wnba_season()))


  try(load_wnba_player_core(seasons = most_recent_wnba_season()))

Load WNBA player-impact ratings (RAPM / SPM / BPM / DARKO) from the data repo

Description

Loads season-level WNBA player-impact ratings – one row per player-team-season, combining regularized adjusted plus-minus (RAPM), statistical plus-minus (SPM), box plus-minus (BPM), wins above replacement (WAR), and a DARKO-style skill/projection pair. Produced by the sdv-py NBA/WNBA possession-engine model program; published to the wnba_player_impact release tag as csv/parquet/rds.

Loads season-level NCAA women's college basketball player-value ratings – one row per player-team-season, with a box-score-derived offensive/defensive/net box plus-minus (BPM). Coverage starts at 2014 (the earliest season with published box-score inputs of sufficient quality for the model); this tag is parquet-only, with no csv/rds sibling assets. Produced by the sdv-py NCAA WBB model program; published to the wbb_player_value release tag.

Loads season-level NCAA women's college basketball team ratings – one row per team-season, with adjusted (opponent-strength-normalized) offensive/defensive efficiency, adjusted tempo, raw efficiency, and a national rank. A KenPom-style adjusted-efficiency-margin rating. This tag is parquet-only, with no csv/rds sibling assets. Produced by the sdv-py NCAA WBB model program; published to the wbb_ratings release tag.

Usage

load_wnba_player_impact(
  seasons = most_recent_wnba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wbb_player_value(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wbb_ratings(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit season-ending years for NCAA women's college basketball. Published coverage runs 2008 through the most recent season, with no gaps. Pass seasons = TRUE for every published season. (Min: 2008)

...

Additional arguments passed to an underlying function that writes the season data into a database.

dbConnection

A DBIConnection object, as returned by DBI::dbConnect()

tablename

The name of the data table within the database

Value

Returns a wehoop_data tibble with one row per player-team-season.

col_name types description
player_id integer Unique WNBA Stats player identifier.
player_name character Player display name.
team_id integer Unique team identifier.
team_abbreviation character Team abbreviation.
team_name character Full team display name.
teams character Team abbreviation(s) the player appeared for this season.
season integer Season identifier (4-digit year).
season_type character Season portion (e.g. 'Regular Season').
o_rapm numeric Offensive regularized adjusted plus-minus.
d_rapm numeric Defensive regularized adjusted plus-minus.
rapm numeric Net regularized adjusted plus-minus (o_rapm + d_rapm).
off_poss integer Offensive possessions used in the RAPM fit.
def_poss integer Defensive possessions used in the RAPM fit.
o_adj_rapm numeric Offensive RAPM adjusted for minutes/possession stability.
d_adj_rapm numeric Defensive RAPM adjusted for minutes/possession stability.
adj_rapm numeric Net adjusted RAPM (o_adj_rapm + d_adj_rapm).
ospm numeric Offensive statistical plus-minus (box-score component).
dspm numeric Defensive statistical plus-minus (box-score component).
spm numeric Net statistical plus-minus.
min numeric Minutes played.
gp integer Games played.
obpm numeric Offensive box plus-minus.
dbpm numeric Defensive box plus-minus.
bpm numeric Net box plus-minus.
war numeric Wins above replacement.
darko_filtered_skill numeric DARKO-style filtered skill rating.
darko_projected_rating numeric DARKO-style forward-looking projected rating.
darko_projected_sd numeric Standard deviation of the DARKO-style projected rating.

Returns a wehoop_data tibble with one row per player-team-season.

col_name types description
player_id character stats.ncaa.org player identifier.
player character Player display name (title-cased).
season integer Season identifier (4-digit season-ending year).
team_id character Unique team identifier.
min numeric Minutes played.
box_obpm numeric Box-score offensive box plus-minus.
box_dbpm numeric Box-score defensive box plus-minus.
box_bpm numeric Box-score net box plus-minus (box_obpm + box_dbpm).

Returns a wehoop_data tibble with one row per team-season.

col_name types description
season integer Season identifier (4-digit season-ending year).
team_id character Unique team identifier.
adj_o numeric Adjusted offensive efficiency (points per 100 possessions, opponent-adjusted).
adj_d numeric Adjusted defensive efficiency (points allowed per 100 possessions, opponent-adjusted).
adj_em numeric Adjusted efficiency margin (adj_o minus adj_d).
adj_tempo numeric Adjusted possessions per 40 minutes.
raw_o numeric Unadjusted (raw) offensive efficiency.
raw_d numeric Unadjusted (raw) defensive efficiency.
games integer Games played (season total).
rank integer National rank by adj_em.
adj_em_z numeric Z-score of adj_em relative to the season's team distribution.

Author(s)

Saiem Gilani

Examples

try(load_wnba_player_impact(seasons = most_recent_wnba_stats_season()))


  try(load_wbb_player_value(seasons = most_recent_wbb_season()))


  try(load_wbb_ratings(seasons = most_recent_wbb_season()))

Load wehoop WNBA Stats League Dashboard cube

Description

Loads one asset of the wnba_stats_leaguedash release tag – the Python-scraped ⁠leaguedash*⁠ parameter cube that supersedes the old R-scraped player / team / lineups / standings tags. The cube publishes 24 tables per season and is the full surface behind the compatibility reshapes in load_wnba_stats_player_stats(), load_wnba_stats_team_stats(), load_wnba_stats_lineups() and load_wnba_stats_standings(); several tables (player_bio, ⁠*_master⁠, team_stats_fourfactors, the non-5-man and non-Base/Advanced ⁠lineups_*⁠ measures) are reachable only through this function.

Usage

load_wnba_stats_leaguedash(
  seasons = most_recent_wnba_stats_season(),
  table = NULL,
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given WNBA seasons. Published coverage runs 1997 through the most recent season, with no gaps. Pass seasons = TRUE for every published season. (Min: 1997)

table

Name of the cube table to load. One of player_bio, player_master, player_stats_base, player_stats_advanced, player_stats_misc, player_stats_scoring, player_stats_usage, player_stats_defense, team_master, team_stats_base, team_stats_advanced, team_stats_misc, team_stats_scoring, team_stats_defense, team_stats_opponent, team_stats_fourfactors, lineups_master, lineups_base, lineups_advanced, lineups_misc, lineups_scoring, lineups_opponent, lineups_fourfactors, standings.

...

Additional arguments passed to an underlying function that writes the season data into a database.

dbConnection

A DBIConnection object, as returned by DBI::dbConnect()

tablename

The name of the data table within the database

Value

Returns a wehoop_data tibble of the requested cube table, one row per player-season, team-season or lineup-season depending on table. Column sets differ per table; the ⁠*_master⁠ tables are wide joins of every measure type for that entity.

See Also

Other WNBA Stats loader functions: load_wnba_stats_rosters()

Examples

try(load_wnba_stats_leaguedash(seasons = most_recent_wnba_stats_season(),
                                 table = "player_bio"))

Load cleaned WNBA Stats API season rosters from the data repo

Description

Loads season-level WNBA team rosters scraped from the WNBA Stats API. One row per athlete-team-season triple. Backed by the wehoop-wnba-stats-data pipeline that reads raw JSONs from wehoop-wnba-stats-raw and publishes parquet/rds artifacts to the wnba_stats_rosters release tag.

Loads season-level WNBA coaching staff data scraped from the WNBA Stats API. One row per coach-team-season triple. Backed by the wehoop-wnba-stats-data pipeline that reads raw JSONs from wehoop-wnba-stats-raw and publishes parquet/rds artifacts to the wnba_stats_coaches release tag.

[Deprecated] Loads season-level WNBA player statistics. Deprecated: the wnba_stats_player_season_stats release tag (R-scraped, Base/Advanced/Misc/Scoring/Usage/ Defense measures) is superseded by the wnba_stats_leaguedash tag (Python-scraped parameter cube, same 6 measure types plus player_bio and a wide player_master mega). This function reshapes the cube back into the old stacked-by-measure_type contract for compatibility; call the cube's ⁠player_stats_*⁠ / player_master assets directly with load_wnba_stats_leaguedash() for the full surface.

[Deprecated] Loads season-level WNBA 5-man lineup statistics (leaguedashlineups-style outputs). Deprecated: the wnba_stats_lineups release tag (R-scraped, Base/Advanced measures, 5-man only) is superseded by the wnba_stats_leaguedash tag (Python-scraped parameter cube: 6 measure types x 2/3/4/5-man). This function reshapes the cube back into the old 5-man Base+Advanced contract for compatibility; call the cube's ⁠lineups_*⁠ / lineups_master assets directly with load_wnba_stats_leaguedash() for the full surface.

[Deprecated] Loads season-level team statistics (leaguedashteamstats-style outputs). Deprecated: the wnba_stats_team_season_stats release tag (R-scraped, Base/ Advanced/Misc/Scoring/Defense/Opponent measures) is superseded by the wnba_stats_leaguedash tag (Python-scraped parameter cube, same 6 measures plus ⁠Four Factors⁠ and a wide team_master mega). This function reshapes the cube back into the old stacked-by-measure_type contract for compatibility; call the cube's ⁠team_stats_*⁠ / team_master assets directly with load_wnba_stats_leaguedash() for the full surface.

[Deprecated] Loads season-level WNBA standings (leaguestandingsv3-style outputs). One row per team-season. Deprecated: the wnba_stats_standings release tag (R-scraped) is superseded by the wnba_stats_leaguedash tag's standings asset (same underlying endpoint/params, Python-scraped) — this is close to a pure passthrough.

Loads season-level WNBA draft picks scraped from the WNBA Stats API (drafthistory-style outputs). One row per pick. Backed by the wehoop-wnba-stats-data pipeline that reads raw JSONs from wehoop-wnba-stats-raw and publishes parquet/rds artifacts to the wnba_stats_draft release tag.

Loads shot events scraped from the WNBA Stats API. One row per shot attempt with legacy court coordinates, action/sub type, distance, and made/missed result, carried through from the V3 play-by-play feed (not shotchartdetail). Backed by the wehoop-wnba-stats-data pipeline that reads raw JSONs from wehoop-wnba-stats-raw and publishes parquet/rds artifacts to the wnba_stats_shots release tag.

Loads the per-game inactive player list scraped from the WNBA Stats API – the InactivePlayers result set of boxscoresummaryv2. One row per inactive athlete-game pair, not a full per-game roster: use load_wnba_stats_player_game_logs() for the athletes who did play. Backed by the wehoop-wnba-stats-data pipeline that reads raw JSONs from wehoop-wnba-stats-raw and publishes parquet/rds artifacts to the wnba_stats_game_rosters release tag.

Coverage is thin by construction because the upstream result set is thin: stats.wnba.com reports inactives for only a fraction of games, and most heavily for 2006-2008 and 2021 onward. Season row counts range from 1 (1997) to 610 across 184 games (2026); 2009-2012 carry fewer than 10 rows each. A season with almost no rows is upstream sparsity, not a download failure.

Loads game-level officials data scraped from the WNBA Stats API (boxscoresummaryv2-style outputs). One row per official-game pair. Backed by the wehoop-wnba-stats-data pipeline that reads raw JSONs from wehoop-wnba-stats-raw and publishes parquet/rds artifacts to the wnba_stats_officials release tag.

Loads per-player per-game logs scraped from stats.wnba.com/leaguegamelog?PlayerOrTeam=P (one row per athlete-game pair: minutes, shooting splits, rebounds, steals, blocks, turnovers, personal fouls, plus/minus). Backed by the wehoop-wnba-stats-data pipeline that publishes parquet/rds artifacts to the wnba_stats_player_game_logs release tag.

Loads season-level WNBA schedules scraped from stats.wnba.com/leaguegamefinder (regular season + playoffs combined, pre-rejoined home/away). Backed by the wehoop-wnba-stats-data pipeline that publishes parquet/rds artifacts to the wnba_stats_schedules release tag.

Loads season-level WNBA play-by-play (V3), supplied by wnba_pbp() in the upstream compile script. Backed by the wehoop-wnba-stats-data pipeline that publishes parquet/rds artifacts to the wnba_stats_pbp release tag.

load_wnba_stats_rosters_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the WNBA Stats rosters release tag without downloading any season's full data.

load_wnba_stats_coaches_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the WNBA Stats coaches release tag without downloading any season's full data.

load_wnba_stats_player_stats_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the WNBA Stats player season stats release tag without downloading any season's full data.

load_wnba_stats_lineups_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the WNBA Stats lineups release tag without downloading any season's full data.

load_wnba_stats_team_stats_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the WNBA Stats team season stats release tag without downloading any season's full data.

load_wnba_stats_standings_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the WNBA Stats standings release tag without downloading any season's full data.

load_wnba_stats_draft_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the WNBA Stats draft release tag without downloading any season's full data.

load_wnba_stats_shots_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the WNBA Stats shots release tag without downloading any season's full data.

load_wnba_stats_game_rosters_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the WNBA Stats game rosters release tag without downloading any season's full data.

load_wnba_stats_officials_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the WNBA Stats officials release tag without downloading any season's full data.

load_wnba_stats_player_game_logs_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the WNBA Stats player game logs release tag without downloading any season's full data.

load_wnba_stats_schedule_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the WNBA Stats schedules release tag without downloading any season's full data.

load_wnba_stats_pbp_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the WNBA Stats play-by-play release tag without downloading any season's full data.

Loads possession-level data derived from the WNBA Stats API play-by-play – one row per possession, with the on-court 5-man lineups for both teams, shooting/rebounding/turnover splits, and the possession start type. Backed by the wehoop-wnba-stats-data pipeline that reads raw JSONs from wehoop-wnba-stats-raw and publishes csv.gz/parquet/rds artifacts to the wnba_stats_possessions release tag.

Usage

load_wnba_stats_rosters(
  seasons = most_recent_wnba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_stats_coaches(
  seasons = most_recent_wnba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_stats_player_stats(
  seasons = most_recent_wnba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_stats_lineups(
  seasons = most_recent_wnba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_stats_team_stats(
  seasons = most_recent_wnba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_stats_standings(
  seasons = most_recent_wnba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_stats_draft(
  seasons = most_recent_wnba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_stats_shots(
  seasons = most_recent_wnba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_stats_game_rosters(
  seasons = most_recent_wnba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_stats_officials(
  seasons = most_recent_wnba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_stats_player_game_logs(
  seasons = most_recent_wnba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_stats_schedule(
  seasons = most_recent_wnba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_stats_pbp(
  seasons = most_recent_wnba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_wnba_stats_rosters_manifest()

load_wnba_stats_coaches_manifest()

load_wnba_stats_player_stats_manifest()

load_wnba_stats_lineups_manifest()

load_wnba_stats_team_stats_manifest()

load_wnba_stats_standings_manifest()

load_wnba_stats_draft_manifest()

load_wnba_stats_shots_manifest()

load_wnba_stats_game_rosters_manifest()

load_wnba_stats_officials_manifest()

load_wnba_stats_player_game_logs_manifest()

load_wnba_stats_schedule_manifest()

load_wnba_stats_pbp_manifest()

load_wnba_stats_possessions(
  seasons = most_recent_wnba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given WNBA seasons. Published coverage runs 1997 through the most recent season, with no gaps. Pass seasons = TRUE for every published season. (Min: 1997)

...

Additional arguments passed to an underlying function that writes the season data into a database.

dbConnection

A DBIConnection object, as returned by DBI::dbConnect()

tablename

The name of the data table within the database

Value

Returns a wehoop_data tibble with one row per athlete-team-season.

Returns a wehoop_data tibble with one row per coach-team-season.

Returns a wehoop_data tibble of player season stats.

Returns a wehoop_data tibble of lineup stats.

Returns a wehoop_data tibble of team season stats.

col_name types description
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type character Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
team_id character Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation character Short team abbreviation (e.g. 'LAS').
gp integer Games played.
w integer Wins.
l integer Losses.
w_pct numeric Wins percentage (0-1 decimal).
min numeric Minutes played.
fgm numeric Field goals made.
fga numeric Field goal attempts.
fg_pct numeric Field goal percentage (0-1).
fg3m numeric Three-point field goals made.
fg3a numeric Three-point field goal attempts.
fg3_pct numeric Three-point field goal percentage (0-1).
ftm numeric Free throws made.
fta numeric Free throw attempts.
ft_pct numeric Free throw percentage (0-1).
oreb numeric Offensive rebounds.
dreb numeric Defensive rebounds.
reb numeric Total rebounds.
ast numeric Assists.
tov numeric Turnovers.
stl numeric Steals.
blk numeric Blocks.
pf numeric Personal fouls.
pts numeric Points scored.
plus_minus numeric Plus/minus point differential while on court.

Returns a wehoop_data tibble of team standings.

col_name types description
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_id character Unique season identifier.
team_id character Unique team identifier.
team_city character Team city or region (e.g. 'Las Vegas').
team_name character Full team display name (e.g. 'Las Vegas Aces').
conference character Filter players or teams by conference.
conference_record character Conference win-loss record.
playoff_rank integer League/season rank for playoff.
wins integer Total wins.
losses integer Total losses.
win_pct numeric Win percentage (0-1 decimal).
home_record character Home win-loss record.
road_record character Win-loss record for road.
l10 character L10.
strcurrentstreak character Strcurrentstreak.
points_pg numeric Points pg.
opp_points_pg numeric Opponent points pg.
diff_points_pg numeric Diff points pg.

Returns a wehoop_data tibble of WNBA draft picks.

col_name types description
person_id integer Unique player identifier (V3 endpoints).
player_name character Player name.
season integer Season identifier (4-digit year).
round_number integer Numeric round.
round_pick integer Round pick.
overall_pick integer Overall pick.
draft_type character Draft type ('Draft', 'Allocation' or 'Elite').
team_id integer Unique team identifier.
team_city character Team city or region (e.g. 'Las Vegas').
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation character Short team abbreviation (e.g. 'LAS').
organization character Organization.
organization_type character Organization type.
player_profile_flag integer Player profile flag.

Returns a wehoop_data tibble with one row per shot attempt.

col_name types description
game_id character Unique game identifier.
season integer Season identifier (4-digit year).
period integer Period of the game (1-4 quarters; 5+ for OT).
clock character Game clock remaining in the period (ISO 8601 duration).
team_id integer Unique team identifier for the shooting team.
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
person_id integer Unique player identifier for the shooter.
player_name character Shooter's name.
action_type character Action type label ('Made Shot' or 'Missed Shot').
sub_type character Shot sub type (e.g. 'Jump Shot', 'Layup', 'DUNK').
shot_result character Shot result, 'Made' or 'Missed'.
shot_value integer Points the shot was worth (2 or 3).
shot_distance integer Shot distance from the basket, in feet.
x_legacy integer Legacy X coordinate on the court (0 = basket center).
y_legacy integer Legacy Y coordinate on the court (baseline at 0).
description character Text description of the play.
score_home character Home team score after the play.
score_away character Away team score after the play.

Returns a wehoop_data tibble with one row per inactive athlete-game pair.

col_name types description
player_id integer Unique player identifier.
first_name character Player's first name.
last_name character Player's last name.
jersey_num character Jersey number worn by the player.
team_id integer Unique team identifier.
team_city character Team city or region (e.g. 'Las Vegas').
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation character Short team abbreviation (e.g. 'LAS').
season integer Season identifier (4-digit year).
game_id character Unique game identifier.

Returns a wehoop_data tibble with one row per official-game pair.

col_name types description
official_id integer Unique official / referee identifier.
first_name character Official's first name.
last_name character Official's last name.
jersey_num character Jersey number worn by the official.
season integer Season identifier (4-digit year).
game_id character Unique game identifier.

Returns a wehoop_data tibble of per-athlete per-game log rows.

Returns a wehoop_data tibble of per-season schedules, one row per game with the home/away sides pre-joined into ⁠home_*⁠ / ⁠away_*⁠ columns.

col_name types description
game_id character Unique game identifier.
season integer Season identifier (4-digit year).
season_type character Portion of the season: regular-season or playoffs.
game_date character Date the game was played, as an ISO YYYY-MM-DD string.
matchup character Matchup string, home side first (e.g. ⁠WAS vs. NYL⁠).
home_team_id integer Unique WNBA Stats team identifier for the home team.
home_team_abbreviation character Home team abbreviation.
home_team_name character Home team full name.
home_pts integer Points scored by the home team.
home_wl character Home team result, W or L.
away_team_id integer Unique WNBA Stats team identifier for the away team.
away_team_abbreviation character Away team abbreviation.
away_team_name character Away team full name.
away_pts integer Points scored by the away team.
away_wl character Away team result, W or L.

Returns a wehoop_data tibble of per-event play-by-play rows.

Returns a wehoop_data tibble with one row per possession.

col_name types description
game_id character Unique game identifier.
period integer Period of the game: 1-2 for the two halves of 1997-2005 (overtime from period 3), 1-4 for the four quarters from 2006 (overtime from period 5).
possession_number integer Sequential possession number within the game.
offense_team_id integer Team identifier for the team on offense.
defense_team_id integer Team identifier for the team on defense.
start_order_index integer Play-by-play order index at the start of the possession.
end_order_index integer Play-by-play order index at the end of the possession.
start_seconds_remaining numeric Seconds remaining in the period at possession start.
end_seconds_remaining numeric Seconds remaining in the period at possession end.
points integer Points scored on the possession.
is_second_chance logical Whether the possession followed an offensive rebound.
number_in_period integer Sequential possession number within the period.
possession_start_type character How the possession started (e.g. 'OffDeadball', 'OffRebound').
count_as_possession logical Whether the event counts as a scoreable possession.
fg2a integer 2-point field goal attempts by the lineup.
fg2m integer 2-point field goals made by the lineup.
fg3a integer Fg3a.
fg3m integer Fg3m.
fta integer Free throw attempts by the lineup.
ftm integer Free throws made by the lineup.
oreb integer Offensive rebounds.
dreb integer Defensive rebounds.
tov integer Turnovers.
off_player_1 integer Offensive lineup slot 1 player identifier.
off_player_2 integer Offensive lineup slot 2 player identifier.
off_player_3 integer Offensive lineup slot 3 player identifier.
off_player_4 integer Offensive lineup slot 4 player identifier.
off_player_5 integer Offensive lineup slot 5 player identifier.
def_player_1 integer Defensive lineup slot 1 player identifier.
def_player_2 integer Defensive lineup slot 2 player identifier.
def_player_3 integer Defensive lineup slot 3 player identifier.
def_player_4 integer Defensive lineup slot 4 player identifier.
def_player_5 integer Defensive lineup slot 5 player identifier.
season integer Season identifier (4-digit year).

Author(s)

Saiem Gilani

See Also

Other WNBA Stats loader functions: load_wnba_stats_leaguedash()

Examples

try(load_wnba_stats_rosters(seasons = most_recent_wnba_stats_season()))


  try(load_wnba_stats_coaches(seasons = most_recent_wnba_stats_season()))


  try(load_wnba_stats_player_stats(seasons = most_recent_wnba_stats_season()))


  try(load_wnba_stats_lineups(seasons = most_recent_wnba_stats_season()))


  try(load_wnba_stats_team_stats(seasons = most_recent_wnba_stats_season()))


  try(load_wnba_stats_standings(seasons = most_recent_wnba_stats_season()))


  try(load_wnba_stats_draft(seasons = most_recent_wnba_stats_season()))


  try(load_wnba_stats_shots(seasons = most_recent_wnba_stats_season()))


  try(load_wnba_stats_game_rosters(seasons = most_recent_wnba_stats_season()))


  try(load_wnba_stats_officials(seasons = most_recent_wnba_stats_season()))


  try(load_wnba_stats_player_game_logs(seasons = most_recent_wnba_stats_season()))


  try(load_wnba_stats_schedule(seasons = most_recent_wnba_stats_season()))


  try(load_wnba_stats_pbp(seasons = most_recent_wnba_stats_season()))


  try(load_wnba_stats_possessions(seasons = most_recent_wnba_stats_season()))

Load cached WNBA team crosswalk from the data repo

Description

Loads cached team-crosswalk snapshots that map ESPN team identifiers to WNBA Stats API team identifiers. One row per team-season. Backed by the wnba_crosswalk release tag in sportsdataverse-data.

Loads cached schedule-crosswalk snapshots that map ESPN game identifiers to WNBA Stats API game identifiers. One row per game-season. Backed by the wnba_crosswalk release tag in sportsdataverse-data.

Loads cached player-crosswalk snapshots that map ESPN athlete identifiers to WNBA Stats API player identifiers. One row per athlete-season. Backed by the wnba_crosswalk release tag in sportsdataverse-data.

Loads cached team-crosswalk snapshots that map ESPN team identifiers to Fox Sports and Bart Torvik team identifiers for Women's College Basketball. One row per team-season. Backed by the wbb_crosswalk release tag in sportsdataverse-data.

Loads cached schedule-crosswalk snapshots that map ESPN game identifiers to Bart Torvik game identifiers for Women's College Basketball. One row per game-season. Backed by the wbb_crosswalk release tag in sportsdataverse-data.

Loads cached player-crosswalk snapshots that map ESPN athlete identifiers to Fox Sports player identifiers for Women's College Basketball. One row per athlete-season. Backed by the wbb_crosswalk release tag in sportsdataverse-data.

Usage

load_wnba_team_crosswalk(seasons = most_recent_wnba_season())

load_wnba_schedule_crosswalk(seasons = most_recent_wnba_season())

load_wnba_player_crosswalk(seasons = most_recent_wnba_season())

load_wbb_team_crosswalk(seasons = most_recent_wbb_season())

load_wbb_schedule_crosswalk(seasons = most_recent_wbb_season())

load_wbb_player_crosswalk(seasons = most_recent_wbb_season())

Arguments

seasons

A vector of 4-digit years associated with given WBB seasons. (Min: 2014)

Value

A wehoop_data tibble of cached team-crosswalk rows.

A wehoop_data tibble of cached schedule-crosswalk rows.

A wehoop_data tibble of cached player-crosswalk rows.

A wehoop_data tibble of cached WBB team-crosswalk rows.

A wehoop_data tibble of cached WBB schedule-crosswalk rows.

A wehoop_data tibble of cached WBB player-crosswalk rows.

See Also

Other WNBA Crosswalk Functions: wnba_player_crosswalk(), wnba_schedule_crosswalk(), wnba_team_crosswalk()

Other WBB Crosswalk Functions: wbb_player_crosswalk(), wbb_schedule_crosswalk(), wbb_team_crosswalk()

Examples

try(load_wnba_team_crosswalk(seasons = most_recent_wnba_season()))


  try(load_wnba_schedule_crosswalk(seasons = most_recent_wnba_season()))


  try(load_wnba_player_crosswalk(seasons = most_recent_wnba_season()))


  try(load_wbb_team_crosswalk(seasons = most_recent_wbb_season()))


  try(load_wbb_schedule_crosswalk(seasons = most_recent_wbb_season()))


  try(load_wbb_player_crosswalk(seasons = most_recent_wbb_season()))

LPB / LPBF Liga Profesional de Baloncesto (Panama) (Atrium shortcuts)

Description

Per-competition shortcuts over the Atrium embed API for LPB / LPBF Liga Profesional de Baloncesto (Panama) (website_id = 22; men's and women's).

Thin bindings of the parameterised ⁠atrium_*()⁠ wrappers to this site, minted from the competition registry (sdv-py tools/codegen/basketball_competitions.yaml); the full surface stays on the ⁠atrium_*()⁠ wrappers.

Usage

lpb_seasons(locale = NULL)
lpb_schedule(season = NULL, season_id = NULL, competition_id = NULL, locale = NULL)
lpb_standings(season = NULL, season_id = NULL, competition_id = NULL, locale = NULL)
lpb_teams(season = NULL, season_id = NULL, competition_id = NULL, locale = NULL)
lpb_player_box(fixture_id, locale = NULL)
lpb_team_box(fixture_id, locale = NULL)
lpb_pbp(fixture_id, locale = NULL)
lpb_shots(fixture_id, locale = NULL)

Arguments

season

(integer optional): Season END year (season rule below). Omit season and season_id for the site's current season.

season_id

(character optional): Season UUID (season_id in the seasons listing); skips the END-year lookup.

competition_id

(character optional): Competition UUID (a site carries many: conferences, cups); needed when several share the season.

locale

(character optional): Label locale, e.g. "en-EN"; omitted = the site's own language.

fixture_id

(character required): Fixture UUID (fixture_id in the schedule).

Details

Season rule: calendar year.

Errors and terms of use are those of atrium_fixtures(): unofficial use of the public widget endpoint, at least 1 s between requests, not republished as release assets. The site also serves women's competitions (pass their competition_id).

 lpb_seasons()
 lpb_schedule()

Value

A wehoop_data tibble with the columns of the base wrapper, one table per function:

lpb_seasons()

The columns of atrium_seasons():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID; pass it as season_id to any season-scoped wrapper.
competition_id character Competition UUID; pass it as competition_id to pick one of several seasons of an END year.
competition_name character Competition name in the site's language; the same name can appear for several years.
season_name character Season name in the site's language, e.g. Betclic ELITE 2025.
abbreviation_local character Local abbreviation of the season; null in every body seen.
year integer The site's own year of the season: the START year on LNB (site 12), the calendar year elsewhere.
season_end_year integer Season END year (the sdv key): the site's year + 1 on LNB (site 12), the calendar year on the other registered sites; null when the site is unregistered, lists no seasons or the body has no season list.
is_default_season logical True for the season the body is about (the site's default when none was asked).

lpb_schedule()

The columns of atrium_fixtures():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID the page is about (the site's default season when none was asked).
competition_id character Competition UUID of the season.
competition_name character Competition name in the site's language, e.g. Betclic ELITE or LIGA CALIENTE.MX LNBP.
season_end_year integer Season END year (the sdv key): the site's year + 1 on LNB (site 12), the calendar year on the other registered sites; null when the site is unregistered, lists no seasons or the body has no season list.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
fixture_type character Kind of game as sent: REGULAR, PLAYOFF, ... (the set is open).
name character Fixture name as the site prints it (e.g. Paris - Lyon-Villeurbanne); null on LNBP.
round character Round of the game as the site words it, e.g. Journee: 30.
round_code character Round code; null in every body seen.
pool character Pool the game belongs to; null when the competition has none.
series character Playoff series the game belongs to as sent (JSON text when an object); null outside a series.
stage_code character Opaque 30-hex stage code of the game; null in every body seen.
status character Status code of the game, e.g. CONFIRMED (final), as sent.
status_label character Status of the game as the site words it in its own language (e.g. Termine, Final).
start_time_utc POSIXct Scheduled start, naive datetime in UTC (the API sends no offset).
start_time_local character Scheduled start in the venue's local time, as the API sends it (YYYY-MM-DDTHH:MM:SS, no offset; timezone gives the zone, which varies per row).
timezone character IANA time zone of the venue (e.g. Europe/Paris, Mexico/General) that start_time_local is in.
times_unconfirmed logical True while the start time is not final.
venue character Name of the arena where the game is played.
venue_id character Venue UUID; joins no other route.
attendance integer Spectators at the game; null when not reported.
home_entity_id character Team UUID of the home team.
home_code character Short code of the home team (e.g. PAB).
home_name character Name of the home team.
home_score integer Points scored by the home team (the API sends a string; Int64 here).
home_result_place integer Result place of the home team: 1 for the winner, 2 for the loser.
home_result_status character Result status of the home team's score, e.g. CONFIRMED.
home_draw logical True when the game ended level for the home team.
home_shootout_attempts character Shootout attempts of the home team as sent (an empty string becomes null).
home_secondary_score character Secondary score of the home team (unused in the samples; shown as text).
away_entity_id character Team UUID of the away team.
away_code character Short code of the away team (e.g. PAB).
away_name character Name of the away team.
away_score integer Points scored by the away team (the API sends a string; Int64 here).
away_result_place integer Result place of the away team: 1 for the winner, 2 for the loser.
away_result_status character Result status of the away team's score, e.g. CONFIRMED.
away_draw logical True when the game ended level for the away team.
away_shootout_attempts character Shootout attempts of the away team as sent (an empty string becomes null).
away_secondary_score character Secondary score of the away team (unused in the samples; shown as text).

lpb_standings()

The columns of atrium_standings():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID of the table.
season_end_year integer Season END year (the sdv key): the site's year + 1 on LNB (site 12), the calendar year on the other registered sites; null when the site is unregistered, lists no seasons or the body has no season list.
group character Label of the table when the standings hold several groups; null for a single table.
position integer League table position (1 = first).
entity_id character Team UUID of the row.
team_name character Team name as the site prints it.
is_current_team logical True for the team the page was opened for (team context); false on a plain standings request.
logo_url character URL of the team logo image.
wins integer Games won; -1 for two teams in the 2025-26 LNB table (an administrative ranking, unverified), kept as sent (team, this table).
losses integer Games lost (team, this table).
played integer Games played (LNBP and the compact standings) (team, this table).
standing_points integer League table points (LNBP) (team, this table).
win_percentage double Share of games won as a 0-1 fraction (not 0-100) (team, this table).
scored_for integer Points scored over the season (team, this table).
scored_against integer Points conceded over the season (team, this table).
point_difference integer Point differential over the season (team, this table).
result_string_home character Home results as a string of result letters in the site's language, one per game (order and letters per locale; unverified) (team, this table).
scored_for_home integer Points scored in home games (team, this table).
scored_against_home integer Points conceded in home games (team, this table).
point_difference_home integer Point differential in home games (team, this table).
result_string_away character Away results as a string of result letters in the site's language, one per game (order and letters per locale; unverified) (team, this table).
scored_for_away integer Points scored in away games (team, this table).
scored_against_away integer Points conceded in away games (team, this table).
point_difference_away integer Point differential in away games (team, this table).
streak integer Length of the current run of results (the win / loss sign convention is unverified) (team, this table).
streak_home integer Length of the current run of home results (sign convention unverified) (team, this table).
streak_away integer Length of the current run of away results (sign convention unverified) (team, this table).

lpb_teams()

The columns of atrium_teams():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID of the team list.
entity_id character Team UUID (entity): one id per club across seasons, shared by every site that shows the team.
name character Team name in the site's language.
image_url character URL of the Sportradar-hosted image (400 px).

lpb_player_box()

The columns of atrium_box_score():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
entity_id character Team UUID the player is rostered with for this game.
side character Side of the game the row belongs to: home or away (from the fixture's isHome flag).
person_id character Player UUID (person), shared across seasons and sites.
person_name character Player name as the site prints it (upper case on LNBP and NBL1).
bib character Jersey number the player wears, as text.
position character Position code on the roster (LNB, e.g. PG); null on LNBP.
starter logical True when the player started the game.
active logical True when the player is on the court in a live game.
participated logical True when the player entered the game; false rows have null statistics.
did_not_play_reason character Reason the player did not play; null in every body seen.
minutes character Time played as an ISO 8601 duration (PT7M23S); a team's is the sum over its players (PT200M) (player, this game).
seconds_played integer Time played in whole seconds, parsed from minutes (player, this game).
points integer Points scored (player, this game).
rebounds integer Total rebounds (player, this game).
rebounds_offensive integer Offensive rebounds (player, this game).
rebounds_defensive integer Defensive rebounds (player, this game).
assists integer Assists (player, this game).
steals integer Steals (player, this game).
blocks integer Shots blocked (player, this game).
blocks_received integer Own shots blocked by an opponent (LNB only) (player, this game).
turnovers integer Turnovers (player, this game).
fouls_total integer Fouls committed (player, this game).
fouls_drawn integer Fouls drawn (committed against the player or team; LNBP only) (player, this game).
plus_minus integer Plus/minus, the point differential while on court (LNB only; null in some team lines) (player, this game).
efficiency integer Efficiency rating, from the site's own formula (player, this game).
field_goals_made integer Field goals made, two- and three-pointers together (LNBP only) (player, this game).
field_goals_attempted integer Field goals attempted (LNBP only) (player, this game).
field_goals_percentage double Field-goal percentage, 0-100 (LNBP only) (player, this game).
points_two_made integer Two-point field goals made (player, this game).
points_two_attempted integer Two-point field goals attempted (player, this game).
points_two_percentage double Two-point percentage, 0-100 (player, this game).
points_three_made integer Three-point field goals made (player, this game).
points_three_attempted integer Three-point field goals attempted (player, this game).
points_three_percentage double Three-point percentage, 0-100 (player, this game).
free_throws_made integer Free throws made (player, this game).
free_throws_attempted integer Free throws attempted (player, this game).
free_throws_percentage double Free-throw percentage, 0-100 (player, this game).
points_fast_break integer Fast-break points (LNBP only) (player, this game).

lpb_team_box()

The columns of atrium_team_box_score():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
entity_id character Team UUID (from the fixture's isHome flag).
side character Side of the game the row belongs to: home or away (from the fixture's isHome flag).
minutes character Time played as an ISO 8601 duration (PT7M23S); a team's is the sum over its players (PT200M) (team, this game).
seconds_played integer Time played in whole seconds, parsed from minutes (team, this game).
points integer Points scored (team, this game).
rebounds integer Total rebounds (team, this game).
rebounds_offensive integer Offensive rebounds (team, this game).
rebounds_defensive integer Defensive rebounds (team, this game).
assists integer Assists (team, this game).
steals integer Steals (team, this game).
blocks integer Shots blocked (team, this game).
blocks_received integer Own shots blocked by an opponent (LNB only) (team, this game).
turnovers integer Turnovers (team, this game).
fouls_total integer Fouls committed (team, this game).
fouls_drawn integer Fouls drawn (committed against the player or team; LNBP only) (team, this game).
plus_minus integer Plus/minus, the point differential while on court (LNB only; null in some team lines) (team, this game).
efficiency integer Efficiency rating, from the site's own formula (team, this game).
field_goals_made integer Field goals made, two- and three-pointers together (LNBP only) (team, this game).
field_goals_attempted integer Field goals attempted (LNBP only) (team, this game).
field_goals_percentage double Field-goal percentage, 0-100 (LNBP only) (team, this game).
points_two_made integer Two-point field goals made (team, this game).
points_two_attempted integer Two-point field goals attempted (team, this game).
points_two_percentage double Two-point percentage, 0-100 (team, this game).
points_three_made integer Three-point field goals made (team, this game).
points_three_attempted integer Three-point field goals attempted (team, this game).
points_three_percentage double Three-point percentage, 0-100 (team, this game).
free_throws_made integer Free throws made (team, this game).
free_throws_attempted integer Free throws attempted (team, this game).
free_throws_percentage double Free-throw percentage, 0-100 (team, this game).
points_fast_break integer Fast-break points (LNBP only) (team, this game).
extra_fouls_total integer Fouls committed (team, credited to the team rather than a player).
extra_rebounds integer Total rebounds (team, credited to the team rather than a player).
extra_rebounds_defensive integer Defensive rebounds (team, credited to the team rather than a player).
extra_rebounds_offensive integer Offensive rebounds (team, credited to the team rather than a player).
extra_turnovers integer Turnovers (team, credited to the team rather than a player).
total_biggest_lead integer Biggest lead of the game, in points (team, game total).
total_biggest_scoring_run integer Longest unanswered scoring run of the game, in points (team, game total).
total_field_goals_percentage double Field-goal percentage, 0-100 (LNBP only) (team, game total).
total_free_throws_percentage double Free-throw percentage, 0-100 (team, game total).
total_lead_changes integer Number of lead changes in the game (team, game total).
total_points_fast_break integer Fast-break points (LNBP only) (team, game total).
total_points_from_bench integer Points scored by non-starters (LNBP only) (team, game total).
total_points_from_turnover integer Points scored off opponent turnovers (LNBP only) (team, game total).
total_time_in_lead character Time the team led, as an ISO 8601 duration (PT36M11S) (team, game total).
total_time_in_lead_seconds integer Time the team led, in whole seconds (team, game total).
total_turnovers integer Turnovers (team, game total).

lpb_pbp()

The columns of atrium_pbp():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
sequence integer 1-based position of the event in the game (periods in order, events chronological).
event_id character Event UUID, shared with the same event in atrium_shots.
period_id integer Period number: 1-4 regulation, 11, 12, ... overtimes (not 5).
clock character Time REMAINING in the period as an ISO 8601 duration (PT10M0S at the start).
clock_seconds integer Seconds remaining in the period, parsed from clock.
entity_id character Team UUID the event is credited to.
side character Side of the game the row belongs to: home or away (from the fixture's isHome flag).
person_id character Player UUID; null for team events (time-outs, team rebounds).
person_name character Player the event is credited to; null for team events (time-outs, team rebounds).
bib character Jersey number of the player, as text; null for team events.
event_type character Event type: 2pt, 3pt, freeThrow, rebound, assist, steal, block, turnover, foul, substitution, timeOut, jumpBall, ... (language-independent).
event_sub_type character Event detail: jumpShot, layup, offensive, defensive, in, out, 1Of2, personal, ...; null when none.
description character The event's text in the site's language (e.g. Entre-deux remporte).
success logical True when a shot or free throw was made, false when missed; null for other events.
success_label character The made / missed label in the site's language; sent on shot events only.
x double Shot location along the 28 m court length as percent of the court (0-100, origin at a corner); the home team attacks the low-x basket all game; null for non-shots.
y double Shot location across the 15 m width as percent of the court (0-100); which sideline is 0 is unverified; null for non-shots.
home_score integer Home team's running score after the event.
away_score integer Away team's running score after the event.

lpb_shots()

The columns of atrium_shots():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
sequence integer 1-based position of the shot among the shots of the game (not the pbp sequence).
event_id character Event UUID of the shot; the same event in atrium_pbp.
period_id integer Period number: 1-4 regulation, 11, 12, ... overtimes (not 5).
clock character Time REMAINING in the period as an ISO 8601 duration (PT10M0S at the start).
clock_seconds integer Seconds remaining in the period, parsed from clock.
entity_id character Team UUID the event is credited to.
side character Side of the game the row belongs to: home or away (from the fixture's isHome flag).
person_id character Player UUID of the shooter.
person_name character Name of the shooter.
bib character Jersey number of the player, as text; null for team events.
event_type character Event type: 2pt, 3pt, freeThrow, rebound, assist, steal, block, turnover, foul, substitution, timeOut, jumpBall, ... (language-independent).
event_sub_type character Event detail: jumpShot, layup, offensive, defensive, in, out, 1Of2, personal, ...; null when none.
description character The event's text in the site's language (e.g. Entre-deux remporte).
success logical True when the shot was made, false when missed.
success_label character The made / missed label in the site's language; sent on shot events only.
x double Shot location along the 28 m court length as percent of the court (0-100, origin at a corner); the home team attacks the low-x basket all game; LNBP and NBL1 clamp rim attempts to 5 / 95.
y double Shot location across the 15 m width as percent of the court (0-100); which sideline is 0 is unverified.
home_score integer Home team's running score after the event.
away_score integer Away team's running score after the event.

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, nbl1_competition


Most Recent Women's College Basketball Season

Description

Returns the most recent women's college basketball season year as an integer based on the current system date. The NCAA WBB season spans two calendar years; this helper rolls over to the next season starting in October. For example, calls made on 2025-11-15 return 2026, while calls made on 2025-03-15 return 2025.

Usage

most_recent_wbb_season()

Value

An integer giving the season-ending year (e.g. 2025 for the 2024-25 season).

Examples

most_recent_wbb_season()

Most Recent WNBA Season

Description

Returns the most recent WNBA season year as an integer based on the current system date. The WNBA season runs from May through October within a single calendar year; this helper rolls forward to the new season starting in May.

Usage

most_recent_wnba_season()

Value

An integer giving the WNBA season year (e.g. 2025).

Examples

most_recent_wnba_season()

Most Recent WNBA Stats API Season

Description

Returns the most recent WNBA Stats API season year as an integer. This is a thin wrapper around most_recent_wnba_season() kept as a separate helper for naming symmetry with the ⁠wnba_stats_*⁠ family of loaders (mirrors the ⁠most_recent_*_season()⁠ convention used elsewhere in the package). The WNBA Stats API and ESPN's WNBA endpoints share the same calendar-year season identifier, so the returned value is identical to most_recent_wnba_season().

Usage

most_recent_wnba_stats_season()

Value

An integer giving the WNBA season year (e.g. 2025).

Examples

most_recent_wnba_stats_season()

NBL Rosetta Match

Description

One match's header: status, scores, clock, venue, season and teams. Box score and play-by-play: the ⁠match_*⁠ frames.

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/match/{match_id}/live/all⁠

Usage

nbl_rosetta_match(match_id)

Arguments

match_id

(character required): DataCore fixture id of the match (match_id of nbl_rosetta_matches), a UUID, e.g. b217a699-4bef-11f0-bc08-933162362355.

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

Value

A wehoop_data tibble (one row):

col_name type description
org character Organisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
match_id character DataCore fixture id (UUID v1); equal to id.
match_status character Status of the match in Rosetta's words (complete for a finished game): box score and play-by-play of any other status are partial.
start_time_datetime character Tip-off, UTC; same value as start_time.
match_type character Match type: regular, final (FINAL upper case seen)
attendance integer Attendance, a STRING; null when not recorded.
clock character Game clock of the latest event, HH:MM:SS remaining in the period.
current_period integer Latest period number as a STRING; null on older matches.
clock_running logical Game clock is running.
home_score integer Home final score, a STRING; null before tip-off.
away_score integer Away final score, a STRING; null before tip-off.
round character Round label: a number as a string in the regular season ("13"), words in the finals ("SEMI FINAL SERIES 1", "CHAMPIONSHIP")
start_time character Tip-off, UTC, with no offset or a Z suffix (ESPN dates the same Perth v SE Melbourne game 2025-12-18T10:30Z; Rosetta says 2025-12-18T10:30:00)
status character Provider fixture status: CONFIRMED, SCHEDULED.
external_media_id character Media id. Through NBL25 (2024-25): the Genius Sports match id (7 digits, e.g. 2636769; 6 or fewer in older seasons). From NBL26: mostly an 8-digit number of unverified origin (e.g. 61386925), date-like codes on some games (05042026 = DDMMYYYY on the 2026 Championship game, 1409252 = DDMMYY + n on the Blitz), null on many preseason games. NBL1 and WNBL 2025 carry 8-digit numbers.
match_slug character URL slug of the match page on nbl.com.au.
match_title character Match title ("⁠<home>⁠ v ⁠<away>⁠ ⁠<men/women>⁠ DD-MM-YYYY")
secondary_external_id character Unobserved in samples (null in every capture); type and meaning unverified.
live_exclusive logical Match is a live-stream exclusive.
season_id character DataCore id (UUID v1, Sportradar) of the season; stable across seasons and the id to join on across routes.
rosetta_season_id character Rosetta's own id (UUID v4; v5 on NBL1) of the season; routes that take this entity accept it as well as the DataCore id.
season_year integer Rosetta's year of the season: the START year for the NBL and WNBL from 1998-99 (2025 = 2025-26), the calendar year for NBL1 and the 1979-1997 winter seasons. See season_end_year for the sdv key.
season_type character Season type: regular (includes finals), preseason, in_season (cups, blitz, exhibition), test.
season_competition_id character Rosetta competition id (UUID v4)
season_competition_name character Name of the competition the season belongs to (e.g. NBL, WNBL, NBL1 North Men).
season_competition_gender character Gender (MALE/FEMALE upper case on seasons and players, male/female lower case on competitions and divisions; UNKNOWN seen)
season_competition_league_name character Name of the league the competition belongs to (NBL, WNBL or NBL1).
season_competition_division character NBL1 divisions (conference x gender); empty for NBL and WNBL.
venue_id character DataCore id (UUID v1, Sportradar) of the venue; stable across seasons and the id to join on across routes.
rosetta_venue_id character Rosetta's own id (UUID v4; v5 on NBL1) of the venue; routes that take this entity accept it as well as the DataCore id.
venue_name character Name of the venue (arena), e.g. RAC Arena.
venue_address character Unobserved in samples (null in every capture); type and meaning unverified.
venue_capacity integer Unobserved in samples (null in every capture); type and meaning unverified.
venue_timezone character IANA time zone of the venue, e.g. Australia/Sydney.
venue_code character Venue code; often null.
venue_state character Unobserved in samples (null in every capture); type and meaning unverified.
venue_suburb character Unobserved in samples (null in every capture); type and meaning unverified.
venue_latitude double Unobserved in samples (null in every capture); type and meaning unverified.
venue_longitude double Unobserved in samples (null in every capture); type and meaning unverified.
venue_country character Country; often null.
home_team_id character DataCore id (UUID v1, Sportradar) of the home team; stable across seasons and the id to join on across routes.
home_team_name character Display name of the team.
home_team_external_team_name character Team name as DataCore spells it.
home_team_code character Team code of the home team, e.g. PER or SYD.
away_team_id character DataCore id (UUID v1, Sportradar) of the away team; stable across seasons and the id to join on across routes.
away_team_name character Display name of the team.
away_team_external_team_name character Team name as DataCore spells it.
away_team_code character Team code of the away team, e.g. PER or SYD.
data_source character Backend that built the body: nexus-api or lambda-cache (observed). It varies between requests for the same match (the NBL 2025-26 sample game came back lambda-cache from /live/all and nexus-api from /match/{match_id} minutes apart, with identical play-by-play), so it says nothing about the data.
match_status_string character Status banner text, e.g. FINAL.
play_by_play_updated_datetime character Last play-by-play update, ISO 8601 UTC.
season_end_year integer sdv season key: the END year of the season (2026 = 2025-26), derived from season_year (a START year for the NBL and WNBL from 1998-99, a calendar year for NBL1 and the 1979-1997 winter seasons; year 1998 is split on the start date). Where the body carries no year it is the season asked for.

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match_by_id(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_box(), nbl_rosetta_match_player_period_box(), nbl_rosetta_match_team_box(), nbl_rosetta_matches(), nbl_rosetta_next_match(), nbl_rosetta_next_match_team(), nbl_rosetta_next_matches(), nbl_rosetta_outcomes(), nbl_rosetta_player_game_log(), nbl_rosetta_player_stats(), nbl_rosetta_players(), nbl_rosetta_seasons(), nbl_rosetta_seasons_current(), nbl_rosetta_standings(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_players(), nbl_rosetta_team_stats(), nbl_rosetta_team_stats_leaders(), nbl_rosetta_teams()

Examples

try(nbl_rosetta_match(match_id = "b217a699-4bef-11f0-bc08-933162362355"))

NBL Rosetta Match by Id

Description

One match's header (the same body as nbl_rosetta_match): status, scores, venue, season and teams.

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/match/{match_id}⁠

Usage

nbl_rosetta_match_by_id(match_id)

Arguments

match_id

(character required): DataCore fixture id of the match (match_id of nbl_rosetta_matches), a UUID, e.g. b217a699-4bef-11f0-bc08-933162362355.

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

 nbl_rosetta_match_by_id(match_id = "b217a699-4bef-11f0-bc08-933162362355")

Value

A wehoop_data tibble (one row):

col_name type description
org character Organisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
match_id character DataCore fixture id (UUID v1); equal to id.
match_status character Status of the match in Rosetta's words (complete for a finished game): box score and play-by-play of any other status are partial.
start_time_datetime character Tip-off, UTC; same value as start_time.
match_type character Match type: regular, final (FINAL upper case seen)
attendance integer Attendance, a STRING; null when not recorded.
clock character Game clock of the latest event, HH:MM:SS remaining in the period.
current_period integer Latest period number as a STRING; null on older matches.
clock_running logical Game clock is running.
home_score integer Home final score, a STRING; null before tip-off.
away_score integer Away final score, a STRING; null before tip-off.
round character Round label: a number as a string in the regular season ("13"), words in the finals ("SEMI FINAL SERIES 1", "CHAMPIONSHIP")
start_time character Tip-off, UTC, with no offset or a Z suffix (ESPN dates the same Perth v SE Melbourne game 2025-12-18T10:30Z; Rosetta says 2025-12-18T10:30:00)
status character Provider fixture status: CONFIRMED, SCHEDULED.
external_media_id character Media id. Through NBL25 (2024-25): the Genius Sports match id (7 digits, e.g. 2636769; 6 or fewer in older seasons). From NBL26: mostly an 8-digit number of unverified origin (e.g. 61386925), date-like codes on some games (05042026 = DDMMYYYY on the 2026 Championship game, 1409252 = DDMMYY + n on the Blitz), null on many preseason games. NBL1 and WNBL 2025 carry 8-digit numbers.
match_slug character URL slug of the match page on nbl.com.au.
match_title character Match title ("⁠<home>⁠ v ⁠<away>⁠ ⁠<men/women>⁠ DD-MM-YYYY")
secondary_external_id character Unobserved in samples (null in every capture); type and meaning unverified.
live_exclusive logical Match is a live-stream exclusive.
season_id character DataCore id (UUID v1, Sportradar) of the season; stable across seasons and the id to join on across routes.
rosetta_season_id character Rosetta's own id (UUID v4; v5 on NBL1) of the season; routes that take this entity accept it as well as the DataCore id.
season_year integer Rosetta's year of the season: the START year for the NBL and WNBL from 1998-99 (2025 = 2025-26), the calendar year for NBL1 and the 1979-1997 winter seasons. See season_end_year for the sdv key.
season_type character Season type: regular (includes finals), preseason, in_season (cups, blitz, exhibition), test.
season_competition_id character Rosetta competition id (UUID v4)
season_competition_name character Name of the competition the season belongs to (e.g. NBL, WNBL, NBL1 North Men).
season_competition_gender character Gender (MALE/FEMALE upper case on seasons and players, male/female lower case on competitions and divisions; UNKNOWN seen)
season_competition_league_name character Name of the league the competition belongs to (NBL, WNBL or NBL1).
season_competition_division character NBL1 divisions (conference x gender); empty for NBL and WNBL.
venue_id character DataCore id (UUID v1, Sportradar) of the venue; stable across seasons and the id to join on across routes.
rosetta_venue_id character Rosetta's own id (UUID v4; v5 on NBL1) of the venue; routes that take this entity accept it as well as the DataCore id.
venue_name character Name of the venue (arena), e.g. RAC Arena.
venue_address character Unobserved in samples (null in every capture); type and meaning unverified.
venue_capacity integer Unobserved in samples (null in every capture); type and meaning unverified.
venue_timezone character IANA time zone of the venue, e.g. Australia/Sydney.
venue_code character Venue code; often null.
venue_state character Unobserved in samples (null in every capture); type and meaning unverified.
venue_suburb character Unobserved in samples (null in every capture); type and meaning unverified.
venue_latitude double Unobserved in samples (null in every capture); type and meaning unverified.
venue_longitude double Unobserved in samples (null in every capture); type and meaning unverified.
venue_country character Country; often null.
home_team_id character DataCore id (UUID v1, Sportradar) of the home team; stable across seasons and the id to join on across routes.
home_team_name character Display name of the team.
home_team_external_team_name character Team name as DataCore spells it.
home_team_code character Team code of the home team, e.g. PER or SYD.
away_team_id character DataCore id (UUID v1, Sportradar) of the away team; stable across seasons and the id to join on across routes.
away_team_name character Display name of the team.
away_team_external_team_name character Team name as DataCore spells it.
away_team_code character Team code of the away team, e.g. PER or SYD.
data_source character Backend that built the body: nexus-api or lambda-cache (observed). It varies between requests for the same match (the NBL 2025-26 sample game came back lambda-cache from /live/all and nexus-api from /match/{match_id} minutes apart, with identical play-by-play), so it says nothing about the data.
match_status_string character Status banner text, e.g. FINAL.
play_by_play_updated_datetime character Last play-by-play update, ISO 8601 UTC.
season_end_year integer sdv season key: the END year of the season (2026 = 2025-26), derived from season_year (a START year for the NBL and WNBL from 1998-99, a calendar year for NBL1 and the 1979-1997 winter seasons; year 1998 is split on the start date). Where the body carries no year it is the season asked for.

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_box(), nbl_rosetta_match_player_period_box(), nbl_rosetta_match_team_box(), nbl_rosetta_matches(), nbl_rosetta_next_match(), nbl_rosetta_next_match_team(), nbl_rosetta_next_matches(), nbl_rosetta_outcomes(), nbl_rosetta_player_game_log(), nbl_rosetta_player_stats(), nbl_rosetta_players(), nbl_rosetta_seasons(), nbl_rosetta_seasons_current(), nbl_rosetta_standings(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_players(), nbl_rosetta_team_stats(), nbl_rosetta_team_stats_leaders(), nbl_rosetta_teams()


NBL Rosetta Match Play-by-Play

Description

One match's play-by-play with shot x/y, oldest first (NBL 2025-26 included, which ESPN's nbl feed lacks).

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/match/{match_id}/live/all⁠

Usage

nbl_rosetta_match_pbp(match_id)

Arguments

match_id

(character required): DataCore fixture id of the match (match_id of nbl_rosetta_matches), a UUID, e.g. b217a699-4bef-11f0-bc08-933162362355.

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

Value

A wehoop_data tibble (one row per event, sorted on action_id):

col_name type description
match_id character DataCore fixture id of the match (UUID v1): the {match_id} route key and fixtureId in play-by-play. Join on it.
rosetta_match_id character Rosetta's match RECORD id (UUID v4) as carried by box-score and play-by-play rows; no route accepts it. Join on match_id.
match_status character Status of the match in Rosetta's words (complete for a finished game): box score and play-by-play of any other status are partial.
action_id integer Event sequence number within the match (ascending in feed time)
period integer Period number, an INTEGER here (1-4 = quarters)
period_type character Period type: regular (overtime unobserved)
clock character Game clock at the event, MM:SS remaining in the period; null on some feed-control events.
clock_seconds double Game clock at the event as seconds (parsed from clock, MM:SS); null for events without a clock.
shot_clock character Shot clock at the event, MM:SS; in Genius-era matches it repeats the game clock (no shot-clock data)
shot_clock_seconds double Shot clock at the event as seconds (parsed from shot_clock); in Genius-era backfills it repeats the game clock.
score_home integer Home team's running score after the event (score_1 in the body).
score_away integer Away team's running score after the event (score_2 in the body).
action_type character Event type: 2pt, 3pt, freeThrow, rebound, assist, steal, block, turnover, foul, substitution, timeOut, jumpBall, possession, possessionArrow, period, fixture, main (clock start/stop)
sub_type character Event detail (shot type, foul type, "1Of2" free throw, In/Out...); absent when the event has none. Two vocabularies: Title Case ("Jump Shot") in NBL/WNBL 2025-26 feeds (events carry fixtureId), camelCase ("jumpShot") in older backfills and NBL1.
sub_type_key character sub_type folded to snake_case, so the Title Case 2025-26 spelling and the camelCase backfill spelling match.
success logical Shot or free throw made (true) or missed (false). DataCore-era feeds (events with fixtureId) and NBL1 carry it only on shots and free throws (absent elsewhere); older backfills carry it on every event, true on non-shot events.
team_id character DataCore id (UUID v1, Sportradar) of the team; stable across seasons and the id to join on across routes.
team_code character Team code, e.g. PER (the {team_code} path value)
team_name character Name of the team as Rosetta spells it, e.g. Perth Wildcats.
is_home logical True when the event's team is the match's home team; null when the event has no team.
player_id character DataCore id (UUID v1, Sportradar) of the player; stable across seasons and the id to join on across routes.
player_name character Full name of the player the event belongs to; null for events no player owns (team rebounds, period starts).
jersey_number character Jersey number of the player at the event, as text (a WNBL backfill writes 6.0).
x double Shot or event position along the court length, percent 0-100, in game orientation (each team's shots sit at x > 50 for two periods and x < 50 for the others). Unverified: which end is x = 0; DataCore-era free-throw, foul and turnover coordinates are not at the free-throw line. Null where none was recorded.
y double Shot or event position across the court width, percent 0-100 (free throws and close shots cluster near 50). Unverified: which sideline is y = 0. Null where none was recorded.
readable_action_type character Human-readable event label, e.g. "Game - Game completed".
system_action_type character Machine event label, e.g. game_game_completed.
timestamp character Wall-clock time of the event, ISO 8601 without offset (UTC)
feed character Feed shape: datacore (NBL and WNBL 2025-26: events carry fixtureId, arrive newest first, Title Case sub_type, a real shot clock) or backfill (older seasons and NBL1 2025: no fixtureId, oldest first, camelCase sub_type, shot_clock repeating the game clock).

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_by_id(), nbl_rosetta_match_player_box(), nbl_rosetta_match_player_period_box(), nbl_rosetta_match_team_box(), nbl_rosetta_matches(), nbl_rosetta_next_match(), nbl_rosetta_next_match_team(), nbl_rosetta_next_matches(), nbl_rosetta_outcomes(), nbl_rosetta_player_game_log(), nbl_rosetta_player_stats(), nbl_rosetta_players(), nbl_rosetta_seasons(), nbl_rosetta_seasons_current(), nbl_rosetta_standings(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_players(), nbl_rosetta_team_stats(), nbl_rosetta_team_stats_leaders(), nbl_rosetta_teams()

Examples

try(nbl_rosetta_match_pbp(match_id = "b217a699-4bef-11f0-bc08-933162362355"))

NBL Rosetta Match Player Box Score

Description

One match's official player box score, one row per player line (period 0 = whole game).

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/match/{match_id}/live/all⁠

Usage

nbl_rosetta_match_player_box(match_id)

Arguments

match_id

(character required): DataCore fixture id of the match (match_id of nbl_rosetta_matches), a UUID, e.g. b217a699-4bef-11f0-bc08-933162362355.

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

Value

A wehoop_data tibble (one row per player line):

col_name type description
match_id character DataCore fixture id of the match (UUID v1): the {match_id} route key and fixtureId in play-by-play. Join on it.
match_status character Status of the match in Rosetta's words (complete for a finished game): box score and play-by-play of any other status are partial.
stat_line_id character Provider record hash of this statistics row (64 hex characters)
rosetta_stat_line_id character Rosetta id of this statistics row (UUID v4)
assists integer Assists in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
blocks integer Blocks in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
defensive_rebounds integer Defensive rebounds in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
efficiency integer Efficiency rating (PTS + REB + AST + STL + BLK - missed FG - missed FT - TOV) in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
field_goals_attempted integer Field goals attempted in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
field_goals_made integer Field goals made in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
field_goals_percentage double Field goals made / attempted, a 0-1 FRACTION.
fouls integer Fouls committed (personal + technical + others) in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
free_throws_attempted integer Free throws attempted in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
free_throws_made integer Free throws made in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
free_throws_percentage double Free throws made / attempted, a 0-1 FRACTION.
jersey_number character Jersey number, a STRING.
minutes double Minutes played: "MM:SS" string in player_match_statistics, decimal minutes in calculated_player_statistics, player-minutes (integer, 5 x period length) in team rows; "00:00" or 0 where not recorded.
minutes_string character Minutes played as an ISO 8601 duration (PT30M32S); null on NBL1.
offensive_rebounds integer Offensive rebounds in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
participated logical Player took part in the game.
period integer Period as a STRING: 0 = game or season total, 1-4 = quarters, 11/12/13 = first/second/third overtime (inferred: fewer teams have each)
period_type character Period type: regular (overtime unobserved)
personal_fouls integer Personal fouls in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
playing_position character Playing position code (G, F, C, PG, SF, FC, ...); null when not recorded.
plus_minus integer Point differential while on court in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
points integer Points in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
rebounds integer Total rebounds in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
starter logical Player started the game.
steals integer Steals in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
technical_fouls integer Technical fouls in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
three_points_attempted integer Three-point field goals attempted in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
three_points_made integer Three-point field goals made in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
three_points_percentage double Three-point field goals made / attempted, a 0-1 FRACTION.
turnovers integer Turnovers in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
two_points_attempted integer Two-point field goals attempted in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
two_points_made integer Two-point field goals made in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
two_points_percentage double Two-point field goals made / attempted, a 0-1 FRACTION.
rosetta_match_id character Rosetta's match RECORD id (UUID v4) as carried by box-score and play-by-play rows; no route accepts it. Join on match_id.
player_id character DataCore id (UUID v1, Sportradar) of the player; stable across seasons and the id to join on across routes.
player_first_name character The player's given name, e.g. Elijah.
player_last_name character The player's family name, e.g. Pepper.
player_full_name character Given and family name.
player_jersey_number character Jersey number, a STRING.
player_playing_position character Playing position code (G, F, C, PG, SF, FC, ...); null when not recorded.
team_id character DataCore id (UUID v1, Sportradar) of the team; stable across seasons and the id to join on across routes.
team_code character Team code, e.g. PER (the {team_code} path value)
team_name character Name of the team as Rosetta spells it, e.g. Perth Wildcats.
sc integer NBL SuperCoach fantasy score for the game.

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_by_id(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_period_box(), nbl_rosetta_match_team_box(), nbl_rosetta_matches(), nbl_rosetta_next_match(), nbl_rosetta_next_match_team(), nbl_rosetta_next_matches(), nbl_rosetta_outcomes(), nbl_rosetta_player_game_log(), nbl_rosetta_player_stats(), nbl_rosetta_players(), nbl_rosetta_seasons(), nbl_rosetta_seasons_current(), nbl_rosetta_standings(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_players(), nbl_rosetta_team_stats(), nbl_rosetta_team_stats_leaders(), nbl_rosetta_teams()

Examples

try(nbl_rosetta_match_player_box(match_id = "b217a699-4bef-11f0-bc08-933162362355"))

NBL Rosetta Match Player Box Score by Period

Description

One match's player box score by period (Rosetta-computed from the event log), one row per player and period.

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/match/{match_id}/live/all⁠

Usage

nbl_rosetta_match_player_period_box(match_id)

Arguments

match_id

(character required): DataCore fixture id of the match (match_id of nbl_rosetta_matches), a UUID, e.g. b217a699-4bef-11f0-bc08-933162362355.

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

 nbl_rosetta_match_player_period_box(match_id = "b217a699-4bef-11f0-bc08-933162362355")

Value

A wehoop_data tibble (one row per player and period):

col_name type description
match_id character DataCore fixture id of the match (UUID v1): the {match_id} route key and fixtureId in play-by-play. Join on it.
match_status character Status of the match in Rosetta's words (complete for a finished game): box score and play-by-play of any other status are partial.
player_id character DataCore id (UUID v1, Sportradar) of the player; stable across seasons and the id to join on across routes.
rosetta_player_id character Rosetta's own id (UUID v4; v5 on NBL1) of the player; routes that take this entity accept it as well as the DataCore id.
player_first_name character The player's given name, e.g. Elijah.
player_last_name character The player's family name, e.g. Pepper.
player_jersey_number character Jersey number, a STRING.
player_playing_position character Playing position code (G, F, C, PG, SF, FC, ...); null when not recorded.
team_id character DataCore id (UUID v1, Sportradar) of the team; stable across seasons and the id to join on across routes.
rosetta_team_id character Rosetta's own id (UUID v4; v5 on NBL1) of the team; routes that take this entity accept it as well as the DataCore id.
period integer Period as a STRING: 0 = game or season total, 1-4 = quarters, 11/12/13 = first/second/third overtime (inferred: fewer teams have each)
period_type character Period type: regular (overtime unobserved)
rosetta_match_id character Rosetta's match RECORD id (UUID v4) as carried by box-score and play-by-play rows; no route accepts it. Join on match_id.
assists integer Assists in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
blocks integer Blocks in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
defensive_rebounds integer Defensive rebounds in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
field_goals_attempted integer Field goals attempted in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
field_goals_made integer Field goals made in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
field_goals_percentage double Field goals made / attempted, a 0-1 FRACTION.
fouls integer Fouls committed (personal + technical + others) in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
free_throws_attempted integer Free throws attempted in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
free_throws_made integer Free throws made in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
free_throws_percentage double Free throws made / attempted, a 0-1 FRACTION.
minutes double Minutes played: "MM:SS" string in player_match_statistics, decimal minutes in calculated_player_statistics, player-minutes (integer, 5 x period length) in team rows; "00:00" or 0 where not recorded.
offensive_rebounds integer Offensive rebounds in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
personal_fouls integer Personal fouls in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
points integer Points in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
rebounds integer Total rebounds in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
steals integer Steals in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
technical_fouls integer Technical fouls in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
three_points_attempted integer Three-point field goals attempted in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
three_points_made integer Three-point field goals made in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
three_points_percentage double Three-point field goals made / attempted, a 0-1 FRACTION.
turnovers integer Turnovers in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
two_points_attempted integer Two-point field goals attempted in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
two_points_made integer Two-point field goals made in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
two_points_percentage double Two-point field goals made / attempted, a 0-1 FRACTION.
jersey_number character Jersey number, a STRING.

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_by_id(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_box(), nbl_rosetta_match_team_box(), nbl_rosetta_matches(), nbl_rosetta_next_match(), nbl_rosetta_next_match_team(), nbl_rosetta_next_matches(), nbl_rosetta_outcomes(), nbl_rosetta_player_game_log(), nbl_rosetta_player_stats(), nbl_rosetta_players(), nbl_rosetta_seasons(), nbl_rosetta_seasons_current(), nbl_rosetta_standings(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_players(), nbl_rosetta_team_stats(), nbl_rosetta_team_stats_leaders(), nbl_rosetta_teams()


NBL Rosetta Match Team Box Score

Description

One match's team box score by period, one row per team and period (0 = whole game).

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/match/{match_id}/live/all⁠

Usage

nbl_rosetta_match_team_box(match_id)

Arguments

match_id

(character required): DataCore fixture id of the match (match_id of nbl_rosetta_matches), a UUID, e.g. b217a699-4bef-11f0-bc08-933162362355.

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

Value

A wehoop_data tibble (one row per team and period):

col_name type description
match_id character DataCore fixture id of the match (UUID v1): the {match_id} route key and fixtureId in play-by-play. Join on it.
match_status character Status of the match in Rosetta's words (complete for a finished game): box score and play-by-play of any other status are partial.
stat_line_id character Provider record hash of this statistics row (64 hex characters)
rosetta_stat_line_id character Rosetta id of this statistics row (UUID v4)
assists integer Assists in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
blocks integer Blocks in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
defensive_rebounds integer Defensive rebounds in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
field_goals_attempted integer Field goals attempted in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
field_goals_made integer Field goals made in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
field_goals_percentage double Field goals made / attempted, a 0-1 FRACTION.
fouls integer Fouls committed (personal + technical + others) in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
free_throws_attempted integer Free throws attempted in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
free_throws_made integer Free throws made in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
free_throws_percentage double Free throws made / attempted, a 0-1 FRACTION.
minutes double Minutes played: "MM:SS" string in player_match_statistics, decimal minutes in calculated_player_statistics, player-minutes (integer, 5 x period length) in team rows; "00:00" or 0 where not recorded.
offensive_rebounds integer Offensive rebounds in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
period integer Period as a STRING: 0 = game or season total, 1-4 = quarters, 11/12/13 = first/second/third overtime (inferred: fewer teams have each)
period_type character Period type: regular (overtime unobserved)
personal_fouls integer Personal fouls in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
points integer Points in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
rebounds integer Total rebounds in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
steals integer Steals in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
technical_fouls integer Technical fouls in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
three_points_attempted integer Three-point field goals attempted in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
three_points_made integer Three-point field goals made in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
three_points_percentage double Three-point field goals made / attempted, a 0-1 FRACTION.
turnovers integer Turnovers in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
two_points_attempted integer Two-point field goals attempted in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
two_points_made integer Two-point field goals made in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
two_points_percentage double Two-point field goals made / attempted, a 0-1 FRACTION.
rosetta_match_id character Rosetta's match RECORD id (UUID v4) as carried by box-score and play-by-play rows; no route accepts it. Join on match_id.
team_id character DataCore id (UUID v1, Sportradar) of the team; stable across seasons and the id to join on across routes.
team_code character Team code, e.g. PER (the {team_code} path value)
team_name character Name of the team as Rosetta spells it, e.g. Perth Wildcats.
timeouts integer Timeouts taken in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_by_id(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_box(), nbl_rosetta_match_player_period_box(), nbl_rosetta_matches(), nbl_rosetta_next_match(), nbl_rosetta_next_match_team(), nbl_rosetta_next_matches(), nbl_rosetta_outcomes(), nbl_rosetta_player_game_log(), nbl_rosetta_player_stats(), nbl_rosetta_players(), nbl_rosetta_seasons(), nbl_rosetta_seasons_current(), nbl_rosetta_standings(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_players(), nbl_rosetta_team_stats(), nbl_rosetta_team_stats_leaders(), nbl_rosetta_teams()

Examples

try(nbl_rosetta_match_team_box(match_id = "b217a699-4bef-11f0-bc08-933162362355"))

NBL Rosetta Matches

Description

Matches of a season: ids, teams, venue, status, scores and start time (UTC).

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/{org}/matches/in/season/{season}/{season_type}⁠

Usage

nbl_rosetta_matches(
  season,
  org = "wnbl",
  season_type = "all",
  limit = NULL,
  offset = NULL
)

Arguments

season

(integer required): Season END year (2026 = 2025-26). The runtime maps it to Rosetta's year: the START year for the NBL and WNBL from 1998-99, the calendar year for NBL1 and the NBL / WNBL winter seasons up to 1998. END 1998 and 1999 both read Rosetta year 1998, which holds two seasons; the matches frame keeps the one asked for.

org

(character default "wnbl", the women's WNBL): Organisation: nbl (men's NBL), wnbl (women's) or nbl1 (the second tier, men's and women's conferences). One of "nbl", "wnbl", "nbl1".

season_type

(character default "all"): Season type: all (every type of the year), regular (includes finals), preseason, in_season (cups, Blitz, NBAxNBL, All-Star) or test. One of "all", "regular", "preseason", "in_season", "test".

limit

(integer default NULL): Rows to return. Omitted = a page large enough for the whole list (a short page cut by Rosetta's path cache is refused).

offset

(integer default NULL): Rows to skip. Pages can overlap, so prefer one large limit.

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

Value

A wehoop_data tibble (one row per match):

col_name type description
org character Organisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
match_id character DataCore fixture id (UUID v1); equal to id.
external_media_id character Media id. Through NBL25 (2024-25): the Genius Sports match id (7 digits, e.g. 2636769; 6 or fewer in older seasons). From NBL26: mostly an 8-digit number of unverified origin (e.g. 61386925), date-like codes on some games (05042026 = DDMMYYYY on the 2026 Championship game, 1409252 = DDMMYY + n on the Blitz), null on many preseason games. NBL1 and WNBL 2025 carry 8-digit numbers.
date_updated character Record last-edit time, ISO 8601 UTC.
start_time character Tip-off, UTC, with no offset or a Z suffix (ESPN dates the same Perth v SE Melbourne game 2025-12-18T10:30Z; Rosetta says 2025-12-18T10:30:00)
start_time_datetime character Tip-off, UTC; same value as start_time.
round character Round label: a number as a string in the regular season ("13"), words in the finals ("SEMI FINAL SERIES 1", "CHAMPIONSHIP")
match_type character Match type: regular, final (FINAL upper case seen)
match_status character Status of the match in Rosetta's words (complete for a finished game): box score and play-by-play of any other status are partial.
status character Provider fixture status: CONFIRMED, SCHEDULED.
home_score integer Home final score, a STRING; null before tip-off.
away_score integer Away final score, a STRING; null before tip-off.
attendance integer Attendance, a STRING; null when not recorded.
match_slug character URL slug of the match page on nbl.com.au.
match_title character Match title ("⁠<home>⁠ v ⁠<away>⁠ ⁠<men/women>⁠ DD-MM-YYYY")
venue_id character DataCore id (UUID v1, Sportradar) of the venue; stable across seasons and the id to join on across routes.
rosetta_venue_id character Rosetta's own id (UUID v4; v5 on NBL1) of the venue; routes that take this entity accept it as well as the DataCore id.
venue_name character Name of the venue (arena), e.g. RAC Arena.
venue_address character Unobserved in samples (null in every capture); type and meaning unverified.
venue_suburb character Unobserved in samples (null in every capture); type and meaning unverified.
venue_state character Unobserved in samples (null in every capture); type and meaning unverified.
venue_country character Country; often null.
venue_capacity integer Unobserved in samples (null in every capture); type and meaning unverified.
venue_timezone character IANA time zone of the venue, e.g. Australia/Sydney.
venue_code character Venue code; often null.
venue_latitude double Unobserved in samples (null in every capture); type and meaning unverified.
venue_longitude double Unobserved in samples (null in every capture); type and meaning unverified.
home_team_id character DataCore id (UUID v1, Sportradar) of the home team; stable across seasons and the id to join on across routes.
rosetta_home_team_id character Rosetta's own id (UUID v4; v5 on NBL1) of the home team; routes that take this entity accept it as well as the DataCore id.
home_team_name character Display name of the team.
home_team_external_team_name character Team name as DataCore spells it.
home_team_code character Team code of the home team, e.g. PER or SYD.
home_team_division_abbreviation character Division code, e.g. EM (East Men)
home_team_division_name character Division name (NBL1 conference + gender)
home_team_conference_name character Name of the NBL1 conference of the home team; null outside NBL1.
away_team_id character DataCore id (UUID v1, Sportradar) of the away team; stable across seasons and the id to join on across routes.
rosetta_away_team_id character Rosetta's own id (UUID v4; v5 on NBL1) of the away team; routes that take this entity accept it as well as the DataCore id.
away_team_name character Display name of the team.
away_team_external_team_name character Team name as DataCore spells it.
away_team_code character Team code of the away team, e.g. PER or SYD.
away_team_division_abbreviation character Division code, e.g. EM (East Men)
away_team_division_name character Division name (NBL1 conference + gender)
away_team_conference_name character Name of the NBL1 conference of the away team; null outside NBL1.
season_id character DataCore id (UUID v1, Sportradar) of the season; stable across seasons and the id to join on across routes.
rosetta_season_id character Rosetta's own id (UUID v4; v5 on NBL1) of the season; routes that take this entity accept it as well as the DataCore id.
season_name character Season name (NBL26, WNBL 2024/25, 2025 South Men)
season_year integer Rosetta's year of the season: the START year for the NBL and WNBL from 1998-99 (2025 = 2025-26), the calendar year for NBL1 and the 1979-1997 winter seasons. See season_end_year for the sdv key.
season_type character Season type: regular (includes finals), preseason, in_season (cups, blitz, exhibition), test.
season_gender character Gender (MALE/FEMALE upper case on seasons and players, male/female lower case on competitions and divisions; UNKNOWN seen)
season_competition_id character Rosetta competition id (UUID v4)
season_competition_name character Name of the competition the season belongs to (e.g. NBL, WNBL, NBL1 North Men).
season_competition_gender character Gender (MALE/FEMALE upper case on seasons and players, male/female lower case on competitions and divisions; UNKNOWN seen)
season_competition_league_name character Name of the league the competition belongs to (NBL, WNBL or NBL1).
season_competition_division character NBL1 divisions (conference x gender); empty for NBL and WNBL.
season_end_year integer sdv season key: the END year of the season (2026 = 2025-26), derived from season_year (a START year for the NBL and WNBL from 1998-99, a calendar year for NBL1 and the 1979-1997 winter seasons; year 1998 is split on the start date). Where the body carries no year it is the season asked for.
home_team_division character NBL1 divisions (conference x gender); empty for NBL and WNBL.
home_team_conference character Conference of the division.
away_team_division character NBL1 divisions (conference x gender); empty for NBL and WNBL.
away_team_conference character Conference of the division.

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_by_id(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_box(), nbl_rosetta_match_player_period_box(), nbl_rosetta_match_team_box(), nbl_rosetta_next_match(), nbl_rosetta_next_match_team(), nbl_rosetta_next_matches(), nbl_rosetta_outcomes(), nbl_rosetta_player_game_log(), nbl_rosetta_player_stats(), nbl_rosetta_players(), nbl_rosetta_seasons(), nbl_rosetta_seasons_current(), nbl_rosetta_standings(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_players(), nbl_rosetta_team_stats(), nbl_rosetta_team_stats_leaders(), nbl_rosetta_teams()

Examples

try(nbl_rosetta_matches(org = "nbl", season = 2026, season_type = "regular"))

NBL Rosetta Next Match

Description

The organisation's next scheduled match (empty between seasons).

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/next/match/for/{org}/{season}⁠

Usage

nbl_rosetta_next_match(season, org = "wnbl")

Arguments

season

(integer required): Season END year (2026 = 2025-26). The runtime maps it to Rosetta's year: the START year for the NBL and WNBL from 1998-99, the calendar year for NBL1 and the NBL / WNBL winter seasons up to 1998. END 1998 and 1999 both read Rosetta year 1998, which holds two seasons; the matches frame keeps the one asked for.

org

(character default "wnbl", the women's WNBL): Organisation: nbl (men's NBL), wnbl (women's) or nbl1 (the second tier, men's and women's conferences). One of "nbl", "wnbl", "nbl1".

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

 nbl_rosetta_next_match(org = "nbl", season = 2027)

Value

A wehoop_data tibble (one row: the next match):

col_name type description
org character Organisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
match_id character DataCore fixture id (UUID v1); equal to id.
external_media_id character Media id. Through NBL25 (2024-25): the Genius Sports match id (7 digits, e.g. 2636769; 6 or fewer in older seasons). From NBL26: mostly an 8-digit number of unverified origin (e.g. 61386925), date-like codes on some games (05042026 = DDMMYYYY on the 2026 Championship game, 1409252 = DDMMYY + n on the Blitz), null on many preseason games. NBL1 and WNBL 2025 carry 8-digit numbers.
date_updated character Record last-edit time, ISO 8601 UTC.
start_time character Tip-off, UTC, with no offset or a Z suffix (ESPN dates the same Perth v SE Melbourne game 2025-12-18T10:30Z; Rosetta says 2025-12-18T10:30:00)
start_time_datetime character Tip-off, UTC; same value as start_time.
round character Round label: a number as a string in the regular season ("13"), words in the finals ("SEMI FINAL SERIES 1", "CHAMPIONSHIP")
match_type character Match type: regular, final (FINAL upper case seen)
match_status character Status of the match in Rosetta's words (complete for a finished game): box score and play-by-play of any other status are partial.
status character Provider fixture status: CONFIRMED, SCHEDULED.
home_score integer Unobserved in samples (null in every capture); type and meaning unverified.
away_score integer Unobserved in samples (null in every capture); type and meaning unverified.
attendance integer Unobserved in samples (null in every capture); type and meaning unverified.
match_slug character URL slug of the match page on nbl.com.au.
match_title character Match title ("⁠<home>⁠ v ⁠<away>⁠ ⁠<men/women>⁠ DD-MM-YYYY")
venue_id character DataCore id (UUID v1, Sportradar) of the venue; stable across seasons and the id to join on across routes.
rosetta_venue_id character Rosetta's own id (UUID v4; v5 on NBL1) of the venue; routes that take this entity accept it as well as the DataCore id.
venue_name character Name of the venue (arena), e.g. RAC Arena.
venue_address character Unobserved in samples (null in every capture); type and meaning unverified.
venue_suburb character Unobserved in samples (null in every capture); type and meaning unverified.
venue_state character Unobserved in samples (null in every capture); type and meaning unverified.
venue_country character Unobserved in samples (null in every capture); type and meaning unverified.
venue_capacity integer Unobserved in samples (null in every capture); type and meaning unverified.
venue_timezone character IANA time zone of the venue, e.g. Australia/Sydney.
venue_code character Venue code; often null.
venue_latitude double Unobserved in samples (null in every capture); type and meaning unverified.
venue_longitude double Unobserved in samples (null in every capture); type and meaning unverified.
home_team_id character DataCore id (UUID v1, Sportradar) of the home team; stable across seasons and the id to join on across routes.
rosetta_home_team_id character Rosetta's own id (UUID v4; v5 on NBL1) of the home team; routes that take this entity accept it as well as the DataCore id.
home_team_name character Display name of the team.
home_team_external_team_name character Team name as DataCore spells it.
home_team_code character Team code of the home team, e.g. PER or SYD.
home_team_division character Unobserved in samples (null in every capture); type and meaning unverified.
home_team_conference character Unobserved in samples (null in every capture); type and meaning unverified.
away_team_id character DataCore id (UUID v1, Sportradar) of the away team; stable across seasons and the id to join on across routes.
rosetta_away_team_id character Rosetta's own id (UUID v4; v5 on NBL1) of the away team; routes that take this entity accept it as well as the DataCore id.
away_team_name character Display name of the team.
away_team_external_team_name character Team name as DataCore spells it.
away_team_code character Team code of the away team, e.g. PER or SYD.
away_team_division character Unobserved in samples (null in every capture); type and meaning unverified.
away_team_conference character Unobserved in samples (null in every capture); type and meaning unverified.
season_id character DataCore id (UUID v1, Sportradar) of the season; stable across seasons and the id to join on across routes.
rosetta_season_id character Rosetta's own id (UUID v4; v5 on NBL1) of the season; routes that take this entity accept it as well as the DataCore id.
season_name character Season name (NBL26, WNBL 2024/25, 2025 South Men)
season_year integer Rosetta's year of the season: the START year for the NBL and WNBL from 1998-99 (2025 = 2025-26), the calendar year for NBL1 and the 1979-1997 winter seasons. See season_end_year for the sdv key.
season_type character Season type: regular (includes finals), preseason, in_season (cups, blitz, exhibition), test.
season_gender character Gender (MALE/FEMALE upper case on seasons and players, male/female lower case on competitions and divisions; UNKNOWN seen)
season_competition_id character Rosetta competition id (UUID v4)
season_competition_name character Name of the competition the season belongs to (e.g. NBL, WNBL, NBL1 North Men).
season_competition_gender character Gender (MALE/FEMALE upper case on seasons and players, male/female lower case on competitions and divisions; UNKNOWN seen)
season_competition_league_name character Name of the league the competition belongs to (NBL, WNBL or NBL1).
season_competition_division character Always an empty array in samples; element shape and meaning unverified.
season_end_year integer sdv season key: the END year of the season (2026 = 2025-26), derived from season_year (a START year for the NBL and WNBL from 1998-99, a calendar year for NBL1 and the 1979-1997 winter seasons; year 1998 is split on the start date). Where the body carries no year it is the season asked for.

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_by_id(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_box(), nbl_rosetta_match_player_period_box(), nbl_rosetta_match_team_box(), nbl_rosetta_matches(), nbl_rosetta_next_match_team(), nbl_rosetta_next_matches(), nbl_rosetta_outcomes(), nbl_rosetta_player_game_log(), nbl_rosetta_player_stats(), nbl_rosetta_players(), nbl_rosetta_seasons(), nbl_rosetta_seasons_current(), nbl_rosetta_standings(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_players(), nbl_rosetta_team_stats(), nbl_rosetta_team_stats_leaders(), nbl_rosetta_teams()


NBL Rosetta Next Match Team

Description

Next match; the team segment is ignored by Rosetta (the body is the organisation's next match).

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/next/match/for/team/{team_code}/{org}/{season}⁠

Usage

nbl_rosetta_next_match_team(team_code, season, org = "wnbl")

Arguments

team_code

(character required): Team code (team_code of nbl_rosetta_teams), e.g. PER for the Perth Wildcats.

season

(integer required): Season END year (2026 = 2025-26). The runtime maps it to Rosetta's year: the START year for the NBL and WNBL from 1998-99, the calendar year for NBL1 and the NBL / WNBL winter seasons up to 1998. END 1998 and 1999 both read Rosetta year 1998, which holds two seasons; the matches frame keeps the one asked for.

org

(character default "wnbl", the women's WNBL): Organisation: nbl (men's NBL), wnbl (women's) or nbl1 (the second tier, men's and women's conferences). One of "nbl", "wnbl", "nbl1".

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

 nbl_rosetta_next_match_team(org = "nbl", season = 2027, team_code = "PER")

Value

A wehoop_data tibble (one row: the next match):

col_name type description
org character Organisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
match_id character DataCore fixture id (UUID v1); equal to id.
external_media_id character Media id. Through NBL25 (2024-25): the Genius Sports match id (7 digits, e.g. 2636769; 6 or fewer in older seasons). From NBL26: mostly an 8-digit number of unverified origin (e.g. 61386925), date-like codes on some games (05042026 = DDMMYYYY on the 2026 Championship game, 1409252 = DDMMYY + n on the Blitz), null on many preseason games. NBL1 and WNBL 2025 carry 8-digit numbers.
date_updated character Record last-edit time, ISO 8601 UTC.
start_time character Tip-off, UTC, with no offset or a Z suffix (ESPN dates the same Perth v SE Melbourne game 2025-12-18T10:30Z; Rosetta says 2025-12-18T10:30:00)
start_time_datetime character Tip-off, UTC; same value as start_time.
round character Round label: a number as a string in the regular season ("13"), words in the finals ("SEMI FINAL SERIES 1", "CHAMPIONSHIP")
match_type character Match type: regular, final (FINAL upper case seen)
match_status character Status of the match in Rosetta's words (complete for a finished game): box score and play-by-play of any other status are partial.
status character Provider fixture status: CONFIRMED, SCHEDULED.
home_score integer Unobserved in samples (null in every capture); type and meaning unverified.
away_score integer Unobserved in samples (null in every capture); type and meaning unverified.
attendance integer Unobserved in samples (null in every capture); type and meaning unverified.
match_slug character URL slug of the match page on nbl.com.au.
match_title character Match title ("⁠<home>⁠ v ⁠<away>⁠ ⁠<men/women>⁠ DD-MM-YYYY")
venue_id character DataCore id (UUID v1, Sportradar) of the venue; stable across seasons and the id to join on across routes.
rosetta_venue_id character Rosetta's own id (UUID v4; v5 on NBL1) of the venue; routes that take this entity accept it as well as the DataCore id.
venue_name character Name of the venue (arena), e.g. RAC Arena.
venue_address character Unobserved in samples (null in every capture); type and meaning unverified.
venue_suburb character Unobserved in samples (null in every capture); type and meaning unverified.
venue_state character Unobserved in samples (null in every capture); type and meaning unverified.
venue_country character Unobserved in samples (null in every capture); type and meaning unverified.
venue_capacity integer Unobserved in samples (null in every capture); type and meaning unverified.
venue_timezone character IANA time zone of the venue, e.g. Australia/Sydney.
venue_code character Unobserved in samples (null in every capture); type and meaning unverified.
venue_latitude double Unobserved in samples (null in every capture); type and meaning unverified.
venue_longitude double Unobserved in samples (null in every capture); type and meaning unverified.
home_team_id character DataCore id (UUID v1, Sportradar) of the home team; stable across seasons and the id to join on across routes.
rosetta_home_team_id character Rosetta's own id (UUID v4; v5 on NBL1) of the home team; routes that take this entity accept it as well as the DataCore id.
home_team_name character Display name of the team.
home_team_external_team_name character Team name as DataCore spells it.
home_team_code character Team code of the home team, e.g. PER or SYD.
home_team_division character Unobserved in samples (null in every capture); type and meaning unverified.
home_team_conference character Unobserved in samples (null in every capture); type and meaning unverified.
away_team_id character DataCore id (UUID v1, Sportradar) of the away team; stable across seasons and the id to join on across routes.
rosetta_away_team_id character Rosetta's own id (UUID v4; v5 on NBL1) of the away team; routes that take this entity accept it as well as the DataCore id.
away_team_name character Display name of the team.
away_team_external_team_name character Team name as DataCore spells it.
away_team_code character Team code of the away team, e.g. PER or SYD.
away_team_division character Unobserved in samples (null in every capture); type and meaning unverified.
away_team_conference character Unobserved in samples (null in every capture); type and meaning unverified.
season_id character DataCore id (UUID v1, Sportradar) of the season; stable across seasons and the id to join on across routes.
rosetta_season_id character Rosetta's own id (UUID v4; v5 on NBL1) of the season; routes that take this entity accept it as well as the DataCore id.
season_name character Season name (NBL26, WNBL 2024/25, 2025 South Men)
season_year integer Rosetta's year of the season: the START year for the NBL and WNBL from 1998-99 (2025 = 2025-26), the calendar year for NBL1 and the 1979-1997 winter seasons. See season_end_year for the sdv key.
season_type character Season type: regular (includes finals), preseason, in_season (cups, blitz, exhibition), test.
season_gender character Gender (MALE/FEMALE upper case on seasons and players, male/female lower case on competitions and divisions; UNKNOWN seen)
season_competition_id character Rosetta competition id (UUID v4)
season_competition_name character Name of the competition the season belongs to (e.g. NBL, WNBL, NBL1 North Men).
season_competition_gender character Unobserved in samples (null in every capture); type and meaning unverified.
season_competition_league_name character Name of the league the competition belongs to (NBL, WNBL or NBL1).
season_competition_division character Always an empty array in samples; element shape and meaning unverified.
season_end_year integer sdv season key: the END year of the season (2026 = 2025-26), derived from season_year (a START year for the NBL and WNBL from 1998-99, a calendar year for NBL1 and the 1979-1997 winter seasons; year 1998 is split on the start date). Where the body carries no year it is the season asked for.

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_by_id(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_box(), nbl_rosetta_match_player_period_box(), nbl_rosetta_match_team_box(), nbl_rosetta_matches(), nbl_rosetta_next_match(), nbl_rosetta_next_matches(), nbl_rosetta_outcomes(), nbl_rosetta_player_game_log(), nbl_rosetta_player_stats(), nbl_rosetta_players(), nbl_rosetta_seasons(), nbl_rosetta_seasons_current(), nbl_rosetta_standings(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_players(), nbl_rosetta_team_stats(), nbl_rosetta_team_stats_leaders(), nbl_rosetta_teams()


NBL Rosetta Next Matches

Description

Each team's next matches: opponent, venue and start time.

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/next/matches/for/teams/in/{org}/{season}⁠

Usage

nbl_rosetta_next_matches(season, org = "wnbl")

Arguments

season

(integer required): Season END year (2026 = 2025-26). The runtime maps it to Rosetta's year: the START year for the NBL and WNBL from 1998-99, the calendar year for NBL1 and the NBL / WNBL winter seasons up to 1998. END 1998 and 1999 both read Rosetta year 1998, which holds two seasons; the matches frame keeps the one asked for.

org

(character default "wnbl", the women's WNBL): Organisation: nbl (men's NBL), wnbl (women's) or nbl1 (the second tier, men's and women's conferences). One of "nbl", "wnbl", "nbl1".

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

 nbl_rosetta_next_matches(org = "nbl", season = 2027)

Value

A wehoop_data tibble (one row per team and upcoming match):

col_name type description
org character Organisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
rosetta_team_id character Rosetta's own id (UUID v4; v5 on NBL1) of the team; routes that take this entity accept it as well as the DataCore id.
team_name character Name of the team as Rosetta spells it, e.g. Perth Wildcats.
team_code character Team code, e.g. PER (the {team_code} path value)
division character Unobserved in samples (null in every capture); type and meaning unverified.
conference character Unobserved in samples (null in every capture); type and meaning unverified.
match_slug character URL slug of the upcoming match, e.g. sydney-kings-v-nz-breakers-men-14-10-2026.
match_title character Title of the upcoming match, e.g. Sydney Kings v NZ Breakers men 14-10-2026.
start_time_datetime character Start of the upcoming match, UTC, ISO 8601 text without an offset.
is_home logical True when the row's team is the home team of the upcoming match.
opponent_name character Name of the opponent in the upcoming match.
venue character Name of the venue (arena) of the upcoming match.
match_id character DataCore fixture id of the match (UUID v1): the {match_id} route key and fixtureId in play-by-play. Join on it.
rosetta_match_id character Rosetta's match RECORD id (UUID v4) as carried by box-score and play-by-play rows; no route accepts it. Join on match_id.
rosetta_opponent_id character Rosetta's own id (UUID v4; v5 on NBL1) of the opponent; routes that take this entity accept it as well as the DataCore id.
season_end_year integer sdv season key: the END year of the season (2026 = 2025-26), derived from season_year (a START year for the NBL and WNBL from 1998-99, a calendar year for NBL1 and the 1979-1997 winter seasons; year 1998 is split on the start date). Where the body carries no year it is the season asked for.

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_by_id(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_box(), nbl_rosetta_match_player_period_box(), nbl_rosetta_match_team_box(), nbl_rosetta_matches(), nbl_rosetta_next_match(), nbl_rosetta_next_match_team(), nbl_rosetta_outcomes(), nbl_rosetta_player_game_log(), nbl_rosetta_player_stats(), nbl_rosetta_players(), nbl_rosetta_seasons(), nbl_rosetta_seasons_current(), nbl_rosetta_standings(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_players(), nbl_rosetta_team_stats(), nbl_rosetta_team_stats_leaders(), nbl_rosetta_teams()


NBL Rosetta Outcomes

Description

Win-loss record and last 10, 5 and 3 results per team, keyed by team name.

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/match/outcomes/for/{org}/teams/in/season/{season}/{season_type}⁠

Usage

nbl_rosetta_outcomes(season, org = "wnbl", season_type = "regular")

Arguments

season

(integer required): Season END year (2026 = 2025-26). The runtime maps it to Rosetta's year: the START year for the NBL and WNBL from 1998-99, the calendar year for NBL1 and the NBL / WNBL winter seasons up to 1998. END 1998 and 1999 both read Rosetta year 1998, which holds two seasons; the matches frame keeps the one asked for.

org

(character default "wnbl", the women's WNBL): Organisation: nbl (men's NBL), wnbl (women's) or nbl1 (the second tier, men's and women's conferences). One of "nbl", "wnbl", "nbl1".

season_type

(character default "regular"): Season type: all (every type of the year), regular (includes finals), preseason, in_season (cups, Blitz, NBAxNBL, All-Star) or test. One of "all", "regular", "preseason", "in_season", "test".

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

 nbl_rosetta_outcomes(org = "nbl", season = 2026, season_type = "regular")

Value

A wehoop_data tibble (one row per team name):

col_name type description
org character Organisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
team_name character Name of the team, the key of Rosetta's outcomes map (the body carries no team id).
wins integer Wins of the team in the season type asked for.
losses integer Losses of the team in the season type asked for.
last10 character Results of the team's last 10 games as a W/L string, oldest first.
last5 character Results of the team's last 5 games as a W/L string, oldest first.
last3 character Results of the team's last 3 games as a W/L string, oldest first.
season_end_year integer sdv season key: the END year of the season (2026 = 2025-26), derived from season_year (a START year for the NBL and WNBL from 1998-99, a calendar year for NBL1 and the 1979-1997 winter seasons; year 1998 is split on the start date). Where the body carries no year it is the season asked for.

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_by_id(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_box(), nbl_rosetta_match_player_period_box(), nbl_rosetta_match_team_box(), nbl_rosetta_matches(), nbl_rosetta_next_match(), nbl_rosetta_next_match_team(), nbl_rosetta_next_matches(), nbl_rosetta_player_game_log(), nbl_rosetta_player_stats(), nbl_rosetta_players(), nbl_rosetta_seasons(), nbl_rosetta_seasons_current(), nbl_rosetta_standings(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_players(), nbl_rosetta_team_stats(), nbl_rosetta_team_stats_leaders(), nbl_rosetta_teams()


NBL Rosetta Player Game Log

Description

A player's game log for a season: the box-score line of each game (period 0 = whole game) and the game.

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/{org}/player_boxscores/for/{player_id}/in/season/{season}/regular⁠

Usage

nbl_rosetta_player_game_log(
  player_id,
  season,
  org = "wnbl",
  participated = NULL
)

Arguments

player_id

(character required): Player id: the DataCore person id (player_id of nbl_rosetta_players) or Rosetta's own id; either is accepted.

season

(integer required): Season END year (2026 = 2025-26). The runtime maps it to Rosetta's year: the START year for the NBL and WNBL from 1998-99, the calendar year for NBL1 and the NBL / WNBL winter seasons up to 1998. END 1998 and 1999 both read Rosetta year 1998, which holds two seasons; the matches frame keeps the one asked for.

org

(character default "wnbl", the women's WNBL): Organisation: nbl (men's NBL), wnbl (women's) or nbl1 (the second tier, men's and women's conferences). One of "nbl", "wnbl", "nbl1".

participated

(integer default NULL): 1 = only games the player played in (without it, games on the roster that he sat out too). Sent as filter[participated].

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

 nbl_rosetta_player_game_log(
   org = "nbl", participated = 1, player_id = "7619d3ea-410d-11f0-9235-2902fc2f936f",
   season = 2026
 )

Value

A wehoop_data tibble (one row per game):

col_name type description
org character Organisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
period integer Period as a STRING: 0 = game or season total, 1-4 = quarters, 11/12/13 = first/second/third overtime (inferred: fewer teams have each)
playing_position character Playing position code (G, F, C, PG, SF, FC, ...); null when not recorded.
points integer Points in the game.
rebounds integer Total rebounds in the game.
assists integer Assists in the game.
blocks integer Blocks in the game.
steals integer Steals in the game.
turnovers integer Turnovers in the game.
offensive_rebounds integer Offensive rebounds in the game.
defensive_rebounds integer Defensive rebounds in the game.
personal_fouls integer Personal fouls in the game.
three_points_attempted integer Three-point field goals attempted in the game.
three_points_made integer Three-point field goals made in the game.
three_points_percentage double Three-point field goals made / attempted, a 0-1 FRACTION.
two_points_attempted integer Two-point field goals attempted in the game.
two_points_made integer Two-point field goals made in the game.
two_points_percentage double Two-point field goals made / attempted, a 0-1 FRACTION.
field_goals_attempted integer Field goals attempted in the game.
field_goals_made integer Field goals made in the game.
field_goals_percentage double Field goals made / attempted, a 0-1 FRACTION.
free_throws_attempted integer Free throws attempted in the game.
free_throws_made integer Free throws made in the game.
free_throws_percentage double Free throws made / attempted, a 0-1 FRACTION.
minutes double Minutes played, decimal minutes.
participated logical Player took part in the game.
match_id character DataCore fixture id of the match (UUID v1): the {match_id} route key and fixtureId in play-by-play. Join on it.
rosetta_match_id character Rosetta's match RECORD id (UUID v4) as carried by box-score and play-by-play rows; no route accepts it. Join on match_id.
match_start_time_datetime character Tip-off, UTC; same value as start_time.
match_status character Status of the match in Rosetta's words (complete for a finished game): box score and play-by-play of any other status are partial.
match_season_id character DataCore id (UUID v1, Sportradar) of the match's season; stable across seasons and the id to join on across routes.
rosetta_match_season_id character Rosetta's own id (UUID v4; v5 on NBL1) of the match's season; routes that take this entity accept it as well as the DataCore id.
match_season_year integer Season year as a STRING. NBL and WNBL from 1998-99: the START year ("2025" = 2025-26, sdv END = year + 1). NBL and WNBL 1979-1997 and every NBL1 season: the calendar year the season was played (END = year). Year 1998 holds two NBL and two WNBL seasons (calendar 1998 and 1998-99): tell them apart by start_date.
match_season_type character Season type: regular (includes finals), preseason, in_season (cups, blitz, exhibition), test.
rosetta_match_home_team_id character Rosetta's own id (UUID v4; v5 on NBL1) of the match's home team; routes that take this entity accept it as well as the DataCore id.
match_home_team_name character Display name of the team.
match_home_team_code character Team code of the match's home team, e.g. PER or SYD.
rosetta_match_away_team_id character Rosetta's own id (UUID v4; v5 on NBL1) of the match's away team; routes that take this entity accept it as well as the DataCore id.
match_away_team_name character Display name of the team.
match_away_team_code character Team code of the match's away team, e.g. PER or SYD.
player_id character DataCore id (UUID v1, Sportradar) of the player; stable across seasons and the id to join on across routes.
rosetta_player_id character Rosetta's own id (UUID v4; v5 on NBL1) of the player; routes that take this entity accept it as well as the DataCore id.
player_jersey_number character Jersey number, a STRING.
player_first_name character The player's given name, e.g. Elijah.
player_last_name character The player's family name, e.g. Pepper.
team_id character DataCore id (UUID v1, Sportradar) of the team; stable across seasons and the id to join on across routes.
rosetta_team_id character Rosetta's own id (UUID v4; v5 on NBL1) of the team; routes that take this entity accept it as well as the DataCore id.
team_name character Name of the team as Rosetta spells it, e.g. Perth Wildcats.
team_code character Team code, e.g. PER (the {team_code} path value)
sc_total_score integer SuperCoach score including double-double / triple-double bonuses.
sc_total_score_without_dd_and_td integer SuperCoach score without those bonuses.
sc_breakdown_points_value integer The stat's value for the game or season.
sc_breakdown_points_points integer SuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_rebounds_value integer The stat's value for the game or season.
sc_breakdown_rebounds_points integer SuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_assists_value integer The stat's value for the game or season.
sc_breakdown_assists_points integer SuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_blocks_value integer The stat's value for the game or season.
sc_breakdown_blocks_points integer SuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_steals_value integer The stat's value for the game or season.
sc_breakdown_steals_points integer SuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_turnovers_value integer The stat's value for the game or season.
sc_breakdown_turnovers_points integer SuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_double_figure_count integer Stats in double figures (for the double-double / triple-double bonus)
sc_season_total integer Player's SuperCoach total for the season so far.
season_end_year integer sdv season key: the END year of the season (2026 = 2025-26), derived from season_year (a START year for the NBL and WNBL from 1998-99, a calendar year for NBL1 and the 1979-1997 winter seasons; year 1998 is split on the start date). Where the body carries no year it is the season asked for.

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_by_id(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_box(), nbl_rosetta_match_player_period_box(), nbl_rosetta_match_team_box(), nbl_rosetta_matches(), nbl_rosetta_next_match(), nbl_rosetta_next_match_team(), nbl_rosetta_next_matches(), nbl_rosetta_outcomes(), nbl_rosetta_player_stats(), nbl_rosetta_players(), nbl_rosetta_seasons(), nbl_rosetta_seasons_current(), nbl_rosetta_standings(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_players(), nbl_rosetta_team_stats(), nbl_rosetta_team_stats_leaders(), nbl_rosetta_teams()


NBL Rosetta Player Stats

Description

A player's season totals and averages for every season, by period.

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/{org}/statistics/for/player/{player_id}⁠

Usage

nbl_rosetta_player_stats(player_id, org = "wnbl")

Arguments

player_id

(character required): Player id: the DataCore person id (player_id of nbl_rosetta_players) or Rosetta's own id; either is accepted.

org

(character default "wnbl", the women's WNBL): Organisation: nbl (men's NBL), wnbl (women's) or nbl1 (the second tier, men's and women's conferences). One of "nbl", "wnbl", "nbl1".

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

Value

A wehoop_data tibble (one row per season and period):

col_name type description
org character Organisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
assists_average double Assists per game.
blocks_average double Blocks per game.
field_goals_attempted integer Field goals attempted, season total.
field_goals_made integer Field goals made, season total.
field_goals_attempted_average double Field goals attempted per game.
field_goals_made_average double Field goals made per game.
field_goals_percentage double Field goals made / attempted, a 0-1 FRACTION.
fouls_average double Fouls committed (personal + technical + others) per game.
free_throws_attempted integer Free throws attempted, season total.
free_throws_made integer Free throws made, season total.
free_throws_attempted_average double Free throws attempted per game.
free_throws_made_average double Free throws made per game.
free_throws_percentage double Free throws made / attempted, a 0-1 FRACTION.
games integer Games played in the season (in the period rows, by the player or team).
games_started integer Games in the starting five.
offensive_rebounds integer Offensive rebounds, season total.
fouls integer Fouls committed (personal + technical + others), season total.
personal_fouls integer Personal fouls, season total.
technical_fouls integer Technical fouls, season total.
period integer Period as a STRING: 0 = game or season total, 1-4 = quarters, 11/12/13 = first/second/third overtime (inferred: fewer teams have each)
three_points_attempted integer Three-point field goals attempted, season total.
three_points_attempted_average double Three-point field goals attempted per game.
three_points_made integer Three-point field goals made, season total.
three_points_made_average double Three-point field goals made per game.
three_points_percentage double Three-point field goals made / attempted, a 0-1 FRACTION.
turnovers_average double Turnovers per game.
turnovers integer Turnovers, season total.
two_points_attempted integer Two-point field goals attempted, season total.
two_points_attempted_average double Two-point field goals attempted per game.
two_points_made integer Two-point field goals made, season total.
two_points_made_average double Two-point field goals made per game.
two_points_percentage double Two-point field goals made / attempted, a 0-1 FRACTION.
minutes double Minutes played, decimal minutes.
minutes_average double Minutes per game, decimal minutes.
points integer Points, season total.
rebounds integer Total rebounds, season total.
assists integer Assists, season total.
blocks integer Blocks, season total.
steals integer Steals, season total.
plus_minus integer Point differential while on court, season total.
plus_minus_average double Point differential while on court per game.
efficiency integer Efficiency rating (PTS + REB + AST + STL + BLK - missed FG - missed FT - TOV), season total.
efficiency_average double Efficiency rating (PTS + REB + AST + STL + BLK - missed FG - missed FT - TOV) per game.
points_average double Points per game.
rebounds_average double Total rebounds per game.
steals_average double Steals per game.
player_id character DataCore id (UUID v1, Sportradar) of the player; stable across seasons and the id to join on across routes.
rosetta_player_id character Rosetta's own id (UUID v4; v5 on NBL1) of the player; routes that take this entity accept it as well as the DataCore id.
player_first_name character The player's given name, e.g. Elijah.
player_jersey_number character Jersey number, a STRING.
player_last_name character The player's family name, e.g. Pepper.
player_playing_position character Playing position code (G, F, C, PG, SF, FC, ...); null when not recorded.
team_id character DataCore id (UUID v1, Sportradar) of the team; stable across seasons and the id to join on across routes.
rosetta_team_id character Rosetta's own id (UUID v4; v5 on NBL1) of the team; routes that take this entity accept it as well as the DataCore id.
team_name character Name of the team as Rosetta spells it, e.g. Perth Wildcats.
team_code character Team code, e.g. PER (the {team_code} path value)
season_id character DataCore id (UUID v1, Sportradar) of the season; stable across seasons and the id to join on across routes.
rosetta_season_id character Rosetta's own id (UUID v4; v5 on NBL1) of the season; routes that take this entity accept it as well as the DataCore id.
season_year integer Rosetta's year of the season: the START year for the NBL and WNBL from 1998-99 (2025 = 2025-26), the calendar year for NBL1 and the 1979-1997 winter seasons. See season_end_year for the sdv key.
season_type character Season type: regular (includes finals), preseason, in_season (cups, blitz, exhibition), test.
season_competition_division character NBL1 divisions (conference x gender); empty for NBL and WNBL.
sc_total_score integer SuperCoach score including double-double / triple-double bonuses.
sc_total_score_without_dd_and_td integer SuperCoach score without those bonuses.
sc_breakdown_points_value integer The stat's value for the game or season.
sc_breakdown_points_points integer SuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_rebounds_value integer The stat's value for the game or season.
sc_breakdown_rebounds_points integer SuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_assists_value integer The stat's value for the game or season.
sc_breakdown_assists_points integer SuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_blocks_value integer The stat's value for the game or season.
sc_breakdown_blocks_points integer SuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_steals_value integer The stat's value for the game or season.
sc_breakdown_steals_points integer SuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_turnovers_value integer The stat's value for the game or season.
sc_breakdown_turnovers_points integer SuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_triple_double_value integer The stat's value for the game or season.
sc_breakdown_triple_double_points integer SuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_double_figure_count integer Stats in double figures (for the double-double / triple-double bonus)
season_end_year integer sdv season key: the END year of the season (2026 = 2025-26), derived from season_year (a START year for the NBL and WNBL from 1998-99, a calendar year for NBL1 and the 1979-1997 winter seasons; year 1998 is split on the start date). Where the body carries no year it is the season asked for.
sc_breakdown_double_double_value integer The stat's value for the game or season.
sc_breakdown_double_double_points integer SuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
season_start_date character First day of the season, ISO date-time without offset.
player_full_name character Given and family name.
player_active logical Player record is active.
player_date_of_birth character Date of birth, ISO date.
player_nationality character Unobserved in samples (null in every capture); type and meaning unverified.
player_height double Height in centimetres.
player_weight double Unobserved in samples (null in every capture); type and meaning unverified.
team_gender character Gender (MALE/FEMALE upper case on seasons and players, male/female lower case on competitions and divisions; UNKNOWN seen)
synthetic_from_roster logical Row built from the roster because the player has no season statistics (all stats 0)

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_by_id(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_box(), nbl_rosetta_match_player_period_box(), nbl_rosetta_match_team_box(), nbl_rosetta_matches(), nbl_rosetta_next_match(), nbl_rosetta_next_match_team(), nbl_rosetta_next_matches(), nbl_rosetta_outcomes(), nbl_rosetta_player_game_log(), nbl_rosetta_players(), nbl_rosetta_seasons(), nbl_rosetta_seasons_current(), nbl_rosetta_standings(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_players(), nbl_rosetta_team_stats(), nbl_rosetta_team_stats_leaders(), nbl_rosetta_teams()

Examples

try(nbl_rosetta_player_stats(org = "nbl", player_id = "7619d3ea-410d-11f0-9235-2902fc2f936f"))

NBL Rosetta Players

Description

Roster rows of every team in a season: player bio, jersey, position and team.

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/{org}/players/in/season/{season}⁠

Usage

nbl_rosetta_players(season, org = "wnbl", limit = NULL, offset = NULL)

Arguments

season

(integer required): Season END year (2026 = 2025-26). The runtime maps it to Rosetta's year: the START year for the NBL and WNBL from 1998-99, the calendar year for NBL1 and the NBL / WNBL winter seasons up to 1998. END 1998 and 1999 both read Rosetta year 1998, which holds two seasons; the matches frame keeps the one asked for.

org

(character default "wnbl", the women's WNBL): Organisation: nbl (men's NBL), wnbl (women's) or nbl1 (the second tier, men's and women's conferences). One of "nbl", "wnbl", "nbl1".

limit

(integer default NULL): Rows to return. Omitted = a page large enough for the whole list (a short page cut by Rosetta's path cache is refused).

offset

(integer default NULL): Rows to skip. Pages can overlap, so prefer one large limit.

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

Value

A wehoop_data tibble (one row per roster entry):

col_name type description
org character Organisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
jersey_number character Jersey number, a STRING.
playing_position character Playing position code (G, F, C, PG, SF, FC, ...); null when not recorded.
player_id character DataCore id (UUID v1, Sportradar) of the player; stable across seasons and the id to join on across routes.
rosetta_player_id character Rosetta's own id (UUID v4; v5 on NBL1) of the player; routes that take this entity accept it as well as the DataCore id.
player_date_updated character Record last-edit time, ISO 8601 UTC.
player_first_name character The player's given name, e.g. Elijah.
player_last_name character The player's family name, e.g. Pepper.
player_date_of_birth character Date of birth, ISO date.
player_height double Height in centimetres.
player_weight double Weight in kilograms.
player_dominant_hand character Unobserved in samples (null in every capture); type and meaning unverified.
player_gender character Gender (MALE/FEMALE upper case on seasons and players, male/female lower case on competitions and divisions; UNKNOWN seen)
player_nationality character Unobserved in samples (null in every capture); type and meaning unverified.
player_nationality_code character Nationality, ISO 3166-1 alpha-3 code.
player_dominant_foot character Unobserved in samples (null in every capture); type and meaning unverified.
player_jersey_number character Jersey number, a STRING.
player_playing_position character Playing position code (G, F, C, PG, SF, FC, ...); null when not recorded.
player_active logical Player record is active.
player_league character Rosetta league record id, UUID v4.
player_birthplace character Unobserved in samples (null in every capture); type and meaning unverified.
player_rookie_year character Unobserved in samples (null in every capture); type and meaning unverified.
player_person character Unobserved in samples (null in every capture); type and meaning unverified.
player_latest_jersey_number character Player's most recent jersey number, a STRING.
player_full_name character Given and family name.
player_source_updated_at character Unobserved in samples (null in every capture); type and meaning unverified.
player_source_provider character Unobserved in samples (null in every capture); type and meaning unverified.
team_id character DataCore id (UUID v1, Sportradar) of the team; stable across seasons and the id to join on across routes.
rosetta_team_id character Rosetta's own id (UUID v4; v5 on NBL1) of the team; routes that take this entity accept it as well as the DataCore id.
team_code character Team code, e.g. PER (the {team_code} path value)
team_name character Name of the team as Rosetta spells it, e.g. Perth Wildcats.
season_competition_division character NBL1 divisions (conference x gender); empty for NBL and WNBL.
season_end_year integer sdv season key: the END year of the season (2026 = 2025-26), derived from season_year (a START year for the NBL and WNBL from 1998-99, a calendar year for NBL1 and the 1979-1997 winter seasons; year 1998 is split on the start date). Where the body carries no year it is the season asked for.

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_by_id(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_box(), nbl_rosetta_match_player_period_box(), nbl_rosetta_match_team_box(), nbl_rosetta_matches(), nbl_rosetta_next_match(), nbl_rosetta_next_match_team(), nbl_rosetta_next_matches(), nbl_rosetta_outcomes(), nbl_rosetta_player_game_log(), nbl_rosetta_player_stats(), nbl_rosetta_seasons(), nbl_rosetta_seasons_current(), nbl_rosetta_standings(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_players(), nbl_rosetta_team_stats(), nbl_rosetta_team_stats_leaders(), nbl_rosetta_teams()

Examples

try(nbl_rosetta_players(org = "nbl", season = 2026))

NBL Rosetta Seasons

Description

Every season of an organisation: regular, preseason, in-season cups and test seasons, with dates.

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/{org}/seasons⁠

Usage

nbl_rosetta_seasons(org = "wnbl", limit = NULL)

Arguments

org

(character default "wnbl", the women's WNBL): Organisation: nbl (men's NBL), wnbl (women's) or nbl1 (the second tier, men's and women's conferences). One of "nbl", "wnbl", "nbl1".

limit

(integer default NULL): Rows to return. Omitted = a page large enough for the whole list (a short page cut by Rosetta's path cache is refused).

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

Value

A wehoop_data tibble (one row per season):

col_name type description
org character Organisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
season_id character DataCore season id (UUID v1); accepted as {season_id}.
rosetta_season_id character Rosetta season id (UUID v4; v5 on NBL1); the {season_id} route key.
name character Season name as Rosetta spells it (NBL26, WNBL 2024/25, 2025 South Men); names drift, key on season_year.
season_year integer Rosetta's year of the season: the START year for the NBL and WNBL from 1998-99 (2025 = 2025-26), the calendar year for NBL1 and the 1979-1997 winter seasons. See season_end_year for the sdv key.
season_type character Season type: regular (includes finals), preseason, in_season (cups, blitz, exhibition), test.
start_date character First day of the season, ISO date-time without offset.
end_date character Last day of the season, ISO date-time without offset; null on older seasons.
competition_league_name character Name of the league the season's competition belongs to (NBL, WNBL or NBL1).
competition_division character NBL1 divisions (conference x gender); empty for NBL and WNBL.
season_end_year integer sdv season key: the END year of the season (2026 = 2025-26), derived from season_year (a START year for the NBL and WNBL from 1998-99, a calendar year for NBL1 and the 1979-1997 winter seasons; year 1998 is split on the start date). Where the body carries no year it is the season asked for.

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_by_id(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_box(), nbl_rosetta_match_player_period_box(), nbl_rosetta_match_team_box(), nbl_rosetta_matches(), nbl_rosetta_next_match(), nbl_rosetta_next_match_team(), nbl_rosetta_next_matches(), nbl_rosetta_outcomes(), nbl_rosetta_player_game_log(), nbl_rosetta_player_stats(), nbl_rosetta_players(), nbl_rosetta_seasons_current(), nbl_rosetta_standings(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_players(), nbl_rosetta_team_stats(), nbl_rosetta_team_stats_leaders(), nbl_rosetta_teams()

Examples

try(nbl_rosetta_seasons(org = "nbl"))

NBL Rosetta Seasons Current

Description

The season in progress (empty between seasons: wehoop_no_data).

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/{org}/seasons/current⁠

Usage

nbl_rosetta_seasons_current(org = "wnbl")

Arguments

org

(character default "wnbl", the women's WNBL): Organisation: nbl (men's NBL), wnbl (women's) or nbl1 (the second tier, men's and women's conferences). One of "nbl", "wnbl", "nbl1".

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

Value

A wehoop_data tibble (one row: the season in progress):

col_name type description
org character Organisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
season_id character DataCore season id (UUID v1); accepted as {season_id}.
rosetta_season_id character Rosetta season id (UUID v4; v5 on NBL1); the {season_id} route key.
name character Season name as Rosetta spells it (NBL26, WNBL 2024/25); names drift, key on season_year.
season_year integer Rosetta's year of the season: the START year for the NBL and WNBL from 1998-99 (2025 = 2025-26), the calendar year for NBL1 and the 1979-1997 winter seasons. See season_end_year for the sdv key.
season_type character Season type: regular (includes finals), preseason, in_season (cups, blitz, exhibition), test.
start_date character First day of the season, ISO date-time without offset.
end_date character Last day of the season, ISO date-time without offset; null on older seasons.
competition_name character Name of the competition the season belongs to (e.g. NBL).
competition_age_group character Unobserved in samples (null in every capture); type and meaning unverified.
next_match_start_datetime character Tip-off of the season's next match, UTC; null when none.
season_end_year integer sdv season key: the END year of the season (2026 = 2025-26), derived from season_year (a START year for the NBL and WNBL from 1998-99, a calendar year for NBL1 and the 1979-1997 winter seasons; year 1998 is split on the start date). Where the body carries no year it is the season asked for.

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_by_id(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_box(), nbl_rosetta_match_player_period_box(), nbl_rosetta_match_team_box(), nbl_rosetta_matches(), nbl_rosetta_next_match(), nbl_rosetta_next_match_team(), nbl_rosetta_next_matches(), nbl_rosetta_outcomes(), nbl_rosetta_player_game_log(), nbl_rosetta_player_stats(), nbl_rosetta_players(), nbl_rosetta_seasons(), nbl_rosetta_standings(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_players(), nbl_rosetta_team_stats(), nbl_rosetta_team_stats_leaders(), nbl_rosetta_teams()

Examples

try(nbl_rosetta_seasons_current(org = "nbl"))

NBL Rosetta Standings

Description

Regular-season ladder: position, record, points for and against, home and away splits and form.

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/{org}/standings/{season}/regular⁠

Usage

nbl_rosetta_standings(season, org = "wnbl", limit = NULL)

Arguments

season

(integer required): Season END year (2026 = 2025-26). The runtime maps it to Rosetta's year: the START year for the NBL and WNBL from 1998-99, the calendar year for NBL1 and the NBL / WNBL winter seasons up to 1998. END 1998 and 1999 both read Rosetta year 1998, which holds two seasons; the matches frame keeps the one asked for.

org

(character default "wnbl", the women's WNBL): Organisation: nbl (men's NBL), wnbl (women's) or nbl1 (the second tier, men's and women's conferences). One of "nbl", "wnbl", "nbl1".

limit

(integer default NULL): Rows to return. Omitted = a page large enough for the whole list (a short page cut by Rosetta's path cache is refused).

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

Value

A wehoop_data tibble (one row per ladder entry):

col_name type description
org character Organisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
rosetta_standing_id character Rosetta's id of this ladder row (UUID v4); not an entity id.
position integer Ladder position (1 = top)
won integer Wins in the season.
lost integer Losses in the season.
played integer Games played in the season (wins plus losses).
points_percentage double points_for / points_against, a RATIO (1.1379 = 113.79 %)
win_percentage double Won / played, a 0-1 FRACTION.
last_5 character Results string, W/L oldest first. Despite the name it can hold the whole season (33 characters in NBL 2025-26)
streak integer Current streak length (the type is the last letter of last_5)
points_for integer Points scored by the team in the season.
points_against integer Points conceded.
away_losses integer Away losses in the season.
away_wins integer Away wins in the season.
home_losses integer Home losses in the season.
home_wins integer Home wins in the season.
team_id character DataCore id (UUID v1, Sportradar) of the team; stable across seasons and the id to join on across routes.
rosetta_team_id character Rosetta's own id (UUID v4; v5 on NBL1) of the team; routes that take this entity accept it as well as the DataCore id.
team_code character Team code, e.g. PER (the {team_code} path value)
team_name character Name of the team as Rosetta spells it, e.g. Perth Wildcats.
season_year integer Rosetta's year of the season: the START year for the NBL and WNBL from 1998-99 (2025 = 2025-26), the calendar year for NBL1 and the 1979-1997 winter seasons. See season_end_year for the sdv key.
season_type character Season type: regular (includes finals), preseason, in_season (cups, blitz, exhibition), test.
season_competition_division character NBL1 divisions (conference x gender); empty for NBL and WNBL.
season_end_year integer sdv season key: the END year of the season (2026 = 2025-26), derived from season_year (a START year for the NBL and WNBL from 1998-99, a calendar year for NBL1 and the 1979-1997 winter seasons; year 1998 is split on the start date). Where the body carries no year it is the season asked for.

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_by_id(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_box(), nbl_rosetta_match_player_period_box(), nbl_rosetta_match_team_box(), nbl_rosetta_matches(), nbl_rosetta_next_match(), nbl_rosetta_next_match_team(), nbl_rosetta_next_matches(), nbl_rosetta_outcomes(), nbl_rosetta_player_game_log(), nbl_rosetta_player_stats(), nbl_rosetta_players(), nbl_rosetta_seasons(), nbl_rosetta_seasons_current(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_players(), nbl_rosetta_team_stats(), nbl_rosetta_team_stats_leaders(), nbl_rosetta_teams()

Examples

try(nbl_rosetta_standings(org = "nbl", season = 2026))

NBL Rosetta Stats Leaders

Description

Player season totals and averages of a season (the leaderboard), one row per player and period.

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/{org}/stats/leaders/for/season/id/{season_id}⁠

Usage

nbl_rosetta_stats_leaders(season_id, org = "wnbl", limit = NULL)

Arguments

season_id

(character required): Season id: the DataCore season id (season_id of nbl_rosetta_seasons) or Rosetta's own id (rosetta_season_id); either is accepted. Not the year.

org

(character default "wnbl", the women's WNBL): Organisation: nbl (men's NBL), wnbl (women's) or nbl1 (the second tier, men's and women's conferences). One of "nbl", "wnbl", "nbl1".

limit

(integer default NULL): Rows to return. Omitted = a page large enough for the whole list (a short page cut by Rosetta's path cache is refused).

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

 nbl_rosetta_stats_leaders(org = "nbl", season_id = "1f8e4a79-e98b-457b-85a5-e4b898c6c0bd")

Value

A wehoop_data tibble (one row per player and period):

col_name type description
org character Organisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
assists_average double Assists per game.
blocks_average double Blocks per game.
field_goals_attempted integer Field goals attempted, season total.
field_goals_made integer Field goals made, season total.
field_goals_attempted_average double Field goals attempted per game.
field_goals_made_average double Field goals made per game.
field_goals_percentage double Field goals made / attempted, a 0-1 FRACTION.
fouls_average double Fouls committed (personal + technical + others) per game.
free_throws_attempted integer Free throws attempted, season total.
free_throws_made integer Free throws made, season total.
free_throws_attempted_average double Free throws attempted per game.
free_throws_made_average double Free throws made per game.
free_throws_percentage double Free throws made / attempted, a 0-1 FRACTION.
games integer Games played in the season (in the period rows, by the player or team).
games_started integer Games in the starting five.
offensive_rebounds integer Offensive rebounds, season total.
fouls integer Fouls committed (personal + technical + others), season total.
personal_fouls integer Personal fouls, season total.
technical_fouls integer Technical fouls, season total.
period integer Period as a STRING: 0 = game or season total, 1-4 = quarters, 11/12/13 = first/second/third overtime (inferred: fewer teams have each)
three_points_attempted integer Three-point field goals attempted, season total.
three_points_attempted_average double Three-point field goals attempted per game.
three_points_made integer Three-point field goals made, season total.
three_points_made_average double Three-point field goals made per game.
three_points_percentage double Three-point field goals made / attempted, a 0-1 FRACTION.
turnovers_average double Turnovers per game.
turnovers integer Turnovers, season total.
two_points_attempted integer Two-point field goals attempted, season total.
two_points_attempted_average double Two-point field goals attempted per game.
two_points_made integer Two-point field goals made, season total.
two_points_made_average double Two-point field goals made per game.
two_points_percentage double Two-point field goals made / attempted, a 0-1 FRACTION.
minutes double Minutes played, decimal minutes.
minutes_average double Minutes per game, decimal minutes.
points integer Points, season total.
rebounds integer Total rebounds, season total.
assists integer Assists, season total.
blocks integer Blocks, season total.
steals integer Steals, season total.
plus_minus integer Point differential while on court, season total.
plus_minus_average double Point differential while on court per game.
efficiency integer Efficiency rating (PTS + REB + AST + STL + BLK - missed FG - missed FT - TOV), season total.
efficiency_average double Efficiency rating (PTS + REB + AST + STL + BLK - missed FG - missed FT - TOV) per game.
points_average double Points per game.
rebounds_average double Total rebounds per game.
steals_average double Steals per game.
player_id character DataCore id (UUID v1, Sportradar) of the player; stable across seasons and the id to join on across routes.
rosetta_player_id character Rosetta's own id (UUID v4; v5 on NBL1) of the player; routes that take this entity accept it as well as the DataCore id.
player_first_name character The player's given name, e.g. Elijah.
player_jersey_number character Jersey number, a STRING.
player_last_name character The player's family name, e.g. Pepper.
player_playing_position character Playing position code (G, F, C, PG, SF, FC, ...); null when not recorded.
team_id character DataCore id (UUID v1, Sportradar) of the team; stable across seasons and the id to join on across routes.
rosetta_team_id character Rosetta's own id (UUID v4; v5 on NBL1) of the team; routes that take this entity accept it as well as the DataCore id.
team_name character Name of the team as Rosetta spells it, e.g. Perth Wildcats.
team_code character Team code, e.g. PER (the {team_code} path value)
season_id character DataCore id (UUID v1, Sportradar) of the season; stable across seasons and the id to join on across routes.
rosetta_season_id character Rosetta's own id (UUID v4; v5 on NBL1) of the season; routes that take this entity accept it as well as the DataCore id.
season_year integer Rosetta's year of the season: the START year for the NBL and WNBL from 1998-99 (2025 = 2025-26), the calendar year for NBL1 and the 1979-1997 winter seasons. See season_end_year for the sdv key.
season_type character Season type: regular (includes finals), preseason, in_season (cups, blitz, exhibition), test.
season_competition_division character NBL1 divisions (conference x gender); empty for NBL and WNBL.
sc_total_score integer SuperCoach score including double-double / triple-double bonuses.
sc_total_score_without_dd_and_td integer SuperCoach score without those bonuses.
sc_breakdown_points_value integer The stat's value for the game or season.
sc_breakdown_points_points integer SuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_rebounds_value integer The stat's value for the game or season.
sc_breakdown_rebounds_points integer SuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_assists_value integer The stat's value for the game or season.
sc_breakdown_assists_points integer SuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_blocks_value integer The stat's value for the game or season.
sc_breakdown_blocks_points integer SuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_steals_value integer The stat's value for the game or season.
sc_breakdown_steals_points integer SuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_turnovers_value integer The stat's value for the game or season.
sc_breakdown_turnovers_points integer SuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_triple_double_value integer The stat's value for the game or season.
sc_breakdown_triple_double_points integer SuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_double_figure_count integer Stats in double figures (for the double-double / triple-double bonus)
season_end_year integer sdv season key: the END year of the season (2026 = 2025-26), derived from season_year (a START year for the NBL and WNBL from 1998-99, a calendar year for NBL1 and the 1979-1997 winter seasons; year 1998 is split on the start date). Where the body carries no year it is the season asked for.

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_by_id(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_box(), nbl_rosetta_match_player_period_box(), nbl_rosetta_match_team_box(), nbl_rosetta_matches(), nbl_rosetta_next_match(), nbl_rosetta_next_match_team(), nbl_rosetta_next_matches(), nbl_rosetta_outcomes(), nbl_rosetta_player_game_log(), nbl_rosetta_player_stats(), nbl_rosetta_players(), nbl_rosetta_seasons(), nbl_rosetta_seasons_current(), nbl_rosetta_standings(), nbl_rosetta_team_players(), nbl_rosetta_team_stats(), nbl_rosetta_team_stats_leaders(), nbl_rosetta_teams()


NBL Rosetta Team Players

Description

Roster of one team in a season: player bio, jersey and position.

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/{org}/players/for/team/{team_id}/in/season/{season}⁠

Usage

nbl_rosetta_team_players(team_id, season, org = "wnbl")

Arguments

team_id

(character required): Team id: the DataCore id (team_id of nbl_rosetta_teams) or Rosetta's own id; either is accepted.

season

(integer required): Season END year (2026 = 2025-26). The runtime maps it to Rosetta's year: the START year for the NBL and WNBL from 1998-99, the calendar year for NBL1 and the NBL / WNBL winter seasons up to 1998. END 1998 and 1999 both read Rosetta year 1998, which holds two seasons; the matches frame keeps the one asked for.

org

(character default "wnbl", the women's WNBL): Organisation: nbl (men's NBL), wnbl (women's) or nbl1 (the second tier, men's and women's conferences). One of "nbl", "wnbl", "nbl1".

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

 nbl_rosetta_team_players(
   org = "nbl", season = 2026, team_id = "befee10a-410c-11f0-b3f4-1b3c55488bbb"
 )

Value

A wehoop_data tibble (one row per roster entry):

col_name type description
org character Organisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
jersey_number character Jersey number, a STRING.
playing_position character Playing position code (G, F, C, PG, SF, FC, ...); null when not recorded.
team_id character DataCore id (UUID v1, Sportradar) of the team; stable across seasons and the id to join on across routes.
rosetta_team_id character Rosetta's own id (UUID v4; v5 on NBL1) of the team; routes that take this entity accept it as well as the DataCore id.
team_name character Name of the team as Rosetta spells it, e.g. Perth Wildcats.
team_code character Team code, e.g. PER (the {team_code} path value)
team_gender character Gender (MALE/FEMALE upper case on seasons and players, male/female lower case on competitions and divisions; UNKNOWN seen)
player_id character DataCore id (UUID v1, Sportradar) of the player; stable across seasons and the id to join on across routes.
rosetta_player_id character Rosetta's own id (UUID v4; v5 on NBL1) of the player; routes that take this entity accept it as well as the DataCore id.
player_first_name character The player's given name, e.g. Elijah.
player_last_name character The player's family name, e.g. Pepper.
player_full_name character Given and family name.
player_jersey_number character Jersey number, a STRING.
player_playing_position character Playing position code (G, F, C, PG, SF, FC, ...); null when not recorded.
player_active logical Player record is active.
player_date_of_birth character Date of birth, ISO date.
player_nationality character Unobserved in samples (null in every capture); type and meaning unverified.
player_height double Height in centimetres.
player_weight double Weight in kilograms.
player_dominant_hand character Unobserved in samples (null in every capture); type and meaning unverified.
player_gender character Gender (MALE/FEMALE upper case on seasons and players, male/female lower case on competitions and divisions; UNKNOWN seen)
player_nationality_code character Nationality, ISO 3166-1 alpha-3 code.
player_birthplace character Unobserved in samples (null in every capture); type and meaning unverified.
player_rookie_year character Unobserved in samples (null in every capture); type and meaning unverified.
season_end_year integer sdv season key: the END year of the season (2026 = 2025-26), derived from season_year (a START year for the NBL and WNBL from 1998-99, a calendar year for NBL1 and the 1979-1997 winter seasons; year 1998 is split on the start date). Where the body carries no year it is the season asked for.

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_by_id(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_box(), nbl_rosetta_match_player_period_box(), nbl_rosetta_match_team_box(), nbl_rosetta_matches(), nbl_rosetta_next_match(), nbl_rosetta_next_match_team(), nbl_rosetta_next_matches(), nbl_rosetta_outcomes(), nbl_rosetta_player_game_log(), nbl_rosetta_player_stats(), nbl_rosetta_players(), nbl_rosetta_seasons(), nbl_rosetta_seasons_current(), nbl_rosetta_standings(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_stats(), nbl_rosetta_team_stats_leaders(), nbl_rosetta_teams()


NBL Rosetta Team Stats

Description

Team season totals and averages by period (0 = whole game, 1-4 quarters, 5 and up overtime).

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/{org}/team/stats/for/season/{season}/regular⁠

Usage

nbl_rosetta_team_stats(season, org = "wnbl", limit = NULL)

Arguments

season

(integer required): Season END year (2026 = 2025-26). The runtime maps it to Rosetta's year: the START year for the NBL and WNBL from 1998-99, the calendar year for NBL1 and the NBL / WNBL winter seasons up to 1998. END 1998 and 1999 both read Rosetta year 1998, which holds two seasons; the matches frame keeps the one asked for.

org

(character default "wnbl", the women's WNBL): Organisation: nbl (men's NBL), wnbl (women's) or nbl1 (the second tier, men's and women's conferences). One of "nbl", "wnbl", "nbl1".

limit

(integer default NULL): Rows to return. Omitted = a page large enough for the whole list (a short page cut by Rosetta's path cache is refused).

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

 nbl_rosetta_team_stats(org = "nbl", season = 2026)

Value

A wehoop_data tibble (one row per team and period):

col_name type description
org character Organisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
assists integer Assists, team season total (in that period on period rows)
assists_average double Assists per game.
blocks integer Blocks, team season total (in that period on period rows)
blocks_average double Blocks per game.
defensive_rebounds integer Defensive rebounds, team season total (in that period on period rows)
field_goals_attempted integer Field goals attempted, team season total (in that period on period rows)
field_goals_attempted_average double Field goals attempted per game.
field_goals_made integer Field goals made, team season total (in that period on period rows)
field_goals_made_average double Field goals made per game.
field_goals_percentage double Field goals made / attempted, a 0-1 FRACTION.
fouls integer Fouls committed (personal + technical + others), team season total (in that period on period rows)
fouls_average double Fouls committed (personal + technical + others) per game.
free_throws_attempted integer Free throws attempted, team season total (in that period on period rows)
free_throws_attempted_average double Free throws attempted per game.
free_throws_made integer Free throws made, team season total (in that period on period rows)
free_throws_made_average double Free throws made per game.
free_throws_percentage double Free throws made / attempted, a 0-1 FRACTION.
games integer Games played in the season (in the period rows, by the player or team).
minutes double Player-minutes played (5 x game minutes)
offensive_rebounds integer Offensive rebounds, team season total (in that period on period rows)
offensive_rebounds_average double Offensive rebounds per game.
period integer Period as a STRING: 0 = game or season total, 1-4 = quarters, 11/12/13 = first/second/third overtime (inferred: fewer teams have each)
personal_fouls_average double Personal fouls per game.
points integer Points, team season total (in that period on period rows)
points_average double Points per game.
rebounds integer Total rebounds, team season total (in that period on period rows)
rebounds_average double Total rebounds per game.
results_string character Unobserved in samples (null in every capture); type and meaning unverified.
steals integer Steals, team season total (in that period on period rows)
steals_average double Steals per game.
three_points_attempted integer Three-point field goals attempted, team season total (in that period on period rows)
three_points_attempted_average double Three-point field goals attempted per game.
three_points_made integer Three-point field goals made, team season total (in that period on period rows)
three_points_made_average double Three-point field goals made per game.
three_points_percentage double Three-point field goals made / attempted, a 0-1 FRACTION.
turnovers integer Turnovers, team season total (in that period on period rows)
turnovers_average double Turnovers per game.
two_points_attempted integer Two-point field goals attempted, team season total (in that period on period rows)
two_points_attempted_average double Two-point field goals attempted per game.
two_points_made integer Two-point field goals made, team season total (in that period on period rows)
two_points_made_average double Two-point field goals made per game.
two_points_percentage double Two-point field goals made / attempted, a 0-1 FRACTION.
team_id character DataCore id (UUID v1, Sportradar) of the team; stable across seasons and the id to join on across routes.
rosetta_team_id character Rosetta's own id (UUID v4; v5 on NBL1) of the team; routes that take this entity accept it as well as the DataCore id.
team_name character Name of the team as Rosetta spells it, e.g. Perth Wildcats.
team_code character Team code, e.g. PER (the {team_code} path value)
season_id character DataCore id (UUID v1, Sportradar) of the season; stable across seasons and the id to join on across routes.
rosetta_season_id character Rosetta's own id (UUID v4; v5 on NBL1) of the season; routes that take this entity accept it as well as the DataCore id.
season_year integer Rosetta's year of the season: the START year for the NBL and WNBL from 1998-99 (2025 = 2025-26), the calendar year for NBL1 and the 1979-1997 winter seasons. See season_end_year for the sdv key.
season_type character Season type: regular (includes finals), preseason, in_season (cups, blitz, exhibition), test.
season_competition_division character NBL1 divisions (conference x gender); empty for NBL and WNBL.
season_end_year integer sdv season key: the END year of the season (2026 = 2025-26), derived from season_year (a START year for the NBL and WNBL from 1998-99, a calendar year for NBL1 and the 1979-1997 winter seasons; year 1998 is split on the start date). Where the body carries no year it is the season asked for.

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_by_id(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_box(), nbl_rosetta_match_player_period_box(), nbl_rosetta_match_team_box(), nbl_rosetta_matches(), nbl_rosetta_next_match(), nbl_rosetta_next_match_team(), nbl_rosetta_next_matches(), nbl_rosetta_outcomes(), nbl_rosetta_player_game_log(), nbl_rosetta_player_stats(), nbl_rosetta_players(), nbl_rosetta_seasons(), nbl_rosetta_seasons_current(), nbl_rosetta_standings(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_players(), nbl_rosetta_team_stats_leaders(), nbl_rosetta_teams()


NBL Rosetta Team Stats Leaders

Description

Player season totals of one team in a season, optionally one period and sorted.

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/{org}/stats/leaders/for/season/id/{season_id}/team/{team_code}⁠

Usage

nbl_rosetta_team_stats_leaders(
  season_id,
  team_code,
  org = "wnbl",
  limit = NULL,
  period = NULL,
  sort = NULL
)

Arguments

season_id

(character required): Season id: the DataCore season id (season_id of nbl_rosetta_seasons) or Rosetta's own id (rosetta_season_id); either is accepted. Not the year.

team_code

(character required): Team code (team_code of nbl_rosetta_teams), e.g. PER for the Perth Wildcats.

org

(character default "wnbl", the women's WNBL): Organisation: nbl (men's NBL), wnbl (women's) or nbl1 (the second tier, men's and women's conferences). One of "nbl", "wnbl", "nbl1".

limit

(integer default NULL): Rows to return. Omitted = a page large enough for the whole list (a short page cut by Rosetta's path cache is refused).

period

(integer default NULL): Period to keep: 0 = whole game, 1-4 quarters, 5 and up overtime. Sent as filter[period].

sort

(character default NULL): Sort key; a leading minus sorts descending, e.g. -points.

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

 nbl_rosetta_team_stats_leaders(
   org = "nbl", period = 0, season_id = "1f8e4a79-e98b-457b-85a5-e4b898c6c0bd",
   sort = "-points", team_code = "PER"
 )

Value

A wehoop_data tibble (one row per player and period):

col_name type description
org character Organisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
assists_average double Assists per game.
blocks_average double Blocks per game.
field_goals_attempted integer Field goals attempted, season total.
field_goals_made integer Field goals made, season total.
field_goals_attempted_average double Field goals attempted per game.
field_goals_made_average double Field goals made per game.
field_goals_percentage double Field goals made / attempted, a 0-1 FRACTION.
fouls_average double Fouls committed (personal + technical + others) per game.
free_throws_attempted integer Free throws attempted, season total.
free_throws_made integer Free throws made, season total.
free_throws_attempted_average double Free throws attempted per game.
free_throws_made_average double Free throws made per game.
free_throws_percentage double Free throws made / attempted, a 0-1 FRACTION.
games integer Games played in the season (in the period rows, by the player or team).
games_started integer Games in the starting five.
offensive_rebounds integer Offensive rebounds, season total.
fouls integer Fouls committed (personal + technical + others), season total.
personal_fouls integer Personal fouls, season total.
technical_fouls integer Technical fouls, season total.
period integer Period as a STRING: 0 = game or season total, 1-4 = quarters, 11/12/13 = first/second/third overtime (inferred: fewer teams have each)
three_points_attempted integer Three-point field goals attempted, season total.
three_points_attempted_average double Three-point field goals attempted per game.
three_points_made integer Three-point field goals made, season total.
three_points_made_average double Three-point field goals made per game.
three_points_percentage double Three-point field goals made / attempted, a 0-1 FRACTION.
turnovers_average double Turnovers per game.
turnovers integer Turnovers, season total.
two_points_attempted integer Two-point field goals attempted, season total.
two_points_attempted_average double Two-point field goals attempted per game.
two_points_made integer Two-point field goals made, season total.
two_points_made_average double Two-point field goals made per game.
two_points_percentage double Two-point field goals made / attempted, a 0-1 FRACTION.
minutes double Minutes played, decimal minutes.
minutes_average double Minutes per game, decimal minutes.
points integer Points, season total.
rebounds integer Total rebounds, season total.
assists integer Assists, season total.
blocks integer Blocks, season total.
steals integer Steals, season total.
plus_minus integer Point differential while on court, season total.
plus_minus_average double Point differential while on court per game.
efficiency integer Efficiency rating (PTS + REB + AST + STL + BLK - missed FG - missed FT - TOV), season total.
efficiency_average double Efficiency rating (PTS + REB + AST + STL + BLK - missed FG - missed FT - TOV) per game.
points_average double Points per game.
rebounds_average double Total rebounds per game.
steals_average double Steals per game.
player_id character DataCore id (UUID v1, Sportradar) of the player; stable across seasons and the id to join on across routes.
rosetta_player_id character Rosetta's own id (UUID v4; v5 on NBL1) of the player; routes that take this entity accept it as well as the DataCore id.
player_first_name character The player's given name, e.g. Elijah.
player_jersey_number character Jersey number, a STRING.
player_last_name character The player's family name, e.g. Pepper.
player_playing_position character Playing position code (G, F, C, PG, SF, FC, ...); null when not recorded.
team_id character DataCore id (UUID v1, Sportradar) of the team; stable across seasons and the id to join on across routes.
rosetta_team_id character Rosetta's own id (UUID v4; v5 on NBL1) of the team; routes that take this entity accept it as well as the DataCore id.
team_name character Name of the team as Rosetta spells it, e.g. Perth Wildcats.
team_code character Team code, e.g. PER (the {team_code} path value)
season_id character DataCore id (UUID v1, Sportradar) of the season; stable across seasons and the id to join on across routes.
rosetta_season_id character Rosetta's own id (UUID v4; v5 on NBL1) of the season; routes that take this entity accept it as well as the DataCore id.
season_year integer Rosetta's year of the season: the START year for the NBL and WNBL from 1998-99 (2025 = 2025-26), the calendar year for NBL1 and the 1979-1997 winter seasons. See season_end_year for the sdv key.
season_type character Season type: regular (includes finals), preseason, in_season (cups, blitz, exhibition), test.
season_competition_division character Always an empty array in samples; element shape and meaning unverified.
season_end_year integer sdv season key: the END year of the season (2026 = 2025-26), derived from season_year (a START year for the NBL and WNBL from 1998-99, a calendar year for NBL1 and the 1979-1997 winter seasons; year 1998 is split on the start date). Where the body carries no year it is the season asked for.

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_by_id(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_box(), nbl_rosetta_match_player_period_box(), nbl_rosetta_match_team_box(), nbl_rosetta_matches(), nbl_rosetta_next_match(), nbl_rosetta_next_match_team(), nbl_rosetta_next_matches(), nbl_rosetta_outcomes(), nbl_rosetta_player_game_log(), nbl_rosetta_player_stats(), nbl_rosetta_players(), nbl_rosetta_seasons(), nbl_rosetta_seasons_current(), nbl_rosetta_standings(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_players(), nbl_rosetta_team_stats(), nbl_rosetta_teams()


NBL Rosetta Teams

Description

Every team record of an organisation: current, defunct, exhibition and development sides.

Endpoint: ⁠GET https://prod.rosetta.nbl.com.au/get/{org}/teams⁠

Usage

nbl_rosetta_teams(org = "wnbl", limit = NULL)

Arguments

org

(character default "wnbl", the women's WNBL): Organisation: nbl (men's NBL), wnbl (women's) or nbl1 (the second tier, men's and women's conferences). One of "nbl", "wnbl", "nbl1".

limit

(integer default NULL): Rows to return. Omitted = a page large enough for the whole list (a short page cut by Rosetta's path cache is refused).

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: ⁠<entity>⁠id columns are DataCore ids (UUID v1; join on them), rosetta⁠<entity>⁠_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

Value

A wehoop_data tibble (one row per team record):

col_name type description
org character Organisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
team_id character DataCore team id (UUID v1); stable across seasons.
rosetta_team_id character Rosetta team id (UUID v4; v5 on NBL1); stable across seasons; accepted as {team_id}.
name character Team name as Rosetta spells it, e.g. Perth Wildcats.
team_code character Team code, e.g. PER (the {team_code} path value)
established character Year the club was founded; often null.
head_coach character Head coach; often null.
championships character Championships won; often null.
website character Club website URL.
external_media_competitor_id character Team id on the media/OTT service; often null.
conference character NBL1 conference of the team (name); null for NBL and WNBL teams.
division character NBL1 division of the team (name); null for NBL and WNBL teams.
venue_name character Name of the venue (arena), e.g. RAC Arena.
venue_address character Unobserved in samples (null in every capture); type and meaning unverified.
venue_state character Unobserved in samples (null in every capture); type and meaning unverified.
venue_country character Unobserved in samples (null in every capture); type and meaning unverified.
venue_timezone character IANA time zone of the venue, e.g. Australia/Sydney.
venue_latitude double Unobserved in samples (null in every capture); type and meaning unverified.
venue_longitude double Unobserved in samples (null in every capture); type and meaning unverified.
venue_capacity integer Unobserved in samples (null in every capture); type and meaning unverified.
conference_name character Name of the NBL1 conference the team plays in (e.g. North, South); null outside NBL1.
division_name character Division name (NBL1 conference + gender)

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

See Also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_by_id(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_box(), nbl_rosetta_match_player_period_box(), nbl_rosetta_match_team_box(), nbl_rosetta_matches(), nbl_rosetta_next_match(), nbl_rosetta_next_match_team(), nbl_rosetta_next_matches(), nbl_rosetta_outcomes(), nbl_rosetta_player_game_log(), nbl_rosetta_player_stats(), nbl_rosetta_players(), nbl_rosetta_seasons(), nbl_rosetta_seasons_current(), nbl_rosetta_standings(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_players(), nbl_rosetta_team_stats(), nbl_rosetta_team_stats_leaders()

Examples

try(nbl_rosetta_teams(org = "nbl"))

NBL1 (Australia) (Atrium shortcuts)

Description

Per-competition shortcuts over the Atrium embed API for NBL1 (Australia) (website_id = 3; men's and women's).

Thin bindings of the parameterised ⁠atrium_*()⁠ wrappers to this site, minted from the competition registry (sdv-py tools/codegen/basketball_competitions.yaml); the full surface stays on the ⁠atrium_*()⁠ wrappers.

Usage

nbl1_seasons(locale = NULL)
nbl1_schedule(season = NULL, season_id = NULL, competition_id = NULL, locale = NULL)
nbl1_standings(season = NULL, season_id = NULL, competition_id = NULL, locale = NULL)
nbl1_teams(season = NULL, season_id = NULL, competition_id = NULL, locale = NULL)
nbl1_player_box(fixture_id, locale = NULL)
nbl1_team_box(fixture_id, locale = NULL)
nbl1_pbp(fixture_id, locale = NULL)
nbl1_shots(fixture_id, locale = NULL)

Arguments

season

(integer optional): Season END year (season rule below). Omit season and season_id for the site's current season.

season_id

(character optional): Season UUID (season_id in the seasons listing); skips the END-year lookup.

competition_id

(character optional): Competition UUID (a site carries many: conferences, cups); needed when several share the season.

locale

(character optional): Label locale, e.g. "en-EN"; omitted = the site's own language.

fixture_id

(character required): Fixture UUID (fixture_id in the schedule).

Details

Season rule: calendar year, Mar-Aug (END year); conferences are competition_ids.

Errors and terms of use are those of atrium_fixtures(): unofficial use of the public widget endpoint, at least 1 s between requests, not republished as release assets. The site also serves women's competitions (pass their competition_id).

 nbl1_seasons()
 nbl1_schedule()

Value

A wehoop_data tibble with the columns of the base wrapper, one table per function:

nbl1_seasons()

The columns of atrium_seasons():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID; pass it as season_id to any season-scoped wrapper.
competition_id character Competition UUID; pass it as competition_id to pick one of several seasons of an END year.
competition_name character Competition name in the site's language; the same name can appear for several years.
season_name character Season name in the site's language, e.g. Betclic ELITE 2025.
abbreviation_local character Local abbreviation of the season; null in every body seen.
year integer The site's own year of the season: the START year on LNB (site 12), the calendar year elsewhere.
season_end_year integer Season END year (the sdv key): the site's year + 1 on LNB (site 12), the calendar year on the other registered sites; null when the site is unregistered, lists no seasons or the body has no season list.
is_default_season logical True for the season the body is about (the site's default when none was asked).

nbl1_schedule()

The columns of atrium_fixtures():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID the page is about (the site's default season when none was asked).
competition_id character Competition UUID of the season.
competition_name character Competition name in the site's language, e.g. Betclic ELITE or LIGA CALIENTE.MX LNBP.
season_end_year integer Season END year (the sdv key): the site's year + 1 on LNB (site 12), the calendar year on the other registered sites; null when the site is unregistered, lists no seasons or the body has no season list.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
fixture_type character Kind of game as sent: REGULAR, PLAYOFF, ... (the set is open).
name character Fixture name as the site prints it (e.g. Paris - Lyon-Villeurbanne); null on LNBP.
round character Round of the game as the site words it, e.g. Journee: 30.
round_code character Round code; null in every body seen.
pool character Pool the game belongs to; null when the competition has none.
series character Playoff series the game belongs to as sent (JSON text when an object); null outside a series.
stage_code character Opaque 30-hex stage code of the game; null in every body seen.
status character Status code of the game, e.g. CONFIRMED (final), as sent.
status_label character Status of the game as the site words it in its own language (e.g. Termine, Final).
start_time_utc POSIXct Scheduled start, naive datetime in UTC (the API sends no offset).
start_time_local character Scheduled start in the venue's local time, as the API sends it (YYYY-MM-DDTHH:MM:SS, no offset; timezone gives the zone, which varies per row).
timezone character IANA time zone of the venue (e.g. Europe/Paris, Mexico/General) that start_time_local is in.
times_unconfirmed logical True while the start time is not final.
venue character Name of the arena where the game is played.
venue_id character Venue UUID; joins no other route.
attendance integer Spectators at the game; null when not reported.
home_entity_id character Team UUID of the home team.
home_code character Short code of the home team (e.g. PAB).
home_name character Name of the home team.
home_score integer Points scored by the home team (the API sends a string; Int64 here).
home_result_place integer Result place of the home team: 1 for the winner, 2 for the loser.
home_result_status character Result status of the home team's score, e.g. CONFIRMED.
home_draw logical True when the game ended level for the home team.
home_shootout_attempts character Shootout attempts of the home team as sent (an empty string becomes null).
home_secondary_score character Secondary score of the home team (unused in the samples; shown as text).
away_entity_id character Team UUID of the away team.
away_code character Short code of the away team (e.g. PAB).
away_name character Name of the away team.
away_score integer Points scored by the away team (the API sends a string; Int64 here).
away_result_place integer Result place of the away team: 1 for the winner, 2 for the loser.
away_result_status character Result status of the away team's score, e.g. CONFIRMED.
away_draw logical True when the game ended level for the away team.
away_shootout_attempts character Shootout attempts of the away team as sent (an empty string becomes null).
away_secondary_score character Secondary score of the away team (unused in the samples; shown as text).

nbl1_standings()

The columns of atrium_standings():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID of the table.
season_end_year integer Season END year (the sdv key): the site's year + 1 on LNB (site 12), the calendar year on the other registered sites; null when the site is unregistered, lists no seasons or the body has no season list.
group character Label of the table when the standings hold several groups; null for a single table.
position integer League table position (1 = first).
entity_id character Team UUID of the row.
team_name character Team name as the site prints it.
is_current_team logical True for the team the page was opened for (team context); false on a plain standings request.
logo_url character URL of the team logo image.
wins integer Games won; -1 for two teams in the 2025-26 LNB table (an administrative ranking, unverified), kept as sent (team, this table).
losses integer Games lost (team, this table).
played integer Games played (LNBP and the compact standings) (team, this table).
standing_points integer League table points (LNBP) (team, this table).
win_percentage double Share of games won as a 0-1 fraction (not 0-100) (team, this table).
scored_for integer Points scored over the season (team, this table).
scored_against integer Points conceded over the season (team, this table).
point_difference integer Point differential over the season (team, this table).
result_string_home character Home results as a string of result letters in the site's language, one per game (order and letters per locale; unverified) (team, this table).
scored_for_home integer Points scored in home games (team, this table).
scored_against_home integer Points conceded in home games (team, this table).
point_difference_home integer Point differential in home games (team, this table).
result_string_away character Away results as a string of result letters in the site's language, one per game (order and letters per locale; unverified) (team, this table).
scored_for_away integer Points scored in away games (team, this table).
scored_against_away integer Points conceded in away games (team, this table).
point_difference_away integer Point differential in away games (team, this table).
streak integer Length of the current run of results (the win / loss sign convention is unverified) (team, this table).
streak_home integer Length of the current run of home results (sign convention unverified) (team, this table).
streak_away integer Length of the current run of away results (sign convention unverified) (team, this table).

nbl1_teams()

The columns of atrium_teams():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_id character Season UUID of the team list.
entity_id character Team UUID (entity): one id per club across seasons, shared by every site that shows the team.
name character Team name in the site's language.
image_url character URL of the Sportradar-hosted image (400 px).

nbl1_player_box()

The columns of atrium_box_score():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
entity_id character Team UUID the player is rostered with for this game.
side character Side of the game the row belongs to: home or away (from the fixture's isHome flag).
person_id character Player UUID (person), shared across seasons and sites.
person_name character Player name as the site prints it (upper case on LNBP and NBL1).
bib character Jersey number the player wears, as text.
position character Position code on the roster (LNB, e.g. PG); null on LNBP.
starter logical True when the player started the game.
active logical True when the player is on the court in a live game.
participated logical True when the player entered the game; false rows have null statistics.
did_not_play_reason character Reason the player did not play; null in every body seen.
minutes character Time played as an ISO 8601 duration (PT7M23S); a team's is the sum over its players (PT200M) (player, this game).
seconds_played integer Time played in whole seconds, parsed from minutes (player, this game).
points integer Points scored (player, this game).
rebounds integer Total rebounds (player, this game).
rebounds_offensive integer Offensive rebounds (player, this game).
rebounds_defensive integer Defensive rebounds (player, this game).
assists integer Assists (player, this game).
steals integer Steals (player, this game).
blocks integer Shots blocked (player, this game).
blocks_received integer Own shots blocked by an opponent (LNB only) (player, this game).
turnovers integer Turnovers (player, this game).
fouls_total integer Fouls committed (player, this game).
fouls_drawn integer Fouls drawn (committed against the player or team; LNBP only) (player, this game).
plus_minus integer Plus/minus, the point differential while on court (LNB only; null in some team lines) (player, this game).
efficiency integer Efficiency rating, from the site's own formula (player, this game).
field_goals_made integer Field goals made, two- and three-pointers together (LNBP only) (player, this game).
field_goals_attempted integer Field goals attempted (LNBP only) (player, this game).
field_goals_percentage double Field-goal percentage, 0-100 (LNBP only) (player, this game).
points_two_made integer Two-point field goals made (player, this game).
points_two_attempted integer Two-point field goals attempted (player, this game).
points_two_percentage double Two-point percentage, 0-100 (player, this game).
points_three_made integer Three-point field goals made (player, this game).
points_three_attempted integer Three-point field goals attempted (player, this game).
points_three_percentage double Three-point percentage, 0-100 (player, this game).
free_throws_made integer Free throws made (player, this game).
free_throws_attempted integer Free throws attempted (player, this game).
free_throws_percentage double Free-throw percentage, 0-100 (player, this game).
points_fast_break integer Fast-break points (LNBP only) (player, this game).

nbl1_team_box()

The columns of atrium_team_box_score():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
entity_id character Team UUID (from the fixture's isHome flag).
side character Side of the game the row belongs to: home or away (from the fixture's isHome flag).
minutes character Time played as an ISO 8601 duration (PT7M23S); a team's is the sum over its players (PT200M) (team, this game).
seconds_played integer Time played in whole seconds, parsed from minutes (team, this game).
points integer Points scored (team, this game).
rebounds integer Total rebounds (team, this game).
rebounds_offensive integer Offensive rebounds (team, this game).
rebounds_defensive integer Defensive rebounds (team, this game).
assists integer Assists (team, this game).
steals integer Steals (team, this game).
blocks integer Shots blocked (team, this game).
blocks_received integer Own shots blocked by an opponent (LNB only) (team, this game).
turnovers integer Turnovers (team, this game).
fouls_total integer Fouls committed (team, this game).
fouls_drawn integer Fouls drawn (committed against the player or team; LNBP only) (team, this game).
plus_minus integer Plus/minus, the point differential while on court (LNB only; null in some team lines) (team, this game).
efficiency integer Efficiency rating, from the site's own formula (team, this game).
field_goals_made integer Field goals made, two- and three-pointers together (LNBP only) (team, this game).
field_goals_attempted integer Field goals attempted (LNBP only) (team, this game).
field_goals_percentage double Field-goal percentage, 0-100 (LNBP only) (team, this game).
points_two_made integer Two-point field goals made (team, this game).
points_two_attempted integer Two-point field goals attempted (team, this game).
points_two_percentage double Two-point percentage, 0-100 (team, this game).
points_three_made integer Three-point field goals made (team, this game).
points_three_attempted integer Three-point field goals attempted (team, this game).
points_three_percentage double Three-point percentage, 0-100 (team, this game).
free_throws_made integer Free throws made (team, this game).
free_throws_attempted integer Free throws attempted (team, this game).
free_throws_percentage double Free-throw percentage, 0-100 (team, this game).
points_fast_break integer Fast-break points (LNBP only) (team, this game).
extra_fouls_total integer Fouls committed (team, credited to the team rather than a player).
extra_rebounds integer Total rebounds (team, credited to the team rather than a player).
extra_rebounds_defensive integer Defensive rebounds (team, credited to the team rather than a player).
extra_rebounds_offensive integer Offensive rebounds (team, credited to the team rather than a player).
extra_turnovers integer Turnovers (team, credited to the team rather than a player).
total_biggest_lead integer Biggest lead of the game, in points (team, game total).
total_biggest_scoring_run integer Longest unanswered scoring run of the game, in points (team, game total).
total_field_goals_percentage double Field-goal percentage, 0-100 (LNBP only) (team, game total).
total_free_throws_percentage double Free-throw percentage, 0-100 (team, game total).
total_lead_changes integer Number of lead changes in the game (team, game total).
total_points_fast_break integer Fast-break points (LNBP only) (team, game total).
total_points_from_bench integer Points scored by non-starters (LNBP only) (team, game total).
total_points_from_turnover integer Points scored off opponent turnovers (LNBP only) (team, game total).
total_time_in_lead character Time the team led, as an ISO 8601 duration (PT36M11S) (team, game total).
total_time_in_lead_seconds integer Time the team led, in whole seconds (team, game total).
total_turnovers integer Turnovers (team, game total).

nbl1_pbp()

The columns of atrium_pbp():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
sequence integer 1-based position of the event in the game (periods in order, events chronological).
event_id character Event UUID, shared with the same event in atrium_shots.
period_id integer Period number: 1-4 regulation, 11, 12, ... overtimes (not 5).
clock character Time REMAINING in the period as an ISO 8601 duration (PT10M0S at the start).
clock_seconds integer Seconds remaining in the period, parsed from clock.
entity_id character Team UUID the event is credited to.
side character Side of the game the row belongs to: home or away (from the fixture's isHome flag).
person_id character Player UUID; null for team events (time-outs, team rebounds).
person_name character Player the event is credited to; null for team events (time-outs, team rebounds).
bib character Jersey number of the player, as text; null for team events.
event_type character Event type: 2pt, 3pt, freeThrow, rebound, assist, steal, block, turnover, foul, substitution, timeOut, jumpBall, ... (language-independent).
event_sub_type character Event detail: jumpShot, layup, offensive, defensive, in, out, 1Of2, personal, ...; null when none.
description character The event's text in the site's language (e.g. Entre-deux remporte).
success logical True when a shot or free throw was made, false when missed; null for other events.
success_label character The made / missed label in the site's language; sent on shot events only.
x double Shot location along the 28 m court length as percent of the court (0-100, origin at a corner); the home team attacks the low-x basket all game; null for non-shots.
y double Shot location across the 15 m width as percent of the court (0-100); which sideline is 0 is unverified; null for non-shots.
home_score integer Home team's running score after the event.
away_score integer Away team's running score after the event.

nbl1_shots()

The columns of atrium_shots():

col_name type description
website_id integer Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_id character Game UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_id character Season UUID of the game.
sequence integer 1-based position of the shot among the shots of the game (not the pbp sequence).
event_id character Event UUID of the shot; the same event in atrium_pbp.
period_id integer Period number: 1-4 regulation, 11, 12, ... overtimes (not 5).
clock character Time REMAINING in the period as an ISO 8601 duration (PT10M0S at the start).
clock_seconds integer Seconds remaining in the period, parsed from clock.
entity_id character Team UUID the event is credited to.
side character Side of the game the row belongs to: home or away (from the fixture's isHome flag).
person_id character Player UUID of the shooter.
person_name character Name of the shooter.
bib character Jersey number of the player, as text; null for team events.
event_type character Event type: 2pt, 3pt, freeThrow, rebound, assist, steal, block, turnover, foul, substitution, timeOut, jumpBall, ... (language-independent).
event_sub_type character Event detail: jumpShot, layup, offensive, defensive, in, out, 1Of2, personal, ...; null when none.
description character The event's text in the site's language (e.g. Entre-deux remporte).
success logical True when the shot was made, false when missed.
success_label character The made / missed label in the site's language; sent on shot events only.
x double Shot location along the 28 m court length as percent of the court (0-100, origin at a corner); the home team attacks the low-x basket all game; LNBP and NBL1 clamp rim attempts to 5 / 95.
y double Shot location across the 15 m width as percent of the court (0-100); which sideline is 0 is unverified.
home_score integer Home team's running score after the event.
away_score integer Away team's running score after the event.

See Also

Other Atrium Functions: atrium_box_score(), atrium_competition_player_stats(), atrium_competition_team_stats(), atrium_end_year(), atrium_fixture(), atrium_fixture_periods(), atrium_fixtures(), atrium_fixtures_ribbon(), atrium_leaders(), atrium_pbp(), atrium_player(), atrium_player_game_log(), atrium_player_seasons(), atrium_player_stats(), atrium_players(), atrium_season_id(), atrium_seasons(), atrium_shots(), atrium_standings(), atrium_standings_summary(), atrium_team(), atrium_team_box_score(), atrium_team_stats(), atrium_teams(), lmb_competition, lnbp_competition, lpb_competition


NCAA Women's Basketball Endpoint Overview

Description

Wrappers around NCAA-side women's college basketball endpoints beyond what ESPN exposes (rankings, teams reference, etc.). All requests use the same .retry_request() HTTP layer as the rest of the package.

Details

NCAA endpoints

Function Purpose
ncaa_wbb_teams() NCAA WBB team reference
ncaa_wbb_NET_rankings() NCAA NET rankings

Resilience pattern

NCAA endpoints occasionally drop columns. The wrappers use dplyr::any_of() / dplyr::rename(any_of(c(new = "old"))) so schema drift doesn't crash the parser — see ncaa_wbb_NET_rankings() for the reference implementation.


Get Women's college basketball NET rankings for the current date from the NCAA website

Description

Get Women's college basketball NET rankings for the current date from the NCAA website

Usage

ncaa_wbb_NET_rankings()

Value

Returns a tibble

col_name types description
rank integer Whether to include statistical ranks in the returned table.
previous integer Previous.
school character Player's school / college (when distinct from 'college').
conference character Filter players or teams by conference.
record character Record string (e.g. '12-4').
road character Road.
neutral character Neutral.
home character Home.
non_div_i character Non div i.

Author(s)

Saiem Gilani

Examples

# Get current NCAA NET rankings

  try(ncaa_wbb_NET_rankings())

Scrape NCAA Women's Basketball Teams (Division I, II, and III)

Description

Scrapes the NCAA Stats per-season team list at ⁠http://stats.ncaa.org/team/inst_team_list?academic_year=YYYY&conf_id=-1&division=N&sport_code=WBB⁠. Returns one row per team for the requested season-year and division, with the per-season season_id and team_id parsed out of the stats.ncaa.org team URL.

Network access: as of v3.0.0 stats.ncaa.org is fronted by Akamai and returns HTTP 403 (Reference #18.<...>) to many residential and cloud IP ranges regardless of headers. If you hit that block, supply a proxy that egresses from a non-blocked address — pass ⁠proxy =⁠ directly via ... (forwarded to .retry_request()), or set it once with options(wehoop.proxy = list(url=, port=, username=, password=)). See the wehoop CLAUDE.md / pkgdown docs for the full proxy resolution order.

Usage

ncaa_wbb_teams(year = most_recent_wbb_season(), division = 1, ...)

Arguments

year

The season for which data should be returned, in the form of "YYYY". Years currently available: 2002 onward.

division

Division - 1, 2, or 3.

...

Forwarded to the internal .retry_request() HTTP helper. The most useful pass-through is ⁠proxy =⁠ (string "http://host:port" or named list list(url=, port=, username=, password=, auth=)); see ?.retry_request for the full set of recognized arguments.

Details

  ncaa_wbb_teams(year = 2025, division = 1)

  # Behind a proxy (per-call):
  ncaa_wbb_teams(
    year = 2025, division = 1,
    proxy = list(url = "http://my-proxy", port = 8080,
                 username = "user", password = "pass")
  )

  # Or session-wide:
  options(wehoop.proxy = list(url = "http://my-proxy", port = 8080,
                              username = "user", password = "pass"))
  ncaa_wbb_teams(year = 2025, division = 1)

Value

A data frame with the following variables

col_name types description
team_id character Franchise team id (legacy ⁠/team/{id}/...⁠ urls).
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_url character URL for team.
conference_id character Conference identifier.
conference character Filter players or teams by conference.
division numeric Team division.
year numeric 4-digit year.
season_id character Season id (legacy urls).
season_team_id character Season-team id (modern ⁠/teams/{id}⁠ urls).

WNBA Stats API Parameter Descriptions Reference table for parameters used across ⁠wnba_*()⁠ functions.

Description

WNBA Stats API Parameter Descriptions Reference table for parameters used across ⁠wnba_*()⁠ functions.

Usage

parameter_descriptions

Format

A data frame with 52 rows and 5 variables:

col_name description
parameter character. R-side argument name (snake_case).
api_name character. WNBA Stats API CamelCase parameter name.
description character. One-sentence description of the parameter.
valid_values character. Comma-separated enum values; empty string for free-form parameters.
default character. Default value as it appears in function signatures.

Load .parquet file from a remote connection

Description

Sibling of rds_from_url() for release assets published as parquet (e.g. the wnba_stats_leaguedash / nba_stats_leaguedash cube tags). 404-safe: an unpublished asset returns an empty data.table + a warning, matching rds_from_url()'s contract, instead of raising.

Usage

parquet_from_url(url)

Arguments

url

a character url

Value

a dataframe as created by arrow::read_parquet()


Progressively

Description

This function helps add progress-reporting to any function - given function f() and progressor p(), it will return a new function that calls f() and then (on-exiting) will call p() after every iteration.

Usage

progressively(f, p = NULL)

Arguments

f

a function to add progressr functionality to.

p

a progressor function as created by progressr::progressor()

Details

This is inspired by purrr's safely, quietly, and possibly function decorators.

Value

a function that does the same as f but it calls p() after iteration.


Load .rds file from a remote connection

Description

Load .rds file from a remote connection

Usage

rds_from_url(url)

Arguments

url

a character url

Value

a dataframe as created by readRDS()


Get BBL / DBBL Game

Description

One game header: teams, score by period, officials, venue and top scorer.

Endpoint: ⁠GET https://api.basketball-bundesliga.de/games/{game_id}⁠ (DBBL: the same route on ⁠https://api-1.dbbl.scb.world⁠).

Usage

scb_game(game_id, league = "dbbl")

Arguments

game_id

(required) Game id (game_id in scb_games), e.g. 2006920 (BBL) or 10130 (DBBL). One sequence per league.

league

(default "dbbl", the women's DBBL) League: bbl (men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) or dbbl (women, Toyota Damen-Basketball-Bundesliga, api-1.dbbl.scb.world). The two share one API; game ids overlap, so a game is (league, game_id).

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

Value

A wehoop_data tibble: One game header: teams, score by period, officials, venue and top scorer. An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_game):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
season integer Season END year (2026 = 2025-26), the sdv key; the API's season_id plus one.
season_id integer Season, START year (2026 = 2026-27).
game_id character Game id, a string; unique within a league only (BBL and DBBL overlap), and not chronological.
competition character Competition: BBL, BBL_CUP (Pokal), ALLSTAR, CHAMPIONS_CUP on the BBL host; DBBL, DBBL_CUP on the DBBL host.
stage character Stage: MAIN_ROUND (Hauptrunde, regular season), PLAYINS, FIRST_ROUND, SECOND_ROUND, ROUND_OF_16 (Achtelfinale), ROUND_OF_8 (Viertelfinale), SEMI_FINALS, FINALS, THIRD_PLACE_GAME, QUALIFICATION, GROUP_STAGE.
status character Game status: PRE (scheduled), LIVE, POST (ended, not yet official), OFFICIAL (final).
stat_status character Live-stats feed status code. Observed: E (ended; German Ende), N (not started), 1 (old games), empty string. Meaning inferred.
game_progress character Live progress code: E (ended), empty or null before the game. Meaning inferred.
scheduled_time character Scheduled tip-off, ISO 8601 UTC.
match_day integer Round number within the stage (Spieltag).
is_tbd logical Date or time not yet fixed.
is_hidden logical True when the API hides the game (0/1 on /games, a boolean on the header).
home_team_id character Club id; equal to seasonTeamId in every sample. Joins to ⁠/teams/{teamId}⁠.
home_season_team_id character Season-team id; equal to the club teamId in every sample (BBL 2005-2026, DBBL 2024-2026).
home_team_name character Team name as listed that season (sponsor names included, e.g. 'EWE Baskets Oldenburg').
home_tlc character Three-letter club code.
home_is_foreign logical The team is not in this league (cup opponents from the ProA / ProB).
home_rank integer The team's current table position.
home_streak character Current streak: W or L; empty when none.
home_streak_count integer Length of the current streak.
home_last10_victories integer Wins in the last 10 games.
home_last10_losses integer Losses in the last 10 games.
home_total_games integer Games the home team has played so far (the API sends it as a string).
guest_team_id character Club id; equal to seasonTeamId in every sample. Joins to ⁠/teams/{teamId}⁠.
guest_season_team_id character Season-team id; equal to the club teamId in every sample (BBL 2005-2026, DBBL 2024-2026).
guest_team_name character Team name as listed that season (sponsor names included, e.g. 'EWE Baskets Oldenburg').
guest_tlc character Three-letter club code.
guest_is_foreign logical The team is not in this league (cup opponents from the ProA / ProB).
guest_rank integer The team's current table position.
guest_streak character Current streak: W or L; empty when none.
guest_streak_count integer Length of the current streak.
guest_last10_victories integer Wins in the last 10 games.
guest_last10_losses integer Losses in the last 10 games.
guest_total_games integer Games the guest team has played so far (the API sends it as a string).
home_score integer Home team final score.
guest_score integer Guest team final score.
latest_period integer Number of the last period played (4 = Q4, 5 = OT1, ...); the API sends Q4 on /games and 4 on /games/recent. Null before the game.
spectators integer Attendance; 0 when not recorded.
home_q1_score integer Home team points in quarter 1; 0 when quarter scores were not recorded.
home_q2_score integer Home team points in quarter 2; 0 when quarter scores were not recorded.
home_q3_score integer Home team points in quarter 3; 0 when quarter scores were not recorded.
home_q4_score integer Home team points in quarter 4; 0 when quarter scores were not recorded.
home_ot1_score integer Home team points in overtime 1; 0 when not played (null from OT5 on in old seasons).
home_ot2_score integer Home team points in overtime 2; 0 when not played (null from OT5 on in old seasons).
home_ot3_score integer Home team points in overtime 3; 0 when not played (null from OT5 on in old seasons).
home_ot4_score integer Home team points in overtime 4; 0 when not played (null from OT5 on in old seasons).
home_ot5_score integer Home team points in overtime 5; 0 when not played (null from OT5 on in old seasons).
home_ot6_score integer Home team points in overtime 6; 0 when not played (null from OT5 on in old seasons).
home_ot7_score integer Home team points in overtime 7; 0 when not played (null from OT5 on in old seasons).
home_ot8_score integer Home team points in overtime 8; 0 when not played (null from OT5 on in old seasons).
home_ot9_score integer Home team points in overtime 9; 0 when not played (null from OT5 on in old seasons).
guest_q1_score integer Guest team points in quarter 1; 0 when quarter scores were not recorded.
guest_q2_score integer Guest team points in quarter 2; 0 when quarter scores were not recorded.
guest_q3_score integer Guest team points in quarter 3; 0 when quarter scores were not recorded.
guest_q4_score integer Guest team points in quarter 4; 0 when quarter scores were not recorded.
guest_ot1_score integer Guest team points in overtime 1; 0 when not played (null from OT5 on in old seasons).
guest_ot2_score integer Guest team points in overtime 2; 0 when not played (null from OT5 on in old seasons).
guest_ot3_score integer Guest team points in overtime 3; 0 when not played (null from OT5 on in old seasons).
guest_ot4_score integer Guest team points in overtime 4; 0 when not played (null from OT5 on in old seasons).
guest_ot5_score integer Guest team points in overtime 5; 0 when not played (null from OT5 on in old seasons).
guest_ot6_score integer Guest team points in overtime 6; 0 when not played (null from OT5 on in old seasons).
guest_ot7_score integer Guest team points in overtime 7; 0 when not played (null from OT5 on in old seasons).
guest_ot8_score integer Guest team points in overtime 8; 0 when not played (null from OT5 on in old seasons).
guest_ot9_score integer Guest team points in overtime 9; 0 when not played (null from OT5 on in old seasons).
referee1_id character Official id; joins to /referees refId (= its id). /referees lists only the current officials (44), so older games' officials can be missing there: all 40 of 2026-27's matched, 6 of 10 of 2008-09's.
referee1_first_name character Official's given name.
referee1_last_name character Official's family name.
referee2_id character Official id; joins to /referees refId (= its id). /referees lists only the current officials (44), so older games' officials can be missing there: all 40 of 2026-27's matched, 6 of 10 of 2008-09's.
referee2_first_name character Official's given name.
referee2_last_name character Official's family name.
referee3_id character Official id; joins to /referees refId (= its id). /referees lists only the current officials (44), so older games' officials can be missing there: all 40 of 2026-27's matched, 6 of 10 of 2008-09's.
referee3_first_name character Official's given name.
referee3_last_name character Official's family name.
commissioner_id character Official id; joins to /referees refId (= its id). /referees lists only the current officials (44), so older games' officials can be missing there: all 40 of 2026-27's matched, 6 of 10 of 2008-09's.
commissioner_first_name character Official's given name.
commissioner_last_name character Official's family name.
venue_id character Arena id, stable across seasons (Uber Arena = 2 in both 2025-26 and 2026-27); a different key space from /teams seasonVenues.id, and no captured route is keyed by it. A string in /games and ⁠/games/{gameId}⁠, an integer in /games/recent.
venue_name character Name of the arena the game is played in; venue_id is its stable arena id.
venue_address character Postal address, German.
venue_capacity integer Arena capacity, spectators.
venue_is_main logical The club's main arena.
tv_channel character TV channel(s) showing the game, comma-joined (a list on some routes, an empty string when none).
tv_type character TV coverage type; empty or null in every sample.
is_free_tv logical Shown on free-to-air TV.
live_stream_url character Live-stream link (DBBL games link YouTube); empty when none.
top_score integer Points of the game's top scorer; null before the game.
top_scorer_season_player_id character Season-player id. BBL: a string equal to id. DBBL: an INTEGER that matches ⁠/seasons/{seasonId}⁠ seasonPlayerId (5 of 5 rows checked, 2026-27). Joins to ⁠/season-players/{seasonPlayerId}⁠.
top_scorer_real_player_id character Global person id: the same across clubs and seasons. Joins to realPlayerId everywhere.
top_scorer_first_name character Player's given name.
top_scorer_last_name character Player's family name.

See Also

Other SCB Functions: scb_game_actions(), scb_game_players(), scb_game_teams(), scb_games(), scb_games_recent(), scb_player_statistics(), scb_playoff_games(), scb_playoff_series(), scb_records_per_game(), scb_records_season_averages(), scb_referees(), scb_season_player(), scb_season_players(), scb_season_teams(), scb_seasons(), scb_standings(), scb_team(), scb_team_rosters(), scb_team_seasons(), scb_team_statistics(), scb_transfers(), scb_transfers_teams()

Examples

try(scb_game(game_id = "2006920"))

Get BBL / DBBL Game Play-by-Play

Description

Play-by-play of a finished game with shot x/y (BBL 2008-09 on, DBBL 2024-25 on).

Endpoint: ⁠GET https://api.basketball-bundesliga.de/games/{game_id}/stats⁠ (DBBL: the same route on ⁠https://api-1.dbbl.scb.world⁠).

Usage

scb_game_actions(game_id, league = "dbbl")

Arguments

game_id

(required) Game id (game_id in scb_games), e.g. 2006920 (BBL) or 10130 (DBBL). One sequence per league.

league

(default "dbbl", the women's DBBL) League: bbl (men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) or dbbl (women, Toyota Damen-Basketball-Bundesliga, api-1.dbbl.scb.world). The two share one API; game ids overlap, so a game is (league, game_id).

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

Value

A wehoop_data tibble: Play-by-play of a finished game with shot x/y (BBL 2008-09 on, DBBL 2024-25 on). An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_game_actions):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
game_id character Game id, a string; unique within a league only (BBL and DBBL overlap), and not chronological.
action_id integer Action id, an integer unique across games of a league.
order_id integer Chronological sequence of the action within the game.
action_identifier character Provider action key ⁠<n>:<seq>⁠ (opaque; the first part is not the period).
period integer Period: 1-4 quarters, 5+ overtimes.
game_time character Game clock as HH:MM:SS: in an action, the time LEFT in the period (00:10:00 at the start of a 10-minute quarter); in a game header, 00:00:00 in every sample.
seconds_left integer Seconds left in the period at the action: game_time as seconds.
real_time character Wall-clock time of the action, ISO 8601 UTC. Pre-2011 games carry a placeholder: local midnight of the game day (23:00 UTC the day before) on every row.
type character Action type; see the action-type table. Records and videos use their own type (see those routes).
qualifiers character Action qualifiers (shot kind, rebound side, foul kind, turnover kind); see the qualifier table.
is_successful logical Made / successful (shots, free throws); for other types see the action-type table.
season_team_id character Season-team id; equal to the club teamId in every sample (BBL 2005-2026, DBBL 2024-2026).
side character home or guest (the away side), for the team the row belongs to.
season_player_id character Season-player id: one player's engagement with one club (kept across seasons while he stays, new after a move; see README). Joins to box-score seasonPlayer.id, action seasonPlayerId and ⁠/season-players/{seasonPlayerId}⁠. Null on team and period rows.
assisting_season_player_id character Season-player id of the assisting player; only on assisted made shots. Joins to box-score seasonPlayer.id and action seasonPlayerId.
shot_x integer Shot x on the site's half-court chart (0-280 across, 140 through the rim); null without a location. Scale and orientation unverified.
shot_y integer Shot y along the court from behind the baseline (rim near 45, arc top near 147); null without a location. Scale and orientation unverified.
home_team_points integer Home score after this action; only on scoring actions.
guest_team_points integer Guest score after this action; only on scoring actions.

See Also

Other SCB Functions: scb_game(), scb_game_players(), scb_game_teams(), scb_games(), scb_games_recent(), scb_player_statistics(), scb_playoff_games(), scb_playoff_series(), scb_records_per_game(), scb_records_season_averages(), scb_referees(), scb_season_player(), scb_season_players(), scb_season_teams(), scb_seasons(), scb_standings(), scb_team(), scb_team_rosters(), scb_team_seasons(), scb_team_statistics(), scb_transfers(), scb_transfers_teams()

Examples

try(scb_game_actions(game_id = "2006920"))

Get BBL / DBBL Game Player Box Score

Description

Box score of a finished game: one row per player line of both teams (2002-03 on).

Endpoint: ⁠GET https://api.basketball-bundesliga.de/games/{game_id}/stats⁠ (DBBL: the same route on ⁠https://api-1.dbbl.scb.world⁠).

Usage

scb_game_players(game_id, league = "dbbl")

Arguments

game_id

(required) Game id (game_id in scb_games), e.g. 2006920 (BBL) or 10130 (DBBL). One sequence per league.

league

(default "dbbl", the women's DBBL) League: bbl (men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) or dbbl (women, Toyota Damen-Basketball-Bundesliga, api-1.dbbl.scb.world). The two share one API; game ids overlap, so a game is (league, game_id).

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

Value

A wehoop_data tibble: Box score of a finished game: one row per player line of both teams (2002-03 on). An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_game_players):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
game_id character Game id, a string. Joins to ⁠/games/{gameId}⁠.
season integer Season END year (2026 = 2025-26), the sdv key; the API's season_id plus one.
side character home or guest (the away side), for the team the row belongs to.
team_id character Club id; equal to seasonTeamId in every sample. Joins to ⁠/teams/{teamId}⁠.
season_player_id character Season-player id: one player's engagement with one club (kept across seasons while he stays, new after a move; see README). Joins to box-score seasonPlayer.id, action seasonPlayerId and ⁠/season-players/{seasonPlayerId}⁠.
real_player_id integer Global person id: the same across clubs and seasons. Joins to realPlayerId everywhere.
first_name character Player's given name.
last_name character Player's family name.
shirt_number character Jersey number. A number or a numeric string across rows.
position character Position: POINT_GUARD, SHOOTING_GUARD, SMALL_FORWARD, POWER_FORWARD, CENTER.
season_team_id character Season-team id; equal to the club teamId in every sample (BBL 2005-2026, DBBL 2024-2026).
team_name character Team name as listed that season (sponsor names included, e.g. 'EWE Baskets Oldenburg').
team_tlc character Three-letter club code.
season_id integer Season, START year (2026 = 2026-27).
seconds_played integer The player's playing time in SECONDS in the game.
points integer The player's points in the game.
two_point_shots_made integer The player's 2-point field goals made in the game.
two_point_shots_attempted integer The player's 2-point field goals attempted in the game.
two_point_shot_success_percent double The player's 2-point field-goal percentage in the game, 0-100 (one decimal); 0 when no attempts.
three_point_shots_made integer The player's 3-point field goals made in the game.
three_point_shots_attempted integer The player's 3-point field goals attempted in the game.
three_point_shot_success_percent double The player's 3-point field-goal percentage in the game, 0-100 (one decimal); 0 when no attempts.
field_goals_made integer The player's field goals made in the game.
field_goals_attempted integer The player's field goals attempted in the game.
field_goals_success_percent double The player's field-goal percentage in the game, 0-100 (one decimal); 0 when no attempts.
free_throws_made integer The player's free throws made in the game.
free_throws_attempted integer The player's free throws attempted in the game.
free_throws_success_percent double The player's free-throw percentage in the game, 0-100 (one decimal); 0 when no attempts.
offensive_rebounds integer The player's offensive rebounds in the game.
defensive_rebounds integer The player's defensive rebounds in the game.
total_rebounds integer The player's rebounds (offensive + defensive) in the game.
assists integer The player's assists in the game.
steals integer The player's steals in the game.
turnovers integer The player's turnovers in the game.
blocks integer The player's blocked shots in the game.
fouls_committed integer The player's fouls committed in the game.
efficiency integer The player's efficiency (EFF = PTS + REB + AST + STL + BLK - missed FG - missed FT - TO; checked on a 2026 box score) in the game.
plus_minus integer The player's plus-minus (point margin while on court); null when the API sends an empty string (2005-06).
is_starting_five logical Started the game.
double_double integer The player's double-doubles in the game.
triple_double integer The player's triple-doubles in the game.
fouls_received integer The player's fouls drawn in the game.
opponent_team_name character Opponent's name.
field_goals_recomputed logical True when the API's field-goal totals disagreed with its 2-point plus 3-point parts (2005-06 box scores) and were recomputed from the parts.

See Also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_teams(), scb_games(), scb_games_recent(), scb_player_statistics(), scb_playoff_games(), scb_playoff_series(), scb_records_per_game(), scb_records_season_averages(), scb_referees(), scb_season_player(), scb_season_players(), scb_season_teams(), scb_seasons(), scb_standings(), scb_team(), scb_team_rosters(), scb_team_seasons(), scb_team_statistics(), scb_transfers(), scb_transfers_teams()

Examples

try(scb_game_players(game_id = "2006920"))

Get BBL / DBBL Game Team Box Score

Description

Box score of a finished game: one row per team, with the head coach and the team line.

Endpoint: ⁠GET https://api.basketball-bundesliga.de/games/{game_id}/stats⁠ (DBBL: the same route on ⁠https://api-1.dbbl.scb.world⁠).

Usage

scb_game_teams(game_id, league = "dbbl")

Arguments

game_id

(required) Game id (game_id in scb_games), e.g. 2006920 (BBL) or 10130 (DBBL). One sequence per league.

league

(default "dbbl", the women's DBBL) League: bbl (men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) or dbbl (women, Toyota Damen-Basketball-Bundesliga, api-1.dbbl.scb.world). The two share one API; game ids overlap, so a game is (league, game_id).

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

Value

A wehoop_data tibble: Box score of a finished game: one row per team, with the head coach and the team line. An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_game_teams):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
game_id character Game id, a string. Joins to ⁠/games/{gameId}⁠.
season integer Season END year (2026 = 2025-26), the sdv key; the API's season_id plus one.
side character home or guest (the away side), for the team the row belongs to.
team_id character Club id; equal to seasonTeamId in every sample. Joins to ⁠/teams/{teamId}⁠.
head_coach_name character Name of the team's head coach.
status character Game status: PRE (scheduled), LIVE, POST (ended, not yet official) or OFFICIAL (final).
scheduled_time character Scheduled tip-off, ISO 8601 UTC.
season_team_id character Season-team id; equal to the club teamId in every sample (BBL 2005-2026, DBBL 2024-2026).
season_id integer Season, START year (2026 = 2026-27).
team_name character Team name as listed that season (sponsor names included, e.g. 'EWE Baskets Oldenburg').
team_tlc character Three-letter club code.
competition character Competition: BBL, BBL_CUP (Pokal), ALLSTAR, CHAMPIONS_CUP on the BBL host; DBBL, DBBL_CUP on the DBBL host.
stage character Stage: MAIN_ROUND (Hauptrunde, regular season), PLAYINS, FIRST_ROUND, SECOND_ROUND, ROUND_OF_16 (Achtelfinale), ROUND_OF_8 (Viertelfinale), SEMI_FINALS, FINALS, THIRD_PLACE_GAME, QUALIFICATION, GROUP_STAGE.
seconds_played integer The team's playing time in SECONDS in the game (players plus the team line) (12000 = 5 x 40 min).
points integer The team's points in the game (players plus the team line).
two_point_shots_made integer The team's 2-point field goals made in the game (players plus the team line).
two_point_shots_attempted integer The team's 2-point field goals attempted in the game (players plus the team line).
two_point_shot_success_percent double The team's 2-point field-goal percentage in the game (players plus the team line), 0-100 (one decimal); 0 when no attempts.
three_point_shots_made integer The team's 3-point field goals made in the game (players plus the team line).
three_point_shots_attempted integer The team's 3-point field goals attempted in the game (players plus the team line).
three_point_shot_success_percent double The team's 3-point field-goal percentage in the game (players plus the team line), 0-100 (one decimal); 0 when no attempts.
field_goals_made integer The team's field goals made in the game (players plus the team line).
field_goals_attempted integer The team's field goals attempted in the game (players plus the team line).
field_goals_success_percent double The team's field-goal percentage in the game (players plus the team line), 0-100 (one decimal); 0 when no attempts.
free_throws_made integer The team's free throws made in the game (players plus the team line).
free_throws_attempted integer The team's free throws attempted in the game (players plus the team line).
free_throws_success_percent double The team's free-throw percentage in the game (players plus the team line), 0-100 (one decimal); 0 when no attempts.
offensive_rebounds integer The team's offensive rebounds in the game (players plus the team line).
defensive_rebounds integer The team's defensive rebounds in the game (players plus the team line).
total_rebounds integer The team's rebounds (offensive + defensive) in the game (players plus the team line).
assists integer The team's assists in the game (players plus the team line).
steals integer The team's steals in the game (players plus the team line).
turnovers integer The team's turnovers in the game (players plus the team line).
blocks integer The team's blocked shots in the game (players plus the team line).
fouls_committed integer The team's fouls committed in the game (players plus the team line).
efficiency integer The team's efficiency (EFF = PTS + REB + AST + STL + BLK - missed FG - missed FT - TO; checked on a 2026 box score) in the game (players plus the team line).
plus_minus integer The team's point margin in the game.
team_line_seconds_played integer Team-line playing time in SECONDS (not credited to a player).
team_line_points integer Team-line points (not credited to a player).
team_line_two_point_shots_made integer Team-line 2-point field goals made (not credited to a player).
team_line_two_point_shots_attempted integer Team-line 2-point field goals attempted (not credited to a player).
team_line_two_point_shot_success_percent double Team-line 2-point field-goal percentage (not credited to a player), 0-100 (one decimal); 0 when no attempts.
team_line_three_point_shots_made integer Team-line 3-point field goals made (not credited to a player).
team_line_three_point_shots_attempted integer Team-line 3-point field goals attempted (not credited to a player).
team_line_three_point_shot_success_percent double Team-line 3-point field-goal percentage (not credited to a player), 0-100 (one decimal); 0 when no attempts.
team_line_field_goals_made integer Team-line field goals made (not credited to a player).
team_line_field_goals_attempted integer Team-line field goals attempted (not credited to a player).
team_line_field_goals_success_percent double Team-line field-goal percentage (not credited to a player), 0-100 (one decimal); 0 when no attempts.
team_line_free_throws_made integer Team-line free throws made (not credited to a player).
team_line_free_throws_attempted integer Team-line free throws attempted (not credited to a player).
team_line_free_throws_success_percent double Team-line free-throw percentage (not credited to a player), 0-100 (one decimal); 0 when no attempts.
team_line_offensive_rebounds integer Team-line offensive rebounds (not credited to a player).
team_line_defensive_rebounds integer Team-line defensive rebounds (not credited to a player).
team_line_total_rebounds integer Team-line rebounds (offensive + defensive) (not credited to a player).
team_line_assists integer Team-line assists (not credited to a player).
team_line_steals integer Team-line steals (not credited to a player).
team_line_turnovers integer Team-line turnovers (not credited to a player).
team_line_blocks integer Team-line blocked shots (not credited to a player).
team_line_fouls_committed integer Team-line fouls committed (not credited to a player).
team_line_efficiency integer Team-line efficiency (EFF = PTS + REB + AST + STL + BLK - missed FG - missed FT - TO; checked on a 2026 box score) (not credited to a player).
team_line_plus_minus integer Team-line plus-minus: the team line has no court time, so this is not a margin.
field_goals_recomputed logical True when the API's field-goal totals disagreed with its 2-point plus 3-point parts (2005-06 box scores) and were recomputed from the parts.

See Also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_players(), scb_games(), scb_games_recent(), scb_player_statistics(), scb_playoff_games(), scb_playoff_series(), scb_records_per_game(), scb_records_season_averages(), scb_referees(), scb_season_player(), scb_season_players(), scb_season_teams(), scb_seasons(), scb_standings(), scb_team(), scb_team_rosters(), scb_team_seasons(), scb_team_statistics(), scb_transfers(), scb_transfers_teams()

Examples

try(scb_game_teams(game_id = "2006920"))

Get BBL / DBBL Games

Description

Games of a season (the whole season in one page): teams, score by period, officials, venue and top scorer.

Endpoint: ⁠GET https://api.basketball-bundesliga.de/games⁠ (DBBL: the same route on ⁠https://api-1.dbbl.scb.world⁠).

Usage

scb_games(
  league = "dbbl",
  season = NULL,
  competition = NULL,
  game_type = NULL,
  team_id = NULL,
  page_size = 500
)

Arguments

league

(default "dbbl", the women's DBBL) League: bbl (men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) or dbbl (women, Toyota Damen-Basketball-Bundesliga, api-1.dbbl.scb.world). The two share one API; game ids overlap, so a game is (league, game_id).

season

(default NULL) Season END year (2026 = 2025-26, the sdv key). Sent to the API as its START-year seasonId (season - 1). Omitted = the season in progress.

competition

(default NULL) Competition filter: BBL, BBL_CUP (Pokal), ALLSTAR, CHAMPIONS_CUP on the BBL host; DBBL, DBBL_CUP on the DBBL host. Omitted = all. The other host's competition answers an empty page.

game_type

(default NULL) Finished, scheduled or all games. Omitted = all.

team_id

(default NULL) Only the games of this team, home or guest (the club id equals the season-team id).

page_size

(default 500) Rows per page. The wrapper reads page 1 and refuses a result that needs more pages, so keep it large enough for the whole result (500 covers a season).

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

Value

A wehoop_data tibble: Games of a season (the whole season in one page): teams, score by period, officials, venue and top scorer. An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_games):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
season integer Season END year (2026 = 2025-26), the sdv key; the API's season_id plus one.
season_id integer Season, START year (2026 = 2026-27).
game_id character Game id, a string; unique within a league only (BBL and DBBL overlap), and not chronological.
competition character Competition: BBL, BBL_CUP (Pokal), ALLSTAR, CHAMPIONS_CUP on the BBL host; DBBL, DBBL_CUP on the DBBL host.
stage character Stage: MAIN_ROUND (Hauptrunde, regular season), PLAYINS, FIRST_ROUND, SECOND_ROUND, ROUND_OF_16 (Achtelfinale), ROUND_OF_8 (Viertelfinale), SEMI_FINALS, FINALS, THIRD_PLACE_GAME, QUALIFICATION, GROUP_STAGE.
status character Game status: PRE (scheduled), LIVE, POST (ended, not yet official), OFFICIAL (final).
scheduled_time character Scheduled tip-off, ISO 8601 UTC.
match_day integer Round number within the stage (Spieltag).
is_tbd logical Date or time not yet fixed.
is_hidden logical True when the API hides the game (0/1 on /games, a boolean on the header).
home_team_id character Club id; equal to seasonTeamId in every sample. Joins to ⁠/teams/{teamId}⁠.
home_season_team_id character Season-team id; equal to the club teamId in every sample (BBL 2005-2026, DBBL 2024-2026).
home_team_name character Team name as listed that season (sponsor names included, e.g. 'EWE Baskets Oldenburg').
home_tlc character Three-letter club code.
home_is_foreign logical The team is not in this league (cup opponents from the ProA / ProB).
home_rank integer The team's current table position.
home_streak character Current streak: W or L; empty when none.
home_streak_count integer Length of the current streak.
home_last10_victories integer Wins in the last 10 games.
home_last10_losses integer Losses in the last 10 games.
home_total_games integer Games the home team has played so far (the API sends it as a string).
guest_team_id character Club id; equal to seasonTeamId in every sample. Joins to ⁠/teams/{teamId}⁠.
guest_season_team_id character Season-team id; equal to the club teamId in every sample (BBL 2005-2026, DBBL 2024-2026).
guest_team_name character Team name as listed that season (sponsor names included, e.g. 'EWE Baskets Oldenburg').
guest_tlc character Three-letter club code.
guest_is_foreign logical The team is not in this league (cup opponents from the ProA / ProB).
guest_rank integer The team's current table position.
guest_streak character Current streak: W or L; empty when none.
guest_streak_count integer Length of the current streak.
guest_last10_victories integer Wins in the last 10 games.
guest_last10_losses integer Losses in the last 10 games.
guest_total_games integer Games the guest team has played so far (the API sends it as a string).
home_score integer Home team final score.
guest_score integer Guest team final score.
latest_period integer Number of the last period played (4 = Q4, 5 = OT1, ...); the API sends Q4 on /games and 4 on /games/recent. Null before the game.
spectators integer Attendance; 0 when not recorded.
home_q1_score integer Home team points in quarter 1; 0 when quarter scores were not recorded.
home_q2_score integer Home team points in quarter 2; 0 when quarter scores were not recorded.
home_q3_score integer Home team points in quarter 3; 0 when quarter scores were not recorded.
home_q4_score integer Home team points in quarter 4; 0 when quarter scores were not recorded.
home_ot1_score integer Home team points in overtime 1; 0 when not played (null from OT5 on in old seasons).
home_ot2_score integer Home team points in overtime 2; 0 when not played (null from OT5 on in old seasons).
home_ot3_score integer Home team points in overtime 3; 0 when not played (null from OT5 on in old seasons).
home_ot4_score integer Home team points in overtime 4; 0 when not played (null from OT5 on in old seasons).
home_ot5_score integer Home team points in overtime 5; 0 when not played (null from OT5 on in old seasons).
home_ot6_score integer Home team points in overtime 6; 0 when not played (null from OT5 on in old seasons).
home_ot7_score integer Home team points in overtime 7; 0 when not played (null from OT5 on in old seasons).
home_ot8_score integer Home team points in overtime 8; 0 when not played (null from OT5 on in old seasons).
home_ot9_score integer Home team points in overtime 9; 0 when not played (null from OT5 on in old seasons).
guest_q1_score integer Guest team points in quarter 1; 0 when quarter scores were not recorded.
guest_q2_score integer Guest team points in quarter 2; 0 when quarter scores were not recorded.
guest_q3_score integer Guest team points in quarter 3; 0 when quarter scores were not recorded.
guest_q4_score integer Guest team points in quarter 4; 0 when quarter scores were not recorded.
guest_ot1_score integer Guest team points in overtime 1; 0 when not played (null from OT5 on in old seasons).
guest_ot2_score integer Guest team points in overtime 2; 0 when not played (null from OT5 on in old seasons).
guest_ot3_score integer Guest team points in overtime 3; 0 when not played (null from OT5 on in old seasons).
guest_ot4_score integer Guest team points in overtime 4; 0 when not played (null from OT5 on in old seasons).
guest_ot5_score integer Guest team points in overtime 5; 0 when not played (null from OT5 on in old seasons).
guest_ot6_score integer Guest team points in overtime 6; 0 when not played (null from OT5 on in old seasons).
guest_ot7_score integer Guest team points in overtime 7; 0 when not played (null from OT5 on in old seasons).
guest_ot8_score integer Guest team points in overtime 8; 0 when not played (null from OT5 on in old seasons).
guest_ot9_score integer Guest team points in overtime 9; 0 when not played (null from OT5 on in old seasons).
referee1_id character Official id; joins to /referees refId (= its id). /referees lists only the current officials (44), so older games' officials can be missing there: all 40 of 2026-27's matched, 6 of 10 of 2008-09's.
referee1_first_name character Official's given name.
referee1_last_name character Official's family name.
referee2_id character Official id; joins to /referees refId (= its id). /referees lists only the current officials (44), so older games' officials can be missing there: all 40 of 2026-27's matched, 6 of 10 of 2008-09's.
referee2_first_name character Official's given name.
referee2_last_name character Official's family name.
referee3_id character Official id; joins to /referees refId (= its id). /referees lists only the current officials (44), so older games' officials can be missing there: all 40 of 2026-27's matched, 6 of 10 of 2008-09's.
referee3_first_name character Official's given name.
referee3_last_name character Official's family name.
commissioner_id character Official id; joins to /referees refId (= its id). /referees lists only the current officials (44), so older games' officials can be missing there: all 40 of 2026-27's matched, 6 of 10 of 2008-09's.
commissioner_first_name character Official's given name.
commissioner_last_name character Official's family name.
venue_id character Arena id, stable across seasons (Uber Arena = 2 in both 2025-26 and 2026-27); a different key space from /teams seasonVenues.id, and no captured route is keyed by it. A string in /games and ⁠/games/{gameId}⁠, an integer in /games/recent.
venue_name character Name of the arena the game is played in; venue_id is its stable arena id.
venue_address character Postal address, German.
venue_capacity integer Arena capacity, spectators.
venue_is_main logical The club's main arena.
tv_channel character TV channel(s) showing the game, comma-joined (a list on some routes, an empty string when none).
tv_type character TV coverage type; empty or null in every sample.
is_free_tv logical Shown on free-to-air TV.
live_stream_url character Live-stream link (DBBL games link YouTube); empty when none.
top_score integer Points of the game's top scorer; null before the game.
top_scorer_season_player_id character Season-player id. BBL: a string equal to id. DBBL: an INTEGER that matches ⁠/seasons/{seasonId}⁠ seasonPlayerId (5 of 5 rows checked, 2026-27). Joins to ⁠/season-players/{seasonPlayerId}⁠.
top_scorer_real_player_id character Global person id: the same across clubs and seasons. Joins to realPlayerId everywhere.
top_scorer_first_name character Player's given name.
top_scorer_last_name character Player's family name.

See Also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_players(), scb_game_teams(), scb_games_recent(), scb_player_statistics(), scb_playoff_games(), scb_playoff_series(), scb_records_per_game(), scb_records_season_averages(), scb_referees(), scb_season_player(), scb_season_players(), scb_season_teams(), scb_seasons(), scb_standings(), scb_team(), scb_team_rosters(), scb_team_seasons(), scb_team_statistics(), scb_transfers(), scb_transfers_teams()

Examples

try(scb_games())

Get BBL / DBBL Recent Games

Description

Recent, live and upcoming games, one row per game with its past / present / future bucket.

Endpoint: ⁠GET https://api.basketball-bundesliga.de/games/recent⁠ (DBBL: the same route on ⁠https://api-1.dbbl.scb.world⁠).

Usage

scb_games_recent(league = "dbbl", slot_size = NULL)

Arguments

league

(default "dbbl", the women's DBBL) League: bbl (men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) or dbbl (women, Toyota Damen-Basketball-Bundesliga, api-1.dbbl.scb.world). The two share one API; game ids overlap, so a game is (league, game_id).

slot_size

(default NULL) Games per bucket (past, present, future); the API's default is 9.

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

Value

A wehoop_data tibble: Recent, live and upcoming games, one row per game with its past / present / future bucket. An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_games_recent):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
season integer Season END year (2026 = 2025-26), the sdv key; the API's season_id plus one.
season_id integer Season, START year (2026 = 2026-27).
game_id character Game id, a string; unique within a league only (BBL and DBBL overlap), and not chronological.
competition character Competition: BBL, BBL_CUP (Pokal), ALLSTAR, CHAMPIONS_CUP on the BBL host; DBBL, DBBL_CUP on the DBBL host.
stage character Stage: MAIN_ROUND (Hauptrunde, regular season), PLAYINS, FIRST_ROUND, SECOND_ROUND, ROUND_OF_16 (Achtelfinale), ROUND_OF_8 (Viertelfinale), SEMI_FINALS, FINALS, THIRD_PLACE_GAME, QUALIFICATION, GROUP_STAGE.
status character Game status: PRE (scheduled), LIVE, POST (ended, not yet official), OFFICIAL (final).
bucket character Which list of ⁠/games/recent⁠ the game came from: past (finished), present (today or live) or future (scheduled).
game_progress character Live progress code: E (ended), empty or null before the game. Meaning inferred.
scheduled_time character Scheduled tip-off, ISO 8601 UTC.
match_day integer Round number within the stage (Spieltag).
is_tbd logical Date or time not yet fixed.
is_hidden logical True when the API hides the game (0/1 on /games, a boolean on the header).
home_team_id character Club id; equal to seasonTeamId in every sample. Joins to ⁠/teams/{teamId}⁠.
home_season_team_id character Season-team id; equal to the club teamId in every sample (BBL 2005-2026, DBBL 2024-2026).
home_team_name character Team name as listed that season (sponsor names included, e.g. 'EWE Baskets Oldenburg').
home_tlc character Three-letter club code.
home_is_foreign logical The team is not in this league (cup opponents from the ProA / ProB).
home_rank integer The team's current table position.
home_streak character Current streak: W or L; empty when none.
home_streak_count integer Length of the current streak.
home_last10_victories integer Wins in the last 10 games.
home_last10_losses integer Losses in the last 10 games.
home_total_games integer Games the home team has played so far (the API sends it as a string).
guest_team_id character Club id; equal to seasonTeamId in every sample. Joins to ⁠/teams/{teamId}⁠.
guest_season_team_id character Season-team id; equal to the club teamId in every sample (BBL 2005-2026, DBBL 2024-2026).
guest_team_name character Team name as listed that season (sponsor names included, e.g. 'EWE Baskets Oldenburg').
guest_tlc character Three-letter club code.
guest_is_foreign logical The team is not in this league (cup opponents from the ProA / ProB).
guest_rank integer The team's current table position.
guest_streak character Current streak: W or L; empty when none.
guest_streak_count integer Length of the current streak.
guest_last10_victories integer Wins in the last 10 games.
guest_last10_losses integer Losses in the last 10 games.
guest_total_games integer Games the guest team has played so far (the API sends it as a string).
home_score integer Home team final score.
guest_score integer Guest team final score.
latest_period integer Number of the last period played (4 = Q4, 5 = OT1, ...); the API sends Q4 on /games and 4 on /games/recent. Null before the game.
spectators integer Attendance; 0 when not recorded.
home_q1_score integer Home team points in quarter 1; 0 when quarter scores were not recorded.
home_q2_score integer Home team points in quarter 2; 0 when quarter scores were not recorded.
home_q3_score integer Home team points in quarter 3; 0 when quarter scores were not recorded.
home_q4_score integer Home team points in quarter 4; 0 when quarter scores were not recorded.
home_ot1_score integer Home team points in overtime 1; 0 when not played (null from OT5 on in old seasons).
home_ot2_score integer Home team points in overtime 2; 0 when not played (null from OT5 on in old seasons).
home_ot3_score integer Home team points in overtime 3; 0 when not played (null from OT5 on in old seasons).
home_ot4_score integer Home team points in overtime 4; 0 when not played (null from OT5 on in old seasons).
home_ot5_score integer Home team points in overtime 5; 0 when not played (null from OT5 on in old seasons).
home_ot6_score integer Home team points in overtime 6; 0 when not played (null from OT5 on in old seasons).
home_ot7_score integer Home team points in overtime 7; 0 when not played (null from OT5 on in old seasons).
home_ot8_score integer Home team points in overtime 8; 0 when not played (null from OT5 on in old seasons).
home_ot9_score integer Home team points in overtime 9; 0 when not played (null from OT5 on in old seasons).
guest_q1_score integer Guest team points in quarter 1; 0 when quarter scores were not recorded.
guest_q2_score integer Guest team points in quarter 2; 0 when quarter scores were not recorded.
guest_q3_score integer Guest team points in quarter 3; 0 when quarter scores were not recorded.
guest_q4_score integer Guest team points in quarter 4; 0 when quarter scores were not recorded.
guest_ot1_score integer Guest team points in overtime 1; 0 when not played (null from OT5 on in old seasons).
guest_ot2_score integer Guest team points in overtime 2; 0 when not played (null from OT5 on in old seasons).
guest_ot3_score integer Guest team points in overtime 3; 0 when not played (null from OT5 on in old seasons).
guest_ot4_score integer Guest team points in overtime 4; 0 when not played (null from OT5 on in old seasons).
guest_ot5_score integer Guest team points in overtime 5; 0 when not played (null from OT5 on in old seasons).
guest_ot6_score integer Guest team points in overtime 6; 0 when not played (null from OT5 on in old seasons).
guest_ot7_score integer Guest team points in overtime 7; 0 when not played (null from OT5 on in old seasons).
guest_ot8_score integer Guest team points in overtime 8; 0 when not played (null from OT5 on in old seasons).
guest_ot9_score integer Guest team points in overtime 9; 0 when not played (null from OT5 on in old seasons).
referee1_id character Official id; joins to /referees refId (= its id). /referees lists only the current officials (44), so older games' officials can be missing there: all 40 of 2026-27's matched, 6 of 10 of 2008-09's.
referee1_first_name character Official's given name.
referee1_last_name character Official's family name.
referee2_id character Official id; joins to /referees refId (= its id). /referees lists only the current officials (44), so older games' officials can be missing there: all 40 of 2026-27's matched, 6 of 10 of 2008-09's.
referee2_first_name character Official's given name.
referee2_last_name character Official's family name.
referee3_id character Official id; joins to /referees refId (= its id). /referees lists only the current officials (44), so older games' officials can be missing there: all 40 of 2026-27's matched, 6 of 10 of 2008-09's.
referee3_first_name character Official's given name.
referee3_last_name character Official's family name.
commissioner_id character Official id; joins to /referees refId (= its id). /referees lists only the current officials (44), so older games' officials can be missing there: all 40 of 2026-27's matched, 6 of 10 of 2008-09's.
commissioner_first_name character Official's given name.
commissioner_last_name character Official's family name.
venue_id character Arena id, stable across seasons (Uber Arena = 2 in both 2025-26 and 2026-27); a different key space from /teams seasonVenues.id, and no captured route is keyed by it. A string in /games and ⁠/games/{gameId}⁠, an integer in /games/recent.
venue_name character Name of the arena the game is played in; venue_id is its stable arena id.
venue_address character Postal address, German.
venue_capacity integer Arena capacity, spectators.
venue_is_main logical The club's main arena.
tv_channel character TV channel(s) showing the game, comma-joined (a list on some routes, an empty string when none).
tv_type character TV coverage type; empty or null in every sample.
is_free_tv logical Shown on free-to-air TV.
live_stream_url character Live-stream link (DBBL games link YouTube); empty when none.
top_score integer Points of the game's top scorer; null before the game.
top_scorer_season_player_id character Season-player id. BBL: a string equal to id. DBBL: an INTEGER that matches ⁠/seasons/{seasonId}⁠ seasonPlayerId (5 of 5 rows checked, 2026-27). Joins to ⁠/season-players/{seasonPlayerId}⁠.
top_scorer_real_player_id character Global person id: the same across clubs and seasons. Joins to realPlayerId everywhere.
top_scorer_first_name character Player's given name.
top_scorer_last_name character Player's family name.

See Also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_players(), scb_game_teams(), scb_games(), scb_player_statistics(), scb_playoff_games(), scb_playoff_series(), scb_records_per_game(), scb_records_season_averages(), scb_referees(), scb_season_player(), scb_season_players(), scb_season_teams(), scb_seasons(), scb_standings(), scb_team(), scb_team_rosters(), scb_team_seasons(), scb_team_statistics(), scb_transfers(), scb_transfers_teams()

Examples

try(scb_games_recent())

Get BBL / DBBL Season Player Statistics

Description

Season player stat table: totals and per-game values, one row per player and stat block.

Endpoint: ⁠GET https://api.basketball-bundesliga.de/seasons/{season}/player-statistics⁠ (DBBL: the same route on ⁠https://api-1.dbbl.scb.world⁠).

Usage

scb_player_statistics(season, league = "dbbl", display_type = "MAIN_ROUND")

Arguments

season

(required) Season END year (2026 = 2025-26, the sdv key). Sent to the API as its START-year seasonId (season - 1).

league

(default "dbbl", the women's DBBL) League: bbl (men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) or dbbl (women, Toyota Damen-Basketball-Bundesliga, api-1.dbbl.scb.world). The two share one API; game ids overlap, so a game is (league, game_id).

display_type

(default "MAIN_ROUND") Which games the table covers: MAIN_ROUND (regular season), PLAYOFFS, PLAYOFFS_TOTAL, MAIN_ROUND_AND_PLAY_OFFS or CUP.

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

Value

A wehoop_data tibble: Season player stat table: totals and per-game values, one row per player and stat block. An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_player_statistics):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
season integer Season END year (2026 = 2025-26), the sdv key; the API's season_id plus one.
display_type character Which games the table covers, echoed from the request (MAIN_ROUND, PLAYOFFS, PLAYOFFS_TOTAL, MAIN_ROUND_AND_PLAY_OFFS or CUP).
season_player_id character Season-player id: one player's engagement with one club (kept across seasons while he stays, new after a move; see README). Joins to box-score seasonPlayer.id, action seasonPlayerId and ⁠/season-players/{seasonPlayerId}⁠.
real_player_id integer Global person id: the same across clubs and seasons. Joins to realPlayerId everywhere.
first_name character Player's given name.
last_name character Player's family name.
shirt_number character Jersey number of the player, kept as text so a 00 jersey survives.
position character Position: POINT_GUARD, SHOOTING_GUARD, SMALL_FORWARD, POWER_FORWARD, CENTER.
team_id character Club id; equal to seasonTeamId in every sample. Joins to ⁠/teams/{teamId}⁠.
season_team_id character Season-team id; equal to the club teamId in every sample (BBL 2005-2026, DBBL 2024-2026).
team_name character Team name as listed that season (sponsor names included, e.g. 'EWE Baskets Oldenburg').
team_tlc character Three-letter club code.
season_id integer The API's own season key, the START year (2025 = 2025-26); season minus one.
round_code integer Provider round code; 1 for MAIN_ROUND in every sample (mapping unverified).
competition character Competition: BBL, BBL_CUP (Pokal), ALLSTAR, CHAMPIONS_CUP on the BBL host; DBBL, DBBL_CUP on the DBBL host.
seconds_played integer The player's season total playing time in SECONDS over displayType.
points integer The player's season total points over displayType.
two_point_shots_made integer The player's season total 2-point field goals made over displayType.
two_point_shots_attempted integer The player's season total 2-point field goals attempted over displayType.
two_point_shot_success_percent double The player's season total 2-point field-goal percentage over displaytype, 0-100 (one decimal); 0 when no attempts.
three_point_shots_made integer The player's season total 3-point field goals made over displayType.
three_point_shots_attempted integer The player's season total 3-point field goals attempted over displayType.
three_point_shot_success_percent double The player's season total 3-point field-goal percentage over displaytype, 0-100 (one decimal); 0 when no attempts.
field_goals_made integer The player's season total field goals made over displayType.
field_goals_attempted integer The player's season total field goals attempted over displayType.
field_goals_success_percent double The player's season total field-goal percentage over displaytype, 0-100 (one decimal); 0 when no attempts.
free_throws_made integer The player's season total free throws made over displayType.
free_throws_attempted integer The player's season total free throws attempted over displayType.
free_throws_success_percent double The player's season total free-throw percentage over displaytype, 0-100 (one decimal); 0 when no attempts.
offensive_rebounds integer The player's season total offensive rebounds over displayType.
defensive_rebounds integer The player's season total defensive rebounds over displayType.
total_rebounds integer The player's season total rebounds (offensive + defensive) over displayType.
assists integer The player's season total assists over displayType.
steals integer The player's season total steals over displayType.
turnovers integer The player's season total turnovers over displayType.
blocks integer The player's season total blocked shots over displayType.
fouls_committed integer The player's season total fouls committed over displayType.
efficiency integer The player's season total efficiency (EFF = PTS + REB + AST + STL + BLK - missed FG - missed FT - TO; checked on a 2026 box score) over displayType.
plus_minus integer The player's season total plus-minus over displaytype.
games_played integer The player's season total games played over displayType.
seconds_per_game double Per-game average of seconds, seconds.
points_per_game double Per-game average of points.
two_point_shots_made_per_game double Per-game average of 2-point field goals made.
two_point_shots_attempted_per_game double Per-game average of 2-point field goals attempted.
three_point_shots_made_per_game double Per-game average of 3-point field goals made.
three_point_shots_attempted_per_game double Per-game average of 3-point field goals attempted.
field_goals_made_per_game double Per-game average of field goals made.
field_goals_attempted_per_game double Per-game average of field goals attempted.
field_goals_success_percent_per_game double Per-game average of field-goal percentage (0 in every sample: unusable).
free_throws_made_per_game double Per-game average of free throws made.
free_throws_attempted_per_game double Per-game average of free throws attempted.
defensive_rebounds_per_game double Per-game average of defensive rebounds.
offensive_rebounds_per_game double Per-game average of offensive rebounds.
total_rebounds_per_game double Per-game average of rebounds (offensive + defensive).
assists_per_game double Per-game average of assists.
steals_per_game double Per-game average of steals.
turnovers_per_game double Per-game average of turnovers.
blocks_per_game double Per-game average of blocked shots.
fouls_committed_per_game double Per-game average of fouls committed.
efficiency_per_game double Per-game average of efficiency (EFF = PTS + REB + AST + STL + BLK - missed FG - missed FT - TO; checked on a 2026 box score).
plus_minus_per_game double Per-game average of plus-minus (point margin while on court).
double_double integer The player's season total double-doubles over displayType.
double_double_per_game double Per-game average of double-doubles.
games_started integer The player's season total games started over displayType.
triple_double integer The player's season total triple-doubles over displayType.
triple_double_per_game double Per-game average of triple-doubles.
fouls_received integer The player's season total fouls drawn over displayType.
fouls_received_per_game double Per-game average of fouls drawn.
overall logical False in every sample (meaning unverified).
stage character Stage: MAIN_ROUND (Hauptrunde, regular season), PLAYINS, FIRST_ROUND, SECOND_ROUND, ROUND_OF_16 (Achtelfinale), ROUND_OF_8 (Viertelfinale), SEMI_FINALS, FINALS, THIRD_PLACE_GAME, QUALIFICATION, GROUP_STAGE.
aggregation character Aggregation label as sent: STAGE in player tables, MAIN_ROUND in team tables.

See Also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_players(), scb_game_teams(), scb_games(), scb_games_recent(), scb_playoff_games(), scb_playoff_series(), scb_records_per_game(), scb_records_season_averages(), scb_referees(), scb_season_player(), scb_season_players(), scb_season_teams(), scb_seasons(), scb_standings(), scb_team(), scb_team_rosters(), scb_team_seasons(), scb_team_statistics(), scb_transfers(), scb_transfers_teams()

Examples

try(scb_player_statistics(season = 2026))

Get BBL / DBBL Playoff Games

Description

Every playoff game of a season with its series and the points of each series team.

Endpoint: ⁠GET https://api.basketball-bundesliga.de/seasons/{season}/playoff-tree⁠ (DBBL: the same route on ⁠https://api-1.dbbl.scb.world⁠).

Usage

scb_playoff_games(season, league = "dbbl")

Arguments

season

(required) Season END year (2026 = 2025-26, the sdv key). Sent to the API as its START-year seasonId (season - 1).

league

(default "dbbl", the women's DBBL) League: bbl (men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) or dbbl (women, Toyota Damen-Basketball-Bundesliga, api-1.dbbl.scb.world). The two share one API; game ids overlap, so a game is (league, game_id).

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

 scb_playoff_games(season = 2026)

Value

A wehoop_data tibble: Every playoff game of a season with its series and the points of each series team. An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_playoff_games):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
season integer Season END year (2026 = 2025-26), the sdv key; the API's season_id plus one.
season_id integer The API's own season key, the START year (2025 = 2025-26); season minus one.
round character Round of the bracket: quarter_finals, semi_finals or finals.
series integer 1-based position of the game's series within its round, in the order the API lists them.
game_id character Game id, a string (the playoff tree sends an integer); joins scb_games.game_id.
scheduled_time character Scheduled tip-off, ISO 8601 UTC.
timestamp integer Tip-off, Unix seconds.
game_winner_id character Season-team id of the game winner, a string (the playoff tree sends an integer).
home_team_id character Season-team id of the home team, a string (the playoff tree sends an integer).
guest_team_id character Season-team id of the guest (away) team, a string (the playoff tree sends an integer).
team_a_id character Season-team id of the series' team A (the higher seed); points_team_a is its score, whichever side hosted.
team_b_id character Season-team id of the series' team B; points_team_b is its score, whichever side hosted.
points_team_a integer Team A's points in the game.
points_team_b integer Team B's points in the game.

See Also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_players(), scb_game_teams(), scb_games(), scb_games_recent(), scb_player_statistics(), scb_playoff_series(), scb_records_per_game(), scb_records_season_averages(), scb_referees(), scb_season_player(), scb_season_players(), scb_season_teams(), scb_seasons(), scb_standings(), scb_team(), scb_team_rosters(), scb_team_seasons(), scb_team_statistics(), scb_transfers(), scb_transfers_teams()


Get BBL / DBBL Playoff Series

Description

Playoff bracket of a season: one row per series (quarter-finals, semi-finals, finals).

Endpoint: ⁠GET https://api.basketball-bundesliga.de/seasons/{season}/playoff-tree⁠ (DBBL: the same route on ⁠https://api-1.dbbl.scb.world⁠).

Usage

scb_playoff_series(season, league = "dbbl")

Arguments

season

(required) Season END year (2026 = 2025-26, the sdv key). Sent to the API as its START-year seasonId (season - 1).

league

(default "dbbl", the women's DBBL) League: bbl (men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) or dbbl (women, Toyota Damen-Basketball-Bundesliga, api-1.dbbl.scb.world). The two share one API; game ids overlap, so a game is (league, game_id).

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

 scb_playoff_series(season = 2026)

Value

A wehoop_data tibble: Playoff bracket of a season: one row per series (quarter-finals, semi-finals, finals). An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_playoff_series):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
season integer Season END year (2026 = 2025-26), the sdv key; the API's season_id plus one.
season_id integer Season, START year (2026 = 2026-27).
round character Round of the bracket: quarter_finals, semi_finals or finals.
series integer 1-based position of the series within its round, in the order the API lists them.
match_winner_id character Season-team id of the series winner, a string (the playoff tree sends an integer).
is_match_finished logical The series is decided.
team_a_id character Season-team id of series team A (the higher seed is A), a string (the playoff tree sends it as an integer); equals the club team id.
team_a_name character Name of series team A (the higher seed is A) as listed that season.
team_a_tlc character Three-letter club code of series team A (the higher seed is A).
team_a_rank integer Regular-season table position (the seed) of series team A (the higher seed is A).
team_a_victories integer Series wins of team A.
team_b_id character Season-team id of series team B (the higher seed is A), a string (the playoff tree sends it as an integer); equals the club team id.
team_b_name character Name of series team B (the higher seed is A) as listed that season.
team_b_tlc character Three-letter club code of series team B (the higher seed is A).
team_b_rank integer Regular-season table position (the seed) of series team B (the higher seed is A).
team_b_victories integer Series wins of team B.
games integer Games of the series.

See Also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_players(), scb_game_teams(), scb_games(), scb_games_recent(), scb_player_statistics(), scb_playoff_games(), scb_records_per_game(), scb_records_season_averages(), scb_referees(), scb_season_player(), scb_season_players(), scb_season_teams(), scb_seasons(), scb_standings(), scb_team(), scb_team_rosters(), scb_team_seasons(), scb_team_statistics(), scb_transfers(), scb_transfers_teams()


Get BBL / DBBL Single-Game Records

Description

Single-game records: the season's and the all-time ones, one row per record.

Endpoint: ⁠GET https://api.basketball-bundesliga.de/records/per-game/{season}⁠ (DBBL: the same route on ⁠https://api-1.dbbl.scb.world⁠).

Usage

scb_records_per_game(season, league = "dbbl")

Arguments

season

(required) Season END year (2026 = 2025-26, the sdv key). Sent to the API as its START-year seasonId (season - 1).

league

(default "dbbl", the women's DBBL) League: bbl (men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) or dbbl (women, Toyota Damen-Basketball-Bundesliga, api-1.dbbl.scb.world). The two share one API; game ids overlap, so a game is (league, game_id).

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

 scb_records_per_game(season = 2026)

Value

A wehoop_data tibble: Single-game records: the season's and the all-time ones, one row per record. An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_records_per_game):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
season integer Season END year (2026 = 2025-26), the sdv key; the API's season_id plus one.
season_id integer The API's own season key, the START year (2025 = 2025-26); season minus one.
scope character season for the requested season's records, all_time for the all-time list.
stat character The record's stat: points, rebounds, assists, steals, blocks, turnovers, efficiency, free_throws_made, three_point_shots_made or free_throws_success_percentage.
place integer Rank within the list (1 = best); 0 on some rows.
all_time_place integer Rank on the all-time list; null when not on it.
order_id integer Sort order within the list.
all_time_order_id integer Sort order on the all-time list; null when not on it.
value double The record value. A STRING in /records/per-game ('52'); a number in /records/season-averages.
ratio double [made, attempted] as strings, on percentage records only; null otherwise.
season_player_id character Season-player id: one player's engagement with one club (kept across seasons while he stays, new after a move; see README). Joins to box-score seasonPlayer.id, action seasonPlayerId and ⁠/season-players/{seasonPlayerId}⁠.
real_player_id integer Global person id: the same across clubs and seasons. Joins to realPlayerId everywhere.
first_name character Player's given name.
last_name character Player's family name.
team_name character Team name as listed that season (sponsor names included).
team_tlc character The player's team code.
home_tlc character Three-letter code of the home team of the record game.
guest_tlc character Three-letter code of the guest team of the record game.
game_id character Game id, a string. Joins to ⁠/games/{gameId}⁠.
scheduled_time character Scheduled tip-off, ISO 8601 UTC.

See Also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_players(), scb_game_teams(), scb_games(), scb_games_recent(), scb_player_statistics(), scb_playoff_games(), scb_playoff_series(), scb_records_season_averages(), scb_referees(), scb_season_player(), scb_season_players(), scb_season_teams(), scb_seasons(), scb_standings(), scb_team(), scb_team_rosters(), scb_team_seasons(), scb_team_statistics(), scb_transfers(), scb_transfers_teams()


Get BBL / DBBL Season-Average Records

Description

All-time season-average records (points, rebounds, assists, ...), one row per record.

Endpoint: ⁠GET https://api.basketball-bundesliga.de/records/season-averages⁠ (DBBL: the same route on ⁠https://api-1.dbbl.scb.world⁠).

Usage

scb_records_season_averages(league = "dbbl")

Arguments

league

(default "dbbl", the women's DBBL) League: bbl (men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) or dbbl (women, Toyota Damen-Basketball-Bundesliga, api-1.dbbl.scb.world). The two share one API; game ids overlap, so a game is (league, game_id).

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

 scb_records_season_averages()

Value

A wehoop_data tibble: All-time season-average records (points, rebounds, assists, ...), one row per record. An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_records_season_averages):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
stat character The record's stat list: assist_average, block_average, efficiency_average, foul_average, free_throws_success_percentage, points_average, rebound_average, steal_average, three_point_shot_average or turnover_average.
season integer Season END year (2026 = 2025-26), the sdv key; the API's season_id plus one.
season_id integer Season, START year (2026 = 2026-27).
place integer Rank within the list (1 = best); 0 on some rows.
order_id integer Sort order within the list.
value double The record value. A STRING in /records/per-game ('52'); a number in /records/season-averages.
ratio double [made, attempted] as strings, on percentage records only; null otherwise.
season_player_id character Season-player id: one player's engagement with one club (kept across seasons while he stays, new after a move; see README). Joins to box-score seasonPlayer.id, action seasonPlayerId and ⁠/season-players/{seasonPlayerId}⁠.
real_player_id integer Global person id: the same across clubs and seasons. Joins to realPlayerId everywhere.
first_name character Player's given name.
last_name character Player's family name.
team_name character Team name as listed that season (sponsor names included).
team_tlc character The player's team code.

See Also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_players(), scb_game_teams(), scb_games(), scb_games_recent(), scb_player_statistics(), scb_playoff_games(), scb_playoff_series(), scb_records_per_game(), scb_referees(), scb_season_player(), scb_season_players(), scb_season_teams(), scb_seasons(), scb_standings(), scb_team(), scb_team_rosters(), scb_team_seasons(), scb_team_statistics(), scb_transfers(), scb_transfers_teams()


Get BBL Referees

Description

Current referees and commissioners (BBL only).

Endpoint: ⁠GET https://api.basketball-bundesliga.de/referees⁠

Usage

scb_referees(page_size = 100)

Arguments

page_size

(default 100) Rows per page. 100 returns all current officials in one page; a result that needs more pages is refused.

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

 scb_referees()

Value

A wehoop_data tibble: Current referees and commissioners (BBL only). An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_referees):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
referee_id character Official id (refId, equal to the API's id); joins referee1_id .. commissioner_id of scb_games.
first_name character Official's given name.
last_name character Official's family name.
official_function character REFEREE or COMMISSIONER.
participations integer League games officiated.
year_joined_bbl integer Year the official joined the league.

See Also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_players(), scb_game_teams(), scb_games(), scb_games_recent(), scb_player_statistics(), scb_playoff_games(), scb_playoff_series(), scb_records_per_game(), scb_records_season_averages(), scb_season_player(), scb_season_players(), scb_season_teams(), scb_seasons(), scb_standings(), scb_team(), scb_team_rosters(), scb_team_seasons(), scb_team_statistics(), scb_transfers(), scb_transfers_teams()


Get BBL / DBBL Season Player Profile

Description

Player profile by season-player id: bio, position, club and previous clubs.

Endpoint: ⁠GET https://api.basketball-bundesliga.de/season-players/{season_player_id}⁠ (DBBL: the same route on ⁠https://api-1.dbbl.scb.world⁠).

Usage

scb_season_player(season_player_id, league = "dbbl")

Arguments

season_player_id

(required) Season-player id (season_player_id in a box score, an action or scb_season_players): one player's engagement with one club.

league

(default "dbbl", the women's DBBL) League: bbl (men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) or dbbl (women, Toyota Damen-Basketball-Bundesliga, api-1.dbbl.scb.world). The two share one API; game ids overlap, so a game is (league, game_id).

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

 scb_season_player(season_player_id = "56414")

Value

A wehoop_data tibble: Player profile by season-player id: bio, position, club and previous clubs. An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_season_player):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
season_player_id character Season-player id: one player's engagement with one club (kept across seasons while he stays, new after a move). Joins box-score lines, actions, records and scb_season_player.
real_player_id integer Global person id: the same across clubs and seasons. Joins to realPlayerId everywhere.
active_season_player_id character The player's current season-player id (his latest club engagement). Joins to ⁠/season-players/{seasonPlayerId}⁠.
first_name character Player's given name.
last_name character Player's family name.
birth_date character Date of birth, YYYY-MM-DD.
position character Position: POINT_GUARD, SHOOTING_GUARD, SMALL_FORWARD, POWER_FORWARD, CENTER.
shirt_number character Jersey number. A number or a numeric string across rows.
height double Height in metres (float32 noise: 1.77 arrives as 1.7699999809265137).
weight integer Weight in kg; 0 when unknown.
nationalities character Nationalities, ISO 3166-1 alpha-2 codes.
is_all_star logical All-Star selection flag.
is_young logical Young-player flag (German-trained youth rule; inferred).
has_changed_teams logical Moved clubs during the season.
bbl_games_played integer Career league games played (BBL host; 0 on DBBL).
team_id character Club id, a string; equal to season_team_id in every sample. Joins to scb_team and scb_season_teams.
team_name character Team name as listed that season (sponsor names included).
previous_teams character Former clubs, free text (German names).
season_ids character Seasons (start years) with this player or club.

See Also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_players(), scb_game_teams(), scb_games(), scb_games_recent(), scb_player_statistics(), scb_playoff_games(), scb_playoff_series(), scb_records_per_game(), scb_records_season_averages(), scb_referees(), scb_season_players(), scb_season_teams(), scb_seasons(), scb_standings(), scb_team(), scb_team_rosters(), scb_team_seasons(), scb_team_statistics(), scb_transfers(), scb_transfers_teams()


Get BBL / DBBL Season Players

Description

Every player registered in a season: the id crosswalk (season_player_id, real_player_id, season_team_id).

Endpoint: ⁠GET https://api.basketball-bundesliga.de/seasons/{season}⁠ (DBBL: the same route on ⁠https://api-1.dbbl.scb.world⁠).

Usage

scb_season_players(season, league = "dbbl")

Arguments

season

(required) Season END year (2026 = 2025-26, the sdv key). Sent to the API as its START-year seasonId (season - 1).

league

(default "dbbl", the women's DBBL) League: bbl (men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) or dbbl (women, Toyota Damen-Basketball-Bundesliga, api-1.dbbl.scb.world). The two share one API; game ids overlap, so a game is (league, game_id).

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

Value

A wehoop_data tibble: Every player registered in a season: the id crosswalk (season_player_id, real_player_id, season_team_id). An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_season_players):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
season integer Season END year (2026 = 2025-26), the sdv key; the API's season_id plus one.
season_id integer The API's own season key, the START year (2025 = 2025-26); season minus one.
season_player_id character Season-player id: one player's engagement with one club (kept across seasons while he stays, new after a move; see README). Joins to box-score seasonPlayer.id, action seasonPlayerId and ⁠/season-players/{seasonPlayerId}⁠.
real_player_id integer Global person id: the same across clubs and seasons. Joins to realPlayerId everywhere.
season_team_id character Season-team id; equal to the club teamId in every sample (BBL 2005-2026, DBBL 2024-2026).
first_name character Player's given name.
last_name character Player's family name.

See Also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_players(), scb_game_teams(), scb_games(), scb_games_recent(), scb_player_statistics(), scb_playoff_games(), scb_playoff_series(), scb_records_per_game(), scb_records_season_averages(), scb_referees(), scb_season_player(), scb_season_teams(), scb_seasons(), scb_standings(), scb_team(), scb_team_rosters(), scb_team_seasons(), scb_team_statistics(), scb_transfers(), scb_transfers_teams()

Examples

try(scb_season_players(season = 2026))

Get BBL / DBBL Season Teams

Description

Every team of a season: club id, season-team id, name and three-letter code.

Endpoint: ⁠GET https://api.basketball-bundesliga.de/seasons/{season}⁠ (DBBL: the same route on ⁠https://api-1.dbbl.scb.world⁠).

Usage

scb_season_teams(season, league = "dbbl")

Arguments

season

(required) Season END year (2026 = 2025-26, the sdv key). Sent to the API as its START-year seasonId (season - 1).

league

(default "dbbl", the women's DBBL) League: bbl (men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) or dbbl (women, Toyota Damen-Basketball-Bundesliga, api-1.dbbl.scb.world). The two share one API; game ids overlap, so a game is (league, game_id).

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

Value

A wehoop_data tibble: Every team of a season: club id, season-team id, name and three-letter code. An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_season_teams):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
season integer Season END year (2026 = 2025-26), the sdv key; the API's season_id plus one.
season_id integer The API's own season key, the START year (2025 = 2025-26); season minus one.
team_id character Club id; equal to seasonTeamId in every sample. Joins to ⁠/teams/{teamId}⁠.
season_team_id character Season-team id; equal to the club teamId in every sample (BBL 2005-2026, DBBL 2024-2026).
team_name character Team name as listed that season (sponsor names included).
tlc character Three-letter club code.
logo_url character Logo image URL (per season).

See Also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_players(), scb_game_teams(), scb_games(), scb_games_recent(), scb_player_statistics(), scb_playoff_games(), scb_playoff_series(), scb_records_per_game(), scb_records_season_averages(), scb_referees(), scb_season_player(), scb_season_players(), scb_seasons(), scb_standings(), scb_team(), scb_team_rosters(), scb_team_seasons(), scb_team_statistics(), scb_transfers(), scb_transfers_teams()

Examples

try(scb_season_teams(season = 2026))

Get BBL / DBBL Seasons

Description

Seasons, newest first, with the active flag (BBL back to 1966, DBBL 2024 on).

Endpoint: ⁠GET https://api.basketball-bundesliga.de/seasons⁠ (DBBL: the same route on ⁠https://api-1.dbbl.scb.world⁠).

Usage

scb_seasons(league = "dbbl")

Arguments

league

(default "dbbl", the women's DBBL) League: bbl (men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) or dbbl (women, Toyota Damen-Basketball-Bundesliga, api-1.dbbl.scb.world). The two share one API; game ids overlap, so a game is (league, game_id).

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

Value

A wehoop_data tibble: Seasons, newest first, with the active flag (BBL back to 1966, DBBL 2024 on). An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_seasons):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
season integer Season END year (2026 = 2025-26), the sdv key; the API's season_id plus one.
season_id integer The API's own season key, the START year (2025 = 2025-26); season minus one.
is_active logical True for the season in progress.

See Also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_players(), scb_game_teams(), scb_games(), scb_games_recent(), scb_player_statistics(), scb_playoff_games(), scb_playoff_series(), scb_records_per_game(), scb_records_season_averages(), scb_referees(), scb_season_player(), scb_season_players(), scb_season_teams(), scb_standings(), scb_team(), scb_team_rosters(), scb_team_seasons(), scb_team_statistics(), scb_transfers(), scb_transfers_teams()

Examples

try(scb_seasons())

Get BBL / DBBL Standings

Description

League table of a season: record, home / away split, streaks and tie-break detail (2005-06 on).

Endpoint: ⁠GET https://api.basketball-bundesliga.de/standings⁠ (DBBL: the same route on ⁠https://api-1.dbbl.scb.world⁠).

Usage

scb_standings(league = "dbbl", season = NULL, competition = NULL)

Arguments

league

(default "dbbl", the women's DBBL) League: bbl (men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) or dbbl (women, Toyota Damen-Basketball-Bundesliga, api-1.dbbl.scb.world). The two share one API; game ids overlap, so a game is (league, game_id).

season

(default NULL) Season END year (2026 = 2025-26, the sdv key). Sent to the API as its START-year seasonId (season - 1). Omitted = the season in progress. Seasons before about 2000 answer an empty table.

competition

(default NULL) Competition: BBL, BBL_CUP, ALLSTAR, CHAMPIONS_CUP (BBL host) or DBBL, DBBL_CUP (DBBL host). BBL_CUP answers an empty table.

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

Value

A wehoop_data tibble: League table of a season: record, home / away split, streaks and tie-break detail (2005-06 on). An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_standings):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
season integer Season END year (2026 = 2025-26), the sdv key; the API's season_id plus one.
standing_id character Opaque id of the standings row, a string.
season_team_id character Season-team id; equal to the club teamId in every sample (BBL 2005-2026, DBBL 2024-2026). An integer here.
team_id character Club id; equal to seasonTeamId in every sample. Joins to ⁠/teams/{teamId}⁠.
team_name character Team name; null on some rows.
team_tlc character Three-letter club code.
team_name_short character Short team name (null on DBBL).
has_reached_playoffs logical Clinched a playoff place.
has_reached_playins logical Clinched at least the play-ins.
is_relegation_certain logical Relegated for certain.
season_id integer Season, START year (2026 = 2026-27).
competition character Competition: BBL, BBL_CUP (Pokal), ALLSTAR, CHAMPIONS_CUP on the BBL host; DBBL, DBBL_CUP on the DBBL host.
stage character Stage: MAIN_ROUND (Hauptrunde, regular season), PLAYINS, FIRST_ROUND, SECOND_ROUND, ROUND_OF_16 (Achtelfinale), ROUND_OF_8 (Viertelfinale), SEMI_FINALS, FINALS, THIRD_PLACE_GAME, QUALIFICATION, GROUP_STAGE.
rank integer Table position.
streak character Current streak: W or L; empty when none.
streak_count integer Length of the current streak.
point_corrections character Table-point deductions; [] in every sample.
home_victories integer Home games: wins.
home_losses integer Home games: number of losses in the table.
home_victory_percentage double Home games: win percentage, 0-100.
away_victories integer Away games: wins.
away_losses integer Away games: number of losses in the table.
away_victory_percentage double Away games: win percentage, 0-100.
table_points integer Table points scored (2 per win), from the API's totalPointsMade; the provider's notes call its 'Points' fields table points.
table_points_against integer Table points conceded (2 per loss), from the API's totalPointsAgainst; per the provider's notes, table points.
total_victory_percentage double All games: win percentage, 0-100.
total_games integer Games played in the table (home and away together).
total_victories integer All games: wins.
total_losses integer Losses in the table over all games.
last10_victories integer Wins in the last 10 games.
last10_losses integer Losses in the last 10 games.
last10_percentage double Win percentage over the last 10 games, 0-100.
last10_outcomes character Results of the last games, newest first: W or L.
home_last10_victories integer Home games: last 10 games, wins.
home_last10_losses integer Home games: last 10 games, losses.
home_last10_victory_percentage double Home games: last 10 games, win percentage, 0-100.
home_streak character Home games: current streak, W or L.
home_streak_count integer Home games: length of the current streak.
away_last10_victories integer Away games: last 10 games, wins.
away_last10_losses integer Away games: last 10 games, losses.
away_last10_victory_percentage double Away games: last 10 games, win percentage, 0-100.
away_streak character Away games: current streak, W or L.
away_streak_count integer Away games: length of the current streak.
updated_date character Last update of the row, ISO 8601 UTC.
ranking_comparison_info character Tie-break detail among teams level on record.
home_points_for integer Home games: basketball points scored (the API's football-style GoalsMade).
away_points_for integer Away games: basketball points scored (the API's football-style GoalsMade).
total_points_for integer All games: basketball points scored (the API's football-style GoalsMade).
home_points_against integer Home games: basketball points allowed (the API's football-style GoalsAgainst).
away_points_against integer Away games: basketball points allowed (the API's football-style GoalsAgainst).
total_points_against integer All games: basketball points allowed (the API's football-style GoalsAgainst).
home_point_difference integer Home games: point differential, scored minus allowed (the API's GoalDifference).
away_point_difference integer Away games: point differential, scored minus allowed (the API's GoalDifference).
total_point_difference integer All games: point differential, scored minus allowed (the API's GoalDifference).

See Also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_players(), scb_game_teams(), scb_games(), scb_games_recent(), scb_player_statistics(), scb_playoff_games(), scb_playoff_series(), scb_records_per_game(), scb_records_season_averages(), scb_referees(), scb_season_player(), scb_season_players(), scb_season_teams(), scb_seasons(), scb_team(), scb_team_rosters(), scb_team_seasons(), scb_team_statistics(), scb_transfers(), scb_transfers_teams()

Examples

try(scb_standings())

Get BBL / DBBL Team Profile

Description

Club profile: names, code, home page, ticket shop, year joined and honours.

Endpoint: ⁠GET https://api.basketball-bundesliga.de/teams/{team_id}⁠ (DBBL: the same route on ⁠https://api-1.dbbl.scb.world⁠).

Usage

scb_team(team_id, league = "dbbl")

Arguments

team_id

(required) Club id (team_id in scb_season_teams), e.g. 413 (ALBA BERLIN).

league

(default "dbbl", the women's DBBL) League: bbl (men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) or dbbl (women, Toyota Damen-Basketball-Bundesliga, api-1.dbbl.scb.world). The two share one API; game ids overlap, so a game is (league, game_id).

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

 scb_team(team_id = "413")

Value

A wehoop_data tibble: Club profile: names, code, home page, ticket shop, year joined and honours. An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_team):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
team_id character Club id, a string; equal to season_team_id in every sample. Joins to scb_team and scb_season_teams.
tlc character Three-letter club code.
name_full character Full club name as the API lists it today.
name_short character Short name (often the city); null on DBBL.
mascot character Club mascot name (null when none).
homepage_url character Club website address as sent (it can lack the scheme).
ticket_url character Ticket shop URL.
year_joined_bbl integer Year the club joined the league.
order_id integer Display order of the club on the site; null on some clubs.
best_achievements character Honours, German free text (Deutscher Meister = German champion, Pokalsieger = cup winner, Vizepokalsieger = cup runner-up).

See Also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_players(), scb_game_teams(), scb_games(), scb_games_recent(), scb_player_statistics(), scb_playoff_games(), scb_playoff_series(), scb_records_per_game(), scb_records_season_averages(), scb_referees(), scb_season_player(), scb_season_players(), scb_season_teams(), scb_seasons(), scb_standings(), scb_team_rosters(), scb_team_seasons(), scb_team_statistics(), scb_transfers(), scb_transfers_teams()


Get BBL Team Rosters

Description

Per club, the current roster, one row per player (BBL only).

Endpoint: ⁠GET https://api.basketball-bundesliga.de/transfers/teams⁠

Usage

scb_team_rosters()

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

 scb_team_rosters()

Value

A wehoop_data tibble: Per club, the current roster, one row per player (BBL only). An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_team_rosters):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
team_id character Club id, a string; equal to season_team_id in every sample. Joins to scb_team and scb_season_teams.
season integer Season END year (2026 = 2025-26), the sdv key; the API's season_id plus one.
season_id integer Season, START year (2026 = 2026-27).
season_team_id character Season-team id; equal to the club teamId in every sample (BBL 2005-2026, DBBL 2024-2026).
season_player_id character Season-player id: one player's engagement with one club (kept across seasons while he stays, new after a move). Joins box-score lines, actions, records and scb_season_player.
real_player_id integer Global person id: the same across clubs and seasons. Joins to realPlayerId everywhere.
first_name character Player's given name.
last_name character Player's family name.
birth_date character Date of birth, YYYY-MM-DD.
position character Position: POINT_GUARD, SHOOTING_GUARD, SMALL_FORWARD, POWER_FORWARD, CENTER.
shirt_number character Jersey number as sent (a string: it can be 00).
height double Height in metres (float32 noise: 1.77 arrives as 1.7699999809265137).
weight integer Weight in kg; 0 when unknown.
nationalities character Nationalities, ISO 3166-1 alpha-2 codes.
is_all_star logical All-Star selection flag.
is_young logical Young-player flag (German-trained youth rule; inferred).

See Also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_players(), scb_game_teams(), scb_games(), scb_games_recent(), scb_player_statistics(), scb_playoff_games(), scb_playoff_series(), scb_records_per_game(), scb_records_season_averages(), scb_referees(), scb_season_player(), scb_season_players(), scb_season_teams(), scb_seasons(), scb_standings(), scb_team(), scb_team_seasons(), scb_team_statistics(), scb_transfers(), scb_transfers_teams()


Get BBL / DBBL Team Seasons

Description

Every season a club played: its name that season and its championship and cup titles.

Endpoint: ⁠GET https://api.basketball-bundesliga.de/teams/{team_id}⁠ (DBBL: the same route on ⁠https://api-1.dbbl.scb.world⁠).

Usage

scb_team_seasons(team_id, league = "dbbl")

Arguments

team_id

(required) Club id (team_id in scb_season_teams), e.g. 413 (ALBA BERLIN).

league

(default "dbbl", the women's DBBL) League: bbl (men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) or dbbl (women, Toyota Damen-Basketball-Bundesliga, api-1.dbbl.scb.world). The two share one API; game ids overlap, so a game is (league, game_id).

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

 scb_team_seasons(team_id = "413")

Value

A wehoop_data tibble: Every season a club played: its name that season and its championship and cup titles. An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_team_seasons):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
team_id character Club id, a string; equal to season_team_id in every sample. Joins to scb_team and scb_season_teams.
season integer Season END year (2026 = 2025-26), the sdv key; the API's season_id plus one.
season_id integer Season, START year (2026 = 2026-27).
season_team_id character Season-team id, a string; equal to the club team_id in every sample (BBL 2005-2026, DBBL 2024-2026).
team_name character Team name as listed that season (sponsor names included).
is_championship_winner logical Won the championship that season.
is_cup_winner logical Won the cup that season.

See Also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_players(), scb_game_teams(), scb_games(), scb_games_recent(), scb_player_statistics(), scb_playoff_games(), scb_playoff_series(), scb_records_per_game(), scb_records_season_averages(), scb_referees(), scb_season_player(), scb_season_players(), scb_season_teams(), scb_seasons(), scb_standings(), scb_team(), scb_team_rosters(), scb_team_statistics(), scb_transfers(), scb_transfers_teams()


Get BBL / DBBL Season Team Statistics

Description

Season team stat table: totals and per-game values, one row per team and stat block.

Endpoint: ⁠GET https://api.basketball-bundesliga.de/seasons/{season}/team-statistics⁠ (DBBL: the same route on ⁠https://api-1.dbbl.scb.world⁠).

Usage

scb_team_statistics(season, league = "dbbl", display_type = "MAIN_ROUND")

Arguments

season

(required) Season END year (2026 = 2025-26, the sdv key). Sent to the API as its START-year seasonId (season - 1).

league

(default "dbbl", the women's DBBL) League: bbl (men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) or dbbl (women, Toyota Damen-Basketball-Bundesliga, api-1.dbbl.scb.world). The two share one API; game ids overlap, so a game is (league, game_id).

display_type

(default "MAIN_ROUND") Which games the table covers: MAIN_ROUND (regular season), PLAYOFFS, PLAYOFFS_TOTAL, MAIN_ROUND_AND_PLAY_OFFS or CUP.

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

Value

A wehoop_data tibble: Season team stat table: totals and per-game values, one row per team and stat block. An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_team_statistics):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
season integer Season END year (2026 = 2025-26), the sdv key; the API's season_id plus one.
display_type character Which games the table covers, echoed from the request (MAIN_ROUND, PLAYOFFS, PLAYOFFS_TOTAL, MAIN_ROUND_AND_PLAY_OFFS or CUP).
team_id character Club id; equal to seasonTeamId in every sample. Joins to ⁠/teams/{teamId}⁠.
season_team_id character Season-team id; equal to the club teamId in every sample (BBL 2005-2026, DBBL 2024-2026).
team_name character Team name as listed that season (sponsor names included, e.g. 'EWE Baskets Oldenburg').
team_tlc character Three-letter club code.
season_id integer Season, START year (2026 = 2026-27).
round_code integer Provider round code; 1 for MAIN_ROUND in every sample (mapping unverified).
competition character Competition: BBL, BBL_CUP (Pokal), ALLSTAR, CHAMPIONS_CUP on the BBL host; DBBL, DBBL_CUP on the DBBL host.
aggregation character Aggregation label as sent: STAGE in player tables, MAIN_ROUND in team tables.
seconds_played integer The team's season total playing time in SECONDS over displayType.
points integer The team's season total points over displayType.
two_point_shots_made integer The team's season total 2-point field goals made over displayType.
two_point_shots_attempted integer The team's season total 2-point field goals attempted over displayType.
two_point_shot_success_percent double The team's season total 2-point field-goal percentage over displaytype, 0-100 (one decimal); 0 when no attempts.
three_point_shots_made integer The team's season total 3-point field goals made over displayType.
three_point_shots_attempted integer The team's season total 3-point field goals attempted over displayType.
three_point_shot_success_percent double The team's season total 3-point field-goal percentage over displaytype, 0-100 (one decimal); 0 when no attempts.
field_goals_made integer The team's season total field goals made over displayType.
field_goals_attempted integer The team's season total field goals attempted over displayType.
field_goals_success_percent double The team's season total field-goal percentage over displaytype, 0-100 (one decimal); 0 when no attempts.
free_throws_made integer The team's season total free throws made over displayType.
free_throws_attempted integer The team's season total free throws attempted over displayType.
free_throws_success_percent double The team's season total free-throw percentage over displaytype, 0-100 (one decimal); 0 when no attempts.
offensive_rebounds integer The team's season total offensive rebounds over displayType.
defensive_rebounds integer The team's season total defensive rebounds over displayType.
total_rebounds integer The team's season total rebounds (offensive + defensive) over displayType.
assists integer The team's season total assists over displayType.
steals integer The team's season total steals over displayType.
turnovers integer The team's season total turnovers over displayType.
blocks integer The team's season total blocked shots over displayType.
fouls_committed integer The team's season total fouls committed over displayType.
efficiency integer The team's season total efficiency (EFF = PTS + REB + AST + STL + BLK - missed FG - missed FT - TO; checked on a 2026 box score) over displayType.
plus_minus integer The team's season total plus-minus over displaytype.
games_played integer The team's season total games played over displayType.
seconds_per_game double Per-game average of seconds, seconds.
points_per_game double Per-game average of points.
two_point_shots_made_per_game double Per-game average of 2-point field goals made.
two_point_shots_attempted_per_game double Per-game average of 2-point field goals attempted.
three_point_shots_made_per_game double Per-game average of 3-point field goals made.
three_point_shots_attempted_per_game double Per-game average of 3-point field goals attempted.
field_goals_made_per_game double Per-game average of field goals made.
field_goals_attempted_per_game double Per-game average of field goals attempted.
field_goals_success_percent_per_game double Per-game average of field-goal percentage (0 in every sample: unusable).
free_throws_made_per_game double Per-game average of free throws made.
free_throws_attempted_per_game double Per-game average of free throws attempted.
defensive_rebounds_per_game double Per-game average of defensive rebounds.
offensive_rebounds_per_game double Per-game average of offensive rebounds.
total_rebounds_per_game double Per-game average of rebounds (offensive + defensive).
assists_per_game double Per-game average of assists.
steals_per_game double Per-game average of steals.
turnovers_per_game double Per-game average of turnovers.
blocks_per_game double Per-game average of blocked shots.
fouls_committed_per_game double Per-game average of fouls committed.
efficiency_per_game double Per-game average of efficiency (EFF = PTS + REB + AST + STL + BLK - missed FG - missed FT - TO; checked on a 2026 box score).
plus_minus_per_game double Per-game average of plus-minus (point margin while on court).
double_double integer The team's season total double-doubles over displayType.
double_double_per_game double Per-game average of double-doubles.

See Also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_players(), scb_game_teams(), scb_games(), scb_games_recent(), scb_player_statistics(), scb_playoff_games(), scb_playoff_series(), scb_records_per_game(), scb_records_season_averages(), scb_referees(), scb_season_player(), scb_season_players(), scb_season_teams(), scb_seasons(), scb_standings(), scb_team(), scb_team_rosters(), scb_team_seasons(), scb_transfers(), scb_transfers_teams()

Examples

try(scb_team_statistics(season = 2026))

Get BBL Transfers

Description

Latest transfers, one row per move (BBL only).

Endpoint: ⁠GET https://api.basketball-bundesliga.de/transfers⁠

Usage

scb_transfers()

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

 scb_transfers()

Value

A wehoop_data tibble: Latest transfers, one row per move (BBL only). An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_transfers):

col_name type description
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
transfer_date character Date of the transfer, YYYY-MM-DD (the API's sortingDate).
season_player_id character Season-player id: one player's engagement with one club (kept across seasons while he stays, new after a move). Joins box-score lines, actions, records and scb_season_player.
real_player_id integer Global person id (integer): the same player across clubs and seasons. Join players across seasons on this.
first_name character Player's given name.
last_name character Player's family name.
position character Position: POINT_GUARD, SHOOTING_GUARD, SMALL_FORWARD, POWER_FORWARD, CENTER.
source_team_id character Club id the player left; null when the source is not a league club.
source_team_name character Name of the club the player left (the free-text field, else the short club name).
destination_team_id character Club id the player joined; null when the destination is not a league club.
destination_team_name character Name of the club the player joined (the free-text field, else the short club name).

See Also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_players(), scb_game_teams(), scb_games(), scb_games_recent(), scb_player_statistics(), scb_playoff_games(), scb_playoff_series(), scb_records_per_game(), scb_records_season_averages(), scb_referees(), scb_season_player(), scb_season_players(), scb_season_teams(), scb_seasons(), scb_standings(), scb_team(), scb_team_rosters(), scb_team_seasons(), scb_team_statistics(), scb_transfers_teams()


Get BBL Team Transfers

Description

Per club, the players joining and leaving, one row per move with its direction (BBL only).

Endpoint: ⁠GET https://api.basketball-bundesliga.de/transfers/teams⁠

Usage

scb_transfers_teams()

Details

  • Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

  • Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

  • Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

  • Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

  • Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

 scb_transfers_teams()

Value

A wehoop_data tibble: Per club, the players joining and leaving, one row per move with its direction (BBL only). An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_transfers_teams):

col_name type description
team_id character Club id, a string; equal to season_team_id in every sample. Joins to scb_team and scb_season_teams.
direction character joining or leaving: whether team_id is the destination or the source of the move.
league character League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
transfer_date character Date of the transfer, YYYY-MM-DD (the API's sortingDate).
season_player_id character Season-player id: one player's engagement with one club (kept across seasons while he stays, new after a move). Joins box-score lines, actions, records and scb_season_player.
real_player_id integer Global person id (integer): the same player across clubs and seasons. Join players across seasons on this.
first_name character Player's given name.
last_name character Player's family name.
position character Position: POINT_GUARD, SHOOTING_GUARD, SMALL_FORWARD, POWER_FORWARD, CENTER.
source_team_id character Club id the player left; null when the source is not a league club.
source_team_name character Name of the club the player left (the free-text field, else the short club name).
destination_team_id character Club id the player joined; null when the destination is not a league club.
destination_team_name character Name of the club the player joined (the free-text field, else the short club name).

See Also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_players(), scb_game_teams(), scb_games(), scb_games_recent(), scb_player_statistics(), scb_playoff_games(), scb_playoff_series(), scb_records_per_game(), scb_records_season_averages(), scb_referees(), scb_season_player(), scb_season_players(), scb_season_teams(), scb_seasons(), scb_standings(), scb_team(), scb_team_rosters(), scb_team_seasons(), scb_team_statistics(), scb_transfers()


TBF Daily Matches

Description

Every TBF game played on one date, grouped by competition, optionally for one league-season.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Match/get-daily-matches⁠

Usage

tbf_daily_matches(match_date, season = NULL, competition = NULL)

Arguments

match_date

Required. Game date 'YYYY-MM-DD' (Turkey local date), e.g. '2026-10-11'.

season

Optional, with competition: Season END year (2027 = the 2026-2027 season). TBF keys a league-season by internal season and activity ids; the runtime reads them from the league's season list by the END year of the label. A year the list lacks raises wehoop_no_data. Default: games of every competition.

competition

TBF league: bsl (Basketbol Super Ligi), tbl (second tier) or kbsl (women's Super Ligi). The top flight was named TBL until 2007-08 and is listed under bsl. Optional, with season (a season alone reads the kbsl list). Default: every competition.

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

Value

A wehoop_data tibble. One row per game with its group_name (the competition group the app shows). Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
group_name character Competition group the app shows the game under (grup adi).
match_id integer TBF game id (key space: TBF games, ONE global sequence across leagues and seasons: 62552 in 2006-07, 346279 in 2026-27). The match_id argument of every game wrapper; the routes echo it as a string or null, the runtime stamps the integer asked for.
match_code character TBF short game code ('1EA4917'); unique per game, meaning of the letters unverified.
genius_id integer Genius Sports LiveStats match id (TBF spells it genuisId); joins the genius family. Null when TBF stored none: every game before 2018-19, many 2021-25 games and games not yet assigned one.
activity_id integer Activity id (faaliyet = activity; key space: TBF league-SEASONS, new every season: BSL 2026-27 = 22214, BSL 2025-26 = 20728, TBL 2026-27 = 22215, KBSL 2026-27 = 22209). Cast to an integer from the 22214 / 22214.0 the API sends.
activity_name character Activity name ('BSL 2026-2027').
competition character TBF league the row belongs to: bsl, tbl or kbsl (the request's competition, or the league prefix the API reports).
season_id integer Internal TBF season id (key space: TBF seasons, global across leagues: 174 = 2026-2027, 172 = 2025-2026; the odd ids are international UA- seasons). Never an sdv key: use season (END year).
season_label character Season label as TBF writes it, 'YYYY-YYYY' (start and end year).
season integer Season END year (2027 = the 2026-2027 season), read from the 'YYYY-YYYY' label or the request; the sdv season key. Not the internal TBF season id (season_id).
tipoff POSIXct Tip-off as a naive timestamp in Turkey local time (Europe/Istanbul, UTC+3); the API sends no offset.
match_date Date Tip-off date 'YYYY-MM-DD'; equals the MatchDate parameter (checked).
week character Week (hafta) label or number: 'N. Hafta' on schedule rows, the number on standings rows, a playoff round name later in the season.
phase integer Phase code as a string ('1' = first half of the regular season); see get-league-weeks devre_ID.
status_id integer Game status code: 1 = played (Oynandi), 4 = not played (Oynanmadi), 19 = fixture without a date and time. Cast to an integer from the 1 / 1.0 the API sends.
home_team_process_id integer Team-season id (teamProcessId = takimIslemId, 'team registration'; key space: TBF team registrations, a NEW id per club per league-season: Tofas = 265995 in BSL 2026-27). The TeamProcessId parameter of the /Team/ routes. Not the club id (takimID / teamId of the team lists).
home_team character Team name as registered for that season, uppercase with Turkish letters (sponsor name: 'PIZZABULLS BORDO BANDIRMA').
home_score integer Home points (null before the game).
away_team_process_id integer Team-season id (teamProcessId = takimIslemId, 'team registration'; key space: TBF team registrations, a NEW id per club per league-season: Tofas = 265995 in BSL 2026-27). The TeamProcessId parameter of the /Team/ routes. Not the club id (takimID / teamId of the team lists).
away_team character Team name as registered for that season, uppercase with Turkish letters (sponsor name: 'PIZZABULLS BORDO BANDIRMA').
away_score integer Away points (null before the game).
venue character Venue (salon) name.
province character Province (il) of the venue when sent, uppercase Turkish; null otherwise.
gender character Gender in Turkish when sent; empty on get-daily-matches, so null.
broadcast_channel character Broadcaster ('beINSports', 'HT SPOR', 'Youtube / TBF TV'), or ''.
has_overtime logical Overtime flag (uzatma = overtime). Reliability unverified: false on every one of 64 BSL 2025-26 games checked.
status character Game status text in Turkish: Oynandi = played, Oynanmadi = not played.

See Also

Other TBF Functions: tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()

Examples

try(tbf_daily_matches(match_date = "2026-10-11"))

TBF Game Header

Description

Game header of a finished game: teams, coaches, final score, officials, venue and the Genius LiveStats id.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Match/mac-header⁠

Usage

tbf_game_header(match_id)

Arguments

match_id

Required. TBF game id (integer), e.g. 346279; match_id in tbf_schedule(). One global sequence across leagues and seasons. Only a finished game is served.

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

Value

A wehoop_data tibble. One row. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
match_id integer TBF game id (key space: TBF games, ONE global sequence across leagues and seasons: 62552 in 2006-07, 346279 in 2026-27). The match_id argument of every game wrapper; the routes echo it as a string or null, the runtime stamps the integer asked for.
match_code character TBF short game code ('1EA4917').
genius_id integer Genius Sports LiveStats match id (TBF spells it genuisId); joins the genius family. Null when TBF stored none: every game before 2018-19, many 2021-25 games and games not yet assigned one.
activity_id integer Activity id (faaliyet = activity; key space: TBF league-SEASONS, new every season: BSL 2026-27 = 22214, BSL 2025-26 = 20728, TBL 2026-27 = 22215, KBSL 2026-27 = 22209). Cast to an integer from the 22214 / 22214.0 the API sends.
activity_name character Activity name ('BSL 2026-2027').
season_id integer Internal TBF season id (key space: TBF seasons, global across leagues: 174 = 2026-2027, 172 = 2025-2026; the odd ids are international UA- seasons). Never an sdv key: use season (END year).
season_label character Season label 'YYYY-YYYY' (seasonName).
season integer Season END year, read from the season label (seasonName).
tipoff POSIXct Tip-off as a naive timestamp in Turkey local time (Europe/Istanbul, UTC+3).
status_id integer Game status code: 1 = played (Oynandi), 4 = not played (Oynanmadi), 19 = fixture without a date and time. Cast to an integer from the 1 / 1.0 the API sends.
status character Game status text in Turkish: Oynandi = played. Only finished games are served.
venue character Venue name (location) as TBF prints it.
attendance integer Spectator count (matchSpectatorCount); 0 when not recorded.
has_overtime logical Overtime flag (uzatma = overtime). Reliability unverified: false on every one of 64 BSL 2025-26 games checked.
broadcast_channel character Broadcaster (matchBroadcastChannel), e.g. beINSports, or null.
home_team_process_id integer Home team-season id (key space: TBF team registrations; the header calls it homeTeamProcessId).
home_team character Home team name as registered for that season, uppercase with Turkish letters.
home_coach character Home head coach name, uppercase.
home_score integer Home final score.
away_team_process_id integer Away team-season id (key space: TBF team registrations).
away_team character Away team name as registered for that season, uppercase with Turkish letters.
away_coach character Away head coach name, uppercase.
away_score integer Away final score.
referee character Main referee's name (names only: no contact or birth data is returned).
first_assistant_referee character First assistant referee's name.
second_assistant_referee character Second assistant referee's name.
commissioner character Commissioner's (temsilci = representative) name.

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()

Examples

try(tbf_game_header(match_id = 346279))

TBF Game Leaders

Description

Game leaders of a finished game per statistic category (top five each).

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Match/mac-leader⁠

Usage

tbf_game_leaders(match_id)

Arguments

match_id

Required. TBF game id (integer), e.g. 346279; match_id in tbf_schedule(). One global sequence across leagues and seasons. Only a finished game is served.

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

 tbf_game_leaders(match_id = 346279)

Value

A wehoop_data tibble. One row per leader, best first within a category. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
match_id integer TBF game id (key space: TBF games, ONE global sequence across leagues and seasons: 62552 in 2006-07, 346279 in 2026-27). The match_id argument of every game wrapper; the routes echo it as a string or null, the runtime stamps the integer asked for.
category character Leader category code (leaderCategory), e.g. VerimlilikPuani = efficiency rating.
category_label character Leader category label in Turkish (leaderCategoryDescription), e.g. Verimlilik Puani.
rank integer Position in the category's list, 1 = best (top five per category).
side character Side of the leader's team (isHome).
player_id integer TBF person id of the leader (key space: TBF persons; equals the box score player_id).
player_name character Player name as TBF prints it for that route (title case, Turkish letters kept).
jersey_number character Shirt number as a string, so '0' and '00' stay distinct.
value double The leader's value in the category (points, rebounds, ...).

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()


TBF Game Players

Description

Game roster from the header: every listed player of both sides (names and shirt numbers, no usable ids).

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Match/mac-header⁠

Usage

tbf_game_players(match_id)

Arguments

match_id

Required. TBF game id (integer), e.g. 346279; match_id in tbf_schedule(). One global sequence across leagues and seasons. Only a finished game is served.

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

 tbf_game_players(match_id = 346279)

Value

A wehoop_data tibble. One row per rostered player. The header carries no usable player id; join on name + shirt number + side. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
match_id integer TBF game id (key space: TBF games, ONE global sequence across leagues and seasons: 62552 in 2006-07, 346279 in 2026-27). The match_id argument of every game wrapper; the routes echo it as a string or null, the runtime stamps the integer asked for.
side character Side of the game the row belongs to: home or away (from the route's isHome flag or home / away block).
team character Team name for the roster row; empty in the samples, so null.
player_name character Player name as the header roster lists it.
jersey_number character Shirt number as a string, so '0' and '00' stay distinct.
is_starter logical True for a starter in the header roster (isStarter).
is_active logical True when the player is flagged active in the header (isActive).

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()


TBF Highlights

Description

Team comparison of a finished game: rebounds, paint points, fast-break points, lead changes and more.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Match/mac-ozet⁠

Usage

tbf_highlights(match_id)

Arguments

match_id

Required. TBF game id (integer), e.g. 346279; match_id in tbf_schedule(). One global sequence across leagues and seasons. Only a finished game is served.

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

 tbf_highlights(match_id = 346279)

Value

A wehoop_data tibble. One row per statistic with the home and away value. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
match_id integer TBF game id (key space: TBF games, ONE global sequence across leagues and seasons: 62552 in 2006-07, 346279 in 2026-27). The match_id argument of every game wrapper; the routes echo it as a string or null, the runtime stamps the integer asked for.
title character Statistic name in Turkish (Ribaund = rebounds, Asist = assists, Top Kaybi = turnovers).
category character Statistic code (leaderCategory), e.g. PointsFromPaint, LeadChanges, TimeLeading.
home_value character Home value exactly as sent (a string: '90', or '28:38' for TimeLeading).
away_value character Away value exactly as sent (a string: '89', or '8:19' for TimeLeading).
home_number double Home value as a number; null for a time value such as TimeLeading.
away_number double Away value as a number; null for a time value such as TimeLeading.

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()


TBF Leaders: Assists

Description

Season leaders in assists: the server's top 20 by season total and by per-game average.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Player/get-asist-leaders⁠

Usage

tbf_leaders_assists(season, competition = "kbsl")

Arguments

season

Required. Season END year (2027 = the 2026-2027 season). TBF keys a league-season by internal season and activity ids; the runtime reads them from the league's season list by the END year of the label. A year the list lacks raises wehoop_no_data.

competition

TBF league: bsl (Basketbol Super Ligi), tbl (second tier) or kbsl (women's Super Ligi). The top flight was named TBL until 2007-08 and is listed under bsl. Default "kbsl" (the women's Super Ligi).

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

 tbf_leaders_assists(competition = "bsl", season = 2027)

Value

A wehoop_data tibble. Up to 20 rows per kind (total and average), best first. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
season integer Season END year (2027 = the 2026-2027 season), read from the 'YYYY-YYYY' label or the request; the sdv season key. Not the internal TBF season id (season_id).
competition character TBF league the row belongs to: bsl, tbl or kbsl (the request's competition, or the league prefix the API reports).
category character Statistic of the wrapper: points, assists, blocks, rebounds, steals, minutes, threes, turnovers or efficiency.
kind character total = the server's top 20 by season TOTAL; average = the top 20 by PER-GAME average.
rank integer Rank in the list, 1 = best (the API's order).
person_id integer TBF person id (oyuncuKodu, sent as a string; key space: TBF persons).
player_name character Player name as TBF prints it for that route (title case, Turkish letters kept).
team_process_id integer Team-season id (takimKodu, sent as a string; key space: TBF team registrations; despite the name NOT the club id).
team_name character Team name as registered for that season, uppercase with Turkish letters (sponsor name: 'PIZZABULLS BORDO BANDIRMA').
games integer Games played (macSayisi, sent as a string).
value double The ranked statistic: the season total for kind total, the per-game average for kind average (the API names the field grup and sends it as a string).

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()


TBF Leaders: Blocks

Description

Season leaders in blocks: the server's top 20 by season total and by per-game average.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Player/get-blok-leaders⁠

Usage

tbf_leaders_blocks(season, competition = "kbsl")

Arguments

season

Required. Season END year (2027 = the 2026-2027 season). TBF keys a league-season by internal season and activity ids; the runtime reads them from the league's season list by the END year of the label. A year the list lacks raises wehoop_no_data.

competition

TBF league: bsl (Basketbol Super Ligi), tbl (second tier) or kbsl (women's Super Ligi). The top flight was named TBL until 2007-08 and is listed under bsl. Default "kbsl" (the women's Super Ligi).

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

 tbf_leaders_blocks(competition = "bsl", season = 2027)

Value

A wehoop_data tibble. Up to 20 rows per kind (total and average), best first. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
season integer Season END year (2027 = the 2026-2027 season), read from the 'YYYY-YYYY' label or the request; the sdv season key. Not the internal TBF season id (season_id).
competition character TBF league the row belongs to: bsl, tbl or kbsl (the request's competition, or the league prefix the API reports).
category character Statistic of the wrapper: points, assists, blocks, rebounds, steals, minutes, threes, turnovers or efficiency.
kind character total = the server's top 20 by season TOTAL; average = the top 20 by PER-GAME average.
rank integer Rank in the list, 1 = best (the API's order).
person_id integer TBF person id (oyuncuKodu, sent as a string; key space: TBF persons).
player_name character Player name as TBF prints it for that route (title case, Turkish letters kept).
team_process_id integer Team-season id (takimKodu, sent as a string; key space: TBF team registrations; despite the name NOT the club id).
team_name character Team name as registered for that season, uppercase with Turkish letters (sponsor name: 'PIZZABULLS BORDO BANDIRMA').
games integer Games played (macSayisi, sent as a string).
value double The ranked statistic: the season total for kind total, the per-game average for kind average (the API names the field grup and sends it as a string).

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()


TBF Leaders: Efficiency

Description

Season leaders in efficiency rating: the server's top 20 by season total and by per-game average.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Player/get-mvp-leaders⁠

Usage

tbf_leaders_efficiency(season, competition = "kbsl")

Arguments

season

Required. Season END year (2027 = the 2026-2027 season). TBF keys a league-season by internal season and activity ids; the runtime reads them from the league's season list by the END year of the label. A year the list lacks raises wehoop_no_data.

competition

TBF league: bsl (Basketbol Super Ligi), tbl (second tier) or kbsl (women's Super Ligi). The top flight was named TBL until 2007-08 and is listed under bsl. Default "kbsl" (the women's Super Ligi).

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

 tbf_leaders_efficiency(competition = "bsl", season = 2027)

Value

A wehoop_data tibble. Up to 20 rows per kind (total and average), best first. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
season integer Season END year (2027 = the 2026-2027 season), read from the 'YYYY-YYYY' label or the request; the sdv season key. Not the internal TBF season id (season_id).
competition character TBF league the row belongs to: bsl, tbl or kbsl (the request's competition, or the league prefix the API reports).
category character Statistic of the wrapper: points, assists, blocks, rebounds, steals, minutes, threes, turnovers or efficiency.
kind character total = the server's top 20 by season TOTAL; average = the top 20 by PER-GAME average.
rank integer Rank in the list, 1 = best (the API's order).
person_id integer TBF person id (oyuncuKodu, sent as a string; key space: TBF persons).
player_name character Player name as TBF prints it for that route (title case, Turkish letters kept).
team_process_id integer Team-season id (takimKodu, sent as a string; key space: TBF team registrations; despite the name NOT the club id).
team_name character Team name as registered for that season, uppercase with Turkish letters (sponsor name: 'PIZZABULLS BORDO BANDIRMA').
games integer Games played (macSayisi, sent as a string).
value double The ranked statistic: the season total for kind total, the per-game average for kind average (the API names the field grup and sends it as a string).

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()


TBF Leaders: Minutes

Description

Season leaders in minutes played: the server's top 20 by season total and by per-game average.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Player/get-duration-leaders⁠

Usage

tbf_leaders_minutes(season, competition = "kbsl")

Arguments

season

Required. Season END year (2027 = the 2026-2027 season). TBF keys a league-season by internal season and activity ids; the runtime reads them from the league's season list by the END year of the label. A year the list lacks raises wehoop_no_data.

competition

TBF league: bsl (Basketbol Super Ligi), tbl (second tier) or kbsl (women's Super Ligi). The top flight was named TBL until 2007-08 and is listed under bsl. Default "kbsl" (the women's Super Ligi).

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

 tbf_leaders_minutes(competition = "bsl", season = 2027)

Value

A wehoop_data tibble. Up to 20 rows per kind (total and average), best first. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
season integer Season END year (2027 = the 2026-2027 season), read from the 'YYYY-YYYY' label or the request; the sdv season key. Not the internal TBF season id (season_id).
competition character TBF league the row belongs to: bsl, tbl or kbsl (the request's competition, or the league prefix the API reports).
category character Statistic of the wrapper: points, assists, blocks, rebounds, steals, minutes, threes, turnovers or efficiency.
kind character total = the server's top 20 by season TOTAL; average = the top 20 by PER-GAME average.
rank integer Rank in the list, 1 = best (the API's order).
person_id integer TBF person id (oyuncuKodu, sent as a string; key space: TBF persons).
player_name character Player name as TBF prints it for that route (title case, Turkish letters kept).
team_process_id integer Team-season id (takimKodu, sent as a string; key space: TBF team registrations; despite the name NOT the club id).
team_name character Team name as registered for that season, uppercase with Turkish letters (sponsor name: 'PIZZABULLS BORDO BANDIRMA').
games integer Games played (macSayisi, sent as a string).
value double The ranked statistic: the season total for kind total, the per-game average for kind average (the API names the field grup and sends it as a string).

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()


TBF Leaders: Points

Description

Season leaders in points: the server's top 20 by season total and by per-game average.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Player/get-point-leaders⁠

Usage

tbf_leaders_points(season, competition = "kbsl")

Arguments

season

Required. Season END year (2027 = the 2026-2027 season). TBF keys a league-season by internal season and activity ids; the runtime reads them from the league's season list by the END year of the label. A year the list lacks raises wehoop_no_data.

competition

TBF league: bsl (Basketbol Super Ligi), tbl (second tier) or kbsl (women's Super Ligi). The top flight was named TBL until 2007-08 and is listed under bsl. Default "kbsl" (the women's Super Ligi).

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

 tbf_leaders_points(competition = "bsl", season = 2027)

Value

A wehoop_data tibble. Up to 20 rows per kind (total and average), best first. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
season integer Season END year (2027 = the 2026-2027 season), read from the 'YYYY-YYYY' label or the request; the sdv season key. Not the internal TBF season id (season_id).
competition character TBF league the row belongs to: bsl, tbl or kbsl (the request's competition, or the league prefix the API reports).
category character Statistic of the wrapper: points, assists, blocks, rebounds, steals, minutes, threes, turnovers or efficiency.
kind character total = the server's top 20 by season TOTAL; average = the top 20 by PER-GAME average.
rank integer Rank in the list, 1 = best (the API's order).
person_id integer TBF person id (oyuncuKodu, sent as a string; key space: TBF persons).
player_name character Player name as TBF prints it for that route (title case, Turkish letters kept).
team_process_id integer Team-season id (takimKodu, sent as a string; key space: TBF team registrations; despite the name NOT the club id).
team_name character Team name as registered for that season, uppercase with Turkish letters (sponsor name: 'PIZZABULLS BORDO BANDIRMA').
games integer Games played (macSayisi, sent as a string).
value double The ranked statistic: the season total for kind total, the per-game average for kind average (the API names the field grup and sends it as a string).

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()


TBF Leaders: Rebounds

Description

Season leaders in rebounds: the server's top 20 by season total and by per-game average.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Player/get-ribound-leaders⁠

Usage

tbf_leaders_rebounds(season, competition = "kbsl")

Arguments

season

Required. Season END year (2027 = the 2026-2027 season). TBF keys a league-season by internal season and activity ids; the runtime reads them from the league's season list by the END year of the label. A year the list lacks raises wehoop_no_data.

competition

TBF league: bsl (Basketbol Super Ligi), tbl (second tier) or kbsl (women's Super Ligi). The top flight was named TBL until 2007-08 and is listed under bsl. Default "kbsl" (the women's Super Ligi).

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

 tbf_leaders_rebounds(competition = "bsl", season = 2027)

Value

A wehoop_data tibble. Up to 20 rows per kind (total and average), best first. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
season integer Season END year (2027 = the 2026-2027 season), read from the 'YYYY-YYYY' label or the request; the sdv season key. Not the internal TBF season id (season_id).
competition character TBF league the row belongs to: bsl, tbl or kbsl (the request's competition, or the league prefix the API reports).
category character Statistic of the wrapper: points, assists, blocks, rebounds, steals, minutes, threes, turnovers or efficiency.
kind character total = the server's top 20 by season TOTAL; average = the top 20 by PER-GAME average.
rank integer Rank in the list, 1 = best (the API's order).
person_id integer TBF person id (oyuncuKodu, sent as a string; key space: TBF persons).
player_name character Player name as TBF prints it for that route (title case, Turkish letters kept).
team_process_id integer Team-season id (takimKodu, sent as a string; key space: TBF team registrations; despite the name NOT the club id).
team_name character Team name as registered for that season, uppercase with Turkish letters (sponsor name: 'PIZZABULLS BORDO BANDIRMA').
games integer Games played (macSayisi, sent as a string).
value double The ranked statistic: the season total for kind total, the per-game average for kind average (the API names the field grup and sends it as a string).

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()


TBF Leaders: Steals

Description

Season leaders in steals: the server's top 20 by season total and by per-game average.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Player/get-top-calma-leaders⁠

Usage

tbf_leaders_steals(season, competition = "kbsl")

Arguments

season

Required. Season END year (2027 = the 2026-2027 season). TBF keys a league-season by internal season and activity ids; the runtime reads them from the league's season list by the END year of the label. A year the list lacks raises wehoop_no_data.

competition

TBF league: bsl (Basketbol Super Ligi), tbl (second tier) or kbsl (women's Super Ligi). The top flight was named TBL until 2007-08 and is listed under bsl. Default "kbsl" (the women's Super Ligi).

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

 tbf_leaders_steals(competition = "bsl", season = 2027)

Value

A wehoop_data tibble. Up to 20 rows per kind (total and average), best first. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
season integer Season END year (2027 = the 2026-2027 season), read from the 'YYYY-YYYY' label or the request; the sdv season key. Not the internal TBF season id (season_id).
competition character TBF league the row belongs to: bsl, tbl or kbsl (the request's competition, or the league prefix the API reports).
category character Statistic of the wrapper: points, assists, blocks, rebounds, steals, minutes, threes, turnovers or efficiency.
kind character total = the server's top 20 by season TOTAL; average = the top 20 by PER-GAME average.
rank integer Rank in the list, 1 = best (the API's order).
person_id integer TBF person id (oyuncuKodu, sent as a string; key space: TBF persons).
player_name character Player name as TBF prints it for that route (title case, Turkish letters kept).
team_process_id integer Team-season id (takimKodu, sent as a string; key space: TBF team registrations; despite the name NOT the club id).
team_name character Team name as registered for that season, uppercase with Turkish letters (sponsor name: 'PIZZABULLS BORDO BANDIRMA').
games integer Games played (macSayisi, sent as a string).
value double The ranked statistic: the season total for kind total, the per-game average for kind average (the API names the field grup and sends it as a string).

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()


TBF Leaders: Threes

Description

Season leaders in three-point field goals made: the server's top 20 by season total and by per-game average.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Player/get-3Point-leaders⁠

Usage

tbf_leaders_threes(season, competition = "kbsl")

Arguments

season

Required. Season END year (2027 = the 2026-2027 season). TBF keys a league-season by internal season and activity ids; the runtime reads them from the league's season list by the END year of the label. A year the list lacks raises wehoop_no_data.

competition

TBF league: bsl (Basketbol Super Ligi), tbl (second tier) or kbsl (women's Super Ligi). The top flight was named TBL until 2007-08 and is listed under bsl. Default "kbsl" (the women's Super Ligi).

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

 tbf_leaders_threes(competition = "bsl", season = 2027)

Value

A wehoop_data tibble. Up to 20 rows per kind (total and average), best first. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
season integer Season END year (2027 = the 2026-2027 season), read from the 'YYYY-YYYY' label or the request; the sdv season key. Not the internal TBF season id (season_id).
competition character TBF league the row belongs to: bsl, tbl or kbsl (the request's competition, or the league prefix the API reports).
category character Statistic of the wrapper: points, assists, blocks, rebounds, steals, minutes, threes, turnovers or efficiency.
kind character total = the server's top 20 by season TOTAL; average = the top 20 by PER-GAME average.
rank integer Rank in the list, 1 = best (the API's order).
person_id integer TBF person id (oyuncuKodu, sent as a string; key space: TBF persons).
player_name character Player name as TBF prints it for that route (title case, Turkish letters kept).
team_process_id integer Team-season id (takimKodu, sent as a string; key space: TBF team registrations; despite the name NOT the club id).
team_name character Team name as registered for that season, uppercase with Turkish letters (sponsor name: 'PIZZABULLS BORDO BANDIRMA').
games integer Games played (macSayisi, sent as a string).
value double The ranked statistic: the season total for kind total, the per-game average for kind average (the API names the field grup and sends it as a string).

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()


TBF Leaders: Turnovers

Description

Season leaders in turnovers: the server's top 20 by season total and by per-game average.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Player/get-top-kaybi-leaders⁠

Usage

tbf_leaders_turnovers(season, competition = "kbsl")

Arguments

season

Required. Season END year (2027 = the 2026-2027 season). TBF keys a league-season by internal season and activity ids; the runtime reads them from the league's season list by the END year of the label. A year the list lacks raises wehoop_no_data.

competition

TBF league: bsl (Basketbol Super Ligi), tbl (second tier) or kbsl (women's Super Ligi). The top flight was named TBL until 2007-08 and is listed under bsl. Default "kbsl" (the women's Super Ligi).

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

 tbf_leaders_turnovers(competition = "bsl", season = 2027)

Value

A wehoop_data tibble. Up to 20 rows per kind (total and average), best first. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
season integer Season END year (2027 = the 2026-2027 season), read from the 'YYYY-YYYY' label or the request; the sdv season key. Not the internal TBF season id (season_id).
competition character TBF league the row belongs to: bsl, tbl or kbsl (the request's competition, or the league prefix the API reports).
category character Statistic of the wrapper: points, assists, blocks, rebounds, steals, minutes, threes, turnovers or efficiency.
kind character total = the server's top 20 by season TOTAL; average = the top 20 by PER-GAME average.
rank integer Rank in the list, 1 = best (the API's order).
person_id integer TBF person id (oyuncuKodu, sent as a string; key space: TBF persons).
player_name character Player name as TBF prints it for that route (title case, Turkish letters kept).
team_process_id integer Team-season id (takimKodu, sent as a string; key space: TBF team registrations; despite the name NOT the club id).
team_name character Team name as registered for that season, uppercase with Turkish letters (sponsor name: 'PIZZABULLS BORDO BANDIRMA').
games integer Games played (macSayisi, sent as a string).
value double The ranked statistic: the season total for kind total, the per-game average for kind average (the API names the field grup and sends it as a string).

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()


TBF League Seasons

Description

Every season of one TBF league (bsl back to 1966-67) with its activity and season ids.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/League/get-leagues-and-seasons-by-prefix⁠

Usage

tbf_league_seasons(competition = "kbsl")

Arguments

competition

TBF league: bsl (Basketbol Super Ligi), tbl (second tier) or kbsl (women's Super Ligi). The top flight was named TBL until 2007-08 and is listed under bsl. Default "kbsl" (the women's Super Ligi).

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

Value

A wehoop_data tibble. One row per season of the league, newest first. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
activity_id integer Activity id (faaliyet = activity; key space: TBF league-SEASONS, new every season: BSL 2026-27 = 22214, BSL 2025-26 = 20728, TBL 2026-27 = 22215, KBSL 2026-27 = 22209). Cast to an integer from the 22214 / 22214.0 the API sends.
activity_name character League-season name as TBF prints it ('BSL 2026-2027'; the top flight reads 'TBL 2006-2007' until 2007-08).
url character League-season slug, '⁠<prefix>⁠-⁠<YYYY>⁠-⁠<YYYY>⁠' (bsl-2026-2027).
season_id integer Internal TBF season id (key space: TBF seasons, global across leagues: 174 = 2026-2027, 172 = 2025-2026; the odd ids are international UA- seasons). Never an sdv key: use season (END year).
season_label character Season label as TBF writes it, 'YYYY-YYYY' (start and end year).
season integer Season END year (2027 = the 2026-2027 season), read from the 'YYYY-YYYY' label or the request; the sdv season key. Not the internal TBF season id (season_id).
competition character TBF league the row belongs to: bsl, tbl or kbsl (the request's competition, or the league prefix the API reports).

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()

Examples

try(tbf_league_seasons(competition = "bsl"))

TBF Leagues

Description

The featured leagues (league-season activities) of one TBF season: BSL, TBL, KBSL and the others.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/League/get-leagues-for-filter⁠

Usage

tbf_leagues(season)

Arguments

season

Required. Season END year (2027 = the 2026-2027 season). TBF keys a league-season by internal season and activity ids; the runtime reads them from the league's season list by the END year of the label. A year the list lacks raises wehoop_no_data.

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

Value

A wehoop_data tibble. One row per league: BSL, TBL, KBSL, TKBL, TB2L and the youth leagues with their activity_id. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
activity_id integer Activity id (faaliyet = activity; key space: TBF league-SEASONS, new every season: BSL 2026-27 = 22214, BSL 2025-26 = 20728, TBL 2026-27 = 22215, KBSL 2026-27 = 22209). Cast to an integer from the 22214 / 22214.0 the API sends.
name character Activity name '⁠<LEAGUE>⁠ YYYY-YYYY' ('BSL 2026-2027').
display_name character League short name ('BSL', 'KBSL', 'TBL', 'TKBL', 'TB2L', 'BGL', 'BGLK', 'KBBL').
competition character TBF league the row belongs to: bsl, tbl or kbsl (the request's competition, or the league prefix the API reports).
gender character Gender in Turkish: 'Erkek' = men, 'Kadin' = women.
season_id integer Internal TBF season id (key space: TBF seasons, global across leagues: 174 = 2026-2027, 172 = 2025-2026; the odd ids are international UA- seasons). Never an sdv key: use season (END year).
season_label character Season label as TBF writes it, 'YYYY-YYYY' (start and end year).
season integer Season END year (2027 = the 2026-2027 season), read from the 'YYYY-YYYY' label or the request; the sdv season key. Not the internal TBF season id (season_id).
sort integer Display order in the app (integer, 1 = first: BSL).

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()

Examples

try(tbf_leagues(season = 2027))

TBF Play-by-Play

Description

Play-by-play of a finished game (2025-26 onward), in game order, with the running score and an English gloss.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Match/game-flow⁠

Usage

tbf_pbp(match_id)

Arguments

match_id

Required. TBF game id (integer), e.g. 346279; match_id in tbf_schedule(). One global sequence across leagues and seasons. Only a finished game is served.

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

Value

A wehoop_data tibble. One row per event. Games before 2025-26 raise wehoop_no_data. The feed has no player id. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
match_id integer TBF game id (key space: TBF games, ONE global sequence across leagues and seasons: 62552 in 2006-07, 346279 in 2026-27). The match_id argument of every game wrapper; the routes echo it as a string or null, the runtime stamps the integer asked for.
action_number integer Play sequence number (actionNumber); gaps are deleted or hidden actions. Rows are in the API's game order, and a period-end line can carry a LOWER number than the last play of the period (884 after 885 in the sample), so sort by period and clock, not by this number.
period integer Period number (quarterNumber): 1-4; overtime numbering is unverified.
period_type integer Period type code: 1 = regulation, 2 = overtime (from the app code; no overtime game in the samples).
clock character Game clock REMAINING in the period as 'mm:ss' (counts down from 10:00).
seconds_remaining integer Game clock remaining in the period, in seconds.
home_score integer Running home score after the play (the home half of the 'home-away' score text).
away_score integer Running away score after the play (the away half of the score text).
side character Side of the acting team (isHome); null on game events (period start / end, game end).
player_name character Acting player's name; null on game events. The feed carries no player id.
jersey_number character Shirt number as a string, so '0' and '00' stay distinct.
action character Play type in Turkish exactly as TBF sends it (77 values seen).
action_en character English gloss of the Turkish action, from the refs action vocabulary; null for an action not in it.

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()

Examples

try(tbf_pbp(match_id = 346279))

TBF Period Scores

Description

Points each side scored in each period of a finished game, overtime included.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Match/mac-ozet⁠

Usage

tbf_period_scores(match_id)

Arguments

match_id

Required. TBF game id (integer), e.g. 346279; match_id in tbf_schedule(). One global sequence across leagues and seasons. Only a finished game is served.

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

Value

A wehoop_data tibble. One row per side and period (home first). Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
match_id integer TBF game id (key space: TBF games, ONE global sequence across leagues and seasons: 62552 in 2006-07, 346279 in 2026-27). The match_id argument of every game wrapper; the routes echo it as a string or null, the runtime stamps the integer asked for.
side character Side of the score: home (homeTeamScore) or away (awayTeamScore).
period integer Period number (quarter): 1-4 regulation; overtime numbering is unverified.
period_type integer Period type code: 1 = regulation, 2 = overtime (from the app code; no overtime game in the samples).
points integer Points the side scored IN the period (not cumulative).

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()

Examples

try(tbf_period_scores(match_id = 346279))

TBF Player Box Score

Description

Player box score of a finished game: minutes, shooting splits, rebounds, assists, +/- and efficiency.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Match/mac-istatistik⁠

Usage

tbf_player_box(match_id)

Arguments

match_id

Required. TBF game id (integer), e.g. 346279; match_id in tbf_schedule(). One global sequence across leagues and seasons. Only a finished game is served.

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

Value

A wehoop_data tibble. One row per player who is on the sheet; is_starter marks the starting five (none flagged in 2006-07). Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
match_id integer TBF game id (key space: TBF games, ONE global sequence across leagues and seasons: 62552 in 2006-07, 346279 in 2026-27). The match_id argument of every game wrapper; the routes echo it as a string or null, the runtime stamps the integer asked for.
side character Side of the game the row belongs to: home or away (from the route's isHome flag or home / away block).
team_process_id integer Team-season id of the player's side (from the game header; key space: TBF team registrations).
player_id integer TBF person id (key space: TBF persons, stable across seasons and clubs: 196413). The same value as person_id in the player and team tables and the player_id argument of tbf_player_career.
player_name character Player name as TBF prints it for that route (title case, Turkish letters kept).
jersey_number character Shirt number as a string, so '0' and '00' stay distinct.
is_starter logical True for the starting five (homeTopFive / awayTopFive block); none are flagged in 2006-07.
seconds_played integer Time on court in seconds, parsed from the 'mm:ss' or 'hh:mm:ss' text the API sends (team totals sum their players, so 200:00 = 12000).
points integer Points scored in the game (or season) the row covers.
fg_made integer Field goals made, 2PT + 3PT (successfulShots).
fg_attempted integer Field goals attempted, 2PT + 3PT (shotAttempts).
fg_pct integer Field-goal percentage 0-100, rounded to an integer by the API.
fg2_made integer Two-point field goals MADE (the API calls it twoPointShots; attempts are fg2_attempted).
fg2_attempted integer Two-point field goals attempted (twoPointShotAttempts).
fg2_pct integer Two-point percentage 0-100, an integer.
fg3_made integer Three-point field goals MADE (the API calls it threePointShots).
fg3_attempted integer Three-point field goals attempted (threePointShotAttempts).
fg3_pct integer Three-point percentage 0-100, an integer.
ft_made integer Free throws MADE (serbest atis; the API calls it freeThrows).
ft_attempted integer Free throws attempted (freeThrowAttempts).
ft_pct integer Free-throw percentage 0-100, an integer.
off_rebounds integer Offensive rebounds (hucum ribaundu).
def_rebounds integer Defensive rebounds (savunma ribaundu).
rebounds integer Total rebounds (toplam ribaund).
assists integer Assists in this game (asist).
steals integer Steals in this game (top calma).
blocks integer Shots this player blocked in this game (blok).
turnovers integer Turnovers committed in this game (top kaybi).
fouls integer Personal fouls committed (faul).
fouls_drawn integer Fouls drawn (rivalFoul = foul committed by the opponent).
blocks_received integer Own shots blocked by an opponent (blocksReceived).
plus_minus integer Plus/minus while on court (plusMinus); null when the API sends ''.
efficiency integer Efficiency rating (verimlilik puani, PIR): points + rebounds + assists + steals + blocks + fouls drawn - missed shots - turnovers - fouls. An integer on player rows.

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()

Examples

try(tbf_player_box(match_id = 346279))

TBF Player Career

Description

One player's career: a row per season and competition with totals (birth date is not returned).

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Player/get-player-detail-profile-and-career-info/{player_id}⁠

Usage

tbf_player_career(player_id)

Arguments

player_id

Required. TBF person id, e.g. 196413; person_id in tbf_players() and the box score.

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

 tbf_player_career(player_id = 196413)

Value

A wehoop_data tibble. One row per career season and competition. Totals and averages rows are not included. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
person_id integer TBF person id of the player asked for (the player_id argument).
player_name character Player's full name from the profile (the same on every row).
nationality character Nationality as a TURKISH country name from the profile (country).
height_cm integer Height in centimetres from the profile; null when TBF has none.
season_label character Career season as TBF writes it (seasonCode), e.g. 2025-2026.
season integer Career season END year, read from the season label.
team_name character Team the player represented that season, uppercase with Turkish letters (teamName).
activity_name character League-season name (activityName), e.g. 'BSL 2025-2026'.
activity_type_id integer Competition type id (faaliyetTuruId): 1 = BSL, 4 = TBL, 79 = BGL.
activity_id integer Activity id of the league-season (faaliyetAltAlaniId; key space: TBF league-seasons).
games integer Games played (macSayisi = game count).
seconds_played integer Total time on court that season in seconds (formattedTotalSeconds 'hh:mm:ss').
points integer Points scored in the game (or season) the row covers.
assists integer Assists in that season and competition.
fg_made integer Field goals made (fieldGoalsMade), 2PT + 3PT.
fg_attempted integer Field goals attempted (fieldGoalsAttempted), 2PT + 3PT.
fg3_made integer Three-point field goals made (threePointsMade).
fg3_attempted integer Three-point field goals attempted (threePointsAttempted).
ft_made integer Free throws made (the API spells the field freeThows).
ft_attempted integer Free throws attempted (freeThowsAttempted).
off_rebounds integer Offensive rebounds in that season and competition.
def_rebounds integer Defensive rebounds in that season and competition.
rebounds integer Total rebounds in that season and competition.
steals integer Steals in that season and competition.
turnovers integer Turnovers (the API spells the field tournovers).
blocks integer Blocks in that season and competition.
fouls integer Personal fouls (the API spells the field fauls).
efficiency integer Efficiency rating total (playerEfficiency, PIR) for that season and competition.
fouls_drawn integer Fouls drawn (yapilanFaul).
blocks_received integer Own shots blocked by an opponent (yenilenBlok).

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()


TBF Players

Description

Every player registered in one league-season (birth dates are not returned).

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Player/get-player-list⁠

Usage

tbf_players(season, competition = "kbsl")

Arguments

season

Required. Season END year (2027 = the 2026-2027 season). TBF keys a league-season by internal season and activity ids; the runtime reads them from the league's season list by the END year of the label. A year the list lacks raises wehoop_no_data.

competition

TBF league: bsl (Basketbol Super Ligi), tbl (second tier) or kbsl (women's Super Ligi). The top flight was named TBL until 2007-08 and is listed under bsl. Default "kbsl" (the women's Super Ligi).

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

Value

A wehoop_data tibble. One row per registered player. Birth dates are not returned. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
season integer Season END year of the request.
competition character League prefix the row reports (bsl, tbl or kbsl); equals the request's competition.
person_id integer TBF person id (kisiID; key space: TBF persons, stable across seasons and clubs).
player_name character Player name as TBF prints it for that route (title case, Turkish letters kept).
nationality character Nationality as a TURKISH country name (ABD = United States); see the nationality_code.
nationality_code character Nationality code (tabiyetKisa), ISO 3166-1 alpha-3 except GB for the United Kingdom.
club_id integer Stable club id (takimID / teamId of the team lists; key space: TBF clubs, the same across seasons and leagues: Tofas = 13). Not the team-season id (team_process_id).
team_name character Team name for that season, uppercase with Turkish letters.
jersey_number character Shirt number as a string, so '0' and '00' stay distinct.
prefix character League prefix of the row (bsl, tbl, kbsl); the runtime refuses any other than the request's.
season_id integer Internal TBF season id (key space: TBF seasons, global across leagues: 174 = 2026-2027, 172 = 2025-2026; the odd ids are international UA- seasons). Never an sdv key: use season (END year).

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()

Examples

try(tbf_players(competition = "bsl", season = 2027))

TBF Schedule

Description

Schedule and results of one league-season: the games of one week, or of every week.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Match/get-all-matches-for-filter⁠

Usage

tbf_schedule(season, competition = "kbsl", week = NULL)

Arguments

season

Required. Season END year (2027 = the 2026-2027 season). TBF keys a league-season by internal season and activity ids; the runtime reads them from the league's season list by the END year of the label. A year the list lacks raises wehoop_no_data.

competition

TBF league: bsl (Basketbol Super Ligi), tbl (second tier) or kbsl (women's Super Ligi). The top flight was named TBL until 2007-08 and is listed under bsl. Default "kbsl" (the women's Super Ligi).

week

Week (hafta) number as returned by tbf_weeks(), e.g. 1; playoff rounds continue the numbering (31-33 in 2025-26). Default: the latest week for standings, every week for the schedule.

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

Value

A wehoop_data tibble. One row per game. Scores are null before the game; status_id 1 = played, 4 = not played, 19 = no date yet. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
match_id integer TBF game id (key space: TBF games, ONE global sequence across leagues and seasons: 62552 in 2006-07, 346279 in 2026-27). The match_id argument of every game wrapper; the routes echo it as a string or null, the runtime stamps the integer asked for.
match_code character TBF short game code ('1EA4917'); unique per game, meaning of the letters unverified.
genius_id integer Genius Sports LiveStats match id (TBF spells it genuisId); joins the genius family. Null when TBF stored none: every game before 2018-19, many 2021-25 games and games not yet assigned one.
activity_id integer Activity id (faaliyet = activity; key space: TBF league-SEASONS, new every season: BSL 2026-27 = 22214, BSL 2025-26 = 20728, TBL 2026-27 = 22215, KBSL 2026-27 = 22209). Cast to an integer from the 22214 / 22214.0 the API sends.
activity_name character Activity name ('BSL 2026-2027').
competition character TBF league the row belongs to: bsl, tbl or kbsl (the request's competition, or the league prefix the API reports).
season_id integer Internal TBF season id (key space: TBF seasons, global across leagues: 174 = 2026-2027, 172 = 2025-2026; the odd ids are international UA- seasons). Never an sdv key: use season (END year).
season_label character Season label as TBF writes it, 'YYYY-YYYY' (start and end year).
season integer Season END year (2027 = the 2026-2027 season), read from the 'YYYY-YYYY' label or the request; the sdv season key. Not the internal TBF season id (season_id).
tipoff POSIXct Tip-off as a naive timestamp in Turkey local time (Europe/Istanbul, UTC+3); the API sends no offset.
match_date Date Tip-off date 'YYYY-MM-DD' (Turkey local).
week character Week label: 'N. Hafta' (week N) or the playoff round ('Playoff Final').
phase integer Phase code as an integer: 1 = first half of the regular season; see tbf_weeks.
status_id integer Game status code: 1 = played (Oynandi), 4 = not played (Oynanmadi), 19 = fixture without a date and time. Cast to an integer from the 1 / 1.0 the API sends.
home_team_process_id integer Team-season id (teamProcessId = takimIslemId, 'team registration'; key space: TBF team registrations, a NEW id per club per league-season: Tofas = 265995 in BSL 2026-27). The TeamProcessId parameter of the /Team/ routes. Not the club id (takimID / teamId of the team lists).
home_team character Team name as registered for that season, uppercase with Turkish letters (sponsor name: 'PIZZABULLS BORDO BANDIRMA').
home_score integer Home points (null before the game; the API sends '' ).
away_team_process_id integer Team-season id (teamProcessId = takimIslemId, 'team registration'; key space: TBF team registrations, a NEW id per club per league-season: Tofas = 265995 in BSL 2026-27). The TeamProcessId parameter of the /Team/ routes. Not the club id (takimID / teamId of the team lists).
away_team character Team name as registered for that season, uppercase with Turkish letters (sponsor name: 'PIZZABULLS BORDO BANDIRMA').
away_score integer Away points (null before the game; the API sends '' ).
venue character Venue (salon) name.
province character Province (il) of the venue, uppercase Turkish ('ISTANBUL').
gender character Gender in Turkish: Erkek = men, Kadin = women.
broadcast_channel character Broadcaster ('beINSports', 'HT SPOR', 'Youtube / TBF TV'), or ''.
has_overtime logical Overtime flag (uzatma = overtime). Reliability unverified: false on every one of 64 BSL 2025-26 games checked.

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()

Examples

try(tbf_schedule(competition = "bsl", season = 2027, week = 1))

TBF Seasons

Description

The 20 most recent TBF seasons, domestic and international (a server cap), newest first.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Season/get-seasons⁠

Usage

tbf_seasons()

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

Value

A wehoop_data tibble. One row per season, newest first. season is the END year of the label (2026-2027 -> 2027); international marks the odd ⁠UA-⁠ seasons. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
season_id integer Internal TBF season id (key space: TBF seasons, global across leagues: 174 = 2026-2027, 172 = 2025-2026; the odd ids are international UA- seasons). Never an sdv key: use season (END year).
season_label character Season label as TBF writes it, 'YYYY-YYYY' (start and end year).
season integer Season END year (2027 = the 2026-2027 season), read from the 'YYYY-YYYY' label or the request; the sdv season key. Not the internal TBF season id (season_id).
start_date Date Season start, Turkey local time (Europe/Istanbul, UTC+3), ISO 8601 without zone: domestic seasons run 07-01 to 06-30, international ones 10-01 to 09-30.
end_date Date Season end, Turkey local time (Europe/Istanbul, UTC+3), ISO 8601 without zone ('2027-06-30T23:59:00').
international logical True for the international UA- seasons (odd season ids); false for domestic ones.

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()

Examples

try(tbf_seasons())

TBF Shots

Description

Every field-goal attempt of a finished game (2025-26 onward) with its court position.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Match/shot-chart⁠

Usage

tbf_shots(match_id)

Arguments

match_id

Required. TBF game id (integer), e.g. 346279; match_id in tbf_schedule(). One global sequence across leagues and seasons. Only a finished game is served.

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

Value

A wehoop_data tibble. One row per attempt. x and y are percentages of a horizontal full court. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
match_id integer TBF game id (key space: TBF games, ONE global sequence across leagues and seasons: 62552 in 2006-07, 346279 in 2026-27). The match_id argument of every game wrapper; the routes echo it as a string or null, the runtime stamps the integer asked for.
period integer Period number of the attempt: 1-4; overtime numbering is unverified.
period_type integer Period type code: 1 = regulation, 2 = overtime (from the app code; no overtime game in the samples).
side character Side of the shooting team (isHome).
shot_player_id integer Shooter id in the SHOT-CHART key space, which is NOT the TBF person id of the box score (Quentin Peterson = 2814324 here, 501076 as a TBF person): join shots to box rows on player_name + jersey_number + side.
player_name character Player name as TBF prints it for that route (title case, Turkish letters kept).
jersey_number character Shirt number as a string, so '0' and '00' stay distinct.
x integer Court x position: integer percent (0-100) of the LENGTH of a horizontal full court from the LEFT baseline (baskets near 5 and 95); teams change ends at half-time. Metres (x / 100 x 28) are an inference.
y integer Court y position: integer percent (0-100) of the court WIDTH from the BOTTOM sideline (baskets near 50), verified from the app's drawing code (top = 100 - y). Metres (y / 100 x 15) are an inference.
made logical True when the attempt was made (isSucceed).

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()

Examples

try(tbf_shots(match_id = 346279))

TBF Standings

Description

League table of one league-season after a week (default the latest), one row per team and group.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/League/get-standings-table⁠

Usage

tbf_standings(season, competition = "kbsl", week = NULL)

Arguments

season

Required. Season END year (2027 = the 2026-2027 season). TBF keys a league-season by internal season and activity ids; the runtime reads them from the league's season list by the END year of the label. A year the list lacks raises wehoop_no_data.

competition

TBF league: bsl (Basketbol Super Ligi), tbl (second tier) or kbsl (women's Super Ligi). The top flight was named TBL until 2007-08 and is listed under bsl. Default "kbsl" (the women's Super Ligi).

week

Week (hafta) number as returned by tbf_weeks(), e.g. 1; playoff rounds continue the numbering (31-33 in 2025-26). Default: the latest week for standings, every week for the schedule.

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

Value

A wehoop_data tibble. One row per team and group. Tie-break detail rows (tiedRows) are not included. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
season integer Season END year (2027 = the 2026-2027 season), read from the 'YYYY-YYYY' label or the request; the sdv season key. Not the internal TBF season id (season_id).
competition character TBF league the row belongs to: bsl, tbl or kbsl (the request's competition, or the league prefix the API reports).
group character Group name (grup); empty for a single-group league.
activity_id integer Activity id (faaliyet = activity; key space: TBF league-SEASONS, new every season: BSL 2026-27 = 22214, BSL 2025-26 = 20728, TBL 2026-27 = 22215, KBSL 2026-27 = 22209). Cast to an integer from the 22214 / 22214.0 the API sends.
team_process_id integer Team-season id (teamProcessId = takimIslemId, a team REGISTRATION; key space: TBF team registrations, a NEW id per club per league-season: Tofas = 265995 in BSL 2026-27). The team_process_id argument of the team wrappers; not the stable club_id.
team_name character Team name as registered for that season, uppercase with Turkish letters (sponsor name: 'PIZZABULLS BORDO BANDIRMA').
week integer The week the table is computed after (hafta); equals the week argument, else the latest.
rank integer League rank (sira) after that week.
played integer Games played (o = oynanan).
won integer Games won (g = galibiyet).
lost integer Games lost (m = maglubiyet).
points_for integer Points scored (a = atilan).
points_against integer Points conceded (y = yenilen).
points integer League points (puan): 2 for a win, 1 for a loss.
head_to_head_points integer Head-to-head league points among teams tied on points (icP = ic puan).
head_to_head_diff integer Head-to-head point difference among teams tied on points (icA = ic averaj).
total_diff integer Total point difference over all games (toA = toplam averaj).
excluded integer Exclusion marker (ihrac = expulsion); 0 for teams still in the league.

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()

Examples

try(tbf_standings(competition = "bsl", season = 2027))

TBF Team Box Score

Description

Team totals of a finished game with the team-credited rebounds, turnovers and fouls.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Match/mac-istatistik⁠

Usage

tbf_team_box(match_id)

Arguments

match_id

Required. TBF game id (integer), e.g. 346279; match_id in tbf_schedule(). One global sequence across leagues and seasons. Only a finished game is served.

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

Value

A wehoop_data tibble. Two rows: home, then away. Minutes are the players' summed seconds. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
match_id integer TBF game id (key space: TBF games, ONE global sequence across leagues and seasons: 62552 in 2006-07, 346279 in 2026-27). The match_id argument of every game wrapper; the routes echo it as a string or null, the runtime stamps the integer asked for.
side character Side of the game the row belongs to: home or away (from the route's isHome flag or home / away block).
team_process_id integer Team-season id of the side (from the game header; key space: TBF team registrations).
seconds_played integer Time on court in seconds, parsed from the 'mm:ss' or 'hh:mm:ss' text the API sends (team totals sum their players, so 200:00 = 12000).
points integer Points scored in the game (or season) the row covers.
fg_made integer Team field goals made, 2PT + 3PT.
fg_attempted integer Team field goals attempted, 2PT + 3PT.
fg_pct integer Team field-goal percentage 0-100, rounded to an integer by the API.
fg2_made integer Team two-point field goals MADE (the API calls it twoPointShots).
fg2_attempted integer Team two-point field goals attempted.
fg2_pct integer Team two-point percentage 0-100, an integer.
fg3_made integer Team three-point field goals MADE (the API calls it threePointShots).
fg3_attempted integer Team three-point field goals attempted.
fg3_pct integer Team three-point percentage 0-100, an integer.
ft_made integer Team free throws MADE.
ft_attempted integer Team free throws attempted.
ft_pct integer Team free-throw percentage 0-100, an integer.
off_rebounds integer Offensive rebounds (hucum ribaundu).
def_rebounds integer Defensive rebounds (savunma ribaundu).
rebounds integer Total rebounds (toplam ribaund).
assists integer Assists in this game (asist).
steals integer Steals in this game (top calma).
blocks integer Shots this player blocked in this game (blok).
turnovers integer Turnovers committed in this game (top kaybi).
fouls integer Personal fouls committed (faul).
fouls_drawn integer Fouls drawn by the team (rivalFoul).
blocks_received integer Team shots blocked by the opponent.
efficiency integer Team efficiency rating (verimlilik puani): the players' ratings summed; a number on team rows.
team_off_rebounds integer Team offensive rebounds not credited to a player (homeTeamStats).
team_def_rebounds integer Team defensive rebounds not credited to a player.
team_rebounds integer Team rebounds not credited to a player (offensive + defensive).
team_turnovers integer Team turnovers not credited to a player.
team_fouls integer Team fouls not credited to a player (bench / coach technicals); 0 in the samples.

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()

Examples

try(tbf_team_box(match_id = 346279))

TBF Team Games

Description

Games and results of one team-season, scheduled games included.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Team/get-team-detail-matches-by-season-and-league⁠

Usage

tbf_team_games(season, team_process_id, competition = "kbsl")

Arguments

season

Required. Season END year (2027 = the 2026-2027 season). TBF keys a league-season by internal season and activity ids; the runtime reads them from the league's season list by the END year of the label. A year the list lacks raises wehoop_no_data.

team_process_id

Required. Team-season id (team registration), e.g. 265995 = Tofas in BSL 2026-27; team_process_id in tbf_teams() and tbf_schedule(). New for every club in every league-season; not the stable club_id.

competition

TBF league: bsl (Basketbol Super Ligi), tbl (second tier) or kbsl (women's Super Ligi). The top flight was named TBL until 2007-08 and is listed under bsl. Default "kbsl" (the women's Super Ligi).

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

 tbf_team_games(season = 2027, team_process_id = 265995)

Value

A wehoop_data tibble. One row per game of the team (scheduled games included). Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
season integer Season END year (2027 = the 2026-2027 season), read from the 'YYYY-YYYY' label or the request; the sdv season key. Not the internal TBF season id (season_id).
competition character TBF league the row belongs to: bsl, tbl or kbsl (the request's competition, or the league prefix the API reports).
team_process_id integer Team-season id of the request (key space: TBF team registrations).
match_id integer TBF game id (key space: TBF games, one global sequence).
match_code character TBF short game code.
tipoff POSIXct Tip-off as a naive timestamp in Turkey local time (tarih).
week character Week label (formattedWeek), e.g. '1. Hafta'.
city character City of the venue (sehir), uppercase Turkish.
venue character Venue name (salon).
home_team_process_id integer Home team-season id (takimAId; key space: TBF team registrations).
home_team character Home team name (takimA).
home_score integer Home points (skorA); null before the game.
away_team_process_id integer Away team-season id (takimBId).
away_team character Away team name (takimB).
away_score integer Away points (skorB); null before the game.
team_is_home logical True when the asked team was the home side (isHome).
team_won logical True when the asked team won (isWin); false for a loss or an unplayed game.
is_played logical True once the game has been played (isPlayed).
status character Game status text in Turkish: Oynandi = played, Oynanmadi = not played (durum).
status_id integer Game status code (durumId): 1 = played, 4 = not played.
has_overtime logical Overtime flag (uzatma = overtime). Reliability unverified: false on every one of 64 BSL 2025-26 games checked.

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()


TBF Team Player Stats

Description

Season player statistics of one team-season: totals, percentages and per-game averages.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Team/get-team-detail-statistic⁠

Usage

tbf_team_player_stats(season, team_process_id, competition = "kbsl")

Arguments

season

Required. Season END year (2027 = the 2026-2027 season). TBF keys a league-season by internal season and activity ids; the runtime reads them from the league's season list by the END year of the label. A year the list lacks raises wehoop_no_data.

team_process_id

Required. Team-season id (team registration), e.g. 265995 = Tofas in BSL 2026-27; team_process_id in tbf_teams() and tbf_schedule(). New for every club in every league-season; not the stable club_id.

competition

TBF league: bsl (Basketbol Super Ligi), tbl (second tier) or kbsl (women's Super Ligi). The top flight was named TBL until 2007-08 and is listed under bsl. Default "kbsl" (the women's Super Ligi).

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

 tbf_team_player_stats(season = 2027, team_process_id = 265995)

Value

A wehoop_data tibble. One row per player. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
season integer Season END year (2027 = the 2026-2027 season), read from the 'YYYY-YYYY' label or the request; the sdv season key. Not the internal TBF season id (season_id).
competition character TBF league the row belongs to: bsl, tbl or kbsl (the request's competition, or the league prefix the API reports).
team_process_id integer Team-season id of the request (key space: TBF team registrations).
person_id integer TBF person id (code; key space: TBF persons, stable across seasons and clubs).
jersey_number character Shirt number (oyuncuNo) as a string.
first_name character Player's first name.
last_name character Player's last name.
games integer Games played (macSayisi).
seconds_played integer Season total time on court in seconds (sureToplam 'hh:mm:ss').
points integer Season total points (sayiToplam; the API sends it as a string).
fg_made integer Season field goals made (agBasarili; sent as a string).
fg_attempted integer Season field goals attempted (agDeneme).
fg2_made integer Season two-point field goals made (puan20Toplam).
fg2_attempted integer Season two-point field goals attempted (puan21Toplam).
fg3_made integer Season three-point field goals made (puan30Toplam).
fg3_attempted integer Season three-point field goals attempted (puan31Toplam).
ft_made integer Season free throws made (sA0Toplam).
ft_attempted integer Season free throws attempted (sA1Toplam).
def_rebounds integer Season defensive rebounds (drToplam).
off_rebounds integer Season offensive rebounds (hrToplam).
rebounds integer Season total rebounds (trToplam).
assists integer Season assists (asistToplam).
blocks integer Season blocks (blokToplam).
steals integer Season steals (topCalmaToplam).
turnovers integer Season turnovers (topKaybiToplam).
fouls integer Season personal fouls (faulToplam).
plus_minus double Season plus/minus contribution (oyunaKatki = contribution to the game), a decimal string.
efficiency integer Season efficiency rating total (vpToplam, verimlilik puani).
fg_pct double Field-goal percentage 0-100 with two decimals (agYuzdesi).
fg2_pct double Two-point percentage 0-100 with two decimals (ikilikYuzdesi).
fg3_pct double Three-point percentage 0-100 with two decimals (uclukYuzdesi).
ft_pct double Free-throw percentage 0-100 with two decimals (serbestAtisYuzdesi).
seconds_per_game integer Average time on court per game in seconds (sureOrtalama 'hh:mm:ss').
points_per_game double Points per game (sayiOrtalama).
rebounds_per_game double Rebounds per game (trOrtalama).
assists_per_game double Assists per game (asistOrtalama).
steals_per_game double Steals per game (topCalmaOrtalama).
blocks_per_game double Blocks per game (blokOrtalama).
turnovers_per_game double Turnovers per game (topKaybiOrtalama).
efficiency_per_game double Efficiency rating per game (vpOrtalama).

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_roster(), tbf_team_staff(), tbf_teams(), tbf_weeks()


TBF Team Roster

Description

Roster of one team-season with games, minutes and per-game points and efficiency (birth dates dropped).

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Team/get-team-active-player-list-by-season-and-league⁠

Usage

tbf_team_roster(season, team_process_id, competition = "kbsl")

Arguments

season

Required. Season END year (2027 = the 2026-2027 season). TBF keys a league-season by internal season and activity ids; the runtime reads them from the league's season list by the END year of the label. A year the list lacks raises wehoop_no_data.

team_process_id

Required. Team-season id (team registration), e.g. 265995 = Tofas in BSL 2026-27; team_process_id in tbf_teams() and tbf_schedule(). New for every club in every league-season; not the stable club_id.

competition

TBF league: bsl (Basketbol Super Ligi), tbl (second tier) or kbsl (women's Super Ligi). The top flight was named TBL until 2007-08 and is listed under bsl. Default "kbsl" (the women's Super Ligi).

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

Value

A wehoop_data tibble. One row per rostered person. Birth dates are not returned. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
season integer Season END year (2027 = the 2026-2027 season), read from the 'YYYY-YYYY' label or the request; the sdv season key. Not the internal TBF season id (season_id).
competition character TBF league the row belongs to: bsl, tbl or kbsl (the request's competition, or the league prefix the API reports).
team_process_id integer Team-season id of the request (key space: TBF team registrations).
person_id integer TBF person id (personId; key space: TBF persons).
first_name character Given name as registered with TBF, mixed case ('Yigitcan').
last_name character Family name as registered with TBF, mixed case ('Saybir').
nationality character Nationality as a TURKISH country name (country); there is no code on this route.
height_cm integer Height in centimetres; null when TBF has none.
jersey_number character Shirt number as a string, so '0' and '00' stay distinct.
games integer Games played (macSayisi = game count).
seconds_played integer Season time on court in seconds (sure 'hh:mm:ss').
points_per_game double Points per game (sayi).
efficiency_per_game double Efficiency rating per game (verimlilikPuani).

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_staff(), tbf_teams(), tbf_weeks()

Examples

try(tbf_team_roster(season = 2027, team_process_id = 265995))

TBF Team Staff

Description

Coaching and club staff of one team-season.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Team/get-team-detail-team-staff-by-season-and-league⁠

Usage

tbf_team_staff(season, team_process_id, competition = "kbsl")

Arguments

season

Required. Season END year (2027 = the 2026-2027 season). TBF keys a league-season by internal season and activity ids; the runtime reads them from the league's season list by the END year of the label. A year the list lacks raises wehoop_no_data.

team_process_id

Required. Team-season id (team registration), e.g. 265995 = Tofas in BSL 2026-27; team_process_id in tbf_teams() and tbf_schedule(). New for every club in every league-season; not the stable club_id.

competition

TBF league: bsl (Basketbol Super Ligi), tbl (second tier) or kbsl (women's Super Ligi). The top flight was named TBL until 2007-08 and is listed under bsl. Default "kbsl" (the women's Super Ligi).

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

 tbf_team_staff(season = 2027, team_process_id = 265995)

Value

A wehoop_data tibble. One row per staff member. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
season integer Season END year (2027 = the 2026-2027 season), read from the 'YYYY-YYYY' label or the request; the sdv season key. Not the internal TBF season id (season_id).
competition character TBF league the row belongs to: bsl, tbl or kbsl (the request's competition, or the league prefix the API reports).
team_process_id integer Team-season id of the request (key space: TBF team registrations).
person_id integer TBF person id of the staff member (code; staff are TBF persons too).
first_name character Given name(s) as registered with TBF, uppercase ('MEVLUT TULGA').
last_name character Family name as registered with TBF, uppercase ('ONGOREN').
role character Staff role in Turkish as sent (job), e.g. Antrenor = head coach.
role_code integer Staff sub-role code (subRolesCode).

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_teams(), tbf_weeks()


TBF Teams

Description

Every team registered in one league-season with its team-season id (team_process_id) and club id.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/Team/get-teams-by-leauge⁠

Usage

tbf_teams(season, competition = "kbsl")

Arguments

season

Required. Season END year (2027 = the 2026-2027 season). TBF keys a league-season by internal season and activity ids; the runtime reads them from the league's season list by the END year of the label. A year the list lacks raises wehoop_no_data.

competition

TBF league: bsl (Basketbol Super Ligi), tbl (second tier) or kbsl (women's Super Ligi). The top flight was named TBL until 2007-08 and is listed under bsl. Default "kbsl" (the women's Super Ligi).

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

Value

A wehoop_data tibble. One row per team registration. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
season integer Season END year (2027 = the 2026-2027 season), read from the 'YYYY-YYYY' label or the request; the sdv season key. Not the internal TBF season id (season_id).
competition character TBF league the row belongs to: bsl, tbl or kbsl (the request's competition, or the league prefix the API reports).
team_process_id integer Team-season id (teamProcessId = takimIslemId, a team REGISTRATION; key space: TBF team registrations, a NEW id per club per league-season: Tofas = 265995 in BSL 2026-27). The team_process_id argument of the team wrappers; not the stable club_id.
club_id integer Stable club id (takimID / teamId of the team lists; key space: TBF clubs, the same across seasons and leagues: Tofas = 13). Not the team-season id (team_process_id).
team_name character Team name as registered for that season, uppercase with Turkish letters.
city character Home city (teamCityName), uppercase Turkish.
code character Team short code (teamCode).
season_id integer Internal TBF season id (key space: TBF seasons, global across leagues: 174 = 2026-2027, 172 = 2025-2026; the odd ids are international UA- seasons). Never an sdv key: use season (END year).
season_label character Season label 'YYYY-YYYY' of the league-season.

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_weeks()

Examples

try(tbf_teams(competition = "bsl", season = 2027))

TBF Weeks

Description

The weeks (rounds) of one league-season, playoff rounds included.

Endpoint: ⁠GET https://miniappapi.tbf.org.tr/webapi-service/api/League/get-league-weeks⁠

Usage

tbf_weeks(season, competition = "kbsl")

Arguments

season

Required. Season END year (2027 = the 2026-2027 season). TBF keys a league-season by internal season and activity ids; the runtime reads them from the league's season list by the END year of the label. A year the list lacks raises wehoop_no_data.

competition

TBF league: bsl (Basketbol Super Ligi), tbl (second tier) or kbsl (women's Super Ligi). The top flight was named TBL until 2007-08 and is listed under bsl. Default "kbsl" (the women's Super Ligi).

Details

Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. SportsDataverse has not ruled on TBF's terms, so payloads are not redistributed as release assets. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.

Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an unfinished game raises wehoop_asset_fetch). Box scores exist from 2006-07 (no starters flagged that season); play-by-play and shots from 2025-26 only, an earlier finished game raises wehoop_no_data. Every game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names and category labels are Turkish; the column descriptions give the English gloss.

Errors: wehoop_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots); wehoop_bad_request for an invalid argument or HTTP 400 / 422; wehoop_asset_fetch when the fetch failed or the answer is not the one asked for (an unfinished game, a body for another game, season, league or team, an error envelope, a redirect, a partial page or a changed capped list). All inherit wehoop_error. Timestamps are Turkey local time (Europe/Istanbul).

Value

A wehoop_data tibble. One row per week in play order; week is the value the schedule and standings take. Every column below is always present (a zero-row tibble keeps them and their types); an answer with nothing in it raises wehoop_no_data, as in sdv-py.

col_name type description
activity_id integer Activity id of the request's league-season (key space: TBF league-seasons).
season integer Season END year of the request (2027 = 2026-2027).
competition character TBF league of the request: bsl, tbl or kbsl.
week character Week number as a string; the value the week argument of tbf_standings and tbf_schedule takes.
phase integer Phase code (devre = half / phase): 1 = first half of the regular season, 2 = second half, 3 = playoff quarter-final, 4 = semi-final, 5 = final.
phase_name character Phase name in Turkish on playoff weeks (Playoff Final = final); null on regular-season weeks.
label character Week label: 'Hafta N' (week N) or the playoff round name.
is_current logical True on the current (or last played) week; exactly one row.

See Also

Other TBF Functions: tbf_daily_matches(), tbf_game_header(), tbf_game_leaders(), tbf_game_players(), tbf_highlights(), tbf_leaders_assists(), tbf_leaders_blocks(), tbf_leaders_efficiency(), tbf_leaders_minutes(), tbf_leaders_points(), tbf_leaders_rebounds(), tbf_leaders_steals(), tbf_leaders_threes(), tbf_leaders_turnovers(), tbf_league_seasons(), tbf_leagues(), tbf_pbp(), tbf_period_scores(), tbf_player_box(), tbf_player_career(), tbf_players(), tbf_schedule(), tbf_seasons(), tbf_shots(), tbf_standings(), tbf_team_box(), tbf_team_games(), tbf_team_player_stats(), tbf_team_roster(), tbf_team_staff(), tbf_teams()

Examples

try(tbf_weeks(competition = "bsl", season = 2027))

Build/update wehoop WBB play-by-play database

Description

update_wbb_db() updates or creates a database with wehoop play by play data of all completed and available games since 2002.

Usage

update_wbb_db(
  dbdir = ".",
  dbname = "wehoop_db",
  tblname = "wehoop_wbb_pbp",
  force_rebuild = FALSE,
  db_connection = NULL,
  datasets = NULL,
  seasons = TRUE
)

Arguments

dbdir

Directory in which the database is or shall be located

dbname

File name of an existing or desired SQLite database within dbdir

tblname

The name of the play by play data table within the database

force_rebuild

Hybrid parameter (logical or numeric) to rebuild parts of or the complete play by play data table within the database (please see details for further information)

db_connection

A DBIConnection object, as returned by DBI::dbConnect() (please see details for further information)

datasets

Optional character vector of dataset shortnames. When NULL (the default) the legacy behavior is preserved: the play-by-play table tblname is created/updated. When supplied, only the requested datasets are written (one table per dataset, named ⁠wbb_<dataset>⁠ – e.g. wbb_rosters, wbb_player_stats). Valid values: "pbp", "team_box", "player_box", "schedule", "rosters", "player_stats", "team_stats", "standings", "shots", "game_rosters", "officials".

seasons

Optional integer vector of seasons. Forwarded to the dataset loaders only when datasets is supplied. Defaults to all available seasons for the dataset (seasons = TRUE).

Details

This function creates and updates a data table with the name tblname within a SQLite database (other drivers via db_connection) located in dbdir and named dbname. The data table combines all play by play data for every available game back to the 2002 season and adds the most recent completed games as soon as they are available for wehoop.

The argument force_rebuild is of hybrid type. It can rebuild the play by play data table either for the whole wehoop era (with force_rebuild = TRUE) or just for specified seasons (e.g. force_rebuild = c(2019, 2020)). Please note the following behavior:

  • force_rebuild = TRUE: The data table with the name tblname will be removed completely and rebuilt from scratch. This is helpful when new columns are added during the Off-Season.

  • force_rebuild = c(2019, 2020): The data table with the name tblname will be preserved and only rows from the 2019 and 2020 seasons will be deleted and re-added. This is intended to be used for ongoing seasons because ESPN's data provider can make changes to the underlying data during the week.

The parameter db_connection is intended for advanced users who want to use other DBI drivers, such as MariaDB, Postgres or odbc. Please note that the arguments dbdir and dbname are dropped in case a db_connection is provided but the argument tblname will still be used to write the data table into the database.

Value

Logical TRUE/FALSE


Build/update wehoop WNBA play-by-play database

Description

update_wnba_db() updates or creates a database with wehoop play by play data of all completed and available games since 2002.

Usage

update_wnba_db(
  dbdir = ".",
  dbname = "wehoop_db",
  tblname = "wehoop_wnba_pbp",
  force_rebuild = FALSE,
  db_connection = NULL,
  datasets = NULL,
  seasons = TRUE
)

Arguments

dbdir

Directory in which the database is or shall be located

dbname

File name of an existing or desired SQLite database within dbdir

tblname

The name of the play by play data table within the database

force_rebuild

Hybrid parameter (logical or numeric) to rebuild parts of or the complete play by play data table within the database (please see details for further information)

db_connection

A DBIConnection object, as returned by DBI::dbConnect() (please see details for further information)

datasets

Optional character vector of dataset shortnames. When NULL (the default) the legacy behavior is preserved: the play-by-play table tblname is created/updated. When supplied, only the requested datasets are written (one table per dataset, named ⁠wnba_<dataset>⁠ – e.g. wnba_rosters, wnba_player_stats). Valid values: "pbp", "team_box", "player_box", "schedule", "rosters", "player_stats", "team_stats", "standings", "draft", "shots", "game_rosters", "officials".

seasons

Optional integer vector of seasons. Forwarded to the dataset loaders only when datasets is supplied. Defaults to all available seasons for the dataset (seasons = TRUE).

Details

This function creates and updates a data table with the name tblname within a SQLite database (other drivers via db_connection) located in dbdir and named dbname. The data table combines all play by play data for every available game back to the 2002 season and adds the most recent completed games as soon as they are available for wehoop.

The argument force_rebuild is of hybrid type. It can rebuild the play by play data table either for the whole wehoop era (with force_rebuild = TRUE) or just for specified seasons (e.g. force_rebuild = c(2019, 2020)). Please note the following behavior:

  • force_rebuild = TRUE: The data table with the name tblname will be removed completely and rebuilt from scratch. This is helpful when new columns are added during the Off-Season.

  • force_rebuild = c(2019, 2020): The data table with the name tblname will be preserved and only rows from the 2019 and 2020 seasons will be deleted and re-added. This is intended to be used for ongoing seasons because ESPN's data provider can make changes to the underlying data during the week.

The parameter db_connection is intended for advanced users who want to use other DBI drivers, such as MariaDB, Postgres or odbc. Please note that the arguments dbdir and dbname are dropped in case a db_connection is provided but the argument tblname will still be used to write the data table into the database.

Value

Logical TRUE/FALSE


Build/update wehoop WNBA Stats database

Description

update_wnba_stats_db() writes one or more WNBA Stats API datasets into a database. Mirrors the WNBA / WBB ⁠update_*_db()⁠ shape but points at the ⁠load_wnba_stats_*⁠ family. Each dataset is written to its own table, named ⁠wnba_stats_<dataset>⁠.

Usage

update_wnba_stats_db(
  dbdir = ".",
  dbname = "wehoop_db",
  datasets = NULL,
  seasons = TRUE,
  db_connection = NULL
)

Arguments

dbdir

Directory in which the database is or shall be located.

dbname

File name of an existing or desired SQLite database within dbdir.

datasets

Character vector of dataset shortnames (see Details).

seasons

Optional integer vector of seasons to load. Defaults to all available seasons (seasons = TRUE).

db_connection

A DBIConnection object. When supplied, dbdir and dbname are ignored.

Details

Unlike update_wnba_db() / update_wbb_db(), there is no historical "play-by-play table" default to preserve, so datasets is required.

Valid datasets values: "schedule", "player_game_logs", "pbp", "rosters", "coaches", "player_stats", "lineups", "team_stats", "standings", "draft", "shots", "game_rosters", "officials", "possessions".

Value

Invisibly returns TRUE on success.


Get the WBB cross-source player crosswalk

Description

Build a wide, one-row-per-player-per-team crosswalk linking ESPN and Fox Sports (Bifrost) WBB player identities for a season. ESPN is the anchor source; Fox is matched by normalized name (exact first, then Jaro-Winkler fuzzy with jersey tiebreaker) within each team block. Yahoo columns are NA placeholders. Torvik and the WNBA Stats API have no per-player tables for WBB, so neither source is joined.

Usage

wbb_player_crosswalk(season = most_recent_wbb_season(), min_confidence = 0.92)

Arguments

season

Season year (4-digit, e.g. 2025). Defaults to most_recent_wbb_season().

min_confidence

Jaro-Winkler similarity floor for fuzzy matches (default 0.92).

Value

A wehoop_data tibble, one row per player per team (ESPN-anchored):

col_name types description
season integer Season year.
espn_team_id integer ESPN team id (canonical key).
team_abbreviation character ESPN team abbreviation.
player_name character Normalized player name (matching key).
espn_athlete_id character ESPN athlete id.
espn_full_name character ESPN full name.
espn_jersey character ESPN jersey number.
espn_position character ESPN position abbreviation.
fox_athlete_id character Fox athlete id (NA if unmatched).
fox_player character Fox player name (NA if unmatched).
fox_jersey character Fox jersey number (NA if unmatched).
fox_position_group character Fox position group label (NA if unmatched).
yahoo_player_id character Yahoo player id (NA placeholder).
yahoo_player_name character Yahoo player name (NA placeholder).
match_method character "exact_name"/"fuzzy_jw"/"unmatched".
match_confidence numeric Jaro-Winkler score or 1 for exact (NA if none).
match_keys character NA (reserved for future use).

See Also

Other WBB Crosswalk Functions: load_wnba_team_crosswalk(), wbb_schedule_crosswalk(), wbb_team_crosswalk()

Examples

try(wbb_player_crosswalk(season = 2025))

Get the WBB cross-source schedule crosswalk

Description

Build a wide, one-row-per-game crosswalk linking ESPN and Bart Torvik (barttorvik.com/ncaaw) game identifiers for a WBB season. Fox Sports and Yahoo game IDs are NA placeholders. Dates are reduced to Eastern-Time game dates before joining; Torvik team1/team2 are unordered (the join uses a sorted team-pair key, so home/away from the Torvik side is not preserved). Games where either Torvik team name cannot be resolved to an ESPN id via wbb_team_crosswalk() are kept as bart_only rows.

Usage

wbb_schedule_crosswalk(season = most_recent_wbb_season())

Arguments

season

Season year (4-digit, e.g. 2025). Defaults to most_recent_wbb_season().

Value

A wehoop_data tibble, one row per game:

col_name types description
season integer Season year.
game_date Date ET game date.
home_espn_team_id integer ESPN home team id (NA for bart-only rows).
away_espn_team_id integer ESPN away team id (NA for bart-only rows).
espn_game_id character ESPN game id (NA for bart-only rows).
bart_muid character Torvik muid (NA for espn-only rows).
bart_team1 character Torvik team1 name (NA for espn-only rows).
bart_team2 character Torvik team2 name (NA for espn-only rows).
bart_winner character Torvik winner name (NA for espn-only rows).
fox_game_id character Fox game id (NA placeholder).
yahoo_game_id character Yahoo game id (NA placeholder).
match_method character "both"/"espn_only"/"bart_only".
match_confidence numeric 1 for matched, NA for unmatched.

See Also

Other WBB Crosswalk Functions: load_wnba_team_crosswalk(), wbb_player_crosswalk(), wbb_team_crosswalk()

Examples

try(wbb_schedule_crosswalk(season = 2025))

Get the WBB cross-source team crosswalk

Description

Build a wide, one-row-per-team-per-season crosswalk linking ESPN, Fox Sports (Bifrost), and Bart Torvik (barttorvik.com/ncaaw) women's college basketball team identities, keyed on espn_team_id. Yahoo columns are NA placeholders. ESPN is deduped by team_id (first occurrence kept). Fox is joined on the full normalized mascot name (with a curated alias bridge for cases where Fox and ESPN differ); Torvik is joined on the normalized school/location name after a curated alias pass for common divergences (e.g. "UConn" / "Connecticut", "Ole Miss" / "Mississippi").

Every source is read as of season:

  • espn_conference is the conference each team was in that season, under that season's name, from the SDV conference reference (load_wbb_team_group_seasons() and load_wbb_group_seasons()). The ESPN team list itself is today's Division I list, so a team that was not in a Division I conference that season has an NA espn_conference.

  • fox_section comes from Fox's per-conference standings for that season (⁠league/standings?groupId=&season=⁠), which start in 2018-19: earlier seasons get NA ⁠fox_*⁠. Fox lists teams under the conference they joined the NEXT season, so fox_section is set to NA where it disagrees with espn_conference, and for any Fox conference with fewer than two agreeing teams that stay put the next season. fox_team_id is kept.

  • ⁠bart_*⁠ comes from Torvik's ⁠/ncaaw/{season}_team_results.csv⁠ (2021 on; earlier seasons get NA ⁠bart_*⁠).

A source that fails raises an error instead of returning a crosswalk whose columns are silently all NA. Torvik answering with no teams (blocked or empty) for a season it covers, Fox returning no standings for the season, and a missing conference reference raise an error of class crosswalk_source_error.

Usage

wbb_team_crosswalk(season = most_recent_wbb_season(), fox = NULL)

Arguments

season

Season year (4-digit, ending year, e.g. 2025 = 2024-25). Defaults to most_recent_wbb_season().

fox

An already-fetched frame with fox_team_id, fox_team_name and fox_section, or NULL (default) to fetch season's Fox standings live. Pass an empty data.frame() to skip Fox.

Value

A wehoop_data tibble, one row per ESPN team:

col_name types description
season integer Season year.
espn_team_id integer ESPN team id (canonical key).
espn_abbreviation character ESPN abbreviation.
espn_display_name character ESPN display name (school + mascot).
espn_short_name character ESPN short name.
espn_location character ESPN school/location only.
espn_mascot character ESPN mascot/nickname.
espn_conference character Conference that season, under that season's name (NA if not in a Division I conference).
fox_team_id character Fox Bifrost team id (NA if unmatched).
fox_team_name character Fox team name (NA if unmatched).
fox_section character Fox conference that season (NA if unmatched or unconfirmed).
bart_team character Torvik team name (NA if unmatched).
bart_conf character Torvik conference abbreviation (NA if unmatched).
yahoo_team_id character Yahoo team id (NA placeholder).
yahoo_team_name character Yahoo team name (NA placeholder).
fox_match_confidence numeric 1 for matched, NA for unmatched.
bart_match_confidence numeric 1 for matched, NA for unmatched.
match_method character "fox+bart"/"fox_only"/"bart_only"/"espn_only".

See Also

Other WBB Crosswalk Functions: load_wnba_team_crosswalk(), wbb_player_crosswalk(), wbb_schedule_crosswalk()

Examples

try(wbb_team_crosswalk(season = 2025))

Women's British Basketball League (Genius LiveStats)

Description

Convenience wrappers binding the Genius family to the Women's British Basketball League (women's; Genius ORG WBBL, LiveStats ORG WBBL). Season rule: END year; the label span 2025-26 = 2026.

Usage

wbbl_competitions(return_parsed = TRUE)

wbbl_schedule(season = NULL, comp_id = NULL, round_number = -1, return_parsed = TRUE)

wbbl_team_box(match_id, return_parsed = TRUE)

wbbl_player_box(match_id, return_parsed = TRUE)

wbbl_pbp(match_id, return_parsed = TRUE)

wbbl_shots(match_id, return_parsed = TRUE)

Arguments

season

END-year season (see the season rule). NULL (default) = the newest season the org lists.

comp_id

Genius competition id; skips the season lookup (needed when the label rule matches several competitions).

round_number

Round to list; -1 (default) lists every round.

match_id

Genius match id (match_id of wbbl_schedule()) of a game of this competition.

return_parsed

Parse into a tibble (default TRUE); FALSE returns the raw list.

Details

The season's competition is picked from the WBBL chooser by the label rule include = Championship, exclude = Play-?Offs (case-insensitive); cups and play-offs have their own comp_id. Several matching competitions raise wehoop_bad_request (pass comp_id); none raises wehoop_no_data.

Genius match ids are one global sequence shared by every customer and data.json names no competition, so each game alias checks the id on the game's LiveStats shell (⁠/u/WBBL/<match_id>/⁠: one extra request per game, cached per process for an hour): its competition name must pass the label rule. Another org's game, a cup or play-off game of WBBL, or a shell request that fails twice (or names no competition) raises wehoop_asset_fetch. The base ⁠genius_*()⁠ function reads any game unchecked.

Access, proxy and error notes: see genius_game().

 wbbl_competitions()
 wbbl_schedule()

Value

The base function's wehoop_data tibble, same columns and types (the raw list when return_parsed = FALSE), one table per function:

wbbl_competitions()

The columns of genius_competitions():

col_name type description
org character ORG code the request used (the hosted ORG, or the LiveStats ORG for the /u/ shell).
comp_id integer Genius competition id (compId): one per org competition-season; the {compId} of hosted and data/competition paths
label character Competition label as the org typed it, free text in any language: may or may not carry a season ('BASKET LEAGUE 2019 - 20', '1st division', 'Kypello Elladas' (in Greek script) = Greek Cup, 'Mavroskoufeia' (in Greek script) = Mavroskoufeia youth tournament)
league_id integer Genius league id of the org (ESAKE = 115; IBBA has two: 187 and 549)
year integer Genius season year of the competition: the START year of a two-year season (BNXT '2023-2024' = 2023), the year itself for a calendar season. null when the page gives none
season integer sdv END-year season of the competition (2026 = 2025-26) from the label span, else the Genius year; null when no rule applies. See season_rule.
season_rule character Which rule produced season: 'label span', 'genius year + 1 (split)', 'genius year (calendar)', 'label year (calendar)' or 'unknown'.
selected logical True for the competition the hosted chooser pre-selects (the org's default, not always the newest).

wbbl_schedule()

The columns of genius_schedule():

col_name type description
match_id integer From the block id ⁠extfix_<id>⁠. Genius match id: the {matchId} of data.json and /u/; one global sequence across every Genius customer (~0.3 M in 2016, ~2.9 M in Oct 2026)
link_match_id integer Match id of the block's ⁠/match/<id>/summary⁠ link; equals match_id (the capture refuses a page where it does not); null when the org hides match pages (FFBB)
comp_id integer CompId of the match link, or of the team links when the org hides match pages (FFBB); equals the {compId} asked for. A 'To be determined' slot (no team or match link) takes the {compId} the page's other blocks prove
org character ORG code of the match link (or the team links, as comp_id)
status character Status from the block class STATUS_*: COMPLETE, SCHEDULED, POSTPONED, ...
date_time character Tip-off as displayed, 'Mon D, YYYY, h:mm AM' (local time, zone not stated); null when unscheduled
venue_id integer Genius venue id (the /venue/{id} of hosted pages); null when the venue is plain text (FFBB)
venue_name character Venue name as entered (local script)
home_team_id integer Home team: Genius team id (warehouse key space, global across orgs and seasons; the /team/{id} of hosted pages, the tid of the widget, the teamId of data/competition). data.json carries no team id: join on name/code
home_team_name character Home team full name
home_team_code character Home team code (local script possible)
home_score integer Home points; null before tip-off (typed integer only on a route whose 3 sampled rows were all played)
away_team_id integer Away team: Genius team id (warehouse key space, global across orgs and seasons; the /team/{id} of hosted pages, the tid of the widget, the teamId of data/competition). data.json carries no team id: join on name/code
away_team_name character Away team full name
away_team_code character Away team code (local script possible)
away_score integer Away points; null before tip-off (typed integer only on a route whose 3 sampled rows were all played)

wbbl_team_box()

The columns of genius_team_box():

col_name type description
match_id integer Genius match id of the game. data.json does not carry it: it is the match_id asked for, stamped by the runtime (the global match sequence shared by every Genius customer).
tno integer Team number within this game: 1 = the team listed first (home on the hosted schedule and widget), 2 = the other, 0 = no team. In-game only: not a team id.
name character Team name as the org enters it
name_international character Team name in Latin script
short_name character Short team name (shortName in the feed), in the competition's own script when the org enters one.
code character Team code, three letters as entered (may be in the local script, e.g. Greek 'AEK' in Greek script)
code_international character Team code in Latin script
coach character Head coach display name
score integer Team points (current or final); a numeric string in the 2014-15 era sample (WBBL 12248), an integer since
full_score integer Team points including overtime; equal to score in every sample (a numeric string in the 2014-15 era)
p1_score integer Points scored in period 1 (a numeric string in the 2014-15 era)
p2_score integer Points scored in period 2 (a numeric string in the 2014-15 era)
p3_score integer Points scored in period 3 (a numeric string in the 2014-15 era)
p4_score integer Points scored in period 4 (a numeric string in the 2014-15 era)
ot_score integer Points the team scored in overtime; null without overtime. Whether several overtimes are summed is unverified.
fouls integer Team fouls in the current (last) period
timeouts integer Timeouts counter of the current period (unverified: remaining vs taken); 0 in every sampled (finished) game
minutes character Minutes as the feed prints them, an 'mm:ss' text (can exceed 59 for a team; '199:60' happens); the text of an integer when the feed sends one.
seconds_played integer Seconds played parsed from the printed mm:ss text as minutes * 60 + seconds (so '224:60' gives 13500); null when the feed sent an integer, whose unit is unknown.
field_goals_made integer Team total: field goals made
field_goals_attempted integer Team total: field goals attempted
field_goals_percentage double Team total: field-goal percentage, 0-100, rounded to an integer by the feed
three_pointers_made integer Team total: three-pointers made
three_pointers_attempted integer Team total: three-pointers attempted
three_pointers_percentage double Team total: three-point percentage, 0-100, rounded to an integer
two_pointers_made integer Team total: two-pointers made
two_pointers_attempted integer Team total: two-pointers attempted
two_pointers_percentage double Team total: two-point percentage, 0-100, rounded to an integer
free_throws_made integer Team total: free throws made
free_throws_attempted integer Team total: free throws attempted
free_throws_percentage double Team total: free-throw percentage, 0-100, rounded to an integer
rebounds_defensive integer Team total: defensive rebounds
rebounds_offensive integer Team total: offensive rebounds
rebounds_total integer Team total: total rebounds
assists integer Team total: assists
turnovers integer Team total: turnovers
steals integer Team total: steals
blocks integer Team total: blocks made
blocks_received integer Team total: own shots blocked by an opponent
fouls_personal integer Team total: personal fouls committed
fouls_on integer Team total: fouls drawn
points integer Team total: points
points_from_turnovers integer Team total: points off turnovers
points_second_chance integer Team total: second-chance points
points_fast_break integer Team total: fast-break points
points_in_the_paint integer Team total: points in the paint
eff_1 integer Genius efficiency formula 1. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site (team total). Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*
eff_2 integer Genius efficiency formula 2. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site (team total). Team tot_eff_2 is 2 in every 2016+ sample (a constant, not a stat). Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*
eff_3 double Genius efficiency formula 3. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site (team total). Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*
eff_4 double Genius efficiency formula 4. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site (team total). Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*
eff_5 integer Genius efficiency formula 5. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site (team total). Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*
eff_6 integer Genius efficiency formula 6. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site (team total). Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*
eff_7 integer Genius efficiency formula 7. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site (team total). Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*
bench_points integer Team total: points scored by non-starters
biggest_lead integer Team total: biggest lead, points
biggest_scoring_run integer Team total: biggest unanswered scoring run, points
lead_changes integer Team total: lead changes in the game (same value on both teams)
times_scores_level integer Team total: times the score was tied (same value on both teams)
time_leading double Team total: minutes the team led, decimal minutes (33.58 = 33 min 35 s)
fouls_team integer Team total: team (bench) fouls
fouls_total integer Team total: all fouls committed (personal + technical + team bench)
rebounds_team integer Team total: team rebounds (credited to no player)
rebounds_team_defensive integer Team total: team defensive rebounds
rebounds_team_offensive integer Team total: team offensive rebounds
turnovers_team integer Team total: team turnovers (credited to no player, e.g. shot clock)

wbbl_player_box()

The columns of genius_player_box():

col_name type description
match_id integer Genius match id of the game. data.json does not carry it: it is the match_id asked for, stamped by the runtime (the global match sequence shared by every Genius customer).
tno integer Team number within this game: 1 = the team listed first (home on the hosted schedule and widget), 2 = the other, 0 = no team. In-game only: not a team id.
pno integer Player number within this game, the key of the team's player map; 0 = no player. In-game only: not a person id and not the shirt number.
name character Display name ('T. Nichols')
first_name character Given name in the competition's own script and spelling (Greek, Hebrew, Czech, ... as entered)
family_name character Family name in the competition's own script
international_first_name character Given name in Latin script
international_family_name character Family name in Latin script (often upper case)
scoreboard_name character Short display name ('T. Nichols'), in the local script when the org enters one
shirt_number character Shirt number as a string ('0' and '00' differ)
playing_position character Playing position code (PG, SG, SF, PF, C, G, F, ...); empty string when not entered
starter integer 1 when the player started the game, else 0
captain integer 1 for the team captain, else 0; absent in some orgs
active integer 1 when the player is on court now (at game end: on court at the final whistle), else 0
minutes character Minutes as the feed prints them, an 'mm:ss' text (can exceed 59 for a team; '199:60' happens); the text of an integer when the feed sends one.
seconds_played integer Seconds played parsed from the printed mm:ss text as minutes * 60 + seconds (so '224:60' gives 13500); null when the feed sent an integer, whose unit is unknown.
field_goals_made integer Field goals the player made in the game (two- and three-pointers together; a count).
field_goals_attempted integer Field goals the player attempted in the game (two- and three-pointers together; a count).
field_goals_percentage double Field-goal percentage, 0-100, rounded to an integer by the feed
three_pointers_made integer Three-pointers made
three_pointers_attempted integer Three-pointers attempted
three_pointers_percentage double Three-point percentage, 0-100, rounded to an integer
two_pointers_made integer Two-pointers made
two_pointers_attempted integer Two-pointers attempted
two_pointers_percentage double Two-point percentage, 0-100, rounded to an integer
free_throws_made integer Free throws the player made in the game (a count).
free_throws_attempted integer Free throws the player attempted in the game (a count).
free_throws_percentage double Free-throw percentage, 0-100, rounded to an integer
rebounds_defensive integer Defensive rebounds
rebounds_offensive integer Offensive rebounds
rebounds_total integer Total rebounds (offensive plus defensive) the player collected in the game.
assists integer Assists credited to the player in the game.
turnovers integer Turnovers committed by the player in the game.
steals integer Steals credited to the player in the game.
blocks integer Shots the player blocked in the game (blocks made, not received).
blocks_received integer Own shots blocked by an opponent
fouls_personal integer Personal fouls committed
fouls_on integer Fouls drawn: personal fouls committed against the player in the game.
points integer Points the player scored in the game, free throws included.
points_from_turnovers integer Points off turnovers
points_second_chance integer Second-chance points
points_fast_break integer Fast-break points
points_in_the_paint integer Points the player scored in the paint in the game (the feed's sPointsInThePaint).
plus_minus_points integer Plus/minus: team point margin while the player was on court
eff_1 integer Genius efficiency formula 1. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site
eff_2 integer Genius efficiency formula 2. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site
eff_3 double Genius efficiency formula 3. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site
eff_4 double Genius efficiency formula 4. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site
eff_5 integer Genius efficiency formula 5. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site
eff_6 integer Genius efficiency formula 6. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site
eff_7 integer Genius efficiency formula 7. The feed carries seven formulas (eff_1..eff_7) with no labels; the definitions are not published. In samples eff_1/eff_6/eff_7 often agree (an index-rating style total), eff_3/eff_4 are decimals. Unverified: do not treat any as PIR/EFF without checking against a league site. Absent in the 2014-15 era sample (WBBL 12248), which carries eff_1..eff_6 on players and no team tot_eff_*

wbbl_pbp()

The columns of genius_pbp():

col_name type description
match_id integer Genius match id of the game. data.json does not carry it: it is the match_id asked for, stamped by the runtime (the global match sequence shared by every Genius customer).
row_index integer Position of the action in the feed order, 0 = the newest action by game time (normally the game end row). The feed is not strictly sorted by action_number, so sort on action_number for entry order.
action_number integer Action sequence number, unique within the game (gaps where actions were deleted); a shot joins its play-by-play row on it. Null in the 2014-15 feed.
previous_action integer action_number of the linked earlier action (the shot an assist or rebound belongs to); null when the feed sends an empty string.
period integer Period number; restarts at 1 for the first overtime (read it with period_type).
period_type character Period type: REGULAR or OVERTIME.
gt character Game clock, 'mm:ss' remaining in the period
clock character Game clock with hundredths, 'mm:ss:cc' remaining in the period; absent in older feeds (the 2014-15 WBBL sample has gt only)
tno integer Team number within this game: 1 = the team listed first (home on the hosted schedule and widget), 2 = the other, 0 = no team. In-game only: not a team id.
pno integer Player number within this game, the key of the team's player map; 0 = no player. In-game only: not a person id and not the shirt number.
player character Player display name; '' when no player
shirt_number character Player shirt number (string); '' when no player
first_name character Given name in the competition's own script and spelling (Greek, Hebrew, Czech, ... as entered)
family_name character Family name in the competition's own script
international_first_name character Given name in Latin script
international_family_name character Family name in Latin script (often upper case)
scoreboard_name character Short display name ('T. Nichols'), in the local script when the org enters one
action_type character Action type: 2pt, 3pt, freethrow, rebound, assist, turnover, steal, block, foul, foulon (foul drawn), substitution, timeout, jumpball, period, game, headcoachchallenge
sub_type character Action subtype, free-text code per actionType: shot type for 2pt/3pt (layup, drivinglayup, jumpshot, pullupjumpshot, turnaroundjumpshot, ...), 'in'/'out' for substitutions, 'start'/'end' for period and game, foul kind for fouls; empty string when none
qualifier character Qualifier codes of the action joined with commas (pointsinthepaint, fromturnover, 2ndchance, fastbreak, blocked, ...); null when none.
success integer 1 = made / successful, 0 = missed (shots, free throws); 1 for other actions
scoring integer 1 when the action is a scoring attempt (shot or free throw), else 0
score_1 integer Team 1 score after the action, always an integer (the feed sends a string in most games).
score_2 integer Team 2 score after the action, always an integer (the feed sends a string in most games).
lead integer Score margin after the action, team 1 minus team 2 (negative when team 2 leads)

wbbl_shots()

The columns of genius_shots():

col_name type description
match_id integer Genius match id of the game. data.json does not carry it: it is the match_id asked for, stamped by the runtime (the global match sequence shared by every Genius customer).
tno integer Team number within this game: 1 = the team listed first (home on the hosted schedule and widget), 2 = the other, 0 = no team. In-game only: not a team id.
pno integer Player number within this game, the key of the team's player map; 0 = no player. In-game only: not a person id and not the shirt number.
action_number integer Action sequence number, unique within the game (gaps where actions were deleted); a shot joins its play-by-play row on it. Null in the 2014-15 feed.
period integer Period number; restarts at 1 for the first overtime (read it with period_type).
period_type character Period type: REGULAR or OVERTIME.
action_type character Shot value: 2pt or 3pt
sub_type character Shot type (layup, drivinglayup, jumpshot, pullupjumpshot, dunk, ...)
result integer Shot result: 1 = made, 0 = missed.
x double Court x, PERCENT of the full court length (0-100, float), along the long axis. Not normalised to one basket: a team attacks one end in periods 1-2 and the other end in periods 3-4 (ESAKE 2902690: team 1 mean x 90 and 86 in P1-P2, 11 and 19 in P3-P4). Which end x = 0 is, and which end team 1 starts at, are unverified
y double Court y, PERCENT of the full court width (0-100, float), across the court (observed 1.7-97.2). Origin side unverified
player character Shooter's display name as the org enters it, in the local script when it uses one.
shirt_number character Shooter's shirt number (string)

See Also

Other Genius Functions: genius_competition_games(), genius_competitions(), genius_game(), genius_game_crosswalk(), genius_match_competition(), genius_pbp(), genius_player_box(), genius_schedule(), genius_schedule_embed(), genius_shots(), genius_team_box(), genius_team_crosswalk(), genius_widget_games(), lfb_competition


wehoop Data Loaders Overview

Description

Loaders for full seasons of pre-scraped data from the ⁠sportsdataverse/wehoop-{wnba,wbb}-data⁠ releases on sportsdataverse-data. Each helper validates the requested seasons, builds the per-asset URLs, downloads in parallel (with optional progressr progress + optional DBI insertion), and tags the result with the wehoop_data S3 class.

Details

WNBA loaders

Function Asset family
load_wnba_pbp() WNBA play-by-play
load_wnba_player_box() WNBA player boxscores
load_wnba_team_box() WNBA team boxscores
load_wnba_schedule() WNBA schedule
update_wnba_db() Delta loader -> DB

WBB loaders

Function Asset family
load_wbb_pbp() Women's college basketball PBP
load_wbb_player_box() WBB player boxscores
load_wbb_team_box() WBB team boxscores
load_wbb_schedule() WBB schedule
update_wbb_db() Delta loader -> DB

Get W League Box Score

Description

Box score of a final game (2013-14 on): one row per player of both teams.

Endpoint: ⁠GET https://api.wjbl.01core.app/api/boxscore⁠

Usage

wjbl_box_score(play_schedule_id)

Arguments

play_schedule_id

Game id (play_schedule_id in wjbl_schedule): ONE global sequence across every league edition and season, e.g. 7987 (2025-26 playoff final game 1), 5533 (2018-19), 4243 (2013-14 final, box score only). The game must be final.

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.

Value

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

col_name type description
play_schedule_id integer Game id play_schedule_id (key space: W League games, ONE global sequence across every league_id and season, e.g. 4243 = 2013-14 final, 7987 = 2025-26 final). The play_schedule_id parameter of every game route and of the site's /schedule_result/detail/*?play_schedule_id= pages.
team_side character Which side of the game the row belongs to: home or away (the API's home / away blocks).
team_id integer Franchise id team_id of the side (stable across seasons and sponsor renames; 13 = Toyota Antelopes).
player_id integer Player 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_name character Player name in Japanese, 'SURNAME GIVEN' with a space (foreign players in katakana).
player_number character Shirt number, a string.
gs integer Game started: 1 = starter, 0 = bench (integer).
pts integer Points. Integer.
p2m integer Two-point field goals made. Integer.
p2a integer Two-point field goals attempted. Integer.
p3m integer Three-point field goals made. Integer.
p3a integer Three-point field goals attempted. Integer.
ftm integer Free throws made. Integer.
fta integer Free throws attempted. Integer.
f integer Personal fouls committed. Integer.
off integer Offensive rebounds. Integer.
def integer Defensive rebounds. Integer.
tot integer Total rebounds (off + def). Integer.
ast integer Assists. Integer.
stl integer Steals. Integer.
blk integer Blocked shots (made by this player / team). Integer.
to integer Turnovers. Integer.
min character Minutes played 'mm:ss' ('22:19'), a string.
min_seconds integer Minutes played in whole seconds, from the 'mm:ss' clock string min (null when it does not parse).

See Also

Other WJBL Functions: wjbl_game(), wjbl_game_info(), wjbl_game_months(), wjbl_head_to_head(), wjbl_leagues(), wjbl_pbp(), wjbl_period_scores(), wjbl_player(), wjbl_player_period_leaders(), wjbl_roster(), wjbl_schedule(), wjbl_staff(), wjbl_standing_seasons(), wjbl_team_box_score(), wjbl_team_period_stats(), wjbl_team_ranking(), wjbl_team_standings(), wjbl_teams()

Examples

try(wjbl_box_score(play_schedule_id = 7987))

Get W League Game

Description

Game header of a final game: both teams, the result flag and the score by period, one row.

Endpoint: ⁠GET https://api.wjbl.01core.app/api/play-schedule/detail⁠

Usage

wjbl_game(play_schedule_id)

Arguments

play_schedule_id

Game id (play_schedule_id in wjbl_schedule): ONE global sequence across every league edition and season, e.g. 7987 (2025-26 playoff final game 1), 5533 (2018-19), 4243 (2013-14 final, box score only). The game must be final.

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.

Value

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

col_name type description
play_schedule_id integer Game id: ONE global sequence across every league edition and season (7987 = 2025-26 playoff final game 1); the play_schedule_id of the request.
game_status character Game state; always fixed (final) here, the wrapper refuses a game that is not final.
home_team_id integer Home team: 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.
home_season_team_name character Home team name: Team name as registered for the season, in Japanese (company + nickname: Toyota Antelopes).
home_season_team_short_name character Home team short name: Short team name for that season, Japanese (Toyota).
home_team_logo_image character Home team logo: Team logo path, relative to https://www.wjbl.org ('/static/images/base_team/...png' or '/assets/img/team/...png').
home_team_entry_flg integer Official-league participant flag: 1 = a W League member team (the site links its roster), 0 = not (guest or all-star side). Integer.
home_season_team_area character Unobserved: null in every sample, so no type and no meaning is claimed. (By the site's standings JS: 0 = East, 1 = West conference when season_league_flg = 2.)
home_free_text character Free-text team label used when the slot has no team (e.g. 'winner of game X'); empty string in every sample.
home_winner_flg integer Result for this side: 1 = won, -1 = lost (integer; a 0 tie code is unobserved).
home_score integer Home points after the play, parsed from score ('HOME-AWAY'); null on plays that carry no score.
home_score_p1 integer Points scored IN the 1st quarter (not cumulative).
home_score_p2 integer Points scored in the 2nd quarter.
home_score_p3 integer Points scored in the 3rd quarter.
home_score_p4 integer Points scored in the 4th quarter.
home_score_ot1 integer Points scored in the 1st overtime (5 min); null when there was none.
home_score_ot2 integer Unobserved: null in every sample. When filled: Points in the 2nd overtime; null when none.
home_score_ot3 integer Unobserved: null in every sample. When filled: Points in the 3rd overtime; null when none.
home_score_ot4 integer Unobserved: null in every sample. When filled: Points in the 4th overtime; null when none. There is no score_ot5+: overtimes 5-10 appear only as play-by-play period 9-14 and in the /pbp/team-stats and /pbp/player-stats periods maps.
away_team_id integer Away team: 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.
away_season_team_name character Away team name: Team name as registered for the season, in Japanese (company + nickname: Toyota Antelopes).
away_season_team_short_name character Away team short name: Short team name for that season, Japanese (Toyota).
away_team_logo_image character Away team logo: Team logo path, relative to https://www.wjbl.org ('/static/images/base_team/...png' or '/assets/img/team/...png').
away_team_entry_flg integer Official-league participant flag: 1 = a W League member team (the site links its roster), 0 = not (guest or all-star side). Integer.
away_season_team_area character Unobserved: null in every sample, so no type and no meaning is claimed. (By the site's standings JS: 0 = East, 1 = West conference when season_league_flg = 2.)
away_free_text character Free-text team label used when the slot has no team (e.g. 'winner of game X'); empty string in every sample.
away_winner_flg integer Result for this side: 1 = won, -1 = lost (integer; a 0 tie code is unobserved).
away_score integer Away points after the play, parsed from score ('HOME-AWAY'); null on plays that carry no score.
away_score_p1 integer Points scored IN the 1st quarter (not cumulative).
away_score_p2 integer Points scored in the 2nd quarter.
away_score_p3 integer Points scored in the 3rd quarter.
away_score_p4 integer Points scored in the 4th quarter.
away_score_ot1 integer Points scored in the 1st overtime (5 min); null when there was none.
away_score_ot2 integer Unobserved: null in every sample. When filled: Points in the 2nd overtime; null when none.
away_score_ot3 integer Unobserved: null in every sample. When filled: Points in the 3rd overtime; null when none.
away_score_ot4 integer Unobserved: null in every sample. When filled: Points in the 4th overtime; null when none. There is no score_ot5+: overtimes 5-10 appear only as play-by-play period 9-14 and in the /pbp/team-stats and /pbp/player-stats periods maps.

See Also

Other WJBL Functions: wjbl_box_score(), wjbl_game_info(), wjbl_game_months(), wjbl_head_to_head(), wjbl_leagues(), wjbl_pbp(), wjbl_period_scores(), wjbl_player(), wjbl_player_period_leaders(), wjbl_roster(), wjbl_schedule(), wjbl_staff(), wjbl_standing_seasons(), wjbl_team_box_score(), wjbl_team_period_stats(), wjbl_team_ranking(), wjbl_team_standings(), wjbl_teams()

Examples

try(wjbl_game(play_schedule_id = 7987))

Get W League Game Info

Description

Game information of a final game: venue, times, referees, links and the Japanese game report, one row.

Endpoint: ⁠GET https://api.wjbl.01core.app/api/play-schedule⁠

Usage

wjbl_game_info(play_schedule_id)

Arguments

play_schedule_id

Game id (play_schedule_id in wjbl_schedule): ONE global sequence across every league edition and season, e.g. 7987 (2025-26 playoff final game 1), 5533 (2018-19), 4243 (2013-14 final, box score only). The game must be final.

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.

Value

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

col_name type description
play_schedule_id integer Game id play_schedule_id (key space: W League games, ONE global sequence across every league_id and season, e.g. 4243 = 2013-14 final, 7987 = 2025-26 final). The play_schedule_id parameter of every game route and of the site's /schedule_result/detail/*?play_schedule_id= pages.
league_id integer Competition-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_title character Competition-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'.
season integer Season 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_id integer 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_title character Phase title in Japanese: regular season, (Japanese text) / playoff final, playoff semifinal (the separator varies by era).
season_full_name character league_title + phase (+ division) in Japanese: 2025-26 regular season, Premier division (Future division, from 2024-25).
game_date character Game date in Japanese, (Japanese text) (Saturday 4 April 2026).
game_day character Game date as an ISO date (YYYY-MM-DD, Japan time), built from the game year and the game date.
game_start_time character Scheduled tip-off 'HH:MM', Japan time (JST, UTC+9).
started_at character Actual tip-off 'HH:MM', JST, as recorded ('15:01'); junk on 2013-14 games ('05:06' for a 19:00 game, and it CHANGES between requests: 05:06 / 05:16 / 05:25 for game 4243), so ignore it there.
opening_time character Doors-open time 'HH:MM', JST; empty when not published.
venue character Arena name, Japanese.
game_icon integer Icon code shown next to the game: 0 = none, 1 = home-game icon (home.svg), 2 = neutral-site icon (neutral.svg).
venue_address character Arena postal address, Japanese.
venue_others character Access directions to the arena (nearest station, walking time), Japanese free text.
allow_shoes_on integer Outdoor shoes allowed in the arena: 1 = not stated, 2 = yes (o), 3 or 4 = no (x). Integer.
allow_shoes_on_others character Extra note on outdoor shoes; empty string in every sample.
ticket_info character Ticket information, Japanese free text with CRLF line breaks and HTML links.
ticket_url character Ticket sale URL; empty string in every sample.
event_info character Event-day information (gate times, food, shoes, tip-off), Japanese free text with CRLF line breaks.
live_link character Live-stream URL; empty when none.
vod_link character Video-on-demand URL (Basketball LIVE / W-TV); empty when none.
bs_url character Satellite-TV (BS) broadcast URL; empty string in every sample.
cs_url character Cable/satellite (CS) broadcast URL; empty string in every sample.
ground_url character Terrestrial-TV broadcast URL; empty string in every sample.
other_url character Other broadcast URL; empty string in every sample.
cancel_flg integer Cancelled flag: 1 = cancelled, 0 = not.
delay_flg integer Postponed flag: 1 = postponed, 0 = not.
game_status character Game state: 'fixed' = final (confirmed result), 'scheduled' = not played yet (seen on 26-27 games); the site's JS also handles 'live', 'canceled' and 'delayed'. The capture banks only 'fixed' games.
box_flg integer Box-score flag (integer). 1 on every sampled game, scheduled ones included, so it does NOT prove a box score exists.
pbp_flg integer Play-by-play flag: 1 = /pbp/* routes have data (2018-19 onward), 0 = not (they answer []).
referee_name character Crew chief, 'SURNAME GIVEN' in Japanese; empty on 2013-14 (names are in comment); placeholder (Japanese text) (= 'referee 01') on game 5533.
sub_referee_name1 character First umpire, Japanese name; empty when not recorded.
sub_referee_name2 character Second umpire, Japanese name; empty when not recorded.
comment character Officials block, Japanese free text: (Japanese text) crew chief, (Japanese text) first umpire, (Japanese text) second umpire, 2013-14 (Japanese text) referee / (Japanese text) umpires / (Japanese text) commissioner; CRLF or ⁠<br>⁠ separated.
report character Game report (quarter-by-quarter narrative) in Japanese HTML; filled on 2013-14, empty on the newer samples.
home_team_id integer Home team: 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.
home_season_team_name character Home team name: Team name as registered for the season, in Japanese (company + nickname: Toyota Antelopes).
home_season_team_short_name character Home team short name: Short team name for that season, Japanese (Toyota).
home_team_logo_image character Home team logo: Team logo path, relative to https://www.wjbl.org ('/static/images/base_team/...png' or '/assets/img/team/...png').
home_free_text character Free-text team label used when the slot has no team (e.g. 'winner of game X'); empty string in every sample.
away_team_id integer Away team: 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.
away_season_team_name character Away team name: Team name as registered for the season, in Japanese (company + nickname: Toyota Antelopes).
away_season_team_short_name character Away team short name: Short team name for that season, Japanese (Toyota).
away_team_logo_image character Away team logo: Team logo path, relative to https://www.wjbl.org ('/static/images/base_team/...png' or '/assets/img/team/...png').
away_free_text character Free-text team label used when the slot has no team (e.g. 'winner of game X'); empty string in every sample.

See Also

Other WJBL Functions: wjbl_box_score(), wjbl_game(), wjbl_game_months(), wjbl_head_to_head(), wjbl_leagues(), wjbl_pbp(), wjbl_period_scores(), wjbl_player(), wjbl_player_period_leaders(), wjbl_roster(), wjbl_schedule(), wjbl_staff(), wjbl_standing_seasons(), wjbl_team_box_score(), wjbl_team_period_stats(), wjbl_team_ranking(), wjbl_team_standings(), wjbl_teams()

Examples

try(wjbl_game_info(play_schedule_id = 7987))

Get W League Game Months

Description

Months (YYYY-MM) that have games in a season, newest first; each is one page of wjbl_schedule.

Endpoint: ⁠GET https://api.wjbl.01core.app/api/play-schedule-months⁠

Usage

wjbl_game_months(season)

Arguments

season

Season END year (2026 = 2025-26, 2000 = 1999-2000); the wrapper maps it to the league edition id (league_id) with the live league list (wjbl_leagues, one extra cached request).

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.

Value

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

col_name type description
league_id integer Competition edition id league_id, cast to an integer (the API echoes a string here and an integer elsewhere).
season integer Season END year of the request (2026 = 2025-26); the body itself does not carry it.
game_month character Month 'YYYY-MM': the game_month parameter of /play-schedules.
game_month_jpn character The month in Japanese, (Japanese text) (April 2026).

See Also

Other WJBL Functions: wjbl_box_score(), wjbl_game(), wjbl_game_info(), wjbl_head_to_head(), wjbl_leagues(), wjbl_pbp(), wjbl_period_scores(), wjbl_player(), wjbl_player_period_leaders(), wjbl_roster(), wjbl_schedule(), wjbl_staff(), wjbl_standing_seasons(), wjbl_team_box_score(), wjbl_team_period_stats(), wjbl_team_ranking(), wjbl_team_standings(), wjbl_teams()

Examples

try(wjbl_game_months(season = 2026))

Get W League Head-to-Head

Description

Head-to-head results grid (hoshitori-hyo) of one or more season phases: one row per game played.

Endpoint: ⁠GET https://api.wjbl.01core.app/api/team-standings⁠

Usage

wjbl_head_to_head(season_ids)

Arguments

season_ids

Season phase id or ids (season_id in wjbl_standing_seasons; a phase inside a league edition, not a year): an integer, a list or a comma string such as '169,170' (2025-26 regular season Premier and Future divisions).

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_head_to_head(season_ids = "169")

Value

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

col_name type description
season_id integer Season phase id of the grid, e.g. 169 (2025-26 regular season, Premier division).
team_id integer Franchise id team_id of the ROW team (the team whose points are win).
opponent_team_id integer Franchise id team_id of the opponent in that game.
game_number integer 1-based order of the game within the pair of teams in the grid (the wire list has no number).
win integer The ROW team's points in that game (a string on the wire, whatever the result; 56 on a loss).
losg integer The OPPONENT's points in that game (a string on the wire; the wire key is spelled losg).
result character 'o 63-56' = row team won, 'x 56-63' = lost (row team's points first); 'o 20-0' is a forfeit win (FIBA forfeit score).

See Also

Other WJBL Functions: wjbl_box_score(), wjbl_game(), wjbl_game_info(), wjbl_game_months(), wjbl_leagues(), wjbl_pbp(), wjbl_period_scores(), wjbl_player(), wjbl_player_period_leaders(), wjbl_roster(), wjbl_schedule(), wjbl_staff(), wjbl_standing_seasons(), wjbl_team_box_score(), wjbl_team_period_stats(), wjbl_team_ranking(), wjbl_team_standings(), wjbl_teams()


Get W League Leagues

Description

Every competition edition (league_id): the W League seasons back to 1999-2000, all-star games, cups and camps.

Endpoint: ⁠GET https://api.wjbl.01core.app/api/leagues⁠

Usage

wjbl_leagues()

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.

Value

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

col_name type description
league_id integer Competition-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_title character Competition-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'.
season integer Season END year (2025-26 = 2026, 1999-2000 = 2000) from league_title ('25-26 W League'); null for an all-star game, cup or camp.

See Also

Other WJBL Functions: wjbl_box_score(), wjbl_game(), wjbl_game_info(), wjbl_game_months(), wjbl_head_to_head(), wjbl_pbp(), wjbl_period_scores(), wjbl_player(), wjbl_player_period_leaders(), wjbl_roster(), wjbl_schedule(), wjbl_staff(), wjbl_standing_seasons(), wjbl_team_box_score(), wjbl_team_period_stats(), wjbl_team_ranking(), wjbl_team_standings(), wjbl_teams()

Examples

try(wjbl_leagues())

Get W League Play-by-Play

Description

Play-by-play of a final game (2018-19 on): one row per play, Japanese action vocabulary, no shot x/y.

Endpoint: ⁠GET https://api.wjbl.01core.app/api/pbp/play-by-play⁠

Usage

wjbl_pbp(play_schedule_id)

Arguments

play_schedule_id

Game id (play_schedule_id in wjbl_schedule): ONE global sequence across every league edition and season, e.g. 7987 (2025-26 playoff final game 1), 5533 (2018-19), 4243 (2013-14 final, box score only). The game must be final.

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.

Value

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

col_name type description
play_schedule_id integer Game id play_schedule_id (key space: W League games, ONE global sequence across every league_id and season, e.g. 4243 = 2013-14 final, 7987 = 2025-26 final). The play_schedule_id parameter of every game route and of the site's /schedule_result/detail/*?play_schedule_id= pages.
no integer Play sequence number, ascending, 1 = first; numbers can skip (deleted plays: 443 numbers for 439 rows on 7987).
period integer Period: 1-4 = quarters, 5-14 = overtime 1-10 (the site's tab map). Integer.
rest_time character Game clock REMAINING in the period, 'm:ss' without a leading zero ('9:38'; '10:00' at the start, 5:00 in overtime).
seconds_remaining integer Seconds remaining in the period, from the 'm:ss' clock string rest_time.
team_id integer Acting team: franchise id team_id; null on period and game-end lines.
team_name character Acting team name, Japanese (may contain a full-width space and differ from the box score's spelling); empty on period/game-end lines.
team_side character Side of the acting team, home or away (from home_away: 1 home, 2 away); null on period and game-end lines.
player_number1 character Shirt number of the first actor (the player going OUT on a substitution), a string; '' on team and period lines.
player_number2 character Shirt number of the second actor (the player coming IN on a substitution), a string; '' otherwise.
player_name1 character Name of the first actor, Japanese; '' on team and period lines.
player_name2 character Name of the second actor (substitution in), Japanese; '' otherwise.
player_id1 integer First actor (the player going OUT on a substitution): Player id (key space: W League persons, STABLE across seasons and teams). Joins /boxscore home/away.players[].player_id and the player_id of /player (the pi= of the site's /player/detail?pi=). Null on team and period lines.
player_id2 integer Second actor, filled on substitutions only (the player coming IN; verified 89/89 on game 7987): Player id (key space: W League persons, STABLE across seasons and teams). Joins /boxscore home/away.players[].player_id and the player_id of /player (the pi= of the site's /player/detail?pi=). Null otherwise.
play_text character Display text in Japanese: (Japanese text). Bracketed running counts: shots the player's points so far, assists/steals/blocks/turnovers count so far, rebounds '(o-d-t)' = the player's offensive-defensive-total so far, fouls '(a-b:c)' = a the player's personal fouls, b the team's fouls in the period, c free throws awarded (verified on 7987), substitution A out, B in. Empty on period and game-end lines.
score character Score 'HOME-AWAY' after the play ('4-3'); filled on scoring plays and period/game-end lines, '' otherwise.
home_score integer Home points after the play, parsed from score ('HOME-AWAY'); null on plays that carry no score.
away_score integer Away points after the play, parsed from score ('HOME-AWAY'); null on plays that carry no score.
end_period_flg integer End-of-period flag (integer); 0 on every observed row, the period end is the (Japanese text) action instead.
end_game_flg integer End-of-game flag: 1 on the final (Japanese text) line only (the site skips that row), else 0.
action1 character Action in Japanese (vocabulary of 8 full games, 2018-19 to 2025-26): player in (the starting five at the start of the game), substitution (player_id1 OUT, player_id2 IN), (Japanese text) / 'x' = two-point shot outside the paint made / missed ((Japanese text) inside-the-paint is not in the sample games), (Japanese text) / 'x' = three-point shot made / missed, (Japanese text) / 'x' = free throw made / missed, assist, offensive rebound, defensive rebound, (Japanese text) / team offensive / defensive rebound, steal, blocked shot, turnover, team turnover, personal foul, offensive foul, unsportsmanlike foul, timeout, end of period (quarter or overtime), end of game. o = made, x = missed.
action2 character Sub-action in Japanese: jump shot (on field-goal attempts), free throws awarded on this foul, N = 0-3; '' otherwise.
action3 character Second qualifier in Japanese: shooting foul; '' otherwise.
home_away integer Side of the acting team: 1 = home, 2 = away; null on period/game-end lines.

See Also

Other WJBL Functions: wjbl_box_score(), wjbl_game(), wjbl_game_info(), wjbl_game_months(), wjbl_head_to_head(), wjbl_leagues(), wjbl_period_scores(), wjbl_player(), wjbl_player_period_leaders(), wjbl_roster(), wjbl_schedule(), wjbl_staff(), wjbl_standing_seasons(), wjbl_team_box_score(), wjbl_team_period_stats(), wjbl_team_ranking(), wjbl_team_standings(), wjbl_teams()

Examples

try(wjbl_pbp(play_schedule_id = 7987))

Get W League Period Scores

Description

Points of each side in each period played (quarters and overtimes) from the game header.

Endpoint: ⁠GET https://api.wjbl.01core.app/api/play-schedule/detail⁠

Usage

wjbl_period_scores(play_schedule_id)

Arguments

play_schedule_id

Game id (play_schedule_id in wjbl_schedule): ONE global sequence across every league edition and season, e.g. 7987 (2025-26 playoff final game 1), 5533 (2018-19), 4243 (2013-14 final, box score only). The game must be final.

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_period_scores(play_schedule_id = 7987)

Value

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

col_name type description
play_schedule_id integer Game id play_schedule_id (key space: W League games, ONE global sequence across every league_id and season, e.g. 4243 = 2013-14 final, 7987 = 2025-26 final). The play_schedule_id parameter of every game route and of the site's /schedule_result/detail/*?play_schedule_id= pages.
team_side character Which side of the game the row belongs to: home or away (the API's home / away blocks).
team_id integer Franchise id team_id of the side (stable across seasons and sponsor renames; 13 = Toyota Antelopes).
period integer Period number: 1-4 are the quarters and 5-8 the first to fourth overtime (score_ot1 to score_ot4).
period_label character Readable period: Q1-Q4 quarters, OT1-OT10 overtimes (period categories 5-14), H1 / H2 halves (15 / 16), OT all overtimes together (17), GAME the whole game (18).
score integer Points the side scored in that period (null periods, such as overtimes not played, have no row).

See Also

Other WJBL Functions: wjbl_box_score(), wjbl_game(), wjbl_game_info(), wjbl_game_months(), wjbl_head_to_head(), wjbl_leagues(), wjbl_pbp(), wjbl_player(), wjbl_player_period_leaders(), wjbl_roster(), wjbl_schedule(), wjbl_staff(), wjbl_standing_seasons(), wjbl_team_box_score(), wjbl_team_period_stats(), wjbl_team_ranking(), wjbl_team_standings(), wjbl_teams()


Get W League Player

Description

Player profile: current team, names, bio and career notes, one row.

Endpoint: ⁠GET https://api.wjbl.01core.app/api/player⁠

Usage

wjbl_player(player_id)

Arguments

player_id

Player id (player_id in wjbl_box_score or wjbl_roster): the person, stable across seasons, e.g. 9799.

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_player(player_id = 9799)

Value

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

col_name type description
player_id integer Player 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_name character Name in Japanese, 'SURNAME GIVEN'.
player_name_en character Name in romaji, uppercase, 'SURNAME GIVEN' ('OKAMOTO MIYUU').
player_furigana character Name reading in hiragana ((Japanese text)).
team_id integer Current (or last) team: 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.
season_team_name character Team name as registered for the season, in Japanese (company + nickname: Toyota Antelopes).
season_team_short_name character Short team name for that season, Japanese (Toyota).
season_team_player_number character Shirt number this season, a string.
team_logo_image character Team logo path, relative to https://www.wjbl.org ('/static/images/base_team/...png' or '/assets/img/team/...png').
team_url character Team's own website URL.
player_birthday character Date of birth 'YYYY/MM/DD' (public player bio).
player_nickname character Nickname, Japanese.
player_position character Playing position code ('PG', 'SG', 'SF', 'PF', 'C').
player_home_town character Home prefecture, Japanese (Hokkaido).
player_height character Height with unit, a string ('179cm').
player_weight character Weight with unit, a string ('77kg').
player_height_cm integer Height in whole centimetres, parsed from player_height ('179cm').
player_weight_kg integer Weight in whole kilograms, parsed from player_weight ('77kg').
player_affiliation_history character Career path, Japanese, (Japanese text)-separated (mini-basketball club (Japanese) junior high (Japanese) high school (Japanese) university (Japanese) team).
player_independent_flg integer Retired flag (the site greys the team and hides the number): 1 = retired / no longer registered, 0 = active.
player_national_team character National-team history, Japanese free text (Universiade).
player_awards character Awards and honours, Japanese free text.
player_coach_history character Coaching history (for players who became coaches); empty string in the sample.
player_coach_record character Coaching record; empty string in the sample.
player_picture character Photo path relative to https://www.wjbl.org.
player_wjbl_flg integer 1 = a W League player (0 presumably for others; unverified).
player_rookie integer Rookie ((Japanese) icon): 1 = yes, 0 = no.
player_early_entry integer Early-entry player ((Japanese), a student who joined before graduating): 1 = yes, 0 = no.
player_foreign_national_flg integer Foreign national ((Japanese) icon): 1 = yes, 0 = no.
player_naturalized_flg integer Naturalised player ((Japanese) icon): 1 = yes, 0 = no.
player_appeal character Self-introduction text; empty string in the sample.
player_championships character Championships text; empty string in the sample.
player_url character Personal website URL; empty string in the sample.
player_facebook_url character Facebook URL; empty string in the sample.
player_twitter_url character X (Twitter) URL; empty string in the sample.
player_instagram_url character Instagram URL; empty string in the sample.

See Also

Other WJBL Functions: wjbl_box_score(), wjbl_game(), wjbl_game_info(), wjbl_game_months(), wjbl_head_to_head(), wjbl_leagues(), wjbl_pbp(), wjbl_period_scores(), wjbl_player_period_leaders(), wjbl_roster(), wjbl_schedule(), wjbl_staff(), wjbl_standing_seasons(), wjbl_team_box_score(), wjbl_team_period_stats(), wjbl_team_ranking(), wjbl_team_standings(), wjbl_teams()


Get W League Player Period Leaders

Description

Leading scorer, passer and rebounder of each team per period, half and game (2018-19 on).

Endpoint: ⁠GET https://api.wjbl.01core.app/api/pbp/player-stats⁠

Usage

wjbl_player_period_leaders(play_schedule_id)

Arguments

play_schedule_id

Game id (play_schedule_id in wjbl_schedule): ONE global sequence across every league edition and season, e.g. 7987 (2025-26 playoff final game 1), 5533 (2018-19), 4243 (2013-14 final, box score only). The game must be final.

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_player_period_leaders(play_schedule_id = 7987)

Value

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

col_name type description
play_schedule_id integer Game id play_schedule_id (key space: W League games, ONE global sequence across every league_id and season, e.g. 4243 = 2013-14 final, 7987 = 2025-26 final). The play_schedule_id parameter of every game route and of the site's /schedule_result/detail/*?play_schedule_id= pages.
home_team_id integer Home team: 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.
away_team_id integer Away team: 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.
period_category integer The period category again, as an integer (camelCase here, period_category on /pbp/team-stats).
period_label character Readable period: Q1-Q4 quarters, OT1-OT10 overtimes (period categories 5-14), H1 / H2 halves (15 / 16), OT all overtimes together (17), GAME the whole game (18).
home_point_player character Home points leader(s) in the period as '#NUMBER NAME' (Japanese); ties are joined with ', '.
home_point_value character Their points with the counter (Japanese) ((Japanese text)); ties joined with ', ' in the same order.
home_assist_player character Home assist leader(s), '#NUMBER NAME', ties joined with ', '.
home_assist_value character Their assists with the counter (Japanese) ((Japanese text)), ', '-joined for ties.
home_rebound_player character Home rebound leader(s), '#NUMBER NAME', ties joined with ', '.
home_rebound_value character Their rebounds 'offensive-defensive-total' ('0-3-3'), ', '-joined for ties.
away_point_player character Away points leader(s) in the period as '#NUMBER NAME' (Japanese); ties are joined with ', '.
away_point_value character Their points with the counter (Japanese) ((Japanese text)); ties joined with ', ' in the same order.
away_assist_player character Away assist leader(s), '#NUMBER NAME', ties joined with ', '.
away_assist_value character Their assists with the counter (Japanese) ((Japanese text)), ', '-joined for ties.
away_rebound_player character Away rebound leader(s), '#NUMBER NAME', ties joined with ', '.
away_rebound_value character Their rebounds 'offensive-defensive-total' ('0-3-3'), ', '-joined for ties.

See Also

Other WJBL Functions: wjbl_box_score(), wjbl_game(), wjbl_game_info(), wjbl_game_months(), wjbl_head_to_head(), wjbl_leagues(), wjbl_pbp(), wjbl_period_scores(), wjbl_player(), wjbl_roster(), wjbl_schedule(), wjbl_staff(), wjbl_standing_seasons(), wjbl_team_box_score(), wjbl_team_period_stats(), wjbl_team_ranking(), wjbl_team_standings(), wjbl_teams()


Get W League Roster

Description

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).

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)

Value

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

col_name type description
league_id integer Competition-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_title character Competition-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'.
season integer Season 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_id integer The 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_name character league_title + phase (+ division) in Japanese: 2025-26 regular season, Premier division (Future division, from 2024-25).
season_team_id integer Team-season registration id (key space: one per team per season phase; 1343 = Toyota in season 169). Not team_id.
team_id integer The 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_id integer Head-coach id (key space: W League coaches; the coach_id of /coach and of the site's /coach/?coach_id=).
coach_name character Head coach name, Japanese.
team_comment character Free text the league shows with the roster (captains and other notes, HTML with ⁠<br>⁠), as sent.
player_id integer Player 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_name character Player name, Japanese.
player_number character Shirt number, a string.
captain_flg integer Captain: 1 = yes, 0 = no.
sub_captain_flg integer Vice-captain: 1 = yes, 0 = no.
transfer_flg integer Transferred in this season ((Japanese) icon): 1 = yes, 0 = no.
position character Playing position (G / F / C style code); empty in every sampled row.
rookie integer Rookie ((Japanese) icon): 1 = yes, 0 = no.
early_entry integer Early-entry player ((Japanese), a student who joined before graduating): 1 = yes, 0 = no.
picture character Player photo path relative to https://www.wjbl.org.
foreign_national_flg integer Foreign national ((Japanese) icon): 1 = yes, 0 = no.
naturalized_flg integer Naturalised player ((Japanese) icon): 1 = yes, 0 = no.

See Also

Other WJBL Functions: wjbl_box_score(), wjbl_game(), wjbl_game_info(), wjbl_game_months(), wjbl_head_to_head(), wjbl_leagues(), wjbl_pbp(), wjbl_period_scores(), wjbl_player(), wjbl_player_period_leaders(), wjbl_schedule(), wjbl_staff(), wjbl_standing_seasons(), wjbl_team_box_score(), wjbl_team_period_stats(), wjbl_team_ranking(), wjbl_team_standings(), wjbl_teams()


Get W League Schedule

Description

Games of a season in ONE month (default: the season's latest month) with teams, venue, status and score.

Endpoint: ⁠GET https://api.wjbl.01core.app/api/play-schedules⁠

Usage

wjbl_schedule(season, game_month = NULL, team_id = NULL)

Arguments

season

Season END year (2026 = 2025-26, 2000 = 1999-2000); the wrapper maps it to the league edition id (league_id) with the live league list (wjbl_leagues, one extra cached request).

game_month

Month to list, 'YYYY-MM' (see wjbl_game_months). Omitted = the season's latest month only, NOT the whole season: the API pages by month.

team_id

Franchise id (team_id in wjbl_teams): stable across seasons and sponsor renames, e.g. 13 (Toyota Antelopes). Narrows the month to that team's games.

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.

Value

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

col_name type description
league_id integer The league_id asked for (integer): Competition-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_title character Competition-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'.
season integer Season 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_id integer 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_title character Phase title in Japanese: regular season, (Japanese text) / playoff final, playoff semifinal (the separator varies by era).
season_full_name character league_title + phase (+ division) in Japanese: 2025-26 regular season, Premier division (Future division, from 2024-25).
play_schedule_id integer Game id play_schedule_id (key space: W League games, ONE global sequence across every league_id and season, e.g. 4243 = 2013-14 final, 7987 = 2025-26 final). The play_schedule_id parameter of every game route and of the site's /schedule_result/detail/*?play_schedule_id= pages.
game_year integer Calendar year of the game, 'YYYY' string (not the season); parsed to an integer.
game_date character Game day 'MM.DD' ('04.04'); with game_year it is the date, Japan time.
game_day character Game day 'MM.DD' ('04.04'); with game_year it is the date, Japan time.
game_date_week_day_name character Weekday in Japanese, one character: (Japanese) Mon, (Japanese) Tue, (Japanese) Wed, (Japanese) Thu, (Japanese) Fri, (Japanese) Sat, (Japanese) Sun.
game_start_time character Scheduled tip-off 'HH:MM', Japan time (JST, UTC+9).
started_at character Actual tip-off 'HH:MM', JST, as recorded ('15:01'); junk on 2013-14 games ('05:06' for a 19:00 game, and it CHANGES between requests: 05:06 / 05:16 / 05:25 for game 4243), so ignore it there.
opening_time character Doors-open time 'HH:MM', JST; empty when not published.
venue character Arena name, Japanese.
venue_address character Arena postal address, Japanese.
game_icon integer Icon code shown next to the game: 0 = none, 1 = home-game icon (home.svg), 2 = neutral-site icon (neutral.svg).
ticket_url character Ticket sale URL; empty string in every sample.
vod_link character Video-on-demand URL (Basketball LIVE / W-TV); empty when none.
live_link character Live-stream URL; empty when none.
game_status character Game state: 'fixed' = final (confirmed result), 'scheduled' = not played yet (seen on 26-27 games); the site's JS also handles 'live', 'canceled' and 'delayed'. The capture banks only 'fixed' games.
box_flg integer Box-score flag (integer). 1 on every sampled game, scheduled ones included, so it does NOT prove a box score exists.
pbp_flg integer Play-by-play flag: 1 = /pbp/* routes have data (2018-19 onward), 0 = not (they answer []).
cancel_flg integer Cancelled flag: 1 = cancelled, 0 = not.
delay_flg integer Postponed flag: 1 = postponed, 0 = not.
ot_flg integer Overtime flag: 1 = the game went to overtime, 0 = not.
home_team_id integer Home team: 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.
home_season_team_name character Home team name: Team name as registered for the season, in Japanese (company + nickname: Toyota Antelopes).
home_season_team_short_name character Home team short name: Short team name for that season, Japanese (Toyota).
home_team_logo_image character Home team logo: Team logo path, relative to https://www.wjbl.org ('/static/images/base_team/...png' or '/assets/img/team/...png').
home_team_free_text character Free-text team label used when the slot has no team (e.g. 'winner of game X'); empty string in every sample.
home_team_score integer Home final points (integer). Every sampled game is finished, so null is not in the type; unplayed games (2026-27 'scheduled') carry null.
home_team_entry_flg integer Official-league participant flag: 1 = a W League member team (the site links its roster), 0 = not (guest or all-star side). Integer.
away_team_id integer Away team: 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.
away_season_team_name character Away team name: Team name as registered for the season, in Japanese (company + nickname: Toyota Antelopes).
away_season_team_short_name character Away team short name: Short team name for that season, Japanese (Toyota).
away_team_logo_image character Away team logo: Team logo path, relative to https://www.wjbl.org ('/static/images/base_team/...png' or '/assets/img/team/...png').
away_team_free_text character Free-text team label used when the slot has no team (e.g. 'winner of game X'); empty string in every sample.
away_team_score integer Away final points (integer). Null on unplayed games, as for home_team_score (not in the finished samples).
away_team_entry_flg integer Official-league participant flag: 1 = a W League member team (the site links its roster), 0 = not (guest or all-star side). Integer.

See Also

Other WJBL Functions: wjbl_box_score(), wjbl_game(), wjbl_game_info(), wjbl_game_months(), wjbl_head_to_head(), wjbl_leagues(), wjbl_pbp(), wjbl_period_scores(), wjbl_player(), wjbl_player_period_leaders(), wjbl_roster(), wjbl_staff(), wjbl_standing_seasons(), wjbl_team_box_score(), wjbl_team_period_stats(), wjbl_team_ranking(), wjbl_team_standings(), wjbl_teams()

Examples

try(wjbl_schedule(game_month = "2026-04", season = 2026))

Get W League Staff

Description

Staff of a team in a season phase (general manager, assistant coaches, support staff).

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

Usage

wjbl_staff(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).

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_staff(season_id = 169, team_id = 13)

Value

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

col_name type description
league_id integer Competition-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_title character Competition-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'.
season integer Season 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_id integer The 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_name character league_title + phase (+ division) in Japanese: 2025-26 regular season, Premier division (Future division, from 2024-25).
season_team_id integer Team-season registration id (key space: one per team per season phase; 1343 = Toyota in season 169). Not team_id.
team_id integer The 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.
staff_name character Staff member name, Japanese.
position character Staff role, Japanese: (Japanese) associate head coach, (Japanese) assistant coach, (Japanese) general manager, (Japanese) team director, (Japanese) support staff.
url character Link attached to the staff entry; empty in most rows.

See Also

Other WJBL Functions: wjbl_box_score(), wjbl_game(), wjbl_game_info(), wjbl_game_months(), wjbl_head_to_head(), wjbl_leagues(), wjbl_pbp(), wjbl_period_scores(), wjbl_player(), wjbl_player_period_leaders(), wjbl_roster(), wjbl_schedule(), wjbl_standing_seasons(), wjbl_team_box_score(), wjbl_team_period_stats(), wjbl_team_ranking(), wjbl_team_standings(), wjbl_teams()


Get W League Standing Seasons

Description

Every season phase (season_id) with its edition name and standings flags.

Endpoint: ⁠GET https://api.wjbl.01core.app/api/seasons/standings⁠

Usage

wjbl_standing_seasons()

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.

Value

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

col_name type description
season_id integer 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_name character Edition name with the sponsor, Japanese, e.g. (Japanese text) (truncated by the API).
season integer Season END year (2025-26 = 2026, 1999-2000 = 2000) from league_title ('25-26 W League'); null for an all-star game, cup or camp. Read from the start of season_full_name.
season_league_name character Phase / division label in Japanese: Premier, Future, group stage, second round, lower league; empty for a single-table phase.
team_standings_flg integer 1 = the phase has a standings grid (/team-standings), 0 = not (cups, all-star games, phases not started).
season_tournament_text_flg integer 1 = the phase shows a tournament text instead of a table, 0 = not; 0 in every sample.
season_tournament_text character Tournament text (HTML) for knockout phases; empty in every sample.

See Also

Other WJBL Functions: wjbl_box_score(), wjbl_game(), wjbl_game_info(), wjbl_game_months(), wjbl_head_to_head(), wjbl_leagues(), wjbl_pbp(), wjbl_period_scores(), wjbl_player(), wjbl_player_period_leaders(), wjbl_roster(), wjbl_schedule(), wjbl_staff(), wjbl_team_box_score(), wjbl_team_period_stats(), wjbl_team_ranking(), wjbl_team_standings(), wjbl_teams()

Examples

try(wjbl_standing_seasons())

Get W League Team Box Score

Description

Team line and totals of each side of a final game's box score, with the shooting percentages.

Endpoint: ⁠GET https://api.wjbl.01core.app/api/boxscore⁠

Usage

wjbl_team_box_score(play_schedule_id)

Arguments

play_schedule_id

Game id (play_schedule_id in wjbl_schedule): ONE global sequence across every league edition and season, e.g. 7987 (2025-26 playoff final game 1), 5533 (2018-19), 4243 (2013-14 final, box score only). The game must be final.

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.

Value

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

col_name type description
play_schedule_id integer Game id play_schedule_id (key space: W League games, ONE global sequence across every league_id and season, e.g. 4243 = 2013-14 final, 7987 = 2025-26 final). The play_schedule_id parameter of every game route and of the site's /schedule_result/detail/*?play_schedule_id= pages.
team_side character Which side of the game the row belongs to: home or away (the API's home / away blocks).
team_id integer Franchise id team_id of the side (stable across seasons and sponsor renames; 13 = Toyota Antelopes).
row_type character Which line of the side: team (stats credited to the team itself) or total (the whole side).
pts integer Points scored by the side (the sum of its players' points).
p2m integer Two-point field goals made.
p2a integer Two-point field goals attempted.
p3m integer Three-point field goals made.
p3a integer Three-point field goals attempted.
ftm integer Free throws made.
fta integer Free throws attempted.
f integer Personal fouls committed.
off integer Offensive rebounds.
def integer Defensive rebounds.
tot integer Total rebounds (offensive plus defensive).
ast integer Assists credited to the side.
stl integer Steals credited to the side.
blk integer Blocked shots credited to the side.
to integer Turnovers committed by the side.
min character Minutes: summed minutes 'mmm:ss' on the total row ('200:00' = 5 x 40:00), always '00:00' on the team row.
min_seconds integer Minutes played in whole seconds, from the 'mm:ss' clock string min (null when it does not parse).
p2p double Two-point field-goal percentage 0-100 (a string on the wire); total row only.
p3p double Three-point field-goal percentage 0-100 (a string on the wire); total row only.
ftp double Free-throw percentage 0-100 (a string on the wire); total row only.
fgp double Field-goal percentage 0-100, two- and three-pointers together (a string on the wire); total row only.

See Also

Other WJBL Functions: wjbl_box_score(), wjbl_game(), wjbl_game_info(), wjbl_game_months(), wjbl_head_to_head(), wjbl_leagues(), wjbl_pbp(), wjbl_period_scores(), wjbl_player(), wjbl_player_period_leaders(), wjbl_roster(), wjbl_schedule(), wjbl_staff(), wjbl_standing_seasons(), wjbl_team_period_stats(), wjbl_team_ranking(), wjbl_team_standings(), wjbl_teams()

Examples

try(wjbl_team_box_score(play_schedule_id = 7987))

Get W League Team Period Stats

Description

Team stat summary per period, half and game (2018-19 on): percentages, rebounds, assists, turnovers, lead changes.

Endpoint: ⁠GET https://api.wjbl.01core.app/api/pbp/team-stats⁠

Usage

wjbl_team_period_stats(play_schedule_id)

Arguments

play_schedule_id

Game id (play_schedule_id in wjbl_schedule): ONE global sequence across every league edition and season, e.g. 7987 (2025-26 playoff final game 1), 5533 (2018-19), 4243 (2013-14 final, box score only). The game must be final.

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_team_period_stats(play_schedule_id = 7987)

Value

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

col_name type description
play_schedule_id integer Game id play_schedule_id (key space: W League games, ONE global sequence across every league_id and season, e.g. 4243 = 2013-14 final, 7987 = 2025-26 final). The play_schedule_id parameter of every game route and of the site's /schedule_result/detail/*?play_schedule_id= pages.
home_team_id integer Home team: 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.
away_team_id integer Away team: 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.
period_category integer The period category again, as an integer (see periods).
period_label character Readable period: Q1-Q4 quarters, OT1-OT10 overtimes (period categories 5-14), H1 / H2 halves (15 / 16), OT all overtimes together (17), GAME the whole game (18).
home_ptr double Home field-goal percentage (2PT + 3PT) in the period, 0-100, a NUMBER with up to one decimal (61.5; whole values come as integers).
home_pt2r double Home two-point percentage, 0-100, number.
home_pt3r double Home three-point percentage, 0-100, number.
home_ftr double Home free-throw percentage, 0-100, number (0 when no attempts).
home_rebound_off integer Home offensive rebounds in the period, the first number of the wire's 'off-def-total' string.
home_rebound_def integer Home defensive rebounds in the period, the second number of the wire's 'off-def-total' string.
home_rebound_tot integer Home total rebounds in the period, the third number of the wire's 'off-def-total' string.
home_assist integer Home assists (integer).
home_turnovers integer Home turnovers in the period, from the wire's counted string (6); the wire key is spelled home_trun_over.
home_max_difference integer Home team's largest lead in the period, in points; the wire key is spelled home_max_differenct.
away_ptr double Away field-goal percentage (2PT + 3PT) in the period, 0-100, a NUMBER with up to one decimal (61.5; whole values come as integers).
away_pt2r double Away two-point percentage, 0-100, number.
away_pt3r double Away three-point percentage, 0-100, number.
away_ftr double Away free-throw percentage, 0-100, number (0 when no attempts).
away_rebound_off integer Away offensive rebounds in the period, the first number of the wire's 'off-def-total' string.
away_rebound_def integer Away defensive rebounds in the period, the second number of the wire's 'off-def-total' string.
away_rebound_tot integer Away total rebounds in the period, the third number of the wire's 'off-def-total' string.
away_assist integer Away assists (integer).
away_turnovers integer Away turnovers in the period, from the wire's counted string (6); the wire key is spelled away_trun_over.
away_max_difference integer Away team's largest lead in the period, points (integer).
lead_count integer Lead changes in the period, from the wire's counted string (0 times).
tie_count integer Times the score was tied in the period, from the wire's counted string (4 times).

See Also

Other WJBL Functions: wjbl_box_score(), wjbl_game(), wjbl_game_info(), wjbl_game_months(), wjbl_head_to_head(), wjbl_leagues(), wjbl_pbp(), wjbl_period_scores(), wjbl_player(), wjbl_player_period_leaders(), wjbl_roster(), wjbl_schedule(), wjbl_staff(), wjbl_standing_seasons(), wjbl_team_box_score(), wjbl_team_ranking(), wjbl_team_standings(), wjbl_teams()


Get W League Team Ranking

Description

League table with per-game team averages (points, shooting, rebounds, assists) of one or more season phases.

Endpoint: ⁠GET https://api.wjbl.01core.app/api/team-ranking⁠

Usage

wjbl_team_ranking(season_ids)

Arguments

season_ids

Season phase id or ids (season_id in wjbl_standing_seasons; a phase inside a league edition, not a year): an integer, a list or a comma string such as '169,170' (2025-26 regular season Premier and Future divisions).

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_team_ranking(season_ids = "169,170")

Value

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

col_name type description
league_id integer Competition-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_title character Competition-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'.
season integer Season 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_id integer 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_title character Phase title in Japanese: regular season, (Japanese text) / playoff final, playoff semifinal (the separator varies by era).
season_full_name character league_title + phase (+ division) in Japanese: 2025-26 regular season, Premier division (Future division, from 2024-25).
season_league_name character Phase / division label in Japanese: Premier, Future, group stage, second round, lower league; empty for a single-table phase.
season_league_flg integer Division layout flag: 1 = one table per division (Premier / Future), 2 = split by season_team_area (East / West, by the site's JS), 0 = cup / group stage.
season_league_img character Division badge image path relative to https://www.wjbl.org.
season_tournament_text character Tournament text (HTML); empty in every sample.
update_info character As-of note in Japanese, (Japanese text) (as of 8 Feb 2026).
team_id integer 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.
season_team_name character Team name as registered for the season, in Japanese (company + nickname: Toyota Antelopes).
season_team_short_name character Short team name for that season, Japanese (Toyota).
team_entry_flg integer Official-league participant flag: 1 = a W League member team (the site links its roster), 0 = not (guest or all-star side). Integer.
position integer Rank of the team in the phase (a string on the wire).
season_team_area character Unobserved: null in every sample, so no type and no meaning is claimed. (By the site's standings JS: 0 = East, 1 = West conference when season_league_flg = 2.)
win integer Wins, integer.
lost integer Losses, integer.
winning_rate double Winning percentage as a FRACTION 0-1 with three decimals, a string ('0.821'); parsed to a number.
ppg double Points per game, a string with two decimals; parsed to a number.
opp double Opponent points per game (OPP), a string with two decimals; parsed to a number.
fg double Field-goal percentage 0-100 with a '%' sign, a string ('41.99%'); parsed to a number.
opp_fg double Opponents' field-goal percentage 0-100 with '%', a string; parsed to a number.
p3pg double Three-pointers made per game (3PPG), a string; parsed to a number.
rpg double Rebounds per game, a string; parsed to a number.
apg double Assists per game, a string; parsed to a number.
spg double Steals per game, a string; parsed to a number.
bpg double Blocks per game, a string; parsed to a number.
tpg double Turnovers per game, a string; parsed to a number.
gpd double Point differential summed over the season (GPD), NOT per game: (ppg - opp) x games ('193.00'), a string; parsed to a number.
win_point character Unobserved: null in every sample, so no type and no meaning is claimed. (By the site's JS: league points, a column shown only when filled.)
unsatisfied character Unobserved: null in every sample, so no type and no meaning is claimed. (By the site's JS: a column shown only when filled; meaning unverified.)

See Also

Other WJBL Functions: wjbl_box_score(), wjbl_game(), wjbl_game_info(), wjbl_game_months(), wjbl_head_to_head(), wjbl_leagues(), wjbl_pbp(), wjbl_period_scores(), wjbl_player(), wjbl_player_period_leaders(), wjbl_roster(), wjbl_schedule(), wjbl_staff(), wjbl_standing_seasons(), wjbl_team_box_score(), wjbl_team_period_stats(), wjbl_team_standings(), wjbl_teams()


Get W League Team Standings

Description

League table of one or more season phases: rank and record of every team.

Endpoint: ⁠GET https://api.wjbl.01core.app/api/team-standings⁠

Usage

wjbl_team_standings(season_ids)

Arguments

season_ids

Season phase id or ids (season_id in wjbl_standing_seasons; a phase inside a league edition, not a year): an integer, a list or a comma string such as '169,170' (2025-26 regular season Premier and Future divisions).

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.

Value

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

col_name type description
season_id integer 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_title character Phase title in Japanese: regular season, (Japanese text) / playoff final, playoff semifinal (the separator varies by era).
league_name character Division name, Japanese (Premier).
season_league_name character Phase / division label in Japanese: Premier, Future, group stage, second round, lower league; empty for a single-table phase.
season_league_flg integer Division layout flag: 1 = one table per division (Premier / Future), 2 = split by season_team_area (East / West, by the site's JS), 0 = cup / group stage.
update_date character As-of date in Japanese, (Japanese text).
team_id integer 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.
season_team_name character Team name as registered for the season, in Japanese (company + nickname: Toyota Antelopes).
season_team_short_name character Short team name for that season, Japanese (Toyota).
team_entry_flg integer Official-league participant flag: 1 = a W League member team (the site links its roster), 0 = not (guest or all-star side). Integer.
position integer Rank of the team in the phase (a string on the wire, equal to the map key).
season_team_area character Unobserved: null in every sample, so no type and no meaning is claimed. (By the site's standings JS: 0 = East, 1 = West conference when season_league_flg = 2.)
win_lost character Record in Japanese, (Japanese text) (23 wins, 5 losses).
wins integer Wins in the record, parsed from win_lost (23 wins).
losses integer Losses in the record, parsed from win_lost (5 losses).

See Also

Other WJBL Functions: wjbl_box_score(), wjbl_game(), wjbl_game_info(), wjbl_game_months(), wjbl_head_to_head(), wjbl_leagues(), wjbl_pbp(), wjbl_period_scores(), wjbl_player(), wjbl_player_period_leaders(), wjbl_roster(), wjbl_schedule(), wjbl_staff(), wjbl_standing_seasons(), wjbl_team_box_score(), wjbl_team_period_stats(), wjbl_team_ranking(), wjbl_teams()

Examples

try(wjbl_team_standings(season_ids = "169"))

Get W League Teams

Description

Every franchise (team_id) the site knows, all-star sides included.

Endpoint: ⁠GET https://api.wjbl.01core.app/api/teams/base⁠

Usage

wjbl_teams()

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_teams()

Value

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

col_name type description
team_id integer 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.
team_name character Franchise name, Japanese or English (Fujitsu Red Wave; all-star side Team Sirius).

See Also

Other WJBL Functions: wjbl_box_score(), wjbl_game(), wjbl_game_info(), wjbl_game_months(), wjbl_head_to_head(), wjbl_leagues(), wjbl_pbp(), wjbl_period_scores(), wjbl_player(), wjbl_player_period_leaders(), wjbl_roster(), wjbl_schedule(), wjbl_staff(), wjbl_standing_seasons(), wjbl_team_box_score(), wjbl_team_period_stats(), wjbl_team_ranking(), wjbl_team_standings()


Get WNBA Stats API All-time Leaders Grid

Description

Get WNBA Stats API All-time Leaders Grid

Get WNBA Stats API All-time Leaders Grid

Usage

wnba_alltimeleadersgrids(
  league_id = "10",
  per_mode = "PerGame",
  season_type = "Regular Season",
  top_x = 10,
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WWNBA, '20': G-League

per_mode

Per Mode - PerGame, Totals

season_type

Season Type - Regular Season, Playoffs, All-Star

top_x

Top X

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_alltimeleadersgrids(league_id = '10')

Value

Returns a named list of data frames: ASTLeaders, BLKLeaders, DREBLeaders, FG3ALeaders, FG3MLeaders, FG3_PCTLeaders, FGALeaders, FGMLeaders, FG_PCTLeaders, FTALeaders, FTMLeaders, FT_PCTLeaders, GPLeaders, OREBLeaders, PFLeaders, PTSLeaders, REBLeaders, STLLeaders, TOVLeaders

GPLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
GP character Games played.
GP_RANK character
IS_ACTIVE_FLAG character

PTSLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
PTS character Points scored.
PTS_RANK character
IS_ACTIVE_FLAG character

ASTLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
AST character Assists.
AST_RANK character
IS_ACTIVE_FLAG character

STLLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
STL character Steals.
STL_RANK character
IS_ACTIVE_FLAG character

OREBLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
OREB character Offensive rebounds.
OREB_RANK character
IS_ACTIVE_FLAG character

DREBLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
DREB character Defensive rebounds.
DREB_RANK character
IS_ACTIVE_FLAG character

REBLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
REB character Total rebounds.
REB_RANK character
IS_ACTIVE_FLAG character

BLKLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
BLK character Blocks.
BLK_RANK character
IS_ACTIVE_FLAG character

FGMLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FGM character Field goals made.
FGM_RANK character
IS_ACTIVE_FLAG character

FGALeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FGA character Field goal attempts.
FGA_RANK character
IS_ACTIVE_FLAG character

FG_PCTLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FG_PCT character Field goal percentage (0-1).
FG_PCT_RANK character
IS_ACTIVE_FLAG character

TOVLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TOV character Turnovers.
TOV_RANK character
IS_ACTIVE_FLAG character

FG3MLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FG3M character Three-point field goals made.
FG3M_RANK character
IS_ACTIVE_FLAG character

FG3ALeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FG3A character Three-point field goal attempts.
FG3A_RANK character
IS_ACTIVE_FLAG character

FG3_PCTLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FG3_PCT character Three-point field goal percentage (0-1).
FG3_PCT_RANK character
IS_ACTIVE_FLAG character

PFLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
PF character Personal fouls.
PF_RANK character
IS_ACTIVE_FLAG character

FTMLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FTM character Free throws made.
FTM_RANK character
IS_ACTIVE_FLAG character

FTALeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FTA character Free throw attempts.
FTA_RANK character
IS_ACTIVE_FLAG character

FT_PCTLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FT_PCT character Free throw percentage (0-1).
FT_PCT_RANK character
IS_ACTIVE_FLAG character

Author(s)

Saiem Gilani

See Also

Other WNBA Leaders Functions: wnba_assistleaders(), wnba_assisttracker(), wnba_homepagewidget(), wnba_leagueleaders()


Get WNBA Stats API Assist Leaders

Description

Get WNBA Stats API Assist Leaders

Get WNBA Stats API Assist Leaders

Usage

wnba_assistleaders(
  league_id = "10",
  per_mode = "PerGame",
  player_or_team = "Team",
  season = most_recent_wnba_season() - 1,
  season_type = "Regular Season",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WWNBA, '20': G-League

per_mode

Per Mode - PerGame, Totals

player_or_team

Player or Team

season

Season - format 2020-21

season_type

Season Type - Regular Season, Playoffs, All-Star

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_assistleaders(league_id = '10', player_or_team = "Player")
 wnba_assistleaders(league_id = '10', player_or_team = "Team")

Value

Returns a named list of data frames: AssistLeaders

AssistLeaders

col_name types description
RANK character Whether to include statistical ranks in the returned table.
PLAYER_ID character Unique player identifier.
PLAYER character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
JERSEY_NUM character Jersey number worn by the player.
PLAYER_POSITION character
AST character Assists.

Author(s)

Saiem Gilani

See Also

Other WNBA Leaders Functions: wnba_alltimeleadersgrids(), wnba_assisttracker(), wnba_homepagewidget(), wnba_leagueleaders()


Get WNBA Stats API Assist Tracker

Description

Get WNBA Stats API Assist Tracker

Get WNBA Stats API Assist Tracker

Usage

wnba_assisttracker(
  league_id = "10",
  per_mode = "PerGame",
  season = most_recent_wnba_season() - 1,
  season_type = "Regular Season",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WWNBA, '20': G-League

per_mode

Per Mode - PerGame, Totals

season

Season - format 2020-21

season_type

Season Type - Regular Season, Playoffs, All-Star

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_assisttracker(league_id = '10')

Value

Returns a named list of data frames: AssistTracker

AssistTracker

col_name types description
ASSISTS numeric Total assists.

Author(s)

Saiem Gilani

See Also

Other WNBA Leaders Functions: wnba_alltimeleadersgrids(), wnba_assistleaders(), wnba_homepagewidget(), wnba_leagueleaders()


Get WNBA Stats API Boxscore Summary V3

Description

Get WNBA Stats API Boxscore Summary V3

Get WNBA Stats API Boxscore Summary V3

Usage

wnba_boxscoresummaryv3(game_id = "1022200034", ...)

Arguments

game_id

Game ID - 10-digit zero-padded ID (e.g., '1022200034')

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_boxscoresummaryv3(game_id = "1022200034")

Value

Returns a named list of data frames: game_summary, game_info, arena_info, officials, line_score, inactive_players, last_five_meetings, other_stats, available_video

game_summary

col_name types description
game_date character Game date (YYYY-MM-DD).
game_sequence integer Game sequence.
game_id character Unique game identifier.
game_status_id integer Numeric game status identifier.
game_status_text character Game status display text (e.g. 'Final', '4:32 - 4th').
gamecode character Gamecode.
home_team_id integer Unique identifier for the home team.
visitor_team_id integer Unique identifier for visitor team.
season character Season identifier (4-digit year or 'YYYY-YY' string).
live_period integer Live period.
live_pc_time character Time / clock value.
natl_tv_broadcaster_abbreviation character Natl tv broadcaster abbreviation.
home_tv_broadcaster_abbreviation character Home team's tv broadcaster abbreviation.
away_tv_broadcaster_abbreviation character Away team's tv broadcaster abbreviation.
live_period_time_bcast character Live period time bcast.
arena_name character Arena name.
wh_status integer Wh status.

line_score

col_name types description
game_date_est character Game date est.
game_sequence integer Game sequence.
game_id character Unique game identifier.
team_id integer Unique team identifier.
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_city_name character Team city name.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_wins_losses character Team wins losses.
pts_qtr1 integer Pts qtr1.
pts_qtr2 integer Pts qtr2.
pts_qtr3 integer Pts qtr3.
pts_qtr4 integer Pts qtr4.
pts_ot1 integer Pts ot1.
pts integer Points scored.

Author(s)

Saiem Gilani

See Also

Other WNBA Boxscore V3 Functions: wnba_boxscorehustlev2(), wnba_boxscoretraditionalv3()


Get WNBA Stats API Boxscore Traditional V2

Description

Get WNBA Stats API Boxscore Traditional V2

Get WNBA Stats API Boxscore Traditional V2

Get WNBA Stats API Boxscore Advanced V2

Get WNBA Stats API Boxscore Four Factors V2

Get WNBA Stats API Boxscore Misc V2

Get WNBA Stats API Boxscore Scoring V2

Get WNBA Stats API Boxscore Usage V2

Usage

wnba_boxscoretraditionalv2(
  game_id,
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

wnba_boxscoreadvancedv2(
  game_id,
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

wnba_boxscorefourfactorsv2(
  game_id,
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

wnba_boxscoremiscv2(
  game_id,
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

wnba_boxscorescoringv2(
  game_id,
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

wnba_boxscoreusagev2(
  game_id,
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

Arguments

game_id

Game ID

start_period

start_period

end_period

end_period

start_range

start_range

end_range

end_range

range_type

range_type

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_boxscoretraditionalv2(game_id = "1022200034")
  wnba_boxscoreadvancedv2(game_id = "1022200034")
  wnba_boxscorefourfactorsv2(game_id = "1022200034")
  wnba_boxscoremiscv2(game_id = "1022200034")
  wnba_boxscorescoringv2(game_id = "1022200034")
  wnba_boxscoreusagev2(game_id = "1022200034")

Value

A list of data frames: PlayerStats, TeamStarterBenchStats, TeamStats

PlayerStats

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
NICKNAME character Team or athlete nickname.
START_POSITION character
COMMENT character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TO character
PF character Personal fouls.
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.

TeamStats

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TO character
PF character Personal fouls.
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.

TeamStarterBenchStats

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
STARTERS_BENCH character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TO character
PF character Personal fouls.
PTS character Points scored.

Returns a named list of data frames: PlayerStats, TeamStats

PlayerStats

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
NICKNAME character Team or athlete nickname.
START_POSITION character
COMMENT character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
MIN character Minutes played.
E_OFF_RATING character
OFF_RATING character Offensive rating (points produced per 100 possessions).
E_DEF_RATING character
DEF_RATING character Defensive rating (points allowed per 100 possessions).
E_NET_RATING character
NET_RATING character Net rating (off rating - def rating).
AST_PCT character Assist percentage (0-1).
AST_TOV character
AST_RATIO character Assist ratio (assists per 100 possessions used).
OREB_PCT character Offensive rebound percentage (0-1).
DREB_PCT character Defensive rebound percentage (0-1).
REB_PCT character Total rebound percentage (0-1).
TM_TOV_PCT character
EFG_PCT character Effective field goal percentage (0-1).
TS_PCT character True shooting percentage (0-1).
USG_PCT character Usage percentage (0-1).
E_USG_PCT character
E_PACE character
PACE character Possessions per 48 minutes.
PACE_PER40 character Pace per40.
POSS character
PIE character Player Impact Estimate (0-1).

TeamStats

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
MIN character Minutes played.
E_OFF_RATING character
OFF_RATING character Offensive rating (points produced per 100 possessions).
E_DEF_RATING character
DEF_RATING character Defensive rating (points allowed per 100 possessions).
E_NET_RATING character
NET_RATING character Net rating (off rating - def rating).
AST_PCT character Assist percentage (0-1).
AST_TOV character
AST_RATIO character Assist ratio (assists per 100 possessions used).
OREB_PCT character Offensive rebound percentage (0-1).
DREB_PCT character Defensive rebound percentage (0-1).
REB_PCT character Total rebound percentage (0-1).
E_TM_TOV_PCT character
TM_TOV_PCT character
EFG_PCT character Effective field goal percentage (0-1).
TS_PCT character True shooting percentage (0-1).
USG_PCT character Usage percentage (0-1).
E_USG_PCT character
E_PACE character
PACE character Possessions per 48 minutes.
PACE_PER40 character Pace per40.
POSS character
PIE character Player Impact Estimate (0-1).

Returns a named list of data frames: sqlPlayersFourFactors, sqlTeamFourFactors

sqlPlayersFourFactors

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
NICKNAME character Team or athlete nickname.
START_POSITION character
COMMENT character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
MIN character Minutes played.
EFG_PCT character Effective field goal percentage (0-1).
FTA_RATE character Free throw attempt rate (FTA / FGA).
TM_TOV_PCT character
OREB_PCT character Offensive rebound percentage (0-1).
OPP_EFG_PCT character
OPP_FTA_RATE character
OPP_TOV_PCT character
OPP_OREB_PCT character

sqlTeamsFourFactors

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
MIN character Minutes played.
EFG_PCT character Effective field goal percentage (0-1).
FTA_RATE character Free throw attempt rate (FTA / FGA).
TM_TOV_PCT character
OREB_PCT character Offensive rebound percentage (0-1).
OPP_EFG_PCT character
OPP_FTA_RATE character
OPP_TOV_PCT character
OPP_OREB_PCT character

Returns a named list of data frames: sqlPlayersMisc, sqlTeamsMisc

sqlPlayersMisc

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
NICKNAME character Team or athlete nickname.
START_POSITION character
COMMENT character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
MIN character Minutes played.
PTS_OFF_TOV character Points scored off opponent turnovers.
PTS_2ND_CHANCE character
PTS_FB character
PTS_PAINT character Points scored in the paint.
OPP_PTS_OFF_TOV character
OPP_PTS_2ND_CHANCE character
OPP_PTS_FB character
OPP_PTS_PAINT character
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character

sqlTeamsMisc

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
MIN character Minutes played.
PTS_OFF_TOV character Points scored off opponent turnovers.
PTS_2ND_CHANCE character
PTS_FB character
PTS_PAINT character Points scored in the paint.
OPP_PTS_OFF_TOV character
OPP_PTS_2ND_CHANCE character
OPP_PTS_FB character
OPP_PTS_PAINT character
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character

Returns a named list of data frames: sqlPlayersScoring, sqlTeamsScoring

sqlPlayersScoring

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
NICKNAME character Team or athlete nickname.
START_POSITION character
COMMENT character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
MIN character Minutes played.
PCT_FGA_2PT character
PCT_FGA_3PT character
PCT_PTS_2PT character
PCT_PTS_2PT_MR character
PCT_PTS_3PT character
PCT_PTS_FB character
PCT_PTS_FT character
PCT_PTS_OFF_TOV character
PCT_PTS_PAINT character
PCT_AST_2PM character
PCT_UAST_2PM character
PCT_AST_3PM character
PCT_UAST_3PM character
PCT_AST_FGM character
PCT_UAST_FGM character

sqlTeamsScoring

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
MIN character Minutes played.
PCT_FGA_2PT character
PCT_FGA_3PT character
PCT_PTS_2PT character
PCT_PTS_2PT_MR character
PCT_PTS_3PT character
PCT_PTS_FB character
PCT_PTS_FT character
PCT_PTS_OFF_TOV character
PCT_PTS_PAINT character
PCT_AST_2PM character
PCT_UAST_2PM character
PCT_AST_3PM character
PCT_UAST_3PM character
PCT_AST_FGM character
PCT_UAST_FGM character

Returns a named list of data frames: sqlPlayersUsage, sqlTeamsUsage

sqlPlayersUsage

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
NICKNAME character Team or athlete nickname.
START_POSITION character
COMMENT character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
MIN character Minutes played.
USG_PCT character Usage percentage (0-1).
PCT_FGM character
PCT_FGA character
PCT_FG3M character
PCT_FG3A character
PCT_FTM character
PCT_FTA character
PCT_OREB character
PCT_DREB character
PCT_REB character
PCT_AST character
PCT_TOV character
PCT_STL character
PCT_BLK character
PCT_BLKA character
PCT_PF character
PCT_PFD character
PCT_PTS character

sqlTeamsUsage

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
MIN character Minutes played.
USG_PCT character Usage percentage (0-1).
PCT_FGM character
PCT_FGA character
PCT_FG3M character
PCT_FG3A character
PCT_FTM character
PCT_FTA character
PCT_OREB character
PCT_DREB character
PCT_REB character
PCT_AST character
PCT_TOV character
PCT_STL character
PCT_BLK character
PCT_BLKA character
PCT_PF character
PCT_PFD character
PCT_PTS character

Author(s)

Saiem Gilani

See Also

Other WNBA Boxscore Functions: wnba_boxscoresummaryv2(), wnba_gamerotation()


Get WNBA Stats API Boxscore Traditional V3

Description

Get WNBA Stats API Boxscore Traditional V3

Get WNBA Stats API Boxscore Traditional V3

Get WNBA Stats API Boxscore Advanced V3

Get WNBA Stats API Boxscore Misc V3

Get WNBA Stats API Boxscore Scoring V3

Get WNBA Stats API Boxscore Four Factors V3

Get WNBA Stats API Boxscore Player Tracking V3

Get WNBA Stats API Boxscore Usage V3

Usage

wnba_boxscoretraditionalv3(
  game_id = "1022200034",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

wnba_boxscoreadvancedv3(
  game_id = "1022200034",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

wnba_boxscoremiscv3(
  game_id = "1022200034",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

wnba_boxscorescoringv3(
  game_id = "1022200034",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

wnba_boxscorefourfactorsv3(
  game_id = "1022200034",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

wnba_boxscoreplayertrackv3(
  game_id = "1022200034",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

wnba_boxscoreusagev3(
  game_id = "1022200034",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

Arguments

game_id

Game ID - 10-digit zero-padded ID (e.g., '1022200034')

start_period

start_period

end_period

end_period

start_range

start_range

end_range

end_range

range_type

range_type

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_boxscoretraditionalv3(game_id = "1022200034")
 wnba_boxscoreadvancedv3(game_id = "1022200034")
 wnba_boxscoremiscv3(game_id = "1022200034")
 wnba_boxscorescoringv3(game_id = "1022200034")
 wnba_boxscorefourfactorsv3(game_id = "1022200034")
 wnba_boxscoreplayertrackv3(game_id = "1022200034")
 wnba_boxscoreusagev3(game_id = "1022200034")

Value

A list of data frames: home_team_player_traditional, away_team_player_traditional, home_team_totals_traditional, away_team_totals_traditional, home_team_starters_totals, away_team_starters_totals, home_team_bench_totals, away_team_bench_totals

home_team_player_traditional

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
field_goals_percentage numeric Field goal percentage (0-1 decimal).
three_pointers_made integer Three-point field goals made.
three_pointers_attempted integer Three-point field goal attempts.
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
free_throws_percentage numeric Free throw percentage (0-1 decimal).
rebounds_offensive integer Offensive rebounds.
rebounds_defensive integer Defensive rebounds.
rebounds_total integer Total rebounds.
assists integer Total assists.
steals integer Total steals.
blocks integer Total blocks.
turnovers integer Total turnovers.
fouls_personal integer Personal fouls.
points integer Points scored.
plus_minus_points numeric Plus/minus point differential while on court.

away_team_player_traditional

Same columns as the home_team_player_traditional table above.

home_team_totals_traditional

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
field_goals_percentage numeric Field goal percentage (0-1 decimal).
three_pointers_made integer Three-point field goals made.
three_pointers_attempted integer Three-point field goal attempts.
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
free_throws_percentage numeric Free throw percentage (0-1 decimal).
rebounds_offensive integer Offensive rebounds.
rebounds_defensive integer Defensive rebounds.
rebounds_total integer Total rebounds.
assists integer Total assists.
steals integer Total steals.
blocks integer Total blocks.
turnovers integer Total turnovers.
fouls_personal integer Personal fouls.
points integer Points scored.
plus_minus_points numeric Plus/minus point differential while on court.

away_team_totals_traditional

Same columns as the home_team_totals_traditional table above.

home_team_starters_totals

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
field_goals_percentage numeric Field goal percentage (0-1 decimal).
three_pointers_made integer Three-point field goals made.
three_pointers_attempted integer Three-point field goal attempts.
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
free_throws_percentage numeric Free throw percentage (0-1 decimal).
rebounds_offensive integer Offensive rebounds.
rebounds_defensive integer Defensive rebounds.
rebounds_total integer Total rebounds.
assists integer Total assists.
steals integer Total steals.
blocks integer Total blocks.
turnovers integer Total turnovers.
fouls_personal integer Personal fouls.
points integer Points scored.

away_team_starters_totals

Same columns as the home_team_starters_totals table above.

home_team_bench_totals

Same columns as the home_team_starters_totals table above.

away_team_bench_totals

Same columns as the home_team_starters_totals table above.

A list of data frames: home_team_player_advanced, away_team_player_advanced, home_team_totals_advanced, away_team_totals_advanced

home_team_player_advanced

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
estimated_offensive_rating numeric Estimated offensive rating (points per 100 possessions estimate).
offensive_rating numeric Offensive rating (points per 100 possessions).
estimated_defensive_rating numeric Estimated defensive rating (points allowed per 100 possessions estimate).
defensive_rating numeric Defensive rating (points allowed per 100 possessions).
estimated_net_rating numeric Estimated net rating (off rating - def rating).
net_rating numeric Net rating (off rating - def rating).
assist_percentage numeric Assist percentage (0-1).
assist_to_turnover numeric Assist-to-turnover ratio.
assist_ratio numeric Assist ratio (assists per 100 possessions used).
offensive_rebound_percentage numeric Offensive rebound percentage (0-1).
defensive_rebound_percentage numeric Defensive rebound percentage (0-1).
rebound_percentage numeric Total rebound percentage (0-1).
turnover_ratio numeric Turnover ratio (turnovers per 100 possessions used).
effective_field_goal_percentage numeric Effective field goal percentage (0-1).
true_shooting_percentage numeric True shooting percentage (0-1).
usage_percentage numeric Usage percentage (0-1).
estimated_usage_percentage numeric Estimated usage percentage (0-1).
estimated_pace numeric Estimated possessions per 48 minutes.
pace numeric Possessions per 48 minutes.
pace_per40 numeric Pace per40.
possessions numeric Possessions used.
pie numeric Player Impact Estimate (0-1).

away_team_player_advanced

Same columns as the home_team_player_advanced table above.

home_team_totals_advanced

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
estimated_offensive_rating numeric Estimated offensive rating (points per 100 possessions estimate).
offensive_rating numeric Offensive rating (points per 100 possessions).
estimated_defensive_rating numeric Estimated defensive rating (points allowed per 100 possessions estimate).
defensive_rating numeric Defensive rating (points allowed per 100 possessions).
estimated_net_rating numeric Estimated net rating (off rating - def rating).
net_rating numeric Net rating (off rating - def rating).
assist_percentage numeric Assist percentage (0-1).
assist_to_turnover numeric Assist-to-turnover ratio.
assist_ratio numeric Assist ratio (assists per 100 possessions used).
offensive_rebound_percentage numeric Offensive rebound percentage (0-1).
defensive_rebound_percentage numeric Defensive rebound percentage (0-1).
rebound_percentage numeric Total rebound percentage (0-1).
estimated_team_turnover_percentage numeric Estimated team turnover percentage (0-1).
turnover_ratio numeric Turnover ratio (turnovers per 100 possessions used).
effective_field_goal_percentage numeric Effective field goal percentage (0-1).
true_shooting_percentage numeric True shooting percentage (0-1).
usage_percentage numeric Usage percentage (0-1).
estimated_usage_percentage numeric Estimated usage percentage (0-1).
estimated_pace numeric Estimated possessions per 48 minutes.
pace numeric Possessions per 48 minutes.
pace_per40 numeric Pace per40.
possessions numeric Possessions used.
pie numeric Player Impact Estimate (0-1).

away_team_totals_advanced

Same columns as the home_team_totals_advanced table above.

A list of data frames: home_team_player_misc, away_team_player_misc, home_team_totals_misc, away_team_totals_misc

home_team_player_misc

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
points_off_turnovers integer Points scored off opponent turnovers.
points_second_chance integer Second-chance points scored.
points_fast_break integer Fast-break points scored.
points_paint integer Points scored in the paint.
opp_points_off_turnovers integer Opponent points off turnovers.
opp_points_second_chance integer Opponent points second chance.
opp_points_fast_break integer Opponent points fast break.
opp_points_paint integer Opponent points paint.
blocks integer Total blocks.
blocks_against integer Shots blocked by opponents while attempting.
fouls_personal integer Personal fouls.
fouls_drawn integer Personal fouls drawn (by opponent's actions).

away_team_player_misc

Same columns as the home_team_player_misc table above.

home_team_totals_misc

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
points_off_turnovers integer Points scored off opponent turnovers.
points_second_chance integer Second-chance points scored.
points_fast_break integer Fast-break points scored.
points_paint integer Points scored in the paint.
opp_points_off_turnovers integer Opponent points off turnovers.
opp_points_second_chance integer Opponent points second chance.
opp_points_fast_break integer Opponent points fast break.
opp_points_paint integer Opponent points paint.
blocks integer Total blocks.
blocks_against integer Shots blocked by opponents while attempting.
fouls_personal integer Personal fouls.
fouls_drawn integer Personal fouls drawn (by opponent's actions).

away_team_totals_misc

Same columns as the home_team_totals_misc table above.

A list of data frames: home_team_player_scoring, away_team_player_scoring, home_team_totals_scoring, away_team_totals_scoring

home_team_player_scoring

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
percentage_field_goals_attempted2pt numeric Percentage field goals attempted2pt.
percentage_field_goals_attempted3pt numeric Percentage field goals attempted3pt.
percentage_points2pt numeric Percentage points2pt.
percentage_points_midrange2pt numeric Percentage points midrange2pt.
percentage_points3pt numeric Percentage points3pt.
percentage_points_fast_break numeric Percentage points fast break.
percentage_points_free_throw numeric Percentage points free throw.
percentage_points_off_turnovers numeric Percentage points off turnovers.
percentage_points_paint numeric Percentage points paint.
percentage_assisted2pt numeric Percentage assisted2pt.
percentage_unassisted2pt numeric Percentage unassisted2pt.
percentage_assisted3pt numeric Percentage assisted3pt.
percentage_unassisted3pt numeric Percentage unassisted3pt.
percentage_assisted_fgm numeric Percentage assisted fgm.
percentage_unassisted_fgm numeric Percentage unassisted fgm.

away_team_player_scoring

Same columns as the home_team_player_scoring table above.

home_team_totals_scoring

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
percentage_field_goals_attempted2pt numeric Percentage field goals attempted2pt.
percentage_field_goals_attempted3pt numeric Percentage field goals attempted3pt.
percentage_points2pt numeric Percentage points2pt.
percentage_points_midrange2pt numeric Percentage points midrange2pt.
percentage_points3pt numeric Percentage points3pt.
percentage_points_fast_break numeric Percentage points fast break.
percentage_points_free_throw numeric Percentage points free throw.
percentage_points_off_turnovers numeric Percentage points off turnovers.
percentage_points_paint numeric Percentage points paint.
percentage_assisted2pt numeric Percentage assisted2pt.
percentage_unassisted2pt numeric Percentage unassisted2pt.
percentage_assisted3pt numeric Percentage assisted3pt.
percentage_unassisted3pt numeric Percentage unassisted3pt.
percentage_assisted_fgm numeric Percentage assisted fgm.
percentage_unassisted_fgm numeric Percentage unassisted fgm.

away_team_totals_scoring

Same columns as the home_team_totals_scoring table above.

A list of data frames: home_team_player_four_factors, away_team_player_four_factors, home_team_totals_four_factors, away_team_totals_four_factors

home_team_player_four_factors

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
effective_field_goal_percentage numeric Effective field goal percentage (0-1).
free_throw_attempt_rate numeric Free throw attempt rate (FTA / FGA).
team_turnover_percentage numeric Team turnover percentage (0-1).
offensive_rebound_percentage numeric Offensive rebound percentage (0-1).
opp_effective_field_goal_percentage numeric Opponent effective field goal percentage (0-1 decimal).
opp_free_throw_attempt_rate numeric Opponent free throw attempt rate.
opp_team_turnover_percentage numeric Opponent team turnover percentage (0-1 decimal).
opp_offensive_rebound_percentage numeric Opponent offensive rebound percentage (0-1 decimal).

away_team_player_four_factors

Same columns as the home_team_player_four_factors table above.

home_team_totals_four_factors

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
effective_field_goal_percentage numeric Effective field goal percentage (0-1).
free_throw_attempt_rate numeric Free throw attempt rate (FTA / FGA).
team_turnover_percentage numeric Team turnover percentage (0-1).
offensive_rebound_percentage numeric Offensive rebound percentage (0-1).
opp_effective_field_goal_percentage numeric Opponent effective field goal percentage (0-1 decimal).
opp_free_throw_attempt_rate numeric Opponent free throw attempt rate.
opp_team_turnover_percentage numeric Opponent team turnover percentage (0-1 decimal).
opp_offensive_rebound_percentage numeric Opponent offensive rebound percentage (0-1 decimal).

away_team_totals_four_factors

Same columns as the home_team_totals_four_factors table above.

A list of data frames: home_team_player_player_track, away_team_player_player_track, home_team_totals_player_track, away_team_totals_player_track

home_team_player_player_track

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
speed numeric Speed.
distance numeric Distance value (in feet for shot data; otherwise context-dependent).
rebound_chances_offensive integer Rebound chances offensive.
rebound_chances_defensive integer Rebound chances defensive.
rebound_chances_total integer Rebound chances total.
touches integer Touches.
secondary_assists integer Secondary assists.
free_throw_assists integer Free throw assists (passes that led to a fouled shot attempt).
passes integer Passes.
assists integer Total assists.
contested_field_goals_made integer Contested field goals made.
contested_field_goals_attempted integer Contested field goal attempts.
contested_field_goal_percentage numeric Contested field goal percentage (0-1).
uncontested_field_goals_made integer Number of uncontested field goals made.
uncontested_field_goals_attempted integer Number of uncontested field goals attempted.
uncontested_field_goals_percentage numeric Uncontested field goals percentage (0-1 decimal).
field_goal_percentage numeric Field Goal Percentage.
defended_at_rim_field_goals_made integer Field goals made allowed when defending at the rim.
defended_at_rim_field_goals_attempted integer Field goal attempts allowed when defending at the rim.
defended_at_rim_field_goal_percentage numeric Field goal percentage allowed at the rim (0-1).

away_team_player_player_track

Same columns as the home_team_player_player_track table above.

home_team_totals_player_track

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
distance numeric Distance value (in feet for shot data; otherwise context-dependent).
rebound_chances_offensive integer Rebound chances offensive.
rebound_chances_defensive integer Rebound chances defensive.
rebound_chances_total integer Rebound chances total.
touches integer Touches.
secondary_assists integer Secondary assists.
free_throw_assists integer Free throw assists (passes that led to a fouled shot attempt).
passes integer Passes.
assists integer Total assists.
contested_field_goals_made integer Contested field goals made.
contested_field_goals_attempted integer Contested field goal attempts.
contested_field_goal_percentage numeric Contested field goal percentage (0-1).
uncontested_field_goals_made integer Number of uncontested field goals made.
uncontested_field_goals_attempted integer Number of uncontested field goals attempted.
uncontested_field_goals_percentage numeric Uncontested field goals percentage (0-1 decimal).
field_goal_percentage numeric Field Goal Percentage.
defended_at_rim_field_goals_made integer Field goals made allowed when defending at the rim.
defended_at_rim_field_goals_attempted integer Field goal attempts allowed when defending at the rim.
defended_at_rim_field_goal_percentage numeric Field goal percentage allowed at the rim (0-1).

away_team_totals_player_track

Same columns as the home_team_totals_player_track table above.

Returns a named list of data frames: home_team_player_usage, away_team_player_usage, home_team_totals_usage, away_team_totals_usage

home_team_player_usage

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
usage_percentage numeric Usage percentage (0-1).
percentage_field_goals_made numeric Number of percentage field goals made.
percentage_field_goals_attempted numeric Number of percentage field goals attempted.
percentage_three_pointers_made numeric Number of percentage three pointers made.
percentage_three_pointers_attempted numeric Number of percentage three pointers attempted.
percentage_free_throws_made numeric Number of percentage free throws made.
percentage_free_throws_attempted numeric Number of percentage free throws attempted.
percentage_rebounds_offensive numeric Percentage rebounds offensive.
percentage_rebounds_defensive numeric Percentage rebounds defensive.
percentage_rebounds_total numeric Percentage rebounds total.
percentage_assists numeric Percentage assists.
percentage_turnovers numeric Percentage turnovers.
percentage_steals numeric Percentage steals.
percentage_blocks numeric Percentage blocks.
percentage_blocks_allowed numeric Percentage blocks allowed.
percentage_personal_fouls numeric Percentage personal fouls.
percentage_personal_fouls_drawn numeric Percentage personal fouls drawn.
percentage_points numeric Percentage points.

away_team_player_usage

Same columns as the home_team_player_usage table above.

home_team_totals_usage

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
usage_percentage numeric Usage percentage (0-1).
percentage_field_goals_made numeric Number of percentage field goals made.
percentage_field_goals_attempted numeric Number of percentage field goals attempted.
percentage_three_pointers_made numeric Number of percentage three pointers made.
percentage_three_pointers_attempted numeric Number of percentage three pointers attempted.
percentage_free_throws_made numeric Number of percentage free throws made.
percentage_free_throws_attempted numeric Number of percentage free throws attempted.
percentage_rebounds_offensive numeric Percentage rebounds offensive.
percentage_rebounds_defensive numeric Percentage rebounds defensive.
percentage_rebounds_total numeric Percentage rebounds total.
percentage_assists numeric Percentage assists.
percentage_turnovers numeric Percentage turnovers.
percentage_steals numeric Percentage steals.
percentage_blocks numeric Percentage blocks.
percentage_blocks_allowed numeric Percentage blocks allowed.
percentage_personal_fouls numeric Percentage personal fouls.
percentage_personal_fouls_drawn numeric Percentage personal fouls drawn.
percentage_points numeric Percentage points.

away_team_totals_usage

Same columns as the home_team_totals_usage table above.

Author(s)

Saiem Gilani

See Also

Other WNBA Boxscore V3 Functions: wnba_boxscorehustlev2(), wnba_boxscoresummaryv3()


Get WNBA Stats API All Players

Description

Get WNBA Stats API All Players

Get WNBA Stats API All Players

Usage

wnba_commonallplayers(
  is_only_current_season = 0,
  league_id = "10",
  season = most_recent_wnba_season() - 1,
  ...
)

Arguments

is_only_current_season

is_only_current_season

league_id

league_id

season

season

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_commonallplayers(league_id = '10', season = most_recent_wnba_season() - 1)

Value

Return a named list of data frames: CommonAllPlayers

CommonAllPlayers

col_name types description
PERSON_ID character Unique player identifier (V3 endpoints).
DISPLAY_LAST_COMMA_FIRST character
DISPLAY_FIRST_LAST character
ROSTERSTATUS character
FROM_YEAR character
TO_YEAR character
PLAYERCODE character
PLAYER_SLUG character URL-safe player identifier.
TEAM_ID character Unique team identifier.
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CODE character
TEAM_SLUG character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
IS_NBA_ASSIGNED character
NBA_ASSIGNED_TEAM_ID character
GAMES_PLAYED_FLAG character

Author(s)

Saiem Gilani

See Also

Other WNBA Roster Functions: wnba_commonplayerinfo(), wnba_commonteamroster()


Get WNBA Stats API Player Info

Description

Get WNBA Stats API Player Info

Get WNBA Stats API Player Info

Usage

wnba_commonplayerinfo(league_id = "10", player_id = "1628932", ...)

Arguments

league_id

league_id

player_id

player_id

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_commonplayerinfo(league_id = '10', player_id = '1628932')

Value

Return a named list of data frames: CommonPlayerInfo, PlayerHeadlineStats, AvailableSeasons

CommonPlayerInfo

col_name types description
PERSON_ID character Unique player identifier (V3 endpoints).
FIRST_NAME character Player's first name.
LAST_NAME character Player's last name.
DISPLAY_FIRST_LAST character
DISPLAY_LAST_COMMA_FIRST character
DISPLAY_FI_LAST character
PLAYER_SLUG character URL-safe player identifier.
BIRTHDATE character
SCHOOL character Player's school / college (when distinct from 'college').
COUNTRY character Country (full name or code).
LAST_AFFILIATION character
HEIGHT character Player height (string e.g. '6-2' or inches).
WEIGHT character Player weight in pounds.
SEASON_EXP character
JERSEY character Jersey number worn by the player.
POSITION character Listed roster position (G, F, C, etc.).
ROSTERSTATUS character
GAMES_PLAYED_CURRENT_SEASON_FLAG character
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CODE character
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
PLAYERCODE character
FROM_YEAR character
TO_YEAR character
DLEAGUE_FLAG character
NBA_FLAG character
GAMES_PLAYED_FLAG character
DRAFT_YEAR character Draft year (4-digit).
DRAFT_ROUND character Round of the draft selection.
DRAFT_NUMBER character
GREATEST_75_FLAG character

PlayerHeadlineStats

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TimeFrame character
PTS character Points scored.
AST character Assists.
REB character Total rebounds.
ALL_STAR_APPEARANCES character

AvailableSeasons

col_name types description
SEASON_ID character Unique season identifier.

Author(s)

Saiem Gilani

See Also

Other WNBA Roster Functions: wnba_commonallplayers(), wnba_commonteamroster()


Get WNBA Stats API Playoff Series

Description

Get WNBA Stats API Playoff Series

Get WNBA Stats API Playoff Series

Usage

wnba_commonplayoffseries(
  league_id = "10",
  season = most_recent_wnba_season() - 1,
  series_id = "",
  ...
)

Arguments

league_id

league_id

season

season

series_id

series_id

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_commonplayoffseries(league_id = '10', season = most_recent_wnba_season() - 1)

Value

Return a named list of data frames: PlayoffSeries

PlayoffSeries

col_name types description
GAME_ID character Unique game identifier.
HOME_TEAM_ID character Unique identifier for the home team.
VISITOR_TEAM_ID character Unique identifier for visitor team.
SERIES_ID character
GAME_NUM character

Author(s)

Saiem Gilani


Get WNBA Stats API Team Roster

Description

Get WNBA Stats API Team Roster

Get WNBA Stats API Team Roster

Usage

wnba_commonteamroster(
  league_id = "10",
  season = most_recent_wnba_season() - 1,
  team_id = "1611661317",
  ...
)

Arguments

league_id

league_id

season

season

team_id

team_id

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_commonteamroster(season = most_recent_wnba_season() - 1, team_id = '1611661317')

Value

Return a named list of data frames: Coaches, CommonTeamRoster

CommonTeamRoster

col_name types description
TeamID character
SEASON character Season identifier (4-digit year or 'YYYY-YY' string).
LeagueID character
PLAYER character
NICKNAME character Team or athlete nickname.
PLAYER_SLUG character URL-safe player identifier.
NUM character
POSITION character Listed roster position (G, F, C, etc.).
HEIGHT character Player height (string e.g. '6-2' or inches).
WEIGHT character Player weight in pounds.
BIRTH_DATE character Date of birth (YYYY-MM-DD).
AGE character Player age (in years).
EXP character
SCHOOL character Player's school / college (when distinct from 'college').
PLAYER_ID character Unique player identifier.
HOW_ACQUIRED character

Coaches

col_name types description
TEAM_ID character Unique team identifier.
SEASON character Season identifier (4-digit year or 'YYYY-YY' string).
COACH_ID character Unique identifier for coach.
FIRST_NAME character Player's first name.
LAST_NAME character Player's last name.
COACH_NAME character
IS_ASSISTANT character
COACH_TYPE character
SORT_SEQUENCE character
SUB_SORT_SEQUENCE character

Author(s)

Saiem Gilani

See Also

Other WNBA Roster Functions: wnba_commonallplayers(), wnba_commonplayerinfo()


Get WNBA Stats API Cumulative Player Stats

Description

Get WNBA Stats API Cumulative Player Stats

Get WNBA Stats API Cumulative Player Stats

Usage

wnba_cumestatsplayer(
  game_ids = "1022200018",
  league_id = "10",
  player_id = "204319",
  season = "2021-22",
  season_type = "Regular Season",
  team_id = "",
  ...
)

Arguments

game_ids

game_ids

league_id

league_id

player_id

player_id

season

season

season_type

season_type

team_id

team_id

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_cumestatsplayer(game_ids = "1022200018", player_id = "204319", season = "2021-22")

Value

Return a named list of data frames: GameByGameStats, TotalPlayerStats

GameByGameStats

col_name types description
DATE_EST character
VISITOR_TEAM character
HOME_TEAM character
GP character Games played.
GS character Games started.
ACTUAL_MINUTES character
ACTUAL_SECONDS character
FG character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3 character
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FT character
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OFF_REB character
DEF_REB character
TOT_REB character
AVG_TOT_REB character
AST character Assists.
PF character Personal fouls.
DQ character
STL character Steals.
TURNOVERS character Total turnovers.
BLK character Blocks.
PTS character Points scored.
AVG_PTS character

TotalPlayerStats

col_name types description
DISPLAY_FI_LAST character
PERSON_ID character Unique player identifier (V3 endpoints).
JERSEY_NUM character Jersey number worn by the player.
GP character Games played.
GS character Games started.
ACTUAL_MINUTES character
ACTUAL_SECONDS character
FG character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3 character
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FT character
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OFF_REB character
DEF_REB character
TOT_REB character
AST character Assists.
PF character Personal fouls.
DQ character
STL character Steals.
TURNOVERS character Total turnovers.
BLK character Blocks.
PTS character Points scored.
MAX_ACTUAL_MINUTES character
MAX_ACTUAL_SECONDS character
MAX_REB character
MAX_AST character
MAX_STL character
MAX_TURNOVERS character
MAX_BLK character
MAX_PTS character
AVG_ACTUAL_MINUTES character
AVG_ACTUAL_SECONDS character
AVG_TOT_REB character
AVG_AST character
AVG_STL character
AVG_TURNOVERS character The average turnovers committed per game.
AVG_BLK character
AVG_PTS character
PER_MIN_TOT_REB character
PER_MIN_AST character
PER_MIN_STL character
PER_MIN_TURNOVERS character
PER_MIN_BLK character
PER_MIN_PTS character

Author(s)

Saiem Gilani

See Also

Other WNBA Cume Functions: wnba_cumestatsplayergames(), wnba_cumestatsteam(), wnba_cumestatsteamgames()


Get WNBA Stats API Cumulative Player Game Stats

Description

Get WNBA Stats API Cumulative Player Game Stats

Get WNBA Stats API Cumulative Player Game Stats

Usage

wnba_cumestatsplayergames(
  league_id = "10",
  location = "",
  outcome = "",
  player_id = "204319",
  season = "2021-22",
  season_type = "Regular Season",
  vs_conference = "",
  vs_division = "",
  vs_team_id = "",
  ...
)

Arguments

league_id

league_id

location

location

outcome

outcome

player_id

player_id

season

season

season_type

season_type

vs_conference

vs_conference

vs_division

vs_division

vs_team_id

vs_team_id

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_cumestatsplayergames(player_id = "204319", season = "2021-22")

Value

Returns a named list of data frames: CumeStatsPlayerGames

CumeStatsPlayerGames

col_name types description
MATCHUP character Matchup.
GAME_ID character Unique game identifier.

Author(s)

Saiem Gilani

See Also

Other WNBA Cume Functions: wnba_cumestatsplayer(), wnba_cumestatsteam(), wnba_cumestatsteamgames()


Get WNBA Stats API Cumulative Team Stats

Description

Get WNBA Stats API Cumulative Team Stats

Get WNBA Stats API Cumulative Team Stats

Usage

wnba_cumestatsteam(
  game_ids = "1022200018",
  league_id = "10",
  season = "2021-22",
  season_type = "Regular Season",
  team_id = "1611661317",
  ...
)

Arguments

game_ids

game_ids

league_id

league_id

season

season

season_type

season_type

team_id

team_id

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_cumestatsteam(game_ids = "1022200018", season = "2021-22", team_id = "1611661317")

Value

Returns a named list of data frames: GameByGameStats, TotalTeamStats

GameByGameStats

col_name types description
JERSEY_NUM character Jersey number worn by the player.
PLAYER character
PERSON_ID character Unique player identifier (V3 endpoints).
TEAM_ID character Unique team identifier.
GP character Games played.
GS character Games started.
ACTUAL_MINUTES character
ACTUAL_SECONDS character
FG character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3 character
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FT character
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OFF_REB character
DEF_REB character
TOT_REB character
AST character Assists.
PF character Personal fouls.
DQ character
STL character Steals.
TURNOVERS character Total turnovers.
BLK character Blocks.
PTS character Points scored.
MAX_ACTUAL_MINUTES character
MAX_ACTUAL_SECONDS character
MAX_REB character
MAX_AST character
MAX_STL character
MAX_TURNOVERS character
MAX_BLKP character
MAX_PTS character
AVG_ACTUAL_MINUTES character
AVG_ACTUAL_SECONDS character
AVG_REB character
AVG_AST character
AVG_STL character
AVG_TURNOVERS character The average turnovers committed per game.
AVG_BLKP character
AVG_PTS character
PER_MIN_REB character
PER_MIN_AST character
PER_MIN_STL character
PER_MIN_TURNOVERS character
PER_MIN_BLK character
PER_MIN_PTS character

TotalTeamStats

col_name types description
CITY character City.
NICKNAME character Team or athlete nickname.
TEAM_ID character Unique team identifier.
W character Wins.
L character Losses.
W_HOME character
L_HOME character
W_ROAD character
L_ROAD character
TEAM_TURNOVERS character Team turnovers (turnovers credited to the team rather than a player).
TEAM_REBOUNDS character Team rebounds (rebounds credited to the team rather than a player).
GP character Games played.
GS character Games started.
ACTUAL_MINUTES character
ACTUAL_SECONDS character
FG character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3 character
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FT character
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OFF_REB character
DEF_REB character
TOT_REB character
AST character Assists.
PF character Personal fouls.
STL character Steals.
TOTAL_TURNOVERS character Total turnovers (player + team).
BLK character Blocks.
PTS character Points scored.
AVG_REB character
AVG_PTS character
DQ character

Author(s)

Saiem Gilani

See Also

Other WNBA Cume Functions: wnba_cumestatsplayer(), wnba_cumestatsplayergames(), wnba_cumestatsteamgames()


Get WNBA Stats API Cumulative Team Game Stats

Description

Get WNBA Stats API Cumulative Team Game Stats

Get WNBA Stats API Cumulative Team Game Stats

Usage

wnba_cumestatsteamgames(
  league_id = "10",
  location = "",
  outcome = "",
  season = "2021-22",
  season_id = "",
  season_type = "Regular Season",
  team_id = 1611661317,
  vs_conference = "",
  vs_division = "",
  vs_team_id = "",
  ...
)

Arguments

league_id

league_id

location

location

outcome

outcome

season

season

season_id

season_id

season_type

season_type

team_id

team_id

vs_conference

vs_conference

vs_division

vs_division

vs_team_id

vs_team_id

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_cumestatsteamgames(team_id = 1611661317, season = "2021-22")
``

Value

Returns a named list of data frames: CumeStatsTeamGames

CumeStatsTeamGames

col_name types description
MATCHUP character Matchup.
GAME_ID character Unique game identifier.

Author(s)

Saiem Gilani

See Also

Other WNBA Cume Functions: wnba_cumestatsplayer(), wnba_cumestatsplayergames(), wnba_cumestatsteam()


Get WNBA Data API Play-by-Play

Description

Get WNBA Data API Play-by-Play

Get WNBA Data API Play-by-Play

Usage

wnba_data_pbp(game_id = "1022200034", ...)

Arguments

game_id

Game ID - 10 digits, i.e. "0021900001"

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_data_pbp(game_id = "1022200034")

Value

Returns a tibble

col_name types description
game_id character Unique game identifier.
league character League.
period integer Period of the game (1-4 quarters; 5+ for OT).
event_num integer Sequential event number within the game (V2 PBP).
clock character Game clock value.
description character Long-form description text.
locX integer
locY integer
opt1 integer Opt1.
opt2 integer Opt2.
event_action_type integer Numeric event-action-type code (V2 PBP).
event_type integer Event / play type code (V2 PBP).
team_id integer Unique team identifier.
offense_team_id integer Unique identifier for offense team.
player1_id integer V2 PBP primary player ID (e.g. shooter / fouler).
player2_id integer V2 PBP secondary player ID (e.g. assister / fouled-by).
player3_id integer V2 PBP tertiary player ID (e.g. blocker).
home_score integer Home team score at the time of the play.
away_score integer Away team score at the time of the play.
order integer Display order within the result set.

Event Message Types (event_type):

1 -> MAKE

2 -> MISS

3 -> FreeThrow

4 -> Rebound

5 -> Turnover

6 -> Foul

7 -> Violation

8 -> Substitution

9 -> Timeout

10 -> JumpBall

11 -> Ejection

12 -> StartOfPeriod

13 -> EndOfPeriod

14 -> Empty

Author(s)

Saiem Gilani

See Also

Other WNBA PBP Functions: wnba_live_pbp(), wnba_pbp(), wnba_pbps(), wnba_playbyplayv3()


Get WNBA Stats API Draft Board

Description

Get WNBA Stats API Draft Board

Get WNBA Stats API Draft Board

Usage

wnba_draftboard(season = most_recent_wnba_season(), ...)

Arguments

season

Draft year as numeric or character (e.g. 2026).

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_draftboard(season = most_recent_wnba_season())

Value

Returns a named list of tibbles: board, picks.

board

col_name types description
draft_id integer Unique identifier for draft.
title character Title or label for the record.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
status character Status label.
on_the_clock character On the clock.
draft_date character Date in YYYY-MM-DD format.
modified character Modified.

picks

col_name types description
round integer Tournament / playoff round.
pick integer Pick.
team_id integer Unique team identifier.
team_external_id integer Unique identifier for team external.
team_name character Full team display name (e.g. 'Las Vegas Aces').
prospect_id integer Unique identifier for prospect.
first_name character Player's first name.
last_name character Player's last name.
position character Listed roster position (G, F, C, etc.).
country character Country (full name or code).
college character College or school attended.
ppg character Points per game.
rpg character Rebounds per game.
apg character Assists per game.
spg character Steals per game.
bpg character Blocks per game.
fg_pct character Field goal percentage (0-1).
description character Long-form description text.
headshot_url character URL for headshot.

Author(s)

Saiem Gilani

See Also

Other WNBA Draft Functions: wnba_draftcombinestats(), wnba_drafthistory()


Get WNBA Stats API Draft Combine Stats

Description

Get WNBA Stats API Draft Combine Stats

Get WNBA Stats API Draft Combine Stats

Get WNBA Stats API Draft Combine Drill Results

Get WNBA Stats API Draft Combine Non-Stationary Shooting

Get WNBA Stats API Draft Combine Player Anthropological Measurements

Get WNBA Stats API Draft Combine - Spot Shooting

Usage

wnba_draftcombinestats(
  league_id = "10",
  season_year = most_recent_wnba_season() - 1,
  ...
)

wnba_draftcombinedrillresults(
  league_id = "10",
  season_year = most_recent_wnba_season() - 1,
  ...
)

wnba_draftcombinenonstationaryshooting(
  league_id = "10",
  season_year = most_recent_wnba_season() - 1,
  ...
)

wnba_draftcombineplayeranthro(
  league_id = "10",
  season_year = most_recent_wnba_season() - 1,
  ...
)

wnba_draftcombinespotshooting(
  league_id = "10",
  season_year = most_recent_wnba_season() - 1,
  ...
)

Arguments

league_id

league_id

season_year

season_year

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_draftcombinestats(season_year = most_recent_wnba_season() - 1)

(Possibly Defunct)

  wnba_draftcombinedrillresults(season_year = most_recent_wnba_season() - 2)

(Possibly Defunct)

  wnba_draftcombinenonstationaryshooting(season_year = most_recent_wnba_season() - 2)

(Possibly Defunct)

  wnba_draftcombineplayeranthro(season_year = most_recent_wnba_season() - 2)

(Possibly Defunct)

  wnba_draftcombinespotshooting(season_year = most_recent_wnba_season() - 2)

Value

Returns a named list of data frames: DraftCombineStats

DraftCombineStats

col_name types description
SEASON character Season identifier (4-digit year or 'YYYY-YY' string).
PLAYER_ID character Unique player identifier.
FIRST_NAME character Player's first name.
LAST_NAME character Player's last name.
PLAYER_NAME character Player name.
POSITION character Listed roster position (G, F, C, etc.).
HEIGHT_WO_SHOES character
HEIGHT_WO_SHOES_FT_IN character
HEIGHT_W_SHOES character
HEIGHT_W_SHOES_FT_IN character
WEIGHT character Player weight in pounds.
WINGSPAN character
WINGSPAN_FT_IN character
STANDING_REACH character
STANDING_REACH_FT_IN character
BODY_FAT_PCT character
HAND_LENGTH character
HAND_WIDTH character
STANDING_VERTICAL_LEAP character
MAX_VERTICAL_LEAP character
LANE_AGILITY_TIME character
MODIFIED_LANE_AGILITY_TIME character
THREE_QUARTER_SPRINT character
BENCH_PRESS character
SPOT_FIFTEEN_CORNER_LEFT character
SPOT_FIFTEEN_BREAK_LEFT character
SPOT_FIFTEEN_TOP_KEY character
SPOT_FIFTEEN_BREAK_RIGHT character
SPOT_FIFTEEN_CORNER_RIGHT character
SPOT_COLLEGE_CORNER_LEFT character
SPOT_COLLEGE_BREAK_LEFT character
SPOT_COLLEGE_TOP_KEY character
SPOT_COLLEGE_BREAK_RIGHT character
SPOT_COLLEGE_CORNER_RIGHT character
SPOT_NBA_CORNER_LEFT character
SPOT_NBA_BREAK_LEFT character
SPOT_NBA_TOP_KEY character
SPOT_NBA_BREAK_RIGHT character
SPOT_NBA_CORNER_RIGHT character
OFF_DRIB_FIFTEEN_BREAK_LEFT character
OFF_DRIB_FIFTEEN_TOP_KEY character
OFF_DRIB_FIFTEEN_BREAK_RIGHT character
OFF_DRIB_COLLEGE_BREAK_LEFT character
OFF_DRIB_COLLEGE_TOP_KEY character
OFF_DRIB_COLLEGE_BREAK_RIGHT character
ON_MOVE_FIFTEEN character
ON_MOVE_COLLEGE character

Returns a named list of data frames: Results

Returns a named list of data frames: Results

Returns a named list of data frames: Results

Returns a named list of data frames: Results

Author(s)

Saiem Gilani

See Also

Other WNBA Draft Functions: wnba_draftboard(), wnba_drafthistory()


Get WNBA Stats API Draft History

Description

Get WNBA Stats API Draft History

Usage

wnba_drafthistory(
  league_id = "10",
  college = "",
  overall_pick = "",
  round_pick = "",
  round_num = "",
  season = most_recent_wnba_season() - 1,
  team_id = "",
  top_x = "",
  ...
)

Arguments

league_id

league_id

college

college

overall_pick

overall_pick

round_pick

round_pick

round_num

round_num

season

season

team_id

team_id

top_x

top_x

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_drafthistory(season = most_recent_wnba_season() - 1)

Value

Returns a named list of data frames: DraftHistory

DraftHistory

col_name types description
PERSON_ID character Unique player identifier (V3 endpoints).
PLAYER_NAME character Player name.
SEASON character Season identifier (4-digit year or 'YYYY-YY' string).
ROUND_NUMBER character Numeric round.
ROUND_PICK character Round pick.
OVERALL_PICK character Overall pick.
DRAFT_TYPE character
TEAM_ID character Unique team identifier.
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
ORGANIZATION character Organization.
ORGANIZATION_TYPE character Organization type.
PLAYER_PROFILE_FLAG character Player profile flag.

Author(s)

Saiem Gilani

See Also

Other WNBA Draft Functions: wnba_draftboard(), wnba_draftcombinestats()


Get WNBA Stats API Fantasy Widget

Description

Get WNBA Stats API Fantasy Widget

Get WNBA Stats API Fantasy Widget

Usage

wnba_fantasywidget(
  active_players = "N",
  date_from = "",
  date_to = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  month = "",
  opponent_team_id = "",
  po_round = "",
  player_id = "",
  position = "",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  team_id = "",
  todays_opponent = 0,
  todays_players = "N",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

active_players

active_players

date_from

date_from date_from

date_to

date_to date_to

last_n_games

last_n_games

league_id

league_id

location

location

month

month

opponent_team_id

opponent_team_id

po_round

po_round

player_id

player_id

position

position

season

season

season_segment

season_segment

season_type

season_type

team_id

team_id

todays_opponent

todays_opponent

todays_players

todays_players

vs_conference

vs_conference

vs_division

vs_division

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_fantasywidget(league_id = '10', season = most_recent_wnba_season() - 1)

Value

Returns a named list of data frames: FantasyWidgetResult

FantasyWidgetResult

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
PLAYER_POSITION character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
GP character Games played.
MIN character Minutes played.
FAN_DUEL_PTS character
NBA_FANTASY_PTS character
PTS character Points scored.
REB character Total rebounds.
AST character Assists.
BLK character Blocks.
STL character Steals.
TOV character Turnovers.
FG3M character Three-point field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).

Author(s)

Saiem Gilani

See Also

Other WNBA Fantasy Functions: wnba_infographicfanduelplayer(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph()


Get WNBA Stats API Franchise History

Description

Get WNBA Stats API Franchise History

Get WNBA Stats API Franchise History

Usage

wnba_franchisehistory(league_id = "10", ...)

Arguments

league_id

league_id

...

Additional arguments passed to an underlying function like httr.

Details

Franchise History

  wnba_franchisehistory(league_id = '10')

Value

Returns a named list of data frames: DefunctTeams, FranchiseHistory

FranchiseHistory

col_name types description
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
START_YEAR character
END_YEAR character
YEARS character Years.
GAMES character
WINS character Total wins.
LOSSES character Total losses.
WIN_PCT character Win percentage (0-1 decimal).
PO_APPEARANCES character
DIV_TITLES character
CONF_TITLES character
LEAGUE_TITLES character

DefunctTeams

Same columns as the FranchiseHistory table above.

Author(s)

Saiem Gilani

See Also

Other WNBA Franchise Functions: wnba_franchiseleaders(), wnba_franchiseleaderswrank(), wnba_franchiseplayers()


Get WNBA Stats API Franchise Leaders

Description

Get WNBA Stats API Franchise Leaders

Get WNBA Stats API Franchise Leaders

Usage

wnba_franchiseleaders(league_id = "10", team_id = "1611661324", ...)

Arguments

league_id

league_id

team_id

team_id

...

Additional arguments passed to an underlying function like httr.

Details

Franchise Leaders

  wnba_franchiseleaders(league_id = '10', team_id = '1611661324')

Value

Returns a named list of data frames: FranchiseLeaders

FranchiseLeaders

col_name types description
TEAM_ID character Unique team identifier.
PTS character Points scored.
PTS_PERSON_ID character
PTS_PLAYER character
AST character Assists.
AST_PERSON_ID character
AST_PLAYER character
REB character Total rebounds.
REB_PERSON_ID character
REB_PLAYER character
BLK character Blocks.
BLK_PERSON_ID character
BLK_PLAYER character
STL character Steals.
STL_PERSON_ID character
STL_PLAYER character

Author(s)

Saiem Gilani

See Also

Other WNBA Franchise Functions: wnba_franchisehistory(), wnba_franchiseleaderswrank(), wnba_franchiseplayers()


Get WNBA Stats API Franchise Leaders with Rank

Description

Get WNBA Stats API Franchise Leaders with Rank

Get WNBA Stats API Franchise Leaders with Rank

Usage

wnba_franchiseleaderswrank(
  league_id = "10",
  per_mode = "Totals",
  season_type = "Regular Season",
  team_id = "1611661324",
  ...
)

Arguments

league_id

league_id

per_mode

per_mode

season_type

season_type

team_id

team_id

...

Additional arguments passed to an underlying function like httr.

Details

Franchise Leaders

 wnba_franchiseleaderswrank(league_id = '10', team_id = '1611661324')

Value

Returns a named list of data frames: FranchiseLeaderswRank

FranchiseLeaderswRank

col_name types description
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
TEAM character Team-side label or team identifier.
PERSON_ID character Unique player identifier (V3 endpoints).
PLAYER character
SEASON_TYPE character Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
ACTIVE_WITH_TEAM character
GP character Games played.
MINUTES character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
PF character Personal fouls.
STL character Steals.
TOV character Turnovers.
BLK character Blocks.
PTS character Points scored.
F_RANK_GP character
F_RANK_MINUTES character
F_RANK_FGM character
F_RANK_FGA character
F_RANK_FG_PCT character
F_RANK_FG3M character
F_RANK_FG3A character
F_RANK_FG3_PCT character
F_RANK_FTM character
F_RANK_FTA character
F_RANK_FT_PCT character
F_RANK_OREB character
F_RANK_DREB character
F_RANK_REB character
F_RANK_AST character
F_RANK_PF character
F_RANK_STL character
F_RANK_TOV character
F_RANK_BLK character
F_RANK_PTS character

Author(s)

Saiem Gilani

See Also

Other WNBA Franchise Functions: wnba_franchisehistory(), wnba_franchiseleaders(), wnba_franchiseplayers()


Get WNBA Stats API Franchise Players

Description

Get WNBA Stats API Franchise Players

Get WNBA Stats API Franchise Players

Usage

wnba_franchiseplayers(
  league_id = "10",
  per_mode = "Totals",
  season_type = "Regular Season",
  team_id = "1611661319",
  ...
)

Arguments

league_id

league_id

per_mode

per_mode

season_type

season_type

team_id

team_id

...

Additional arguments passed to an underlying function like httr.

Details

Franchise Players

 wnba_franchiseplayers(league_id = '10', team_id = '1611661319')
 wnba_franchiseplayers(league_id = '10', season_type = 'Playoffs', team_id = '1611661319')

Value

Returns a named list of data frames: FranchisePlayers

FranchisePlayers

col_name types description
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
TEAM character Team-side label or team identifier.
PERSON_ID character Unique player identifier (V3 endpoints).
PLAYER character
SEASON_TYPE character Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
ACTIVE_WITH_TEAM character
GP character Games played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
PF character Personal fouls.
STL character Steals.
TOV character Turnovers.
BLK character Blocks.
PTS character Points scored.

Author(s)

Saiem Gilani

See Also

Other WNBA Franchise Functions: wnba_franchisehistory(), wnba_franchiseleaders(), wnba_franchiseleaderswrank()


Get WNBA Stats API Game Rotation

Description

Get WNBA Stats API Game Rotation

Get WNBA Stats API Game Rotation

Usage

wnba_gamerotation(game_id, league_id = "10", rotation_stat = "PLAYER_PTS", ...)

Arguments

game_id

Game ID

league_id

League ID

rotation_stat

Rotation stat to provide details on: PLAYER_PTS, PT_DIFF, USG_PCT

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_gamerotation(game_id = "1022200034")

Value

Returns a named list of data frames: AwayTeam, HomeTeam

AwayTeam

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
PERSON_ID character Unique player identifier (V3 endpoints).
PLAYER_FIRST character
PLAYER_LAST character
IN_TIME_REAL character
OUT_TIME_REAL character
PLAYER_PTS character
PT_DIFF character
USG_PCT character Usage percentage (0-1).

HomeTeam

Same columns as the AwayTeam table above.

Author(s)

Saiem Gilani

See Also

Other WNBA Boxscore Functions: wnba_boxscoresummaryv2(), wnba_boxscoretraditionalv2()

Other WNBA Lineup Functions: wnba_leaguedashlineups(), wnba_leaguelineupviz(), wnba_possession_lineups(), wnba_rapm(), wnba_shot_zones(), wnba_shotchartlineupdetail(), wnba_teamdashlineups()


Get WNBA Stats API Homepage Widget Leaders

Description

Get WNBA Stats API Homepage Widget Leaders

Get WNBA Stats API Homepage Widget Leaders

Usage

wnba_homepagewidget(player_or_team = "Player", ...)

Arguments

player_or_team

Player or Team

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_homepagewidget(player_or_team = "Player")
 wnba_homepagewidget(player_or_team = "Team")

Value

Returns, for current season, a named list of data frames: PTS, REB, AST, BLK, STL, FG_PCT, FG3M, FG3_PCT, FANTASY_POINTS, TOTAL_PTS, TOTAL_REB, TOTAL_AST, ALL_TIME_TD3, TD3, GAME_FG3M, GAME_PTS, GAME_AST, GAME_STL, GAME_BLK, PCT_PTS_3PT, PCT_PTS_2PT, PCT_PTS_2PT_MR

PTS

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
RANK integer Whether to include statistical ranks in the returned table.
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID integer Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
PTS numeric Points scored.
FIRST_NAME character Player's first name.
NICKNAME character Team or athlete nickname.
LAST_NAME character Player's last name.
JERSEY_NUM character Jersey number worn by the player.
POSITION character Listed roster position (G, F, C, etc.).

REB

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
RANK integer Whether to include statistical ranks in the returned table.
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID integer Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
REB numeric Total rebounds.
FIRST_NAME character Player's first name.
NICKNAME character Team or athlete nickname.
LAST_NAME character Player's last name.
JERSEY_NUM character Jersey number worn by the player.
POSITION character Listed roster position (G, F, C, etc.).

AST

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
RANK integer Whether to include statistical ranks in the returned table.
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID integer Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
AST numeric Assists.
FIRST_NAME character Player's first name.
NICKNAME character Team or athlete nickname.
LAST_NAME character Player's last name.
JERSEY_NUM character Jersey number worn by the player.
POSITION character Listed roster position (G, F, C, etc.).

BLK

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
RANK integer Whether to include statistical ranks in the returned table.
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID integer Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
BLK numeric Blocks.
FIRST_NAME character Player's first name.
NICKNAME character Team or athlete nickname.
LAST_NAME character Player's last name.
JERSEY_NUM character Jersey number worn by the player.
POSITION character Listed roster position (G, F, C, etc.).

STL

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
RANK integer Whether to include statistical ranks in the returned table.
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID integer Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
STL numeric Steals.
FIRST_NAME character Player's first name.
NICKNAME character Team or athlete nickname.
LAST_NAME character Player's last name.
JERSEY_NUM character Jersey number worn by the player.
POSITION character Listed roster position (G, F, C, etc.).

FG_PCT

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
RANK integer Whether to include statistical ranks in the returned table.
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID integer Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
FG_PCT numeric Field goal percentage (0-1).
FIRST_NAME character Player's first name.
NICKNAME character Team or athlete nickname.
LAST_NAME character Player's last name.
JERSEY_NUM character Jersey number worn by the player.
POSITION character Listed roster position (G, F, C, etc.).

FG3M

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
RANK integer Whether to include statistical ranks in the returned table.
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID integer Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
FG3M integer Three-point field goals made.
FIRST_NAME character Player's first name.
NICKNAME character Team or athlete nickname.
LAST_NAME character Player's last name.
JERSEY_NUM character Jersey number worn by the player.
POSITION character Listed roster position (G, F, C, etc.).

FG3_PCT

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
RANK integer Whether to include statistical ranks in the returned table.
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID integer Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
FG3_PCT numeric Three-point field goal percentage (0-1).
FIRST_NAME character Player's first name.
NICKNAME character Team or athlete nickname.
LAST_NAME character Player's last name.
JERSEY_NUM character Jersey number worn by the player.
POSITION character Listed roster position (G, F, C, etc.).

FANTASY_POINTS

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID integer Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
FANTASY_POINTS numeric
FIRST_NAME character Player's first name.
NICKNAME character Team or athlete nickname.
LAST_NAME character Player's last name.
JERSEY_NUM character Jersey number worn by the player.
POSITION character Listed roster position (G, F, C, etc.).

TOTAL_PTS

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
PLAYER_NAME_LAST_FIRST character
NICKNAME character Team or athlete nickname.
TEAM_ID integer Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
PTS integer Points scored.

TOTAL_REB

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
PLAYER_NAME_LAST_FIRST character
NICKNAME character Team or athlete nickname.
TEAM_ID integer Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
REB integer Total rebounds.

TOTAL_AST

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
PLAYER_NAME_LAST_FIRST character
NICKNAME character Team or athlete nickname.
TEAM_ID integer Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
AST integer Assists.

ALL_TIME_TD3

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
PLAYER_NAME_LAST_FIRST character
TD3 integer

TD3

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
PLAYER_NAME_LAST_FIRST character
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
SEASON_YEAR character Season year string ('YYYY-YY' format).
TD3 integer

GAME_FG3M

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
PLAYER_NAME_LAST_FIRST character
NICKNAME character Team or athlete nickname.
TEAM_ID integer Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
FG3M integer Three-point field goals made.
GAME_ID character Unique game identifier.

GAME_PTS

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
PLAYER_NAME_LAST_FIRST character
NICKNAME character Team or athlete nickname.
TEAM_ID integer Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
PTS integer Points scored.
GAME_ID character Unique game identifier.

GAME_AST

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
PLAYER_NAME_LAST_FIRST character
NICKNAME character Team or athlete nickname.
TEAM_ID integer Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
AST integer Assists.
GAME_ID character Unique game identifier.

GAME_STL

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
PLAYER_NAME_LAST_FIRST character
NICKNAME character Team or athlete nickname.
TEAM_ID integer Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
STL integer Steals.
GAME_ID character Unique game identifier.

GAME_BLK

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
PLAYER_NAME_LAST_FIRST character
NICKNAME character Team or athlete nickname.
TEAM_ID integer Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
BLK integer Blocks.
GAME_ID character Unique game identifier.

PCT_PTS_3PT

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
PLAYER_NAME_LAST_FIRST character
NICKNAME character Team or athlete nickname.
TEAM_ID integer Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
PCT_PTS_3PT numeric

PCT_PTS_2PT

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
PLAYER_NAME_LAST_FIRST character
NICKNAME character Team or athlete nickname.
TEAM_ID integer Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
PCT_PTS_2PT numeric

PCT_PTS_2PT_MR

col_name types description
title character Title or label for the record.
deep_link character Deep link URL into wnba.com / espn.com.
name character Display name.
timestamp character ISO 8601 UTC timestamp.
permode character Per-mode aggregation ('Totals', 'PerGame', 'Per40', 'Per100Possessions', etc.).
season character Season identifier (4-digit year or 'YYYY-YY' string).
seasontype character Season type ('Regular Season', 'Playoffs', 'Pre Season', 'All Star').
PLAYER_ID integer Unique player identifier.
PLAYER_NAME character Player name.
PLAYER_NAME_LAST_FIRST character
NICKNAME character Team or athlete nickname.
TEAM_ID integer Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
PCT_PTS_2PT_MR numeric

Author(s)

Saiem Gilani

See Also

Other WNBA Leaders Functions: wnba_alltimeleadersgrids(), wnba_assistleaders(), wnba_assisttracker(), wnba_leagueleaders()


Get WNBA Stats API FanDuel Player Infographic

Description

Get WNBA Stats API FanDuel Player Infographic

Get WNBA Stats API FanDuel Player Infographic

Usage

wnba_infographicfanduelplayer(game_id, ...)

Arguments

game_id

game_id

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_infographicfanduelplayer(game_id = "1022200034")

Value

Return a named list of data frames: FanDuelPlayer

FanDuelPlayer

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
JERSEY_NUM character Jersey number worn by the player.
PLAYER_POSITION character
LOCATION character Filter results by game location.
FAN_DUEL_PTS character
WNBA_FANTASY_PTS character
USG_PCT character Usage percentage (0-1).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.

Author(s)

Saiem Gilani

See Also

Other WNBA Player Functions: wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playerindex(), wnba_playernextngames(), wnba_playerprofilev2(), wnba_playervsplayer()

Other WNBA Fantasy Functions: wnba_fantasywidget(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph()


Get WNBA Stats API League Dashboard Lineups

Description

Get WNBA Stats API League Dashboard Lineups

Get WNBA Stats API League Dashboard Lineups

Usage

wnba_leaguedashlineups(
  conference = "",
  date_from = "",
  date_to = "",
  division = "",
  game_segment = "",
  group_quantity = 5,
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  plus_minus = "N",
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

conference

conference

date_from

date_from

date_to

date_to

division

division

game_segment

game_segment

group_quantity

group_quantity

last_n_games

last_n_games

league_id

league_id

location

location

measure_type

measure_type

month

month

opponent_team_id

opponent_team_id

outcome

outcome

po_round

po_round

pace_adjust

pace_adjust

per_mode

per_mode

period

period

plus_minus

plus_minus

rank

rank

season

season

season_segment

season_segment

season_type

season_type

shot_clock_range

shot_clock_range

team_id

team_id

vs_conference

vs_conference

vs_division

vs_division

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_leaguedashlineups(league_id = '10', season = most_recent_wnba_season() - 1)

Value

Returns a named list of data frames: Lineups

Lineups

col_name types description
GROUP_SET character
GROUP_ID character Group identifier (e.g. conference group_id).
GROUP_NAME character Group name.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

Author(s)

Saiem Gilani

See Also

Other WNBA League Functions: wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leaguedashteamclutch(), wnba_leaguedashteamshotlocations(), wnba_leaguedashteamstats(), wnba_leaguegamefinder(), wnba_leaguegamelog(), wnba_leaguelineupviz(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_leaguestandingsv3(), wnba_shotchartleaguewide()

Other WNBA Lineup Functions: wnba_gamerotation(), wnba_leaguelineupviz(), wnba_possession_lineups(), wnba_rapm(), wnba_shot_zones(), wnba_shotchartlineupdetail(), wnba_teamdashlineups()


Get WNBA Stats API League Dashboard Player Biographical Stats

Description

Get WNBA Stats API League Dashboard Player Biographical Stats

Get WNBA Stats API League Dashboard Player Biographical Stats

Usage

wnba_leaguedashplayerbiostats(
  college = "",
  conference = "",
  country = "",
  date_from = "",
  date_to = "",
  division = "",
  draft_pick = "",
  draft_year = "",
  game_segment = "",
  game_scope = "",
  height = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  per_mode = "Totals",
  period = "",
  player_experience = "",
  player_position = "",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  starter_bench = "",
  team_id = "",
  touch_time_range = "",
  vs_conference = "",
  vs_division = "",
  weight = "",
  ...
)

Arguments

college

college

conference

conference

country

country

date_from

date_from

date_to

date_to

division

division

draft_pick

draft_pick

draft_year

draft_year

game_segment

game_segment

game_scope

game_scope

height

height

last_n_games

last_n_games

league_id

league_id

location

location

month

month

opponent_team_id

opponent_team_id

outcome

outcome

po_round

po_round

per_mode

per_mode

period

period

player_experience

player_experience

player_position

player_position

season

season

season_segment

season_segment

season_type

season_type

shot_clock_range

shot_clock_range

starter_bench

starter_bench

team_id

team_id

touch_time_range

touch_time_range

vs_conference

vs_conference

vs_division

vs_division

weight

weight

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_leaguedashplayerbiostats(league_id = '10', season = most_recent_wnba_season() - 1)

Value

Returns a named list of data frames: LeagueDashPlayerBioStats

LeagueDashPlayerBioStats

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
AGE character Player age (in years).
PLAYER_HEIGHT character
PLAYER_HEIGHT_INCHES character
PLAYER_WEIGHT character
COLLEGE character College or school attended.
COUNTRY character Country (full name or code).
DRAFT_YEAR character Draft year (4-digit).
DRAFT_ROUND character Round of the draft selection.
DRAFT_NUMBER character
GP character Games played.
PTS character Points scored.
REB character Total rebounds.
AST character Assists.
NET_RATING character Net rating (off rating - def rating).
OREB_PCT character Offensive rebound percentage (0-1).
DREB_PCT character Defensive rebound percentage (0-1).
USG_PCT character Usage percentage (0-1).
TS_PCT character True shooting percentage (0-1).
AST_PCT character Assist percentage (0-1).

Author(s)

Saiem Gilani

See Also

Other WNBA League Functions: wnba_leaguedashlineups(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leaguedashteamclutch(), wnba_leaguedashteamshotlocations(), wnba_leaguedashteamstats(), wnba_leaguegamefinder(), wnba_leaguegamelog(), wnba_leaguelineupviz(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_leaguestandingsv3(), wnba_shotchartleaguewide()

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playerindex(), wnba_playernextngames(), wnba_playerprofilev2(), wnba_playervsplayer()


Get WNBA Stats API League Dashboard by Player Clutch Splits

Description

Get WNBA Stats API League Dashboard by Player Clutch Splits

Get WNBA Stats API League Dashboard by Player Clutch Splits

Usage

wnba_leaguedashplayerclutch(
  ahead_behind = "Ahead or Behind",
  clutch_time = "Last 5 Minutes",
  college = "",
  conference = "",
  country = "",
  date_from = "",
  date_to = "",
  division = "",
  draft_pick = "",
  draft_year = "",
  game_scope = "",
  game_segment = "",
  height = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  point_diff = 5,
  po_round = "",
  per_mode = "Totals",
  period = 0,
  player_experience = "",
  player_position = "",
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  starter_bench = "",
  team_id = "",
  touch_time_range = "",
  vs_conference = "",
  vs_division = "",
  weight = "",
  ...
)

Arguments

ahead_behind

ahead_behind

clutch_time

clutch_time

college

college

conference

conference

country

country

date_from

date_from

date_to

date_to

division

division

draft_pick

draft_pick

draft_year

draft_year

game_scope

game_scope

game_segment

game_segment

height

height

last_n_games

last_n_games

league_id

league_id

location

location

measure_type

measure_type

month

month

opponent_team_id

opponent_team_id

outcome

outcome

pace_adjust

pace_adjust

plus_minus

plus_minus

point_diff

point_diff

po_round

po_round

per_mode

per_mode

period

period

player_experience

player_experience

player_position

player_position

rank

rank

season

season

season_segment

season_segment

season_type

season_type

shot_clock_range

shot_clock_range

starter_bench

starter_bench

team_id

team_id

touch_time_range

touch_time_range

vs_conference

vs_conference

vs_division

vs_division

weight

weight

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_leaguedashplayerclutch(league_id = '10', season = most_recent_wnba_season() - 1)

Value

Returns a named list of data frames: LeagueDashPlayerClutch

LeagueDashPlayerClutch

col_name types description
GROUP_SET character
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
NICKNAME character Team or athlete nickname.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
AGE character Player age (in years).
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
NBA_FANTASY_PTS character
DD2 character
TD3 character
WNBA_FANTASY_PTS character
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character
NBA_FANTASY_PTS_RANK character
DD2_RANK character
TD3_RANK character
WNBA_FANTASY_PTS_RANK character

Author(s)

Saiem Gilani

See Also

Other WNBA League Functions: wnba_leaguedashlineups(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leaguedashteamclutch(), wnba_leaguedashteamshotlocations(), wnba_leaguedashteamstats(), wnba_leaguegamefinder(), wnba_leaguegamelog(), wnba_leaguelineupviz(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_leaguestandingsv3(), wnba_shotchartleaguewide()

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playerindex(), wnba_playernextngames(), wnba_playerprofilev2(), wnba_playervsplayer()


Get WNBA Stats API League Dashboard Player Shot Locations

Description

Get WNBA Stats API League Dashboard Player Shot Locations

Get WNBA Stats API League Dashboard Player Shot Locations

Usage

wnba_leaguedashplayershotlocations(
  college = "",
  conference = "",
  country = "",
  date_from = "",
  date_to = "",
  distance_range = "By Zone",
  division = "",
  draft_pick = "",
  draft_year = "",
  dribble_range = "",
  game_scope = "",
  game_segment = "",
  height = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_experience = "",
  player_position = "",
  plus_minus = "N",
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  starter_bench = "",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  weight = "",
  ...
)

Arguments

college

college

conference

conference

country

country

date_from

date_from

date_to

date_to

distance_range

distance_range

division

division

draft_pick

draft_pick

draft_year

draft_year

dribble_range

dribble_range

game_scope

game_scope

game_segment

game_segment

height

height

last_n_games

last_n_games

league_id

league_id

location

location

measure_type

measure_type

month

month

opponent_team_id

opponent_team_id

outcome

outcome

po_round

po_round

pace_adjust

pace_adjust

per_mode

per_mode

period

period

player_experience

player_experience

player_position

player_position

plus_minus

plus_minus

rank

rank

season

season

season_segment

season_segment

season_type

season_type

shot_clock_range

shot_clock_range

starter_bench

starter_bench

team_id

team_id

vs_conference

vs_conference

vs_division

vs_division

weight

weight

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_leaguedashplayershotlocations(league_id = '10', season = most_recent_wnba_season() - 1)

Value

Returns a named list of data frames: ShotLocations

ShotLocations

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
AGE character Player age (in years).
NICKNAME character Team or athlete nickname.
Restricted_Area_FGM character
Restricted_Area_FGA character
Restricted_Area_FG_PCT character
In_The_Paint_Non_RA_FGM character
In_The_Paint_Non_RA_FGA character
In_The_Paint_Non_RA_FG_PCT character
Mid_Range_FGM character
Mid_Range_FGA character
Mid_Range_FG_PCT character
Left_Corner_3_FGM character
Left_Corner_3_FGA character
Left_Corner_3_FG_PCT character
Right_Corner_3_FGM character
Right_Corner_3_FGA character
Right_Corner_3_FG_PCT character
Above_the_Break_3_FGM character
Above_the_Break_3_FGA character
Above_the_Break_3_FG_PCT character
Backcourt_FGM character
Backcourt_FGA character
Backcourt_FG_PCT character
Corner_3_FGM character
Corner_3_FGA character
Corner_3_FG_PCT character

Author(s)

Saiem Gilani

See Also

Other WNBA League Functions: wnba_leaguedashlineups(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayerstats(), wnba_leaguedashteamclutch(), wnba_leaguedashteamshotlocations(), wnba_leaguedashteamstats(), wnba_leaguegamefinder(), wnba_leaguegamelog(), wnba_leaguelineupviz(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_leaguestandingsv3(), wnba_shotchartleaguewide()

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playerindex(), wnba_playernextngames(), wnba_playerprofilev2(), wnba_playervsplayer()

Other WNBA Shooting Functions: wnba_leaguedashteamshotlocations(), wnba_playerdashboardbyclutch(), wnba_shotchartdetail(), wnba_shotchartleaguewide(), wnba_shotchartlineupdetail(), wnba_teamdashboardbyclutch()


Get WNBA Stats API League Dashboard Player Stats

Description

Get WNBA Stats API League Dashboard Player Stats

Get WNBA Stats API League Dashboard Player Stats

Usage

wnba_leaguedashplayerstats(
  college = "",
  conference = "",
  country = "",
  date_from = "",
  date_to = "",
  division = "",
  draft_pick = "",
  draft_year = "",
  game_scope = "",
  game_segment = "",
  height = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  player_experience = "",
  player_position = "",
  plus_minus = "N",
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  starter_bench = "",
  team_id = "",
  two_way = "",
  vs_conference = "",
  vs_division = "",
  weight = "",
  ...
)

Arguments

college

college

conference

conference

country

country

date_from

date_from

date_to

date_to

division

division

draft_pick

draft_pick

draft_year

draft_year

game_scope

game_scope

game_segment

game_segment

height

height

last_n_games

last_n_games

league_id

league_id

location

location

measure_type

measure_type

month

month

opponent_team_id

opponent_team_id

outcome

outcome

pace_adjust

pace_adjust

po_round

po_round

per_mode

per_mode

period

period

player_experience

player_experience

player_position

player_position

plus_minus

plus_minus

rank

rank

season

season

season_segment

season_segment

season_type

season_type

shot_clock_range

shot_clock_range

starter_bench

starter_bench

team_id

team_id

two_way

two_way

vs_conference

vs_conference

vs_division

vs_division

weight

weight

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_leaguedashplayerstats(league_id = '10', season = most_recent_wnba_season() - 1)

Value

Returns a named list of data frames: LeagueDashPlayerStats

LeagueDashPlayerStats

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
NICKNAME character Team or athlete nickname.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
AGE character Player age (in years).
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
NBA_FANTASY_PTS character
DD2 character
TD3 character
WNBA_FANTASY_PTS character
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character
NBA_FANTASY_PTS_RANK character
DD2_RANK character
TD3_RANK character
WNBA_FANTASY_PTS_RANK character

Author(s)

Saiem Gilani

See Also

Other WNBA League Functions: wnba_leaguedashlineups(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashteamclutch(), wnba_leaguedashteamshotlocations(), wnba_leaguedashteamstats(), wnba_leaguegamefinder(), wnba_leaguegamelog(), wnba_leaguelineupviz(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_leaguestandingsv3(), wnba_shotchartleaguewide()

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playerindex(), wnba_playernextngames(), wnba_playerprofilev2(), wnba_playervsplayer()


Get WNBA Stats API League Dashboard by Team Clutch Splits

Description

Get WNBA Stats API League Dashboard by Team Clutch Splits

Get WNBA Stats API League Dashboard by Team Clutch Splits

Usage

wnba_leaguedashteamclutch(
  ahead_behind = "Ahead or Behind",
  clutch_time = "Last 5 Minutes",
  conference = "",
  date_from = "",
  date_to = "",
  division = "",
  game_scope = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  point_diff = 5,
  po_round = "",
  per_mode = "Totals",
  period = 0,
  player_experience = "",
  player_position = "",
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  starter_bench = "",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

ahead_behind

ahead_behind

clutch_time

clutch_time

conference

conference

date_from

date_from

date_to

date_to

division

division

game_scope

game_scope

game_segment

game_segment

last_n_games

last_n_games

league_id

league_id

location

location

measure_type

measure_type

month

month

opponent_team_id

opponent_team_id

outcome

outcome

pace_adjust

pace_adjust

plus_minus

plus_minus

point_diff

point_diff

po_round

po_round

per_mode

per_mode

period

period

player_experience

player_experience

player_position

player_position

rank

rank

season

season

season_segment

season_segment

season_type

season_type

shot_clock_range

shot_clock_range

starter_bench

starter_bench

team_id

team_id

vs_conference

vs_conference

vs_division

vs_division

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_leaguedashteamclutch(league_id = '10', season = most_recent_wnba_season() - 1)

Value

Returns a named list of data frames: LeagueDashTeamClutch

LeagueDashTeamClutch

Columns as documented in the shared wnba_leaguedashteamclutch_league_dash_team_clutch_schema table.

Author(s)

Saiem Gilani

See Also

Other WNBA League Functions: wnba_leaguedashlineups(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leaguedashteamshotlocations(), wnba_leaguedashteamstats(), wnba_leaguegamefinder(), wnba_leaguegamelog(), wnba_leaguelineupviz(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_leaguestandingsv3(), wnba_shotchartleaguewide()

Other WNBA Clutch Functions: wnba_playerdashboardbyclutch(), wnba_teamdashboardbyclutch()


Get WNBA Stats API League Dashboard Team Shot Locations

Description

Get WNBA Stats API League Dashboard Team Shot Locations

Get WNBA Stats API League Dashboard Team Shot Locations

Usage

wnba_leaguedashteamshotlocations(
  conference = "",
  date_from = "",
  date_to = "",
  distance_range = "By Zone",
  division = "",
  game_scope = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_experience = "",
  player_position = "",
  plus_minus = "N",
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  starter_bench = "",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

conference

conference

date_from

date_from

date_to

date_to

distance_range

distance_range

division

division

game_scope

game_scope

game_segment

game_segment

last_n_games

last_n_games

league_id

league_id

location

location

measure_type

measure_type

month

month

opponent_team_id

opponent_team_id

outcome

outcome

po_round

po_round

pace_adjust

pace_adjust

per_mode

per_mode

period

period

player_experience

player_experience

player_position

player_position

plus_minus

plus_minus

rank

rank

season

season

season_segment

season_segment

season_type

season_type

shot_clock_range

shot_clock_range

starter_bench

starter_bench

team_id

team_id

vs_conference

vs_conference

vs_division

vs_division

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_leaguedashteamshotlocations(league_id = '10', season = most_recent_wnba_season() - 1)

Value

Returns a named list of data frames: ShotLocations

ShotLocations

col_name types description
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
Restricted_Area_FGM character
Restricted_Area_FGA character
Restricted_Area_FG_PCT character
In_The_Paint_Non_RA_FGM character
In_The_Paint_Non_RA_FGA character
In_The_Paint_Non_RA_FG_PCT character
Mid_Range_FGM character
Mid_Range_FGA character
Mid_Range_FG_PCT character
Left_Corner_3_FGM character
Left_Corner_3_FGA character
Left_Corner_3_FG_PCT character
Right_Corner_3_FGM character
Right_Corner_3_FGA character
Right_Corner_3_FG_PCT character
Above_the_Break_3_FGM character
Above_the_Break_3_FGA character
Above_the_Break_3_FG_PCT character
Backcourt_FGM character
Backcourt_FGA character
Backcourt_FG_PCT character
Corner_3_FGM character
Corner_3_FGA character
Corner_3_FG_PCT character

Author(s)

Saiem Gilani

See Also

Other WNBA League Functions: wnba_leaguedashlineups(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leaguedashteamclutch(), wnba_leaguedashteamstats(), wnba_leaguegamefinder(), wnba_leaguegamelog(), wnba_leaguelineupviz(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_leaguestandingsv3(), wnba_shotchartleaguewide()

Other WNBA Shooting Functions: wnba_leaguedashplayershotlocations(), wnba_playerdashboardbyclutch(), wnba_shotchartdetail(), wnba_shotchartleaguewide(), wnba_shotchartlineupdetail(), wnba_teamdashboardbyclutch()


Get WNBA Stats API League Dashboard Team Stats

Description

Get WNBA Stats API League Dashboard Team Stats

Get WNBA Stats API League Dashboard Team Stats

Usage

wnba_leaguedashteamstats(
  conference = "",
  date_from = "",
  date_to = "",
  division = "",
  game_scope = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  plus_minus = "N",
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  starter_bench = "",
  team_id = "",
  two_way = "",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

conference

conference

date_from

date_from

date_to

date_to

division

division

game_scope

game_scope

game_segment

game_segment

last_n_games

last_n_games

league_id

league_id

location

location

measure_type

measure_type

month

month

opponent_team_id

opponent_team_id

outcome

outcome

po_round

po_round

pace_adjust

pace_adjust

per_mode

per_mode

period

period

plus_minus

plus_minus

rank

rank

season

season

season_segment

season_segment

season_type

season_type

shot_clock_range

shot_clock_range

starter_bench

starter_bench

team_id

team_id

two_way

two_way

vs_conference

vs_conference

vs_division

vs_division

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_leaguedashteamstats(league_id = '10', season = most_recent_wnba_season() - 1)

Value

Returns a named list of data frames: LeagueDashTeamStats

LeagueDashTeamStats

Columns as documented in the shared wnba_leaguedashteamclutch_league_dash_team_clutch_schema table.

Author(s)

Saiem Gilani

See Also

Other WNBA League Functions: wnba_leaguedashlineups(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leaguedashteamclutch(), wnba_leaguedashteamshotlocations(), wnba_leaguegamefinder(), wnba_leaguegamelog(), wnba_leaguelineupviz(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_leaguestandingsv3(), wnba_shotchartleaguewide()

Other WNBA Team Functions: wnba_teamdashboardbyclutch(), wnba_teamdashlineups(), wnba_teamdetails(), wnba_teamestimatedmetrics(), wnba_teamgamelog(), wnba_teamgamelogs(), wnba_teamgamestreakfinder(), wnba_teamhistoricalleaders(), wnba_teaminfocommon(), wnba_teamplayeronoffdetails(), wnba_teams(), wnba_teamvsplayer(), wnba_teamyearbyyearstats()


Get WNBA Stats API League Game Streak Finder

Description

Get WNBA Stats API League Game Streak Finder

Get WNBA Stats API League Game Streak Finder

Usage

wnba_leaguegamefinder(
  conference = "",
  date_from = "",
  date_to = "",
  division = "",
  draft_year = "",
  draft_team_id = "",
  draft_round = "",
  draft_number = "",
  et_ast = "",
  et_blk = "",
  et_dd = "",
  et_dreb = "",
  et_fg3a = "",
  et_fg3m = "",
  et_fg3_pct = "",
  et_fga = "",
  et_fgm = "",
  et_fg_pct = "",
  et_fta = "",
  et_ftm = "",
  et_ft_pct = "",
  et_minutes = "",
  et_oreb = "",
  et_pf = "",
  et_pts = "",
  et_reb = "",
  et_stl = "",
  et_td = "",
  et_tov = "",
  game_id = "",
  gt_ast = "",
  gt_blk = "",
  gt_dd = "",
  gt_dreb = "",
  gt_fg3a = "",
  gt_fg3m = "",
  gt_fg3_pct = "",
  gt_fga = "",
  gt_fgm = "",
  gt_fg_pct = "",
  gt_fta = "",
  gt_ftm = "",
  gt_ft_pct = "",
  gt_minutes = "",
  gt_oreb = "",
  gt_pf = "",
  gt_pts = "",
  gt_reb = "",
  gt_stl = "",
  gt_td = "",
  gt_tov = "",
  league_id = "10",
  location = "",
  lt_ast = "",
  lt_blk = "",
  lt_dd = "",
  lt_dreb = "",
  lt_fg3a = "",
  lt_fg3m = "",
  lt_fg3_pct = "",
  lt_fga = "",
  lt_fgm = "",
  lt_fg_pct = "",
  lt_fta = "",
  lt_ftm = "",
  lt_ft_pct = "",
  lt_minutes = "",
  lt_oreb = "",
  lt_pf = "",
  lt_pts = "",
  lt_reb = "",
  lt_stl = "",
  lt_td = "",
  lt_tov = "",
  outcome = "",
  po_round = "",
  player_id = "",
  player_or_team = "T",
  rookie_year = "",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  starter_bench = "",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  vs_team_id = "",
  years_experience = "",
  ...
)

Arguments

conference

conference

date_from

date_from

date_to

date_to

division

division

draft_year

draft_year

draft_team_id

draft_team_id

draft_round

draft_round

draft_number

draft_number

et_ast

et_ast

et_blk

et_blk

et_dd

et_dd

et_dreb

et_dreb

et_fg3a

et_fg3a

et_fg3m

et_fg3m

et_fg3_pct

et_fg3_pct

et_fga

et_fga

et_fgm

et_fgm

et_fg_pct

et_fg_pct

et_fta

et_fta

et_ftm

et_ftm

et_ft_pct

et_ft_pct

et_minutes

et_minutes

et_oreb

et_oreb

et_pf

et_pf

et_pts

et_pts

et_reb

et_reb

et_stl

et_stl

et_td

et_td

et_tov

et_tov

game_id

game_id

gt_ast

gt_ast

gt_blk

gt_blk

gt_dd

gt_dd

gt_dreb

gt_dreb

gt_fg3a

gt_fg3a

gt_fg3m

gt_fg3m

gt_fg3_pct

gt_fg3_pct

gt_fga

gt_fga

gt_fgm

gt_fgm

gt_fg_pct

gt_fg_pct

gt_fta

gt_fta

gt_ftm

gt_ftm

gt_ft_pct

gt_ft_pct

gt_minutes

gt_minutes

gt_oreb

gt_oreb

gt_pf

gt_pf

gt_pts

gt_pts

gt_reb

gt_reb

gt_stl

gt_stl

gt_td

gt_td

gt_tov

gt_tov

league_id

league_id

location

location

lt_ast

lt_ast

lt_blk

lt_blk

lt_dd

lt_dd

lt_dreb

lt_dreb

lt_fg3a

lt_fg3a

lt_fg3m

lt_fg3m

lt_fg3_pct

lt_fg3_pct

lt_fga

lt_fga

lt_fgm

lt_fgm

lt_fg_pct

lt_fg_pct

lt_fta

lt_fta

lt_ftm

lt_ftm

lt_ft_pct

lt_ft_pct

lt_minutes

lt_minutes

lt_oreb

lt_oreb

lt_pf

lt_pf

lt_pts

lt_pts

lt_reb

lt_reb

lt_stl

lt_stl

lt_td

lt_td

lt_tov

lt_tov

outcome

outcome

po_round

po_round

player_id

player_id

player_or_team

player_or_team

rookie_year

rookie_year

season

season - Min: '1983-84'

season_segment

season_segment

season_type

season_type

starter_bench

starter_bench

team_id

team_id

vs_conference

vs_conference

vs_division

vs_division

vs_team_id

vs_team_id

years_experience

years_experience

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_leaguegamefinder(league_id = '10', season = most_recent_wnba_season() - 1)

Value

Return a named list of data frames: LeagueGameFinderResults

LeagueGameFinderResults

col_name types description
SEASON_ID character Unique season identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
GAME_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
MATCHUP character Matchup.
WL character
MIN character Minutes played.
PTS character Points scored.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PLUS_MINUS character Plus/minus point differential while on court.

Author(s)

Saiem Gilani

See Also

Other WNBA League Functions: wnba_leaguedashlineups(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leaguedashteamclutch(), wnba_leaguedashteamshotlocations(), wnba_leaguedashteamstats(), wnba_leaguegamelog(), wnba_leaguelineupviz(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_leaguestandingsv3(), wnba_shotchartleaguewide()

Other WNBA Game Finder Functions: wnba_playergamestreakfinder(), wnba_teamgamestreakfinder()


Get WNBA Stats API League Game Log

Description

Get WNBA Stats API League Game Log

Get WNBA Stats API League Game Log

Usage

wnba_leaguegamelog(
  counter = 0,
  date_from = "",
  date_to = "",
  direction = "ASC",
  league_id = "10",
  player_or_team = "T",
  season = most_recent_wnba_season() - 1,
  season_type = "Regular Season",
  sorter = "DATE",
  ...
)

Arguments

counter

counter

date_from

date_from

date_to

date_to

direction

direction

league_id

league_id. Default '10' (WNBA). Use '00' for NBA or '20' for G-League data on the same endpoint.

player_or_team

player_or_team

season

season

season_type

season_type

sorter

sorter

...

Additional arguments passed to an underlying function like httr.

Details

Player/Team Boxscores

  wnba_leaguegamelog(league_id = '10', season = most_recent_wnba_season() - 1)

Value

Return a named list of data frames: LeagueGameLog

LeagueGameLog

col_name types description
SEASON_ID character Unique season identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
GAME_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
MATCHUP character Matchup.
WL character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
VIDEO_AVAILABLE character Video available.

Author(s)

Saiem Gilani

See Also

Other WNBA League Functions: wnba_leaguedashlineups(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leaguedashteamclutch(), wnba_leaguedashteamshotlocations(), wnba_leaguedashteamstats(), wnba_leaguegamefinder(), wnba_leaguelineupviz(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_leaguestandingsv3(), wnba_shotchartleaguewide()


Get WNBA Stats API League Leaders

Description

Get WNBA Stats API League Leaders

Get WNBA Stats API League Leaders

Usage

wnba_leagueleaders(
  active_flag = "",
  league_id = "10",
  per_mode = "Totals",
  scope = "S",
  season = most_recent_wnba_season() - 1,
  season_type = "Regular Season",
  stat_category = "PTS",
  ...
)

Arguments

active_flag

Active Flag

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League

per_mode

Per Mode - Totals, PerGame, Per48

scope

Scope - RS, S, Rookies

season

Season - format 2020-21

season_type

Season Type - Regular Season, Playoffs

stat_category

Stat Category: PTS, REB, AST, FG_PCT, FT_PCT, FG3_PCT, STL, BLK

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_leagueleaders(league_id = '10')

Value

Returns a named list of data frames: LeagueLeaders

LeagueLeaders

col_name types description
PLAYER_ID character Unique player identifier.
RANK character Whether to include statistical ranks in the returned table.
PLAYER character
TEAM_ID character Unique team identifier.
TEAM character Team-side label or team identifier.
GP character Games played.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.
EFF character
AST_TOV character
STL_TOV character

Author(s)

Saiem Gilani

See Also

Other WNBA Leaders Functions: wnba_alltimeleadersgrids(), wnba_assistleaders(), wnba_assisttracker(), wnba_homepagewidget()


Get WNBA Stats API League Lineup Visual Data

Description

Get WNBA Stats API League Lineup Visual Data

Get WNBA Stats API League Lineup Visual Data

Usage

wnba_leaguelineupviz(
  conference = "",
  date_from = "",
  date_to = "",
  division = "",
  game_segment = "",
  group_quantity = 5,
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  minutes_min = 10,
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  plus_minus = "N",
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

conference

conference

date_from

date_from

date_to

date_to

division

division

game_segment

game_segment

group_quantity

group_quantity

last_n_games

last_n_games

league_id

league_id

location

location

measure_type

measure_type

minutes_min

minutes_min

month

month

opponent_team_id

opponent_team_id

outcome

outcome

po_round

po_round

pace_adjust

pace_adjust

per_mode

per_mode

period

period

plus_minus

plus_minus

rank

rank

season

season

season_segment

season_segment

season_type

season_type

shot_clock_range

shot_clock_range

team_id

team_id

vs_conference

vs_conference

vs_division

vs_division

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_leaguelineupviz(league_id = '10', season = most_recent_wnba_season() - 1)

Value

Returns a named list of data frames: LeagueLineupViz

LeagueLineupViz

col_name types description
GROUP_ID character Group identifier (e.g. conference group_id).
GROUP_NAME character Group name.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
MIN character Minutes played.
OFF_RATING character Offensive rating (points produced per 100 possessions).
DEF_RATING character Defensive rating (points allowed per 100 possessions).
NET_RATING character Net rating (off rating - def rating).
PACE character Possessions per 48 minutes.
TS_PCT character True shooting percentage (0-1).
FTA_RATE character Free throw attempt rate (FTA / FGA).
TM_AST_PCT character
PCT_FGA_2PT character
PCT_FGA_3PT character
PCT_PTS_2PT_MR character
PCT_PTS_FB character
PCT_PTS_FT character
PCT_PTS_PAINT character
PCT_AST_FGM character
PCT_UAST_FGM character
OPP_FG3_PCT character
OPP_EFG_PCT character
OPP_FTA_RATE character
OPP_TOV_PCT character

Author(s)

Saiem Gilani

See Also

Other WNBA League Functions: wnba_leaguedashlineups(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leaguedashteamclutch(), wnba_leaguedashteamshotlocations(), wnba_leaguedashteamstats(), wnba_leaguegamefinder(), wnba_leaguegamelog(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_leaguestandingsv3(), wnba_shotchartleaguewide()

Other WNBA Lineup Functions: wnba_gamerotation(), wnba_leaguedashlineups(), wnba_possession_lineups(), wnba_rapm(), wnba_shot_zones(), wnba_shotchartlineupdetail(), wnba_teamdashlineups()


Get WNBA Stats API League Player On/Off Details

Description

Get WNBA Stats API League Player On/Off Details

Get WNBA Stats API League Player On/Off Details

Usage

wnba_leagueplayerondetails(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  plus_minus = "N",
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  team_id = "1611661313",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from

date_to

date_to

game_segment

game_segment

last_n_games

last_n_games

league_id

league_id

location

location

measure_type

measure_type

month

month

opponent_team_id

opponent_team_id

outcome

outcome

pace_adjust

pace_adjust

per_mode

per_mode

period

period

plus_minus

plus_minus

rank

rank

season

season

season_segment

season_segment

season_type

season_type

team_id

team_id

vs_conference

vs_conference

vs_division

vs_division

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_leagueplayerondetails(team_id = '1611661313', season = most_recent_wnba_season() - 1)

Value

Returns a named list of data frames: PlayersOnCourtLeaguePlayerDetails

PlayersOnCourtLeaguePlayerDetails

Columns as documented in the shared wnba_on_off_schema table.

Author(s)

Saiem Gilani

See Also

Other WNBA League Functions: wnba_leaguedashlineups(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leaguedashteamclutch(), wnba_leaguedashteamshotlocations(), wnba_leaguedashteamstats(), wnba_leaguegamefinder(), wnba_leaguegamelog(), wnba_leaguelineupviz(), wnba_leagueseasonmatchups(), wnba_leaguestandingsv3(), wnba_shotchartleaguewide()

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playerindex(), wnba_playernextngames(), wnba_playerprofilev2(), wnba_playervsplayer()


Get WNBA Stats API League Season Matchups

Description

Get WNBA Stats API League Season Matchups

Get WNBA Stats API League Season Matchups

Usage

wnba_leagueseasonmatchups(
  def_player_id = "",
  def_team_id = "",
  league_id = "10",
  off_player_id = "",
  off_team_id = "",
  per_mode = "Totals",
  season = most_recent_wnba_season() - 1,
  season_type = "Regular Season",
  ...
)

Arguments

def_player_id

def_player_id

def_team_id

def_team_id

league_id

league_id

off_player_id

off_player_id

off_team_id

off_team_id

per_mode

per_mode

season

season

season_type

season_type

...

Additional arguments passed to an underlying function like httr.

Details

(No Matchups Data for WNBA yet, so defunct)

 wnba_leagueseasonmatchups(league_id = '10', season = most_recent_wnba_season() - 1)

Value

Returns a named list of data frames: SeasonMatchups

SeasonMatchups

col_name types description
SEASON_ID character Unique season identifier.
OFF_PLAYER_ID character
OFF_PLAYER_NAME character
DEF_PLAYER_ID character
DEF_PLAYER_NAME character
GP character Games played.
MATCHUP_MIN character
PARTIAL_POSS character
PLAYER_PTS character
TEAM_PTS character
MATCHUP_AST character
MATCHUP_TOV character
MATCHUP_BLK character
MATCHUP_FGM character
MATCHUP_FGA character
MATCHUP_FG_PCT character
MATCHUP_FG3M character
MATCHUP_FG3A character
MATCHUP_FG3_PCT character
HELP_BLK character
HELP_FGM character
HELP_FGA character
HELP_FG_PERC character
MATCHUP_FTM character
MATCHUP_FTA character
SFL character
MATCHUP_TIME_SEC character

Author(s)

Saiem Gilani

See Also

Other WNBA League Functions: wnba_leaguedashlineups(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leaguedashteamclutch(), wnba_leaguedashteamshotlocations(), wnba_leaguedashteamstats(), wnba_leaguegamefinder(), wnba_leaguegamelog(), wnba_leaguelineupviz(), wnba_leagueplayerondetails(), wnba_leaguestandingsv3(), wnba_shotchartleaguewide()

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playerindex(), wnba_playernextngames(), wnba_playerprofilev2(), wnba_playervsplayer()


Get WNBA Stats API League Standings V3

Description

Get WNBA Stats API League Standings V3

Get WNBA Stats API League Standings V3

Usage

wnba_leaguestandingsv3(
  league_id = "10",
  season = most_recent_wnba_season() - 1,
  season_type = "Regular Season",
  season_year = "",
  ...
)

Arguments

league_id

league_id

season

season

season_type

season_type

season_year

season_year

...

Additional arguments passed to an underlying function like httr.

Details

League Standings

  wnba_leaguestandingsv3(league_id = '10', season = most_recent_wnba_season() - 1)

Value

Return a named list of data frames: Standings

Standings

col_name types description
LeagueID character
SeasonID character
TeamID character
TeamCity character
TeamName character
TeamSlug character
Conference character Filter players or teams by conference.
ConferenceRecord character
PlayoffRank character
ClinchIndicator character
Division character Team division.
DivisionRecord character
DivisionRank character
WINS character Total wins.
LOSSES character Total losses.
WinPCT character
LeagueRank character
Record character Record string (e.g. '12-4').
HOME character Home.
ROAD character Road.
L10 character L10.
Last10Home character
Last10Road character
OT character
ThreePTSOrLess character
TenPTSOrMore character
LongHomeStreak character
strLongHomeStreak character
LongRoadStreak character
strLongRoadStreak character
LongWinStreak character
LongLossStreak character
CurrentHomeStreak character
strCurrentHomeStreak character
CurrentRoadStreak character
strCurrentRoadStreak character
CurrentStreak character
strCurrentStreak character Strcurrentstreak.
ConferenceGamesBack character
DivisionGamesBack character
ClinchedConferenceTitle character
ClinchedDivisionTitle character
ClinchedPlayoffBirth character
ClinchedPlayIn character
EliminatedConference character
EliminatedDivision character
AheadAtHalf character
BehindAtHalf character
TiedAtHalf character
AheadAtThird character
BehindAtThird character
TiedAtThird character
Score100PTS character
OppScore100PTS character
OppOver500 character
LeadInFGPCT character
LeadInReb character
FewerTurnovers character
PointsPG character
OppPointsPG character
DiffPointsPG character
vsEast character
vsAtlantic character
vsCentral character
vsSoutheast character
vsWest character
vsNorthwest character
vsPacific character
vsSouthwest character
Jan character
Feb character
Mar character
Apr character
May character
Jun character
Jul character
Aug character
Sep character
Oct character
Nov character
Dec character
Score_80_Plus character
Opp_Score_80_Plus character
Score_Below_80 character
Opp_Score_Below_80 character
TotalPoints character
OppTotalPoints character
DiffTotalPoints character

Author(s)

Saiem Gilani

See Also

Other WNBA League Functions: wnba_leaguedashlineups(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leaguedashteamclutch(), wnba_leaguedashteamshotlocations(), wnba_leaguedashteamstats(), wnba_leaguegamefinder(), wnba_leaguegamelog(), wnba_leaguelineupviz(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_shotchartleaguewide()


Get WNBA Stats API Live Boxscore

Description

Get WNBA Stats API Live Boxscore

Get WNBA Stats API Live Boxscore

Usage

wnba_live_boxscore(game_id, ...)

Arguments

game_id

Game ID

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_live_boxscore(game_id = "1022200034")

Value

Returns a named list of data frames: game_details, arena, officials, home_team_boxscore, away_team_boxscore, home_team_player_boxscore, away_team_player_boxscore, home_team_linescores, away_team_linescores

game_details

col_name types description
game_id character Unique game identifier.
game_time_local character Game time local.
game_time_utc character Game start time in UTC (ISO 8601 timestamp).
game_time_home character Game time home.
game_time_away character Game time away.
game_et character Game et.
duration integer Duration.
game_code character ESPN game code (numeric identifier).
game_status_text character Game status display text (e.g. 'Final', '4:32 - 4th').
game_status integer Game status label.
regulation_periods integer Regulation periods.
period integer Period of the game (1-4 quarters; 5+ for OT).
game_clock character Game clock.
attendance integer Reported attendance.
sellout character Sellout.
home_team_id integer Unique identifier for the home team.
home_team_name character Home team name.
home_team_city character Home team city / location.
home_team_tricode character Home team three-letter code.
home_team_score integer Home team's score.
home_team_in_bonus character Home team's team in bonus.
home_team_timeouts_remaining integer Home team's team timeouts remaining.
away_team_id integer Unique identifier for the away team.
away_team_name character Away team name.
away_team_city character Away team city / location.
away_team_tricode character Away team three-letter code.
away_team_score integer Away team's score.
away_team_in_bonus character Away team's team in bonus.
away_team_timeouts_remaining integer Away team's team timeouts remaining.

arena

col_name types description
arena_id integer Unique identifier for arena.
arena_name character Arena name.
arena_city character Arena city.
arena_state character Arena state.
arena_country character Arena country.
arena_timezone character Arena timezone.

officials

col_name types description
person_id integer Unique player identifier (V3 endpoints).
name character Display name.
name_i character Initialed name (e.g. 'A. Wilson').
first_name character Player's first name.
family_name character Player's family / last name.
jersey_num character Jersey number worn by the player.
assignment character Assignment.

home_team_boxscore

col_name types description
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_score integer Team's score / final score.
team_in_bonus character Team in bonus.
team_timeouts_remaining integer Team timeouts remaining.
assists integer Total assists.
assists_turnover_ratio numeric Assists turnover ratio.
bench_points integer Points scored by the bench.
biggest_lead integer Biggest lead.
biggest_lead_score character Biggest lead score.
biggest_scoring_run integer Biggest scoring run.
biggest_scoring_run_score character Biggest scoring run score.
blocks integer Total blocks.
blocks_received integer Shots blocked by opponents while attempting.
fast_break_points_attempted integer Number of fast break points attempted.
fast_break_points_made integer Number of fast break points made.
fast_break_points_percentage numeric Fast break points percentage (0-1 decimal).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
field_goals_effective_adjusted numeric Field goals effective adjusted.
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_percentage numeric Field goal percentage (0-1 decimal).
fouls_offensive integer Offensive fouls.
fouls_drawn integer Personal fouls drawn (by opponent's actions).
fouls_personal integer Personal fouls.
fouls_team integer Fouls team.
fouls_technical integer Technical fouls.
fouls_team_technical integer Fouls team technical.
free_throws_attempted integer Free throw attempts.
free_throws_made integer Free throws made.
free_throws_percentage numeric Free throw percentage (0-1 decimal).
lead_changes integer Lead changes.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
minutes_calculated character Minutes calculated from game-clock differences.
points integer Points scored.
points_against integer Points allowed.
points_fast_break integer Fast-break points scored.
points_from_turnovers integer Points from turnovers.
points_in_the_paint integer Points in the paint.
points_in_the_paint_attempted integer Number of points in the paint attempted.
points_in_the_paint_made integer Number of points in the paint made.
points_in_the_paint_percentage numeric Points in the paint percentage (0-1 decimal).
points_second_chance integer Second-chance points scored.
rebounds_defensive integer Defensive rebounds.
rebounds_offensive integer Offensive rebounds.
rebounds_personal integer Rebounds personal.
rebounds_team integer Rebounds team.
rebounds_team_defensive integer Rebounds team defensive.
rebounds_team_offensive integer Rebounds team offensive.
rebounds_total integer Total rebounds.
second_chance_points_attempted integer Number of second chance points attempted.
second_chance_points_made integer Number of second chance points made.
second_chance_points_percentage numeric Second chance points percentage (0-1 decimal).
steals integer Total steals.
three_pointers_attempted integer Three-point field goal attempts.
three_pointers_made integer Three-point field goals made.
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
time_leading character Time leading.
times_tied integer Times tied.
true_shooting_attempts numeric Number of true shooting attempted.
true_shooting_percentage numeric True shooting percentage (0-1).
turnovers integer Total turnovers.
turnovers_team integer Turnovers team.
turnovers_total integer Turnovers total.
two_pointers_attempted integer Number of two pointers attempted.
two_pointers_made integer Number of two pointers made.
two_pointers_percentage numeric Two pointers percentage (0-1 decimal).

away_team_boxscore

Same columns as the home_team_boxscore table above.

home_team_player_boxscore

col_name types description
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_score integer Team's score / final score.
team_in_bonus character Team in bonus.
team_timeouts_remaining integer Team timeouts remaining.
status character Status label.
order integer Display order within the result set.
person_id integer Unique player identifier (V3 endpoints).
jersey_num character Jersey number worn by the player.
position character Listed roster position (G, F, C, etc.).
starter character TRUE if the player was in the starting lineup; FALSE otherwise.
oncourt character Oncourt.
played character Played.
assists integer Total assists.
blocks integer Total blocks.
blocks_received integer Shots blocked by opponents while attempting.
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_percentage numeric Field goal percentage (0-1 decimal).
fouls_offensive integer Offensive fouls.
fouls_drawn integer Personal fouls drawn (by opponent's actions).
fouls_personal integer Personal fouls.
fouls_technical integer Technical fouls.
free_throws_attempted integer Free throw attempts.
free_throws_made integer Free throws made.
free_throws_percentage numeric Free throw percentage (0-1 decimal).
minus numeric Minus.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
minutes_calculated character Minutes calculated from game-clock differences.
plus numeric Plus.
plus_minus_points numeric Plus/minus point differential while on court.
points integer Points scored.
points_fast_break integer Fast-break points scored.
points_in_the_paint integer Points in the paint.
points_second_chance integer Second-chance points scored.
rebounds_defensive integer Defensive rebounds.
rebounds_offensive integer Offensive rebounds.
rebounds_total integer Total rebounds.
steals integer Total steals.
three_pointers_attempted integer Three-point field goal attempts.
three_pointers_made integer Three-point field goals made.
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
turnovers integer Total turnovers.
two_pointers_attempted integer Number of two pointers attempted.
two_pointers_made integer Number of two pointers made.
two_pointers_percentage numeric Two pointers percentage (0-1 decimal).
name character Display name.
name_i character Initialed name (e.g. 'A. Wilson').
first_name character Player's first name.
family_name character Player's family / last name.
not_playing_reason character Not playing reason.
not_playing_description character Not playing description.

away_team_player_boxscore

Same columns as the home_team_player_boxscore table above.

home_team_linescores

col_name types description
period integer Period of the game (1-4 quarters; 5+ for OT).
period_type character Period type.
score integer Final score.

away_team_linescores

Same columns as the home_team_linescores table above.

Author(s)

Saiem Gilani


Get WNBA Stats API Live play-by-play

Description

Get WNBA Stats API Live play-by-play

Get WNBA Stats API Live play-by-play

Usage

wnba_live_pbp(game_id, ...)

Arguments

game_id

Game ID

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_live_pbp(game_id = "1022200034")

Value

Returns a data frame: PlayByPlay

col_name types description
event_num integer Sequential event number within the game (V2 PBP).
clock character Game clock value.
time_actual character Time actual.
period integer Period of the game (1-4 quarters; 5+ for OT).
period_type character Period type.
action_type character Action type label (e.g. 'Made Shot', 'Substitution').
sub_type character Action sub-type label.
qualifiers list Qualifiers.
player1_id integer V2 PBP primary player ID (e.g. shooter / fouler).
x numeric X.
y numeric Y.
offense_team_id integer Unique identifier for offense team.
home_score character Home team score at the time of the play.
away_score character Away team score at the time of the play.
edited character Edited.
order integer Display order within the result set.
x_legacy integer V2-format X coordinate (preserved for V3-to-V2 compatibility).
y_legacy integer V2-format Y coordinate (preserved for V3-to-V2 compatibility).
is_field_goal integer 1 if the action was a field goal; 0 otherwise.
side character Side label (e.g. 'home', 'away', or 'overUnder').
description character Long-form description text.
person_ids_filter list Person ids filter.
team_id integer Unique team identifier.
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
descriptor character Descriptor.
jump_ball_recovered_name character Jump ball recovered name.
jump_ball_recoverd_person_id integer Unique identifier for jump ball recoverd person.
player_name character Player name.
player_name_i character Player name i.
jump_ball_won_player_name character Jump ball won player name.
jump_ball_won_person_id integer Unique identifier for jump ball won person.
jump_ball_lost_player_name character Jump ball lost player name.
jump_ball_lost_person_id integer Unique identifier for jump ball lost person.
shot_distance numeric Shot distance from the basket, in feet.
shot_result character Shot result ('Made' / 'Missed').
shot_action_number integer Shot action number.
rebound_total integer Rebound total.
rebound_defensive_total integer Rebound defensive total.
rebound_offensive_total integer Rebound offensive total.
turnover_total integer Turnover total.
steal_player_name character Steal player name.
steal_person_id integer Unique identifier for steal person.
points_total integer Running total of points scored.
assist_player_name_initial character Assist player name initial.
assist_person_id integer Unique identifier for assist person.
assist_total integer Assist total.
official_id integer Unique official / referee identifier.
foul_personal_total integer Foul personal total.
foul_technical_total integer Foul technical total.
foul_drawn_player_name character Foul drawn player name.
foul_drawn_person_id integer Unique identifier for foul drawn person.
block_player_name character Block player name.
block_person_id integer Unique identifier for block person.
value character Numeric or string value field.
player2_id integer V2 PBP secondary player ID (e.g. assister / fouled-by).
player3_id integer V2 PBP tertiary player ID (e.g. blocker).

Author(s)

Saiem Gilani

See Also

Other WNBA PBP Functions: wnba_data_pbp(), wnba_pbp(), wnba_pbps(), wnba_playbyplayv3()

Other WNBA Live Functions: wnba_todays_scoreboard()


Get WNBA Stats API play-by-play

Description

Get WNBA Stats API play-by-play

Get WNBA Stats API play-by-play

Usage

wnba_pbp(game_id, on_court = TRUE, version = "v3", p = NULL, ...)

Arguments

game_id

Game ID

on_court

IF TRUE will be added ID of players on court

version

Play-by-play version - "v3" (default) or "v2". V3 returns richer data with shot coordinates, shot values, and V3 action types. V2 is available from 2016-17 onwards.

p

Progress bar

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_pbp(game_id = "1022200034", on_court = TRUE)

Value

Returns a data frame: PlayByPlay

col_name types description
game_id character Unique game identifier.
event_num character Sequential event number within the game (V2 PBP).
event_type character Event / play type code (V2 PBP).
event_action_type character Numeric event-action-type code (V2 PBP).
period numeric Period of the game (1-4 quarters; 5+ for OT).
minute_game numeric Minute game.
time_remaining numeric Time remaining.
wc_time_string character Wc time string.
time_quarter character Time quarter.
minute_remaining_quarter numeric Minute remaining quarter.
seconds_remaining_quarter numeric Seconds remaining quarter.
home_description character Home team's description.
neutral_description character Neutral description.
visitor_description character Visitor description.
score character Final score.
away_score numeric Away team score at the time of the play.
home_score numeric Home team score at the time of the play.
score_margin character Score margin.
person1type character Person1type.
player1_id character V2 PBP primary player ID (e.g. shooter / fouler).
player1_name character V2 PBP primary player name.
player1_team_id character Team ID of player1.
player1_team_city character Player1 team city.
player1_team_nickname character Player1 team nickname.
player1_team_abbreviation character Player1 team abbreviation.
person2type character Person2type.
player2_id character V2 PBP secondary player ID (e.g. assister / fouled-by).
player2_name character V2 PBP secondary player name.
player2_team_id character Team ID of player2.
player2_team_city character Player2 team city.
player2_team_nickname character Player2 team nickname.
player2_team_abbreviation character Player2 team abbreviation.
person3type character Person3type.
player3_id character V2 PBP tertiary player ID (e.g. blocker).
player3_name character V2 PBP tertiary player name.
player3_team_id character Team ID of player3.
player3_team_city character Player3 team city.
player3_team_nickname character Player3 team nickname.
player3_team_abbreviation character Player3 team abbreviation.
video_available_flag character Video available flag.
team_leading character Team leading.

See Also

Other WNBA PBP Functions: wnba_data_pbp(), wnba_live_pbp(), wnba_pbps(), wnba_playbyplayv3()


Get WNBA Stats API play-by-play (Multiple Games)

Description

Get WNBA Stats API play-by-play (Multiple Games)

Get WNBA Stats API play-by-play (Multiple Games)

Usage

wnba_pbps(
  game_ids = NULL,
  on_court = TRUE,
  version = "v3",
  nest_data = FALSE,
  ...
)

Arguments

game_ids

Game IDs

on_court

IF TRUE will be added ID of players on court

version

Play-by-play version - "v3" (default) or "v2". V3 returns richer data with shot coordinates, shot values, and V3 action types. V2 is available from 2016-17 onwards.

nest_data

If TRUE returns nested data by game

...

Additional arguments passed to an underlying function like httr.

Details

y <- c("1022200034", "1022200035" )

wnba_pbps(game_ids = y, version = "v2")

Value

Returns a data frame: PlayByPlay

Columns as documented in the shared wnba_players_on_court_schema table.

Author(s)

Jason Lee

See Also

Other WNBA PBP Functions: wnba_data_pbp(), wnba_live_pbp(), wnba_pbp(), wnba_playbyplayv3()


Get WNBA Stats API Play-by-Play V3

Description

Get WNBA Stats API Play-by-Play V3

Get WNBA Stats API Play-by-Play V3

Usage

wnba_playbyplayv3(game_id, start_period = 0, end_period = 0, ...)

Arguments

game_id

Game ID - 10-digit zero-padded ID (e.g., '1022200034')

start_period

Start period filter (default: 0 = all periods).

end_period

End period filter (default: 0 = all periods).

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_playbyplayv3(game_id = "1022200034")

Value

Returns a named list of data frames: PlayByPlay, AvailableVideo

PlayByPlay

col_name types description
game_id character Unique game identifier.
action_number integer Sequential action number within a game (V3 PBP).
clock character Game clock value.
period integer Period of the game (1-4 quarters; 5+ for OT).
team_id integer Unique team identifier.
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
person_id integer Unique player identifier (V3 endpoints).
player_name character Player name.
player_name_i character Player name i.
x_legacy integer V2-format X coordinate (preserved for V3-to-V2 compatibility).
y_legacy integer V2-format Y coordinate (preserved for V3-to-V2 compatibility).
shot_distance numeric Shot distance from the basket, in feet.
shot_result character Shot result ('Made' / 'Missed').
is_field_goal integer 1 if the action was a field goal; 0 otherwise.
score_home character Score home.
score_away character Score away.
points_total integer Running total of points scored.
location character Filter results by game location.
description character Long-form description text.
action_type character Action type label (e.g. 'Made Shot', 'Substitution').
sub_type character Action sub-type label.
video_available integer Video available.
shot_value integer Point value of the shot (2 or 3).
action_id integer Unique action identifier within a game (V3 PBP).

AvailableVideo

col_name types description
video_available integer Video available.

Author(s)

Saiem Gilani

See Also

Other WNBA PBP Functions: wnba_data_pbp(), wnba_live_pbp(), wnba_pbp(), wnba_pbps()


Get the WNBA cross-source player crosswalk

Description

Build a wide, one-row-per-player-per-team crosswalk linking ESPN, WNBA Stats, and Fox player identities for a season. Matching is deterministic: normalized exact name within a team block, then Jaro-Winkler fuzzy with jersey/DOB tiebreakers. Yahoo columns are NA placeholders.

Usage

wnba_player_crosswalk(
  season = most_recent_wnba_season(),
  min_confidence = 0.92
)

Arguments

season

Season year (numeric). Defaults to the most recent WNBA season.

min_confidence

Jaro-Winkler similarity floor for fuzzy matches (default 0.92).

Value

A wehoop_data tibble, one row per player per team (ESPN-anchored).

See Also

Other WNBA Crosswalk Functions: load_wnba_team_crosswalk(), wnba_schedule_crosswalk(), wnba_team_crosswalk()

Examples

try(wnba_player_crosswalk(season = 2024))

Get WNBA Stats API Player Awards

Description

Get WNBA Stats API Player Awards

Get WNBA Stats API Player Awards

Usage

wnba_playerawards(player_id, ...)

Arguments

player_id

Player ID

...

Additional arguments passed to an underlying function like httr.

Details

Player Awards

 wnba_playerawards(player_id = '1628932')

Value

Return a named list of data frames: PlayerAwards

PlayerAwards

col_name types description
PERSON_ID character Unique player identifier (V3 endpoints).
FIRST_NAME character Player's first name.
LAST_NAME character Player's last name.
TEAM character Team-side label or team identifier.
DESCRIPTION character Long-form description text.
ALL_WNBA_TEAM_NUMBER character
SEASON character Season identifier (4-digit year or 'YYYY-YY' string).
MONTH character Month number.
WEEK character Week number within the season.
CONFERENCE character Filter players or teams by conference.
TYPE character Record type / category.
SUBTYPE1 character
SUBTYPE2 character
SUBTYPE3 character

Author(s)

Saiem Gilani

See Also

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playerindex(), wnba_playernextngames(), wnba_playerprofilev2(), wnba_playervsplayer()


Get WNBA Stats API Player Career By College

Description

Get WNBA Stats API Player Career By College

Get WNBA Stats API Player Career By College

Usage

wnba_playercareerbycollege(
  college = "Florida State",
  league_id = "10",
  per_mode = "Totals",
  season = most_recent_wnba_season() - 1,
  season_type = "Regular Season",
  ...
)

Arguments

college

College Name

league_id

League - default: '00'. Other options include '10': WWNBA, '20': G-League

per_mode

Per Mode - PerGame, Totals

season

Season - format 2020-21

season_type

Season Type - Regular Season, Playoffs, All-Star

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_playercareerbycollege(college = 'Florida State', per_mode = 'PerGame')

Value

Return a named list of data frames: PlayerCareerByCollege

PlayerCareerByCollege

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
COLLEGE character College or school attended.
GP character Games played.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
PF character Personal fouls.
PTS character Points scored.

Author(s)

Saiem Gilani

See Also

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playerindex(), wnba_playernextngames(), wnba_playerprofilev2(), wnba_playervsplayer()


Get WNBA Stats API Player Career By College Rollup

Description

Get WNBA Stats API Player Career By College Rollup

Get WNBA Stats API Player Career By College Rollup

Usage

wnba_playercareerbycollegerollup(
  league_id = "10",
  per_mode = "Totals",
  season = most_recent_wnba_season() - 1,
  season_type = "Regular Season",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WWNBA, '20': G-League

per_mode

Per Mode - PerGame, Totals

season

Season - format 2020-21

season_type

Season Type - Regular Season, Playoffs, All-Star

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_playercareerbycollegerollup(per_mode = 'Totals')

Value

Return a named list of data frames: East, Midwest, South, West

East

col_name types description
REGION character Region label.
SEED character Tournament seed.
COLLEGE character College or school attended.
PLAYERS character
GP character Games played.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

South

Same columns as the East table above.

Midwest

Same columns as the East table above.

West

Same columns as the East table above.

Author(s)

Saiem Gilani

See Also

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playerindex(), wnba_playernextngames(), wnba_playerprofilev2(), wnba_playervsplayer()


Get WNBA Stats API Player Career Stats

Description

Get WNBA Stats API Player Career Stats

Get WNBA Stats API Player Career Stats

Usage

wnba_playercareerstats(
  league_id = "10",
  per_mode = "Totals",
  player_id = "1628932",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WWNBA, '20': G-League

per_mode

Per Mode - PerGame, Totals

player_id

Player ID

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_playercareerstats(player_id = '1628932')

Value

Return a named list of data frames: CareerTotalsAllStarSeason, CareerTotalsCollegeSeason, CareerTotalsPostSeason, CareerTotalsRegularSeason, SeasonRankingsPostSeason, SeasonRankingsRegularSeason, SeasonTotalsAllStarSeason, SeasonTotalsCollegeSeason, SeasonTotalsPostSeason, SeasonTotalsRegularSeason

SeasonTotalsRegularSeason

Columns as documented in the shared wnba_playercareerstats_season_totals_schema table.

CareerTotalsRegularSeason

col_name types description
PLAYER_ID character Unique player identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
Team_ID character Unique team identifier.
GP character Games played.
GS character Games started.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

SeasonTotalsPostSeason

Columns as documented in the shared wnba_playercareerstats_season_totals_schema table.

CareerTotalsPostSeason

Same columns as the CareerTotalsRegularSeason table above.

SeasonTotalsAllStarSeason

Columns as documented in the shared wnba_playercareerstats_season_totals_schema table.

CareerTotalsAllStarSeason

Same columns as the CareerTotalsRegularSeason table above.

SeasonTotalsCollegeSeason

CareerTotalsCollegeSeason

SeasonTotalsShowcaseSeason

CareerTotalsShowcaseSeason

SeasonRankingsRegularSeason

Columns as documented in the shared wnba_playercareerstats_season_rankings_schema table.

SeasonRankingsPostSeason

Columns as documented in the shared wnba_playercareerstats_season_rankings_schema table.

Author(s)

Saiem Gilani

See Also

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playerindex(), wnba_playernextngames(), wnba_playerprofilev2(), wnba_playervsplayer()


Get WNBA Stats API Player Compare

Description

Get WNBA Stats API Player Compare

Get WNBA Stats API Player Compare

Usage

wnba_playercompare(
  conference = "",
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id_list = "100720,202250,204319,1627668,1628931",
  plus_minus = "N",
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  vs_conference = "",
  vs_division = "",
  vs_player_id_list = "202252,203399,1631022,1628878,204333",
  ...
)

Arguments

conference

conference

date_from

date_from

date_to

date_to

game_segment

game_segment

last_n_games

last_n_games

league_id

League - default: '00'. Other options include '10': WWNBA, '20': G-League

location

location

measure_type

measure_type

month

month

opponent_team_id

opponent_team_id

outcome

outcome

pace_adjust

pace_adjust

per_mode

per_mode

period

period

player_id_list

Player ID

plus_minus

plus_minus

rank

rank

season

Season - format 2020-21

season_segment

season_segment

season_type

Season Type - Regular Season, Playoffs, All-Star

shot_clock_range

shot_clock_range

vs_conference

vs_conference

vs_division

vs_division

vs_player_id_list

vs_player_id_list

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_playercompare(player_id_list = '100720,202250,204319,1627668,1628931', vs_player_id_list = '202252,203399,1631022,1628878,204333')

Value

Return a named list of data frames: Individual, OverallCompare

OverallCompare

col_name types description
GROUP_SET character
DESCRIPTION character Long-form description text.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.

Individual

Same columns as the OverallCompare table above.

Author(s)

Saiem Gilani

See Also

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playerindex(), wnba_playernextngames(), wnba_playerprofilev2(), wnba_playervsplayer()


Get WNBA Stats API Player Dashboard by Clutch Splits

Description

Get WNBA Stats API Player Dashboard by Clutch Splits

Get WNBA Stats API Player Dashboard by Clutch Splits

Get WNBA Stats API Player Dashboard by Game Splits

Get WNBA Stats API Player Dashboard by General Splits

Get WNBA Stats API Player Dashboard by Last N Games

Get WNBA Stats API Player Dashboard by Opponent

Get WNBA Stats API Player Dashboard by Shooting Splits

Get WNBA Stats API Player Dashboard by Team Performance

Get WNBA Stats API Player Dashboard Year over Year

Usage

wnba_playerdashboardbyclutch(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id = "1628932",
  plus_minus = "N",
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  vs_conference = "",
  vs_division = "",
  ...
)

wnba_playerdashboardbygamesplits(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id = "1628932",
  plus_minus = "N",
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  vs_conference = "",
  vs_division = "",
  ...
)

wnba_playerdashboardbygeneralsplits(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id = "1628932",
  plus_minus = "N",
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  vs_conference = "",
  vs_division = "",
  ...
)

wnba_playerdashboardbylastngames(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id = "1628932",
  plus_minus = "N",
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  vs_conference = "",
  vs_division = "",
  ...
)

wnba_playerdashboardbyopponent(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id = "1628932",
  plus_minus = "N",
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  vs_conference = "",
  vs_division = "",
  ...
)

wnba_playerdashboardbyshootingsplits(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id = "1628932",
  plus_minus = "N",
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  vs_conference = "",
  vs_division = "",
  ...
)

wnba_playerdashboardbyteamperformance(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id = "1628932",
  plus_minus = "N",
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  vs_conference = "",
  vs_division = "",
  ...
)

wnba_playerdashboardbyyearoveryear(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id = "1628932",
  plus_minus = "N",
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from

date_to

date_to

game_segment

game_segment

last_n_games

last_n_games

league_id

league_id

location

location

measure_type

measure_type

month

month

opponent_team_id

opponent_team_id

outcome

outcome

po_round

po_round

pace_adjust

pace_adjust

per_mode

per_mode

period

period

player_id

player_id

plus_minus

plus_minus

rank

rank

season

season

season_segment

season_segment

season_type

season_type

shot_clock_range

shot_clock_range

vs_conference

vs_conference

vs_division

vs_division

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_playerdashboardbyclutch(player_id = '1628932', season = most_recent_wnba_season() - 1)
 wnba_playerdashboardbygamesplits(player_id = '1628932', season = most_recent_wnba_season() - 1)
 wnba_playerdashboardbygeneralsplits(player_id = '1628932', season = most_recent_wnba_season() - 1)
 wnba_playerdashboardbylastngames(player_id = '1628932', season = most_recent_wnba_season() - 1)
 wnba_playerdashboardbyopponent(player_id = '1628932', season = most_recent_wnba_season() - 1)
 wnba_playerdashboardbyshootingsplits(player_id = '1628932', season = most_recent_wnba_season() - 1)
 wnba_playerdashboardbyteamperformance(player_id = '1628932', season = most_recent_wnba_season() - 1)
 wnba_playerdashboardbyyearoveryear(player_id = '1628932', season = most_recent_wnba_season() - 1)

Value

Return a named list of data frames: Last10Sec3Point2PlayerDashboard, Last10Sec3PointPlayerDashboard, Last1Min5PointPlayerDashboard, Last1MinPlusMinus5PointPlayerDashboard, Last30Sec3Point2PlayerDashboard, Last30Sec3PointPlayerDashboard, Last3Min5PointPlayerDashboard, Last3MinPlusMinus5PointPlayerDashboard, Last5Min5PointPlayerDashboard, Last5MinPlusMinus5PointPlayerDashboard, OverallPlayerDashboard

OverallPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

Last5Min5PointPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

Last3Min5PointPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

Last1Min5PointPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

Last30Sec3PointPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

Last10Sec3PointPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

Last5MinPlusMinus5PointPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

Last3MinPlusMinus5PointPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

Last1MinPlusMinus5PointPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

Last30Sec3Point2PlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

Last10Sec3Point2PlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

Return a named list of data frames: ByActualMarginPlayerDashboard, ByHalfPlayerDashboard, ByPeriodPlayerDashboard, ByScoreMarginPlayerDashboard, OverallPlayerDashboard

OverallPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

ByHalfPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

ByPeriodPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

ByScoreMarginPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

ByActualMarginPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

Return a named list of data frames: DaysRestPlayerDashboard, LocationPlayerDashboard, MonthPlayerDashboard, OverallPlayerDashboard, PrePostAllStarPlayerDashboard, StartingPosition, WinsLossesPlayerDashboard

OverallPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

LocationPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

WinsLossesPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

MonthPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

PrePostAllStarPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

StartingPosition

Columns as documented in the shared wnba_player_dashboard_schema table.

DaysRestPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

Return a named list of data frames: GameNumberPlayerDashboard, Last10PlayerDashboard, Last15PlayerDashboard, Last20PlayerDashboard, Last5PlayerDashboard, OverallPlayerDashboard

OverallPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

Last5PlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

Last10PlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

Last15PlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

Last20PlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

GameNumberPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

Return a named list of data frames: ConferencePlayerDashboard, DivisionPlayerDashboard, OpponentPlayerDashboard, OverallPlayerDashboard

OverallPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

ConferencePlayerDashboard

col_name types description
GROUP_SET character
GROUP_VALUE character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
NBA_FANTASY_PTS character
DD2 character
TD3 character
WNBA_FANTASY_PTS character
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character
WBA_FANTASY_PTS_RANK character
DD2_RANK character
TD3_RANK character
WNBA_FANTASY_PTS_RANK character

DivisionPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

OpponentPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

Return a named list of data frames: AssistedBy, AssitedShotPlayerDashboard, OverallPlayerDashboard, Shot5FTPlayerDashboard, Shot8FTPlayerDashboard, ShotAreaPlayerDashboard, ShotTypePlayerDashboard, ShotTypeSummaryPlayerDashboard

OverallPlayerDashboard

Columns as documented in the shared wnba_shooting_splits_schema table.

Shot5FTPlayerDashboard

Columns as documented in the shared wnba_shooting_splits_schema table.

Shot8FTPlayerDashboard

Columns as documented in the shared wnba_shooting_splits_schema table.

ShotAreaPlayerDashboard

Columns as documented in the shared wnba_shooting_splits_schema table.

AssitedShotPlayerDashboard

Columns as documented in the shared wnba_shooting_splits_schema table.

ShotTypeSummaryPlayerDashboard

col_name types description
GROUP_SET character
GROUP_VALUE character
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
EFG_PCT character Effective field goal percentage (0-1).
BLKA character
PCT_AST_2PM character
PCT_UAST_2PM character
PCT_AST_3PM character
PCT_UAST_3PM character
PCT_AST_FGM character
PCT_UAST_FGM character

ShotTypePlayerDashboard

Columns as documented in the shared wnba_shooting_splits_schema table.

AssistedBy

Columns as documented in the shared wnba_shooting_splits_assisted_by_schema table.

Return a named list of data frames: OverallPlayerDashboard, PointsScoredPlayerDashboard, PointsAgainstPlayerDashboard, ScoreDifferentialPlayerDashboard

OverallPlayerDashboard

Columns as documented in the shared wnba_player_dashboard_schema table.

ScoreDifferentialPlayerDashboard

col_name types description
GROUP_SET character
GROUP_VALUE_ORDER character
GROUP_VALUE character
GROUP_VALUE_2 character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
NBA_FANTASY_PTS character
DD2 character
TD3 character
WNBA_FANTASY_PTS character
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character
NBA_FANTASY_PTS_RANK character
DD2_RANK character
TD3_RANK character
WNBA_FANTASY_PTS_RANK character

PointsScoredPlayerDashboard

Same columns as the ScoreDifferentialPlayerDashboard table above.

PontsAgainstPlayerDashboard

Same columns as the ScoreDifferentialPlayerDashboard table above.

Return a named list of data frames: ByYearPlayerDashboard, OverallPlayerDashboard

OverallPlayerDashboard

col_name types description
GROUP_SET character
GROUP_VALUE character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
MAX_GAME_DATE character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
NBA_FANTASY_PTS character
DD2 character
TD3 character
WNBA_FANTASY_PTS character
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character
NBA_FANTASY_PTS_RANK character
DD2_RANK character
TD3_RANK character
WNBA_FANTASY_PTS_RANK character

ByYearPlayerDashboard

Same columns as the OverallPlayerDashboard table above.

Author(s)

Saiem Gilani

See Also

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playerindex(), wnba_playernextngames(), wnba_playerprofilev2(), wnba_playervsplayer()

Other WNBA Clutch Functions: wnba_leaguedashteamclutch(), wnba_teamdashboardbyclutch()

Other WNBA Shooting Functions: wnba_leaguedashplayershotlocations(), wnba_leaguedashteamshotlocations(), wnba_shotchartdetail(), wnba_shotchartleaguewide(), wnba_shotchartlineupdetail(), wnba_teamdashboardbyclutch()


Get WNBA Stats API Player Estimated Metrics

Description

Get WNBA Stats API Player Estimated Metrics

Get WNBA Stats API Player Estimated Metrics

Usage

wnba_playerestimatedmetrics(
  league_id = "10",
  season = most_recent_wnba_season() - 1,
  season_type = "Regular Season",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WWNBA, '20': G-League

season

Season - format 2020-21

season_type

Season Type - Regular Season, Playoffs, All-Star

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_playerestimatedmetrics()

Value

Return a named list of data frames: PlayerEstimatedMetrics

PlayerEstimatedMetrics

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
E_OFF_RATING character
E_DEF_RATING character
E_NET_RATING character
E_AST_RATIO character
E_OREB_PCT character
E_DREB_PCT character
E_REB_PCT character
E_TOV_PCT character
E_USG_PCT character
E_PACE character
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
E_OFF_RATING_RANK character
E_DEF_RATING_RANK character
E_NET_RATING_RANK character
E_AST_RATIO_RANK character
E_OREB_PCT_RANK character
E_DREB_PCT_RANK character
E_REB_PCT_RANK character
E_TOV_PCT_RANK character
E_USG_PCT_RANK character
E_PACE_RANK character

Author(s)

Saiem Gilani

See Also

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playerindex(), wnba_playernextngames(), wnba_playerprofilev2(), wnba_playervsplayer()


Get WNBA Stats API Player Fantasy Profile

Description

Get WNBA Stats API Player Fantasy Profile

Get WNBA Stats API Player Fantasy Profile

Usage

wnba_playerfantasyprofile(
  league_id = "10",
  measure_type = "Base",
  pace_adjust = "N",
  per_mode = "Totals",
  player_id = "1628932",
  plus_minus = "N",
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_type = "Regular Season",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WWNBA, '20': G-League

measure_type

measure_type

pace_adjust

Pace Adjustment - Y/N

per_mode

Per Mode - PerGame, Totals

player_id

Player ID

plus_minus

Plus Minus - Y/N

rank

Rank - Y/N

season

Season - format 2020-21

season_type

Season Type - Regular Season, Playoffs, All-Star

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_playerfantasyprofile(player_id = '1628932')

Value

Return a named list of data frames: DaysRestModified, LastNGames, Location, Opponent, Overall

Overall

col_name types description
GROUP_SET character
GROUP_VALUE character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
DD2 character
TD3 character
FAN_DUEL_PTS character
WNBA_FANTASY_PTS character

Location

Same columns as the Overall table above.

LastNGames

Same columns as the Overall table above.

DaysRestModified

col_name types description
GROUP_SET character
GROUP_VALUE character
SEASON_YEAR character Season year string ('YYYY-YY' format).
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
DD2 character
TD3 character
FAN_DUEL_PTS character
WNBA_FANTASY_PTS character

Opponent

col_name types description
GROUP_SET character
GROUP_VALUE character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
DD2 character
TD3 character
FAN_DUEL_PTS character
NBA_FANTASY_PTS character

Author(s)

Saiem Gilani

See Also

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playerindex(), wnba_playernextngames(), wnba_playerprofilev2(), wnba_playervsplayer()

Other WNBA Fantasy Functions: wnba_fantasywidget(), wnba_infographicfanduelplayer(), wnba_playerfantasyprofilebargraph()


Get WNBA Stats API Player Fantasy Profile Bar Graph

Description

Get WNBA Stats API Player Fantasy Profile Bar Graph

Get WNBA Stats API Player Fantasy Profile Bar Graph

Usage

wnba_playerfantasyprofilebargraph(
  league_id = "10",
  player_id = "1628932",
  season = most_recent_wnba_season() - 1,
  season_type = "Regular Season",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WWNBA, '20': G-League

player_id

Player ID

season

Season - format 2020-21

season_type

Season Type - Regular Season, Playoffs, All-Star

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_playerfantasyprofilebargraph(player_id = '1628932')

Value

Return a named list of data frames: LastFiveGamesAvg, SeasonAvg

SeasonAvg

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
FAN_DUEL_PTS character
NBA_FANTASY_PTS character
PTS character Points scored.
REB character Total rebounds.
AST character Assists.
FG3M character Three-point field goals made.
FT_PCT character Free throw percentage (0-1).
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
FG_PCT character Field goal percentage (0-1).

LastFiveGamesAvg

Same columns as the SeasonAvg table above.

Author(s)

Saiem Gilani

See Also

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playerindex(), wnba_playernextngames(), wnba_playerprofilev2(), wnba_playervsplayer()

Other WNBA Fantasy Functions: wnba_fantasywidget(), wnba_infographicfanduelplayer(), wnba_playerfantasyprofile()


Get WNBA Stats API Player Game Log

Description

Get WNBA Stats API Player Game Log

Get WNBA Stats API Player Game Log

Usage

wnba_playergamelog(
  date_from = "",
  date_to = "",
  league_id = "10",
  player_id = "1628932",
  season = most_recent_wnba_season() - 1,
  season_type = "Regular Season",
  ...
)

Arguments

date_from

date_from

date_to

date_to

league_id

League - default: '00'. Other options include '10': WWNBA, '20': G-League

player_id

Player ID

season

Season - format 2020-21

season_type

Season Type - Regular Season, Playoffs, All-Star

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_playergamelog(player_id = '1628932')

Value

Return a named list of data frames: PlayerGameLog

PlayerGameLog

col_name types description
SEASON_ID character Unique season identifier.
Player_ID character Unique player identifier.
Game_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
MATCHUP character Matchup.
WL character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
VIDEO_AVAILABLE character Video available.

Author(s)

Saiem Gilani

See Also

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playerindex(), wnba_playernextngames(), wnba_playerprofilev2(), wnba_playervsplayer()


Get WNBA Stats API Player Game Logs

Description

Get WNBA Stats API Player Game Logs

Get WNBA Stats API Player Game Logs

Usage

wnba_playergamelogs(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  player_id = "1628932",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from

date_to

date_to

game_segment

game_segment

last_n_games

last_n_games

league_id

League - default: '00'. Other options include '10': WWNBA, '20': G-League

location

location

measure_type

measure_type

month

month

opponent_team_id

opponent_team_id

outcome

outcome

po_round

po_round

per_mode

per_mode

period

period

player_id

Player ID

season

Season - format 2020-21

season_segment

season_segment

season_type

Season Type - Regular Season, Playoffs, All-Star

team_id

team_id

vs_conference

vs_conference

vs_division

vs_division

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_playergamelogs(player_id = '1628932')

Value

Return a named list of data frames: PlayerGameLogs

PlayerGameLogs

col_name types description
SEASON_YEAR character Season year string ('YYYY-YY' format).
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
NICKNAME character Team or athlete nickname.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
GAME_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
MATCHUP character Matchup.
WL character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
WNBA_FANTASY_PTS character
DD2 character
TD3 character
WWNBA_FANTASY_PTS character
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character
WNBA_FANTASY_PTS_RANK character
DD2_RANK character
TD3_RANK character
WWNBA_FANTASY_PTS_RANK character
VIDEO_AVAILABLE_FLAG character Video available flag.

Author(s)

Saiem Gilani

See Also

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playerindex(), wnba_playernextngames(), wnba_playerprofilev2(), wnba_playervsplayer()


Get WNBA Stats API Player Game Streak Finder

Description

Get WNBA Stats API Player Game Streak Finder

Get WNBA Stats API Player Game Streak Finder

Usage

wnba_playergamestreakfinder(
  active_streaks_only = "",
  conference = "",
  date_from = "",
  date_to = "",
  division = "",
  draft_year = "",
  draft_team_id = "",
  draft_round = "",
  draft_number = "",
  et_ast = "",
  et_blk = "",
  et_dd = "",
  et_dreb = "",
  et_fg3a = "",
  et_fg3m = "",
  et_fg3_pct = "",
  et_fga = "",
  et_fgm = "",
  et_fg_pct = "",
  et_fta = "",
  et_ftm = "",
  et_ft_pct = "",
  et_minutes = "",
  et_oreb = "",
  et_pf = "",
  et_pts = "",
  et_reb = "",
  et_stl = "",
  et_td = "",
  et_tov = "",
  game_id = "",
  gt_ast = "",
  gt_blk = "",
  gt_dd = "",
  gt_dreb = "",
  gt_fg3a = "",
  gt_fg3m = "",
  gt_fg3_pct = "",
  gt_fga = "",
  gt_fgm = "",
  gt_fg_pct = "",
  gt_fta = "",
  gt_ftm = "",
  gt_ft_pct = "",
  gt_minutes = "",
  gt_oreb = "",
  gt_pf = "",
  gt_pts = "",
  gt_reb = "",
  gt_stl = "",
  gt_td = "",
  gt_tov = "",
  league_id = "10",
  location = "",
  lt_ast = "",
  lt_blk = "",
  lt_dd = "",
  lt_dreb = "",
  lt_fg3a = "",
  lt_fg3m = "",
  lt_fg3_pct = "",
  lt_fga = "",
  lt_fgm = "",
  lt_fg_pct = "",
  lt_fta = "",
  lt_ftm = "",
  lt_ft_pct = "",
  lt_minutes = "",
  lt_oreb = "",
  lt_pf = "",
  lt_pts = "",
  lt_reb = "",
  lt_stl = "",
  lt_td = "",
  lt_tov = "",
  min_games = "",
  outcome = "",
  po_round = "",
  player_id = "",
  rookie_year = "",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  starter_bench = "",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  vs_team_id = "",
  years_experience = "",
  ...
)

Arguments

active_streaks_only

active_streaks_only

conference

conference

date_from

date_from

date_to

date_to

division

division

draft_year

draft_year

draft_team_id

draft_team_id

draft_round

draft_round

draft_number

draft_number

et_ast

et_ast

et_blk

et_blk

et_dd

et_dd

et_dreb

et_dreb

et_fg3a

et_fg3a

et_fg3m

et_fg3m

et_fg3_pct

et_fg3_pct

et_fga

et_fga

et_fgm

et_fgm

et_fg_pct

et_fg_pct

et_fta

et_fta

et_ftm

et_ftm

et_ft_pct

et_ft_pct

et_minutes

et_minutes

et_oreb

et_oreb

et_pf

et_pf

et_pts

et_pts

et_reb

et_reb

et_stl

et_stl

et_td

et_td

et_tov

et_tov

game_id

game_id

gt_ast

gt_ast

gt_blk

gt_blk

gt_dd

gt_dd

gt_dreb

gt_dreb

gt_fg3a

gt_fg3a

gt_fg3m

gt_fg3m

gt_fg3_pct

gt_fg3_pct

gt_fga

gt_fga

gt_fgm

gt_fgm

gt_fg_pct

gt_fg_pct

gt_fta

gt_fta

gt_ftm

gt_ftm

gt_ft_pct

gt_ft_pct

gt_minutes

gt_minutes

gt_oreb

gt_oreb

gt_pf

gt_pf

gt_pts

gt_pts

gt_reb

gt_reb

gt_stl

gt_stl

gt_td

gt_td

gt_tov

gt_tov

league_id

league_id

location

location

lt_ast

lt_ast

lt_blk

lt_blk

lt_dd

lt_dd

lt_dreb

lt_dreb

lt_fg3a

lt_fg3a

lt_fg3m

lt_fg3m

lt_fg3_pct

lt_fg3_pct

lt_fga

lt_fga

lt_fgm

lt_fgm

lt_fg_pct

lt_fg_pct

lt_fta

lt_fta

lt_ftm

lt_ftm

lt_ft_pct

lt_ft_pct

lt_minutes

lt_minutes

lt_oreb

lt_oreb

lt_pf

lt_pf

lt_pts

lt_pts

lt_reb

lt_reb

lt_stl

lt_stl

lt_td

lt_td

lt_tov

lt_tov

min_games

min_games

outcome

outcome

po_round

po_round

player_id

player_id

rookie_year

rookie_year

season

season

season_segment

season_segment

season_type

season_type

starter_bench

starter_bench

team_id

team_id

vs_conference

vs_conference

vs_division

vs_division

vs_team_id

vs_team_id

years_experience

years_experience

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_playergamestreakfinder()

Value

Return a named list of data frames: PlayerGameStreakFinderResults

PlayerGameStreakFinderResults

col_name types description
PLAYER_NAME_LAST_FIRST character
PLAYER_ID character Unique player identifier.
GAMESTREAK character
STARTDATE character
ENDDATE character
ACTIVESTREAK character
NUMSEASONS character
LASTSEASON character
FIRSTSEASON character

Author(s)

Saiem Gilani

See Also

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playerheadshot(), wnba_playerindex(), wnba_playernextngames(), wnba_playerprofilev2(), wnba_playervsplayer()

Other WNBA Game Finder Functions: wnba_leaguegamefinder(), wnba_teamgamestreakfinder()


Get WNBA Stats API Player Head-shot

Description

Get WNBA Stats API Player Head-shot

Get WNBA Stats API Player Head-shot

Usage

wnba_playerheadshot(player_id = "1628932", ...)

Arguments

player_id

Player ID

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_playerheadshot(player_id = '1628932')

Value

Returns a url of the png for the player_id selected

Author(s)

Saiem Gilani

See Also

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerindex(), wnba_playernextngames(), wnba_playerprofilev2(), wnba_playervsplayer()


Get WNBA Stats API Player Index

Description

Get WNBA Stats API Player Index

Get WNBA Stats API Player Index

Usage

wnba_playerindex(
  college = "",
  country = "",
  draft_pick = "",
  draft_round = "",
  draft_year = "",
  height = "",
  historical = 1,
  league_id = "10",
  season = most_recent_wnba_season() - 1,
  season_type = "Regular Season",
  team_id = "0",
  weight = "",
  ...
)

Arguments

college

Player College

country

Player Country

draft_pick

Draft Pick

draft_round

Draft Round

draft_year

Draft Year

height

Player Height

historical

Whether to include only current players (0) or all historical (1).

league_id

League - default: '00'. Other options include '10': WWNBA, '20': G-League

season

Season - format 2020-21

season_type

Season Type - Regular Season, Playoffs, All-Star

team_id

Team ID. Default: 0 (all teams).

weight

Player weight

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_playerindex()

Value

Return a named list of data frames: PlayerIndex

PlayerIndex

col_name types description
PERSON_ID character Unique player identifier (V3 endpoints).
PLAYER_LAST_NAME character
PLAYER_FIRST_NAME character
PLAYER_SLUG character URL-safe player identifier.
TEAM_ID character Unique team identifier.
TEAM_SLUG character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
IS_DEFUNCT character
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
JERSEY_NUMBER character
POSITION character Listed roster position (G, F, C, etc.).
HEIGHT character Player height (string e.g. '6-2' or inches).
WEIGHT character Player weight in pounds.
COLLEGE character College or school attended.
COUNTRY character Country (full name or code).
DRAFT_YEAR character Draft year (4-digit).
DRAFT_ROUND character Round of the draft selection.
DRAFT_NUMBER character
ROSTER_STATUS character
PTS character Points scored.
REB character Total rebounds.
AST character Assists.
STATS_TIMEFRAME character
FROM_YEAR character
TO_YEAR character

Author(s)

Saiem Gilani

See Also

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playernextngames(), wnba_playerprofilev2(), wnba_playervsplayer()


Get WNBA Stats API Player Next N Games

Description

Get WNBA Stats API Player Next N Games

Get WNBA Stats API Player Next N Games

Usage

wnba_playernextngames(
  league_id = "10",
  number_of_games = 2147483647,
  player_id = "1628932",
  season = most_recent_wnba_season() - 1,
  season_type = "Regular Season",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WWNBA, '20': G-League

number_of_games

N in number of games

player_id

Player ID

season

Season - format 2020-21

season_type

Season Type - Regular Season, Playoffs, All-Star

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_playernextngames(player_id = '1628932', season = most_recent_wnba_season() - 1)

Value

Return a named list of data frames: NextNGames

NextNGames

col_name types description
GAME_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
HOME_TEAM_ID character Unique identifier for the home team.
VISITOR_TEAM_ID character Unique identifier for visitor team.
HOME_TEAM_NAME character Home team name.
VISITOR_TEAM_NAME character
HOME_TEAM_ABBREVIATION character
VISITOR_TEAM_ABBREVIATION character
HOME_TEAM_NICKNAME character
VISITOR_TEAM_NICKNAME character
GAME_TIME character Game start time.
HOME_WL character
VISITOR_WL character

Author(s)

Saiem Gilani

See Also

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playerindex(), wnba_playerprofilev2(), wnba_playervsplayer()


Get WNBA Stats API Player Profile V2

Description

Get WNBA Stats API Player Profile V2

Get WNBA Stats API Player Profile V2

Usage

wnba_playerprofilev2(
  league_id = "10",
  per_mode = "Totals",
  player_id = "1628932",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WWNBA, '20': G-League

per_mode

Season - format 2020-21

player_id

Player ID

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_playerprofilev2(player_id = '1628932')

Value

Return a named list of data frames: CareerHighs, CareerTotalsAllStarSeason, CareerTotalsCollegeSeason, CareerTotalsPostSeason, CareerTotalsPreseason, CareerTotalsRegularSeason, NextGame, SeasonHighs, SeasonRankingsPostSeason, SeasonRankingsRegularSeason, SeasonTotalsAllStarSeason, SeasonTotalsCollegeSeason, SeasonTotalsPostSeason, SeasonTotalsPreseason, SeasonTotalsRegularSeason

SeasonTotalsRegularSeason

Columns as documented in the shared wnba_playercareerstats_season_totals_schema table.

CareerTotalsRegularSeason

col_name types description
PLAYER_ID character Unique player identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
GP character Games played.
GS character Games started.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

SeasonTotalsPostSeason

Columns as documented in the shared wnba_playercareerstats_season_totals_schema table.

CareerTotalsPostSeason

Same columns as the CareerTotalsRegularSeason table above.

SeasonTotalsAllStarSeason

Columns as documented in the shared wnba_playercareerstats_season_totals_schema table.

CareerTotalsAllStarSeason

Same columns as the CareerTotalsRegularSeason table above.

SeasonTotalsCollegeSeason

CareerTotalsCollegeSeason

SeasonTotalsPreseason

Columns as documented in the shared wnba_playercareerstats_season_totals_schema table.

CareerTotalsPreseason

Same columns as the CareerTotalsRegularSeason table above.

SeasonRankingsRegularSeason

Columns as documented in the shared wnba_playercareerstats_season_rankings_schema table.

SeasonRankingsPostSeason

Columns as documented in the shared wnba_playercareerstats_season_rankings_schema table.

SeasonHighs

col_name types description
PLAYER_ID character Unique player identifier.
GAME_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
VS_TEAM_ID character
VS_TEAM_CITY character
VS_TEAM_NAME character
VS_TEAM_ABBREVIATION character
STAT character
STAT_VALUE character Stat value.
STAT_ORDER character
DATE_EST character

CareerHighs

Same columns as the SeasonHighs table above.

NextGame

col_name types description
GAME_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
GAME_TIME character Game start time.
LOCATION character Filter results by game location.
PLAYER_TEAM_ID character
PLAYER_TEAM_CITY character
PLAYER_TEAM_NICKNAME character
PLAYER_TEAM_ABBREVIATION character
VS_TEAM_ID character
VS_TEAM_CITY character
VS_TEAM_NICKNAME character
VS_TEAM_ABBREVIATION character

Author(s)

Saiem Gilani

See Also

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playerindex(), wnba_playernextngames(), wnba_playervsplayer()


Get WNBA Stats API Player vs Player

Description

Get WNBA Stats API Player vs Player

Get WNBA Stats API Player vs Player

Usage

wnba_playervsplayer(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id = "1628932",
  plus_minus = "N",
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  vs_conference = "",
  vs_division = "",
  vs_player_id = "1629488",
  ...
)

Arguments

date_from

date_from

date_to

date_to

game_segment

game_segment

last_n_games

last_n_games

league_id

League - default: '00'. Other options include '10': WWNBA, '20': G-League

location

location

measure_type

measure_type

month

month

opponent_team_id

opponent_team_id

outcome

outcome

pace_adjust

pace_adjust

per_mode

per_mode

period

period

player_id

Player ID

plus_minus

plus_minus

rank

rank

season

Season - format 2020-21

season_segment

season_segment

season_type

Season Type - Regular Season, Playoffs, All-Star

vs_conference

vs_conference

vs_division

vs_division

vs_player_id

vs_player_id

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_playervsplayer(player_id = '1628932', vs_player_id = '1629488')

Value

Return a named list of data frames: OnOffCourt, Overall, PlayerInfo, ShotAreaOffCourt, ShotAreaOnCourt, ShotAreaOverall, ShotDistanceOffCourt, ShotDistanceOnCourt, ShotDistanceOverall, VsPlayerInfo

Overall

col_name types description
GROUP_SET character
GROUP_VALUE character
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
WNBA_FANTASY_PTS character

OnOffCourt

col_name types description
GROUP_SET character
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
VS_PLAYER_ID character
VS_PLAYER_NAME character
COURT_STATUS character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
WNBA_FANTASY_PTS character

ShotDistanceOverall

col_name types description
GROUP_SET character
GROUP_VALUE character
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).

ShotDistanceOnCourt

col_name types description
GROUP_SET character
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
VS_PLAYER_ID character
VS_PLAYER_NAME character
COURT_STATUS character
GROUP_VALUE character
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).

ShotDistanceOffCourt

Same columns as the ShotDistanceOnCourt table above.

ShotAreaOverall

Same columns as the ShotDistanceOverall table above.

ShotAreaOnCourt

Same columns as the ShotDistanceOnCourt table above.

ShotAreaOffCourt

Same columns as the ShotDistanceOnCourt table above.

PlayerInfo

col_name types description
PERSON_ID character Unique player identifier (V3 endpoints).
FIRST_NAME character Player's first name.
LAST_NAME character Player's last name.
DISPLAY_FIRST_LAST character
DISPLAY_LAST_COMMA_FIRST character
DISPLAY_FI_LAST character
BIRTHDATE character
SCHOOL character Player's school / college (when distinct from 'college').
COUNTRY character Country (full name or code).
LAST_AFFILIATION character

VsPlayerInfo

Same columns as the PlayerInfo table above.

Author(s)

Saiem Gilani

See Also

Other WNBA Player Functions: wnba_infographicfanduelplayer(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_playerawards(), wnba_playercareerbycollege(), wnba_playercareerbycollegerollup(), wnba_playercareerstats(), wnba_playercompare(), wnba_playerdashboardbyclutch(), wnba_playerestimatedmetrics(), wnba_playerfantasyprofile(), wnba_playerfantasyprofilebargraph(), wnba_playergamelog(), wnba_playergamelogs(), wnba_playergamestreakfinder(), wnba_playerheadshot(), wnba_playerindex(), wnba_playernextngames(), wnba_playerprofilev2()


Get WNBA Possession-Level Stint Matrix

Description

Get WNBA Possession-Level Stint Matrix

Get WNBA Possession-Level Stint Matrix

Usage

wnba_possession_lineups(game_id, ...)

Arguments

game_id

WNBA Stats game id. 10-character zero-padded string (e.g., "1022400001").

...

reserved for future use.

Value

Returns a data frame with one row per possession:

col_name types description
game_id character Unique game identifier (10-character WNBA Stats ID).
period integer Game period (1-4 regular, 5+ overtime).
possession_number integer Sequential possession counter within the game (1-based).
offense_team_id integer WNBA Stats team ID of the team on offense for this possession.
defense_team_id integer WNBA Stats team ID of the team on defense for this possession.
points integer Points scored by the offense during this possession (0 or positive).
second_chance logical TRUE if the possession was extended by an offensive rebound (second-chance opportunity).
start_event_idx integer 1-based row index into the source PBP frame for the first event of this possession.
end_event_idx integer 1-based row index into the source PBP frame for the last event of this possession.
off_player_1 integer WNBA Stats person_id for offensive on-court player slot 1.
off_player_2 integer WNBA Stats person_id for offensive on-court player slot 2.
off_player_3 integer WNBA Stats person_id for offensive on-court player slot 3.
off_player_4 integer WNBA Stats person_id for offensive on-court player slot 4.
off_player_5 integer WNBA Stats person_id for offensive on-court player slot 5.
def_player_1 integer WNBA Stats person_id for defensive on-court player slot 1.
def_player_2 integer WNBA Stats person_id for defensive on-court player slot 2.
def_player_3 integer WNBA Stats person_id for defensive on-court player slot 3.
def_player_4 integer WNBA Stats person_id for defensive on-court player slot 4.
def_player_5 integer WNBA Stats person_id for defensive on-court player slot 5.

Author(s)

Saiem Gilani

See Also

Other WNBA Lineup Functions: wnba_gamerotation(), wnba_leaguedashlineups(), wnba_leaguelineupviz(), wnba_rapm(), wnba_shot_zones(), wnba_shotchartlineupdetail(), wnba_teamdashlineups()


Fit a Ridge-Regression RAPM Model from WNBA Possession Data

Description

Fit a Ridge-Regression RAPM Model from WNBA Possession Data

Fit a Ridge-Regression RAPM Model from WNBA Possession Data

Usage

wnba_rapm(possessions, ...)

Arguments

possessions

A possession-level stint matrix as produced by wnba_possession_lineups(), with columns off_player_1 through off_player_5, def_player_1 through def_player_5 (integer WNBA Stats person IDs), and points (numeric, points scored on that possession).

...

Reserved for future keyword arguments (currently ignored).

Value

Returns a data.frame with one row per player:

col_name types description
player_id integer WNBA Stats person ID. Rows are sorted ascending by player_id.
o_rapm numeric Offensive RAPM (per-100-possession points added on offense). Positive = better offensive player.
d_rapm numeric Defensive RAPM (per-100-possession points saved on defense). Positive = better defensive player (sign is flipped so good defense is positive).
rapm numeric Total RAPM = o_rapm + d_rapm. Positive = net positive impact.
off_poss integer Number of possessions the player appeared on offense.
def_poss integer Number of possessions the player appeared on defense.

Returns a 0-row frame with the same schema when input is empty or all possessions have NA lineup cells (never-raise).

Note: RAPM is expressed in per-100-possession units. A full season of possessions (~3,000–5,000) is needed for statistically meaningful estimates. Results from a single game (~120–200 possessions) are highly unstable and are provided here for pipeline illustration only.

Results are deterministic: the cross-validation uses fixed, construction-based folds (not random), so repeated calls on the same possessions return identical output with no need to set a seed.

Author(s)

Saiem Gilani

See Also

Other WNBA Lineup Functions: wnba_gamerotation(), wnba_leaguedashlineups(), wnba_leaguelineupviz(), wnba_possession_lineups(), wnba_shot_zones(), wnba_shotchartlineupdetail(), wnba_teamdashlineups()


WNBA referee assignments for a given date

Description

Retrieves the referee crew assignments and replay-center officials for every WNBA game on date, from official.nba.com's internal get-game-officials endpoint (the same feed used by the NBA officiating pages). That endpoint returns NBA and G-League blocks in the same payload; this function extracts only "wnba". Port of the scraping logic in atlhawksfanatic/L2M (MIT, (c) 2019 atlhawksfanatic).

Usage

wnba_referee_assignments(date, proxy = NULL)

Arguments

date

Date to fetch: a single Date, POSIXct/POSIXlt, or "YYYY-MM-DD" string. Date-times are formatted in their own time zone, so a late-evening POSIXct keeps its calendar day.

proxy

Optional proxy config. NULL (default) falls back to getOption("wehoop.proxy"), then lets libcurl honor the standard http_proxy / https_proxy / no_proxy environment variables. A single URL string (e.g. "http://host:port") is forwarded to httr2::req_proxy(url = proxy). A named list is spread as keyword args into httr2::req_proxy() (url, port, username, password, auth).

Details

crew_position (1-4) is the feed's slot order; slot 1 is inferred to be the crew chief – official.nba.com does not label crew roles in this feed. The feed encodes the season as ⁠<type digit><START year>⁠ (e.g. "22026" is the 2026 regular season). season is that START year: a WNBA season sits inside one calendar year, so no end-year conversion is applied. season_type decodes the leading digit.

Failures are signalled as classed conditions, both inheriting wehoop_error:

  • wehoop_no_data – HTTP 404, or HTTP 403 with an S3 ⁠<Code>AccessDenied</Code>⁠ XML body: official.nba.com has no report for date.

  • wehoop_fetch_error – any other non-200 status (e.g. an Akamai HTML 403 block, or a rate limit / 5xx that outlived the retries), an empty or non-JSON body, JSON without the wnba Table/Table1 rows lists or with a Table row that has no game_id or a Table1 row that has no replaycenter_official name, or a transport failure (DNS, TLS, dropped connection). The feed carries the wnba block on every date, with zero rows on a day without games, so a missing block is never an empty day.

An invalid argument (date or proxy), including an impossible date such as "2026-02-31", is an ordinary error raised before any request.

Statuses 408, 429, 500, 502, 503 and 504 and transport failures are retried (3 attempts in total); 403 and 404 are definitive and never retried.

Value

A named list of two wehoop_data tibbles.

officials – long format, one row per game x filled crew slot (WNBA crews have three officials, so slot 4 is usually absent):

col_name types description
league character League slug; always "wnba".
game_id character 10-character zero-padded game id.
game_date Date Game date.
season integer Season (the START year of the feed's season code; one calendar year for the WNBA). NA when the code is missing, not 5 characters, or its year is not numeric.
season_type character One of preseason / regular / all-star / playoffs / play-in / nba-cup-final, from the season code's leading digit. NA when the code is missing or the digit is unknown.
game_code character official.nba.com game code (YYYYMMDD/AWAYHOME).
home_team_id integer Home team id.
home_team_abbr character Home team abbreviation.
away_team_id integer Away team id.
away_team_abbr character Away team abbreviation.
crew_position integer Feed slot order (1-4); slot 1 is inferred to be the crew chief.
official_id integer Official id.
official_name character Official display name.
jersey_num character Official jersey number.

replay_center – one row per replay-center official per game date:

col_name types description
league character League slug; always "wnba".
game_date Date Game date.
official_id integer Replay-center official id.
official_name character Replay-center official display name.

A date with no WNBA games returns zero-row tibbles carrying this schema, not an error. A field the feed omits comes back as NA; it never drops the row or the column.

Author(s)

Saiem Gilani

Examples

try(wnba_referee_assignments(date = "2026-06-13"))

Get WNBA Stats API Season Schedule

Description

Get WNBA Stats API Season Schedule

Get WNBA Stats API Season Schedule

Usage

wnba_schedule(league_id = "10", season = most_recent_wnba_season() - 1, ...)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League

season

Season

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_schedule(league_id = '10', season = most_recent_wnba_season() - 1)

Value

Returns a tibble with the following columns:

col_name types description
game_date character Game date (YYYY-MM-DD).
game_id character Unique game identifier.
game_code character ESPN game code (numeric identifier).
game_status integer Game status label.
game_status_text character Game status display text (e.g. 'Final', '4:32 - 4th').
game_sequence integer Game sequence.
game_date_est character Game date est.
game_time_est character Game time est.
game_date_time_est character Game date time est.
game_date_utc character Game date utc.
game_time_utc character Game start time in UTC (ISO 8601 timestamp).
game_date_time_utc character Game date time utc.
away_team_time character Time / clock value.
home_team_time character Time / clock value.
day character Day number within the month.
month_num integer Month num.
week_number integer Week number.
week_name character Week name.
if_necessary character If necessary.
series_game_number character Series game number.
series_text character Series text.
arena_name character Arena name.
arena_state character Arena state.
arena_city character Arena city.
postponed_status character Postponed status.
branch_link character Branch link.
game_subtype character Game subtype.
home_team_id integer Unique identifier for the home team.
home_team_name character Home team name.
home_team_city character Home team city / location.
home_team_tricode character Home team three-letter code.
home_team_slug character Home team's team slug.
home_team_wins integer Home team's team wins.
home_team_losses integer Home team's team losses.
home_team_score integer Home team's score.
home_team_seed integer Home team's team seed.
away_team_id integer Unique identifier for the away team.
away_team_name character Away team name.
away_team_city character Away team city / location.
away_team_tricode character Away team three-letter code.
away_team_slug character Away team's team slug.
away_team_wins integer Away team's team wins.
away_team_losses integer Away team's team losses.
away_team_score integer Away team's score.
away_team_seed integer Away team's team seed.
season character Season identifier (4-digit year or 'YYYY-YY' string).
league_id character League identifier ('10' = WNBA).

Author(s)

Saiem Gilani

See Also

Other WNBA Schedule Functions: wnba_scoreboardv2(), wnba_scoreboardv3(), wnba_todays_scoreboard()


Get the WNBA cross-source schedule crosswalk

Description

Build a wide, one-row-per-game crosswalk linking ESPN and WNBA Stats game ids (with NA Fox/Yahoo placeholders) for a season. Dates from both sources are reduced to the local Eastern-Time game date before joining. Note: the WNBA Stats CDN serves the current season only, so the live builder is effectively current-season; historical coverage comes from cached release artifacts.

Usage

wnba_schedule_crosswalk(season = most_recent_wnba_season())

Arguments

season

Season year (numeric). Defaults to the most recent WNBA season.

Value

A wehoop_data tibble, one row per game (columns: season, season_type, game_date, resolved home_espn_team_id/away_espn_team_id, espn_game_id, wnba_game_id, wnba_game_code, Fox/Yahoo placeholders, match_method, match_confidence).

See Also

Other WNBA Crosswalk Functions: load_wnba_team_crosswalk(), wnba_player_crosswalk(), wnba_team_crosswalk()

Examples

try(wnba_schedule_crosswalk(season = 2024))

Get WNBA Stats API Scoreboard V2

Description

Get WNBA Stats API Scoreboard V2

Get WNBA Stats API Scoreboard V2

Usage

wnba_scoreboardv2(
  league_id = "10",
  game_date = "2022-07-20",
  day_offset = 0,
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WWNBA, '20': G-League

game_date

Game Date, format: 2022/05/17

day_offset

Day Offset (integer 0,-1)

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_scoreboardv2(league_id = '10', game_date = '2022-07-20')

Value

Return a named list of data frames: Available, EastConfStandingsByDay, GameHeader, LastMeeting, LineScore, SeriesStandings, TeamLeaders, TicketLinks, WestConfStandingsByDay, WinProbability

GameHeader

col_name types description
GAME_DATE_EST character Game date est.
GAME_SEQUENCE character Game sequence.
GAME_ID character Unique game identifier.
GAME_STATUS_ID character Numeric game status identifier.
GAME_STATUS_TEXT character Game status display text (e.g. 'Final', '4:32 - 4th').
GAMECODE character Gamecode.
HOME_TEAM_ID character Unique identifier for the home team.
VISITOR_TEAM_ID character Unique identifier for visitor team.
SEASON character Season identifier (4-digit year or 'YYYY-YY' string).
LIVE_PERIOD character Live period.
LIVE_PC_TIME character Time / clock value.
NATL_TV_BROADCASTER_ABBREVIATION character Natl tv broadcaster abbreviation.
HOME_TV_BROADCASTER_ABBREVIATION character Home team's tv broadcaster abbreviation.
AWAY_TV_BROADCASTER_ABBREVIATION character Away team's tv broadcaster abbreviation.
LIVE_PERIOD_TIME_BCAST character Live period time bcast.
ARENA_NAME character Arena name.
WH_STATUS character Wh status.
WNBA_COMMISSIONER_FLAG character

LineScore

col_name types description
GAME_DATE_EST character Game date est.
GAME_SEQUENCE character Game sequence.
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY_NAME character Team city name.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_WINS_LOSSES character Team wins losses.
PTS_QTR1 character Pts qtr1.
PTS_QTR2 character Pts qtr2.
PTS_QTR3 character Pts qtr3.
PTS_QTR4 character Pts qtr4.
PTS_OT1 character Pts ot1.
PTS_OT2 character
PTS_OT3 character
PTS_OT4 character
PTS_OT5 character
PTS_OT6 character
PTS_OT7 character
PTS_OT8 character
PTS_OT9 character
PTS_OT10 character
PTS character Points scored.
FG_PCT character Field goal percentage (0-1).
FT_PCT character Free throw percentage (0-1).
FG3_PCT character Three-point field goal percentage (0-1).
AST character Assists.
REB character Total rebounds.
TOV character Turnovers.

SeriesStandings

Columns as documented in the shared wnba_boxscoresummaryv2_season_series_schema table.

LastMeeting

Columns as documented in the shared wnba_boxscoresummaryv2_last_meeting_schema table.

EastConfStandingsByDay

Columns as documented in the shared wnba_scoreboard_east_conf_standings_by_day_schema table.

WestConfStandingsByDay

Columns as documented in the shared wnba_scoreboard_east_conf_standings_by_day_schema table.

Available

col_name types description
GAME_ID character Unique game identifier.
PT_AVAILABLE character

TeamLeaders

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
TEAM_NICKNAME character Team nickname.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
PTS_PLAYER_ID character
PTS_PLAYER_NAME character
PTS character Points scored.
REB_PLAYER_ID character
REB_PLAYER_NAME character
REB character Total rebounds.
AST_PLAYER_ID character
AST_PLAYER_NAME character
AST character Assists.

TicketLinks

WinProbability

Author(s)

Saiem Gilani

See Also

Other WNBA Schedule Functions: wnba_schedule(), wnba_scoreboardv3(), wnba_todays_scoreboard()


Get WNBA Stats API Scoreboard V3

Description

Get WNBA Stats API Scoreboard V3

Get WNBA Stats API Scoreboard V3

Usage

wnba_scoreboardv3(league_id = "10", game_date = "2022-06-26", ...)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League

game_date

Game Date

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_scoreboardv3(league_id = '10', game_date = '2022-06-26')

Value

Return a tibble with the following scoreboard data:

col_name types description
game_id character Unique game identifier.
game_code character ESPN game code (numeric identifier).
game_status integer Game status label.
game_status_text character Game status display text (e.g. 'Final', '4:32 - 4th').
game_date character Game date (YYYY-MM-DD).
game_time_utc character Game start time in UTC (ISO 8601 timestamp).
game_et character Game et.
home_team_id integer Unique identifier for the home team.
home_team_name character Home team name.
home_team_city character Home team city / location.
home_team_tricode character Home team three-letter code.
home_team_slug character Home team's team slug.
away_team_id integer Unique identifier for the away team.
away_team_name character Away team name.
away_team_city character Away team city / location.
away_team_tricode character Away team three-letter code.
away_team_slug character Away team's team slug.
period integer Period of the game (1-4 quarters; 5+ for OT).
game_clock character Game clock.
regulation_periods integer Regulation periods.
series_game_number character Series game number.
series_text character Series text.
if_necessary logical If necessary.
series_conference character Series conference.
po_round_desc character Po round desc.
game_subtype character Game subtype.
game_home_leaders_person_id integer Unique identifier for game home leaders person.
game_home_leaders_name character Game home leaders name.
game_home_leaders_player_slug character Game home leaders player slug.
game_home_leaders_jersey_num character Game home leaders jersey num.
game_home_leaders_position character Game home leaders position.
game_home_leaders_team_tricode character Game home leaders team tricode.
game_home_leaders_points integer Game home leaders points.
game_home_leaders_rebounds integer Game home leaders rebounds.
game_home_leaders_assists integer Game home leaders assists.
game_away_leaders_person_id integer Unique identifier for game away leaders person.
game_away_leaders_name character Game away leaders name.
game_away_leaders_player_slug character Game away leaders player slug.
game_away_leaders_jersey_num character Game away leaders jersey num.
game_away_leaders_position character Game away leaders position.
game_away_leaders_team_tricode character Game away leaders team tricode.
game_away_leaders_points integer Game away leaders points.
game_away_leaders_rebounds integer Game away leaders rebounds.
game_away_leaders_assists integer Game away leaders assists.
team_home_leaders_person_id integer Unique identifier for team home leaders person.
team_home_leaders_name character Team home leaders name.
team_home_leaders_player_slug character Team home leaders player slug.
team_home_leaders_jersey_num character Team home leaders jersey num.
team_home_leaders_position character Team home leaders position.
team_home_leaders_team_tricode character Team home leaders team tricode.
team_home_leaders_points numeric Team home leaders points.
team_home_leaders_rebounds numeric Team home leaders rebounds.
team_home_leaders_assists numeric Team home leaders assists.
team_away_leaders_person_id integer Unique identifier for team away leaders person.
team_away_leaders_name character Team away leaders name.
team_away_leaders_player_slug character Team away leaders player slug.
team_away_leaders_jersey_num character Team away leaders jersey num.
team_away_leaders_position character Team away leaders position.
team_away_leaders_team_tricode character Team away leaders team tricode.
team_away_leaders_points numeric Team away leaders points.
team_away_leaders_rebounds numeric Team away leaders rebounds.
team_away_leaders_assists numeric Team away leaders assists.
team_season_leaders_flag integer Team season leaders flag.
home_wins integer Home team's wins.
home_losses integer Home team's losses.
home_score integer Home team score at the time of the play.
home_seed integer Home team's seed.
home_in_bonus logical Home team's in bonus.
home_timeouts_remaining integer Home team's timeouts remaining.
home_periods list Home team's periods.
away_wins integer Away team's wins.
away_losses integer Away team's losses.
away_score integer Away team score at the time of the play.
away_seed integer Away team's seed.
away_in_bonus logical Away team's in bonus.
away_timeouts_remaining integer Away team's timeouts remaining.
away_periods list Away team's periods.
league_id character League identifier ('10' = WNBA).
league character League.
broadcasters data.frame

Author(s)

Saiem Gilani

See Also

Other WNBA Schedule Functions: wnba_schedule(), wnba_scoreboardv2(), wnba_todays_scoreboard()


Fetch WNBA Play-by-Play and Classify Field-Goal Attempts by Shot Zone

Description

Fetch WNBA Play-by-Play and Classify Field-Goal Attempts by Shot Zone

Fetch WNBA Play-by-Play and Classify Field-Goal Attempts by Shot Zone

Usage

wnba_shot_zones(game_id, ...)

Arguments

game_id

A length-1 character string — the ten-character WNBA Stats game identifier (e.g. "1022400003" for a 2024 WNBA game).

...

Reserved for future keyword arguments (currently ignored).

Details

 df <- wnba_shot_zones(game_id = "1022400003")
 print(table(df$shot_zone, useNA = "ifany"))

Value

Returns a data.frame containing the full V3 play-by-play for game_id with an appended shot_zone column:

col_name types description
event_type character Play event type code. "1" = MadeShot, "2" = MissedShot, "3" = FreeThrow, etc.
shot_value integer Point value of the shot attempt (2 or 3); 0 for non-FGA events.
x_legacy numeric Horizontal court coordinate (legacy units). Negative = left side of the court.
y_legacy numeric Vertical court coordinate (legacy units). Values near 0 = baseline.
shot_distance numeric Distance from the basket in feet.
shot_zone character Shot-zone classification. One of "corner_3", "above_the_break_3", "restricted_area", "in_the_paint_non_ra", "mid_range". NA on non-field-goal rows.

All other columns from the V3 PBP schema (wnba_pbp()) are also present. Returns a 0-row frame when the game cannot be fetched (never-raise).

Shot zone definitions (pbpstats-core aligned):

  • "corner_3" — three-point attempt with abs(x_legacy) >= 220 and y_legacy <= 87.5 (baseline corner area).

  • "above_the_break_3" — all other three-point attempts.

  • "restricted_area" — two-point attempt within 4 ft of the basket.

  • "in_the_paint_non_ra" — two-point attempt 4–8 ft from the basket and within 80 legacy units of the paint center (abs(x_legacy) <= 80).

  • "mid_range" — all remaining two-point attempts.

Author(s)

Saiem Gilani

See Also

Other WNBA Lineup Functions: wnba_gamerotation(), wnba_leaguedashlineups(), wnba_leaguelineupviz(), wnba_possession_lineups(), wnba_rapm(), wnba_shotchartlineupdetail(), wnba_teamdashlineups()

Examples

try({
    df <- wnba_shot_zones(game_id = "1022400003")
    print(df[!is.na(df$shot_zone), c("shot_distance", "shot_zone")])
  })

Get WNBA Stats API Shot Chart Detail

Description

Get WNBA Stats API Shot Chart Detail

Get WNBA Stats API Shot Chart Detail

Usage

wnba_shotchartdetail(
  context_measure = "FGA",
  date_from = "",
  date_to = "",
  game_id = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  period = 0,
  player_id = "1628932",
  player_position = "",
  rookie_year = "",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  team_id = 0,
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

context_measure

context_measure

date_from

date_from

date_to

date_to

game_id

game_id

game_segment

game_segment

last_n_games

last_n_games

league_id

league_id

location

location

month

month

opponent_team_id

opponent_team_id

outcome

outcome

period

period

player_id

player_id

player_position

player_position

rookie_year

rookie_year

season

season

season_segment

season_segment

season_type

season_type

team_id

team_id

vs_conference

vs_conference

vs_division

vs_division

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_shotchartdetail(league_id = '10', player_id = '1628932', season = most_recent_wnba_season() - 1)

Value

Return a named list of data frames: LeagueAverages, Shot_Chart_Detail

Shot_Chart_Detail

col_name types description
GRID_TYPE character
GAME_ID character Unique game identifier.
GAME_EVENT_ID character Unique identifier for game event.
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
PERIOD character Period of the game (1-4 quarters; 5+ for OT).
MINUTES_REMAINING character Minutes remaining.
SECONDS_REMAINING character Seconds remaining in the period.
EVENT_TYPE character Event / play type code (V2 PBP).
ACTION_TYPE character Action type label (e.g. 'Made Shot', 'Substitution').
SHOT_TYPE character Shot type label (e.g. 'Jump Shot', 'Layup').
SHOT_ZONE_BASIC character Shot zone (e.g. 'Restricted Area', 'Mid-Range', 'Above the Break 3').
SHOT_ZONE_AREA character Shot zone area ('Left Side', 'Right Side', 'Center').
SHOT_ZONE_RANGE character Shot zone range ('Less Than 8 ft.', '8-16 ft.', '16-24 ft.', etc.).
SHOT_DISTANCE character Shot distance from the basket, in feet.
LOC_X character X coordinate on the court (units of inches; 0 = basket center).
LOC_Y character Y coordinate on the court (units of inches; baseline at 0).
SHOT_ATTEMPTED_FLAG character 1 if a shot was attempted on this event.
SHOT_MADE_FLAG character 1 if the shot was made; 0 if missed.
GAME_DATE character Game date (YYYY-MM-DD).
HTM character
VTM character

LeagueAverages

Columns as documented in the shared wnba_shotchartdetail_league_averages_schema table.

Author(s)

Saiem Gilani

See Also

Other WNBA Shooting Functions: wnba_leaguedashplayershotlocations(), wnba_leaguedashteamshotlocations(), wnba_playerdashboardbyclutch(), wnba_shotchartleaguewide(), wnba_shotchartlineupdetail(), wnba_teamdashboardbyclutch()


Get WNBA Stats API Shot Chart League-Wide

Description

Get WNBA Stats API Shot Chart League-Wide

Get WNBA Stats API Shot Chart League-Wide

Usage

wnba_shotchartleaguewide(
  league_id = "10",
  season = most_recent_wnba_season() - 1,
  ...
)

Arguments

league_id

League - default: '10'. Other options include '00': NBA, '20': G-League

season

season

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_shotchartleaguewide(league_id = '10', season = most_recent_wnba_season() - 1)

Value

Return a named list of data frames: League_Wide

League_Wide

Columns as documented in the shared wnba_shotchartdetail_league_averages_schema table.

Author(s)

Saiem Gilani

See Also

Other WNBA Shooting Functions: wnba_leaguedashplayershotlocations(), wnba_leaguedashteamshotlocations(), wnba_playerdashboardbyclutch(), wnba_shotchartdetail(), wnba_shotchartlineupdetail(), wnba_teamdashboardbyclutch()

Other WNBA League Functions: wnba_leaguedashlineups(), wnba_leaguedashplayerbiostats(), wnba_leaguedashplayerclutch(), wnba_leaguedashplayershotlocations(), wnba_leaguedashplayerstats(), wnba_leaguedashteamclutch(), wnba_leaguedashteamshotlocations(), wnba_leaguedashteamstats(), wnba_leaguegamefinder(), wnba_leaguegamelog(), wnba_leaguelineupviz(), wnba_leagueplayerondetails(), wnba_leagueseasonmatchups(), wnba_leaguestandingsv3()


Get WNBA Stats API Shot Chart for Lineups

Description

Get WNBA Stats API Shot Chart for Lineups

Get WNBA Stats API Shot Chart for Lineups

Usage

wnba_shotchartlineupdetail(
  ahead_behind = "",
  cfid = "",
  cfparams = "",
  clutch_time = "",
  conference = "",
  context_filter = "",
  context_measure = "FGA",
  date_from = "",
  date_to = "",
  division = "",
  end_period = "10",
  end_range = "28800",
  group_id = "-1628899-1629481-1630096-1631019-1642784-",
  game_event_id = "",
  game_id = "",
  game_segment = "",
  group_mode = "",
  group_quantity = "5",
  last_n_games = "0",
  league_id = "10",
  location = "",
  month = "0",
  on_off = "",
  opp_player_id = "",
  opponent_team_id = "0",
  outcome = "",
  po_round = "0",
  period = "0",
  player_id = "0",
  player_id1 = "",
  player_id2 = "",
  player_id3 = "",
  player_id4 = "",
  player_id5 = "",
  player_position = "",
  point_diff = "",
  position = "",
  range_type = "0",
  rookie_year = "",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  start_period = "1",
  start_range = "0",
  starter_bench = "",
  team_id = "1611661321",
  vs_conference = "",
  vs_division = "",
  vs_player_id1 = "",
  vs_player_id2 = "",
  vs_player_id3 = "",
  vs_player_id4 = "",
  vs_player_id5 = "",
  vs_team_id = "",
  ...
)

Arguments

ahead_behind

ahead_behind

cfid

cfid

cfparams

cfparams

clutch_time

clutch_time

conference

conference

context_filter

context_filter

context_measure

context_measure

date_from

date_from

date_to

date_to

division

division

end_period

end_period

end_range

end_range

group_id

group_id

game_event_id

game_event_id

game_id

game_id

game_segment

game_segment

group_mode

group_mode

group_quantity

group_quantity

last_n_games

last_n_games

league_id

league_id

location

location

month

month

on_off

on_off

opp_player_id

opp_player_id

opponent_team_id

opponent_team_id

outcome

outcome

po_round

po_round

period

period

player_id

player_id

player_id1

player_id1

player_id2

player_id2

player_id3

player_id3

player_id4

player_id4

player_id5

player_id5

player_position

player_position

point_diff

point_diff

position

position

range_type

range_type

rookie_year

rookie_year

season

season

season_segment

season_segment

season_type

season_type

shot_clock_range

shot_clock_range

start_period

start_period

start_range

start_range

starter_bench

starter_bench

team_id

team_id

vs_conference

vs_conference

vs_division

vs_division

vs_player_id1

vs_player_id1

vs_player_id2

vs_player_id2

vs_player_id3

vs_player_id3

vs_player_id4

vs_player_id4

vs_player_id5

vs_player_id5

vs_team_id

vs_team_id

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_shotchartlineupdetail(group_id = '-1628899-1629481-1630096-1631019-1642784-', opponent_team_id = '1611661324', season = most_recent_wnba_season() - 1)

Value

Return a named list of data frames: ShotChartLineupDetail, ShotChartLineupLeagueAverage

ShotChartLineupDetail

col_name types description
GRID_TYPE character
GAME_ID character Unique game identifier.
GAME_EVENT_ID character Unique identifier for game event.
GROUP_ID character Group identifier (e.g. conference group_id).
GROUP_NAME character Group name.
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
PERIOD character Period of the game (1-4 quarters; 5+ for OT).
MINUTES_REMAINING character Minutes remaining.
SECONDS_REMAINING character Seconds remaining in the period.
EVENT_TYPE character Event / play type code (V2 PBP).
ACTION_TYPE character Action type label (e.g. 'Made Shot', 'Substitution').
SHOT_TYPE character Shot type label (e.g. 'Jump Shot', 'Layup').
SHOT_ZONE_BASIC character Shot zone (e.g. 'Restricted Area', 'Mid-Range', 'Above the Break 3').
SHOT_ZONE_AREA character Shot zone area ('Left Side', 'Right Side', 'Center').
SHOT_ZONE_RANGE character Shot zone range ('Less Than 8 ft.', '8-16 ft.', '16-24 ft.', etc.).
SHOT_DISTANCE character Shot distance from the basket, in feet.
LOC_X character X coordinate on the court (units of inches; 0 = basket center).
LOC_Y character Y coordinate on the court (units of inches; baseline at 0).
SHOT_ATTEMPTED_FLAG character 1 if a shot was attempted on this event.
SHOT_MADE_FLAG character 1 if the shot was made; 0 if missed.
GAME_DATE character Game date (YYYY-MM-DD).
HTM character
VTM character

ShotChartLineupLeagueAverage

Columns as documented in the shared wnba_shotchartdetail_league_averages_schema table.

Author(s)

Saiem Gilani

See Also

Other WNBA Shooting Functions: wnba_leaguedashplayershotlocations(), wnba_leaguedashteamshotlocations(), wnba_playerdashboardbyclutch(), wnba_shotchartdetail(), wnba_shotchartleaguewide(), wnba_teamdashboardbyclutch()

Other WNBA Lineup Functions: wnba_gamerotation(), wnba_leaguedashlineups(), wnba_leaguelineupviz(), wnba_possession_lineups(), wnba_rapm(), wnba_shot_zones(), wnba_teamdashlineups()


WNBA Stats API Endpoint Overview

Description

Wrappers around the WNBA Stats backend at stats.wnba.com/stats/.... All requests go through request_with_proxy() in utils_wnba_stats.R which sets the required WNBA-side headers (⁠Origin: https://stats.wnba.com⁠, ⁠Referer: https://www.wnba.com/⁠) and threads a proxy via getOption("wehoop.proxy") / env vars / explicit ⁠proxy =⁠ arg.

WNBA-specific differences vs the NBA Stats API: quarters are 10 minutes (not 12), regulation is 40 minutes (not 48), game IDs start with "10", LeagueID = "10".

Details

Boxscores (V2)

Tabular resultSets[] responses parsed via wnba_stats_map_result_sets(). See wnba_boxscoreadvancedv2(), wnba_boxscoretraditionalv2(), wnba_boxscorefourfactorsv2(), wnba_boxscoremiscv2(), wnba_boxscoreplayertrackv2(), wnba_boxscorescoringv2(), wnba_boxscoresummaryv2(), wnba_boxscoreusagev2(), wnba_hustlestatsboxscore().

Boxscores (V3)

Nested JSON parsed via purrr::pluck(). See wnba_boxscoreadvancedv3(), wnba_boxscoretraditionalv3(), wnba_boxscorefourfactorsv3(), wnba_boxscoremiscv3(), wnba_boxscoreplayertrackv3(), wnba_boxscorescoringv3(), wnba_boxscoreusagev3().

Play-by-play

Function Purpose
wnba_pbp() V2 + V3 PBP (with V3-to-V2 conversion pipeline)
wnba_pbps() Multi-game PBP loader
wnba_playbyplayv3() V3-only PBP

Leaders, standings, league

wnba_leagueleaders(), wnba_leaguestandingsv3(), wnba_homepageleaders(), wnba_leaderstiles().

Player + team season + game stats

Full per-mode / per-split families. Search the reference index for ⁠wnba_playerdashboard*⁠, ⁠wnba_teamdashboard*⁠, wnba_leaguedashplayerstats(), wnba_leaguedashteamstats(), wnba_playergamelogs(), wnba_teamgamelogs(), ⁠wnba_playerprofile*⁠.

Schedule + scoreboard

wnba_schedule(), wnba_scoreboard(), wnba_scoreboardv2(), wnba_scoreboardv3(), wnba_todays_scoreboard().

Draft + franchise + reference

wnba_draftboard(), wnba_drafthistory(), wnba_draftcombinestats(), wnba_franchisehistory(), wnba_franchiseleaders().


Get the WNBA cross-source team crosswalk

Description

Build a wide, one-row-per-team-per-season crosswalk linking ESPN, the WNBA Stats API, and Fox Sports team identities, keyed on espn_team_id. Yahoo columns are placeholders (NA) until that source is implemented.

Usage

wnba_team_crosswalk(season = most_recent_wnba_season(), .schedule = NULL)

Arguments

season

Season year (numeric). Defaults to the most recent WNBA season.

.schedule

Internal. An already-fetched wnba_schedule() frame, supplied by wnba_schedule_crosswalk() to avoid a duplicate CDN request. Leave NULL.

Value

A wehoop_data tibble, one row per team:

col_name types description
season integer Season year.
espn_team_id integer ESPN team id (canonical key).
espn_abbreviation character ESPN abbreviation.
espn_display_name character ESPN display name.
espn_short_name character ESPN short name.
espn_location character ESPN team location.
espn_mascot character ESPN team mascot/nickname.
wnba_team_id character WNBA Stats team id.
wnba_team_tricode character WNBA Stats tricode.
wnba_team_name character WNBA Stats team name.
wnba_team_city character WNBA Stats team city.
wnba_team_slug character WNBA Stats team slug.
fox_team_id character Fox Bifrost team id.
fox_team_name character Fox team name.
yahoo_team_id character Yahoo team id (NA placeholder).
yahoo_team_abbreviation character Yahoo abbreviation (NA placeholder).
yahoo_team_name character Yahoo team name (NA placeholder).
match_method character How the row was matched.
match_confidence numeric Match confidence (1 for deterministic).

See Also

Other WNBA Crosswalk Functions: load_wnba_team_crosswalk(), wnba_player_crosswalk(), wnba_schedule_crosswalk()

Examples

try(wnba_team_crosswalk(season = 2024))

Get WNBA Stats API Team Dashboard by Clutch Splits

Description

Get WNBA Stats API Team Dashboard by Clutch Splits

Get WNBA Stats API Team Dashboard by Clutch Splits

Get WNBA Stats API Team Dashboard by Game Splits

Get WNBA Stats API Team Dashboard by General Splits

Get WNBA Stats API Team Dashboard by Last N Games

Get WNBA Stats API Team Dashboard by Opponent

Get WNBA Stats API Team Dashboard by Shooting Splits

Get WNBA Stats API Team Dashboard by Team Performance

Get WNBA Stats API Team Dashboard Year over Year

Usage

wnba_teamdashboardbyclutch(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1611661328",
  vs_conference = "",
  vs_division = "",
  ...
)

wnba_teamdashboardbygamesplits(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1611661328",
  vs_conference = "",
  vs_division = "",
  ...
)

wnba_teamdashboardbygeneralsplits(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1611661328",
  vs_conference = "",
  vs_division = "",
  ...
)

wnba_teamdashboardbylastngames(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1611661328",
  vs_conference = "",
  vs_division = "",
  ...
)

wnba_teamdashboardbyopponent(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1611661328",
  vs_conference = "",
  vs_division = "",
  ...
)

wnba_teamdashboardbyshootingsplits(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1611661328",
  vs_conference = "",
  vs_division = "",
  ...
)

wnba_teamdashboardbyteamperformance(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1611661328",
  vs_conference = "",
  vs_division = "",
  ...
)

wnba_teamdashboardbyyearoveryear(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1611661328",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from

date_to

date_to

game_segment

game_segment

last_n_games

last_n_games

league_id

league_id

location

location

measure_type

measure_type

month

month

opponent_team_id

opponent_team_id

outcome

outcome

pace_adjust

pace_adjust

plus_minus

plus_minus

po_round

po_round

per_mode

per_mode

period

period

rank

rank

season

season

season_segment

season_segment

season_type

season_type

shot_clock_range

shot_clock_range

team_id

team_id

vs_conference

vs_conference

vs_division

vs_division

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_teamdashboardbyclutch(team_id = '1611661328', season = most_recent_wnba_season() - 1)
  wnba_teamdashboardbygamesplits(team_id = '1611661328', season = most_recent_wnba_season() - 1)
  wnba_teamdashboardbygeneralsplits(team_id = '1611661328', season = most_recent_wnba_season() - 1)
  wnba_teamdashboardbylastngames(team_id = '1611661328', season = most_recent_wnba_season() - 1)
  wnba_teamdashboardbyopponent(team_id = '1611661328', season = most_recent_wnba_season() - 1)

Team Dashboard by Shooting Splits

  wnba_teamdashboardbyshootingsplits(team_id = '1611661328', season = most_recent_wnba_season() - 1)
  wnba_teamdashboardbyteamperformance(team_id = '1611661328', season = most_recent_wnba_season() - 1)
  wnba_teamdashboardbyyearoveryear(team_id = '1611661328', season = most_recent_wnba_season() - 1)

Value

Return a named list of data frames: Last10Sec3Point2TeamDashboard, Last10Sec3PointTeamDashboard, Last1Min5PointTeamDashboard, Last1MinPlusMinus5PointTeamDashboard, Last30Sec3Point2TeamDashboard, Last30Sec3PointTeamDashboard, Last3Min5PointTeamDashboard, Last3MinPlusMinus5PointTeamDashboard, Last5Min5PointTeamDashboard, Last5MinPlusMinus5PointTeamDashboard, OverallTeamDashboard

OverallTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

Last5Min5PointTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

Last3Min5PointTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

Last1Min5PointTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

Last30Sec3PointTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

Last10Sec3PointTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

Last5MinPlusMinus5PointTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

Last3MinPlusMinus5PointTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

Last1MinPlusMinus5PointTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

Last30Sec3Point2TeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

Last10Sec3Point2TeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

Return a named list of data frames: ByActualMarginTeamDashboard, ByHalfTeamDashboard, ByPeriodTeamDashboard, ByScoreMarginTeamDashboard, OverallTeamDashboard

OverallTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

ByHalfTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

ByPeriodTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

ByScoreMarginTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

ByActualMarginTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

Return a named list of data frames: DaysRestTeamDashboard, LocationTeamDashboard, MonthTeamDashboard, OverallTeamDashboard, PrePostAllStarTeamDashboard, WinsLossesTeamDashboard

OverallTeamDashboard

col_name types description
GROUP_SET character
GROUP_VALUE character
SEASON_YEAR character Season year string ('YYYY-YY' format).
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

LocationTeamDashboard

col_name types description
GROUP_SET character
GROUP_VALUE character
TEAM_GAME_LOCATION character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

WinsLossesTeamDashboard

col_name types description
GROUP_SET character
GROUP_VALUE character
GAME_RESULT character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

MonthTeamDashboard

col_name types description
GROUP_SET character
GROUP_VALUE character
SEASON_MONTH_NAME character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

PrePostAllStarTeamDashboard

col_name types description
GROUP_SET character
GROUP_VALUE character
SEASON_SEGMENT character Season segment filter ('Pre All-Star' / 'Post All-Star').
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

DaysRestTeamDashboard

col_name types description
GROUP_SET character
GROUP_VALUE character
TEAM_DAYS_REST_RANGE character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

Return a named list of data frames: GameNumberTeamDashboard, Last10TeamDashboard, Last15TeamDashboard, Last20TeamDashboard, Last5TeamDashboard, OverallTeamDashboard

OverallTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

Last5TeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

Last10TeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

Last15TeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

Last20TeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

GameNumberTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

Return a named list of data frames: ConferenceTeamDashboard, DivisionTeamDashboard, OpponentTeamDashboard, OverallTeamDashboard

OverallTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

ConferenceTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

DivisionTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

OpponentTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

Return a named list of data frames: AssistedBy, AssitedShotTeamDashboard, OverallTeamDashboard, Shot5FTTeamDashboard, Shot8FTTeamDashboard, ShotAreaTeamDashboard, ShotTypeTeamDashboard

OverallTeamDashboard

Columns as documented in the shared wnba_shooting_splits_schema table.

Shot5FTTeamDashboard

Columns as documented in the shared wnba_shooting_splits_schema table.

Shot8FTTeamDashboard

Columns as documented in the shared wnba_shooting_splits_schema table.

ShotAreaTeamDashboard

Columns as documented in the shared wnba_shooting_splits_schema table.

AssitedShotTeamDashboard

Columns as documented in the shared wnba_shooting_splits_schema table.

ShotTypeTeamDashboard

Columns as documented in the shared wnba_shooting_splits_schema table.

AssistedBy

Columns as documented in the shared wnba_shooting_splits_assisted_by_schema table.

Return a named list of data frames: OverallTeamDashboard, PointsScoredTeamDashboard, PontsAgainstTeamDashboard, ScoreDifferentialTeamDashboard

OverallTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

ScoreDifferentialTeamDashboard

col_name types description
GROUP_SET character
GROUP_VALUE_ORDER character
GROUP_VALUE character
GROUP_VALUE_2 character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

PointsScoredTeamDashboard

Same columns as the ScoreDifferentialTeamDashboard table above.

PontsAgainstTeamDashboard

Same columns as the ScoreDifferentialTeamDashboard table above.

Return a named list of data frames: ByYearTeamDashboard, OverallTeamDashboard

OverallTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

ByYearTeamDashboard

Columns as documented in the shared wnba_team_dashboard_schema table.

Author(s)

Saiem Gilani

See Also

Other WNBA Team Functions: wnba_leaguedashteamstats(), wnba_teamdashlineups(), wnba_teamdetails(), wnba_teamestimatedmetrics(), wnba_teamgamelog(), wnba_teamgamelogs(), wnba_teamgamestreakfinder(), wnba_teamhistoricalleaders(), wnba_teaminfocommon(), wnba_teamplayeronoffdetails(), wnba_teams(), wnba_teamvsplayer(), wnba_teamyearbyyearstats()

Other WNBA Clutch Functions: wnba_leaguedashteamclutch(), wnba_playerdashboardbyclutch()

Other WNBA Shooting Functions: wnba_leaguedashplayershotlocations(), wnba_leaguedashteamshotlocations(), wnba_playerdashboardbyclutch(), wnba_shotchartdetail(), wnba_shotchartleaguewide(), wnba_shotchartlineupdetail()


Get WNBA Stats API Team Dashboard - Lineups

Description

Get WNBA Stats API Team Dashboard - Lineups

Get WNBA Stats API Team Dashboard - Lineups

Usage

wnba_teamdashlineups(
  date_from = "",
  date_to = "",
  game_id = "",
  game_segment = "",
  group_quantity = 5,
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1611661328",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from

date_to

date_to

game_id

game_id

game_segment

game_segment

group_quantity

group_quantity

last_n_games

last_n_games

league_id

league_id

location

location

measure_type

measure_type

month

month

opponent_team_id

opponent_team_id

outcome

outcome

pace_adjust

pace_adjust

plus_minus

plus_minus

po_round

po_round

per_mode

per_mode

period

period

rank

rank

season

season

season_segment

season_segment

season_type

season_type

shot_clock_range

shot_clock_range

team_id

team_id

vs_conference

vs_conference

vs_division

vs_division

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_teamdashlineups(team_id = '1611661328', season = most_recent_wnba_season() - 1)

Value

Return a named list of data frames: Lineups, Overall

Overall

Columns as documented in the shared wnba_team_summary_overall_schema table.

Lineups

col_name types description
GROUP_SET character
GROUP_ID character Group identifier (e.g. conference group_id).
GROUP_NAME character Group name.
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

Author(s)

Saiem Gilani

See Also

Other WNBA Team Functions: wnba_leaguedashteamstats(), wnba_teamdashboardbyclutch(), wnba_teamdetails(), wnba_teamestimatedmetrics(), wnba_teamgamelog(), wnba_teamgamelogs(), wnba_teamgamestreakfinder(), wnba_teamhistoricalleaders(), wnba_teaminfocommon(), wnba_teamplayeronoffdetails(), wnba_teams(), wnba_teamvsplayer(), wnba_teamyearbyyearstats()

Other WNBA Lineup Functions: wnba_gamerotation(), wnba_leaguedashlineups(), wnba_leaguelineupviz(), wnba_possession_lineups(), wnba_rapm(), wnba_shot_zones(), wnba_shotchartlineupdetail()


Get WNBA Stats API Team Details

Description

Get WNBA Stats API Team Details

Get WNBA Stats API Team Details

Usage

wnba_teamdetails(team_id = "1611661328", ...)

Arguments

team_id

Team ID

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_teamdetails(team_id = '1611661328')

Value

Return a named list of data frames: TeamAwardsChampionships, TeamAwardsConf, TeamAwardsDiv, TeamBackground, TeamHistory, TeamHof, TeamRetired, TeamSocialSites

TeamBackground

col_name types description
TEAM_ID character Unique team identifier.
ABBREVIATION character Short abbreviation.
NICKNAME character Team or athlete nickname.
YEARFOUNDED character
CITY character City.
ARENA character
ARENACAPACITY character
OWNER character
GENERALMANAGER character
HEADCOACH character
DLEAGUEAFFILIATION character

TeamHistory

col_name types description
TEAM_ID character Unique team identifier.
CITY character City.
NICKNAME character Team or athlete nickname.
YEARFOUNDED character
YEARACTIVETILL character

TeamSocialSites

col_name types description
ACCOUNTTYPE character
WEBSITE_LINK character

TeamAwardsChampionships

col_name types description
YEARAWARDED character
OPPOSITETEAM character

TeamAwardsConf

col_name types description
YEARAWARDED integer
OPPOSITETEAM integer

TeamAwardsDiv

Same columns as the TeamAwardsConf table above.

TeamHof

col_name types description
PLAYERID character
PLAYER character
POSITION character Listed roster position (G, F, C, etc.).
JERSEY character Jersey number worn by the player.
SEASONSWITHTEAM character
YEAR character 4-digit year.

TeamRetired

Same columns as the TeamHof table above.

Author(s)

Saiem Gilani

See Also

Other WNBA Team Functions: wnba_leaguedashteamstats(), wnba_teamdashboardbyclutch(), wnba_teamdashlineups(), wnba_teamestimatedmetrics(), wnba_teamgamelog(), wnba_teamgamelogs(), wnba_teamgamestreakfinder(), wnba_teamhistoricalleaders(), wnba_teaminfocommon(), wnba_teamplayeronoffdetails(), wnba_teams(), wnba_teamvsplayer(), wnba_teamyearbyyearstats()


Get WNBA Stats API Team Estimated Metrics

Description

Get WNBA Stats API Team Estimated Metrics

Get WNBA Stats API Team Estimated Metrics

Usage

wnba_teamestimatedmetrics(
  league_id = "10",
  season = most_recent_wnba_season() - 1,
  season_type = "Regular Season",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League

season

Season - format 2020-21

season_type

Season Type - Regular Season, Playoffs, All-Star

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_teamestimatedmetrics()

Value

Return a named list of data frames: TeamEstimatedMetrics

TeamEstimatedMetrics

col_name types description
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ID character Unique team identifier.
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
E_OFF_RATING character
E_DEF_RATING character
E_NET_RATING character
E_PACE character
E_AST_RATIO character
E_OREB_PCT character
E_DREB_PCT character
E_REB_PCT character
E_TM_TOV_PCT character
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
E_OFF_RATING_RANK character
E_DEF_RATING_RANK character
E_NET_RATING_RANK character
E_AST_RATIO_RANK character
E_OREB_PCT_RANK character
E_DREB_PCT_RANK character
E_REB_PCT_RANK character
E_TM_TOV_PCT_RANK character
E_PACE_RANK character

Author(s)

Saiem Gilani

See Also

Other WNBA Team Functions: wnba_leaguedashteamstats(), wnba_teamdashboardbyclutch(), wnba_teamdashlineups(), wnba_teamdetails(), wnba_teamgamelog(), wnba_teamgamelogs(), wnba_teamgamestreakfinder(), wnba_teamhistoricalleaders(), wnba_teaminfocommon(), wnba_teamplayeronoffdetails(), wnba_teams(), wnba_teamvsplayer(), wnba_teamyearbyyearstats()


Get WNBA Stats API Team Game Log

Description

Get WNBA Stats API Team Game Log

Get WNBA Stats API Team Game Log

Usage

wnba_teamgamelog(
  date_from = "",
  date_to = "",
  league_id = "10",
  season = most_recent_wnba_season() - 1,
  season_type = "Regular Season",
  team_id = "1611661328",
  ...
)

Arguments

date_from

date_from

date_to

date_to

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League

season

Season - format 2020-21

season_type

Season Type - Regular Season, Playoffs, All-Star

team_id

Team ID

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_teamgamelog(team_id = '1611661328')

Value

Return a named list of data frames: TeamGameLog

TeamGameLog

col_name types description
Team_ID character Unique team identifier.
Game_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
MATCHUP character Matchup.
WL character
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

Author(s)

Saiem Gilani

See Also

Other WNBA Team Functions: wnba_leaguedashteamstats(), wnba_teamdashboardbyclutch(), wnba_teamdashlineups(), wnba_teamdetails(), wnba_teamestimatedmetrics(), wnba_teamgamelogs(), wnba_teamgamestreakfinder(), wnba_teamhistoricalleaders(), wnba_teaminfocommon(), wnba_teamplayeronoffdetails(), wnba_teams(), wnba_teamvsplayer(), wnba_teamyearbyyearstats()


Get WNBA Stats API Team Game Logs

Description

Get WNBA Stats API Team Game Logs

Get WNBA Stats API Team Game Logs

Usage

wnba_teamgamelogs(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  player_id = "",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  team_id = "1611661328",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from

date_to

date_to

game_segment

game_segment

last_n_games

last_n_games

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League

location

location

measure_type

measure_type

month

month

opponent_team_id

opponent_team_id

outcome

outcome

po_round

po_round

per_mode

per_mode

period

period

player_id

Player ID

season

Season - format 2020-21

season_segment

season_segment

season_type

Season Type - Regular Season, Playoffs, All-Star

team_id

team_id

vs_conference

vs_conference

vs_division

vs_division

...

Additional arguments passed to an underlying function like httr.

Details

Teams Game Log

 wnba_teamgamelogs(team_id = '1611661328')

Value

Return a named list of data frames: TeamGameLogs

TeamGameLogs

col_name types description
SEASON_YEAR character Season year string ('YYYY-YY' format).
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
GAME_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
MATCHUP character Matchup.
WL character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

Author(s)

Saiem Gilani

See Also

Other WNBA Team Functions: wnba_leaguedashteamstats(), wnba_teamdashboardbyclutch(), wnba_teamdashlineups(), wnba_teamdetails(), wnba_teamestimatedmetrics(), wnba_teamgamelog(), wnba_teamgamestreakfinder(), wnba_teamhistoricalleaders(), wnba_teaminfocommon(), wnba_teamplayeronoffdetails(), wnba_teams(), wnba_teamvsplayer(), wnba_teamyearbyyearstats()


Get WNBA Stats API Team Game Streak Finder

Description

Get WNBA Stats API Team Game Streak Finder

Get WNBA Stats API Team Game Streak Finder

Usage

wnba_teamgamestreakfinder(
  active_streaks_only = "",
  active_teams_only = "",
  btr_opp_ast = "",
  btr_opp_blk = "",
  btr_opp_dreb = "",
  btr_opp_fg3a = "",
  btr_opp_fg3m = "",
  btr_opp_fg3_pct = "",
  btr_opp_fga = "",
  btr_opp_fgm = "",
  btr_opp_fg_pct = "",
  btr_opp_fta = "",
  btr_opp_ftm = "",
  btr_opp_ft_pct = "",
  btr_opp_oreb = "",
  btr_opp_pf = "",
  btr_opp_pts = "",
  btr_opp_pts2nd_chance = "",
  btr_opp_pts_fb = "",
  btr_opp_pts_off_tov = "",
  btr_opp_pts_paint = "",
  btr_opp_reb = "",
  btr_opp_stl = "",
  btr_opp_tov = "",
  conference = "",
  date_from = "",
  date_to = "",
  division = "",
  et_ast = "",
  et_blk = "",
  et_dd = "",
  et_dreb = "",
  et_fg3a = "",
  et_fg3m = "",
  et_fg3_pct = "",
  et_fga = "",
  et_fgm = "",
  et_fg_pct = "",
  et_fta = "",
  et_ftm = "",
  et_ft_pct = "",
  et_minutes = "",
  eq_opp_pts2nd_chance = "",
  eq_opp_pts_fb = "",
  eq_opp_pts_off_tov = "",
  eq_opp_pts_paint = "",
  et_oreb = "",
  et_pf = "",
  et_pts = "",
  eq_pts2nd_chance = "",
  eq_pts_fb = "",
  eq_pts_off_tov = "",
  eq_pts_paint = "",
  et_reb = "",
  et_stl = "",
  et_td = "",
  et_tov = "",
  game_id = "",
  gt_ast = "",
  gt_blk = "",
  gt_dd = "",
  gt_dreb = "",
  gt_fg3a = "",
  gt_fg3m = "",
  gt_fg3_pct = "",
  gt_fga = "",
  gt_fgm = "",
  gt_fg_pct = "",
  gt_fta = "",
  gt_ftm = "",
  gt_ft_pct = "",
  gt_minutes = "",
  gt_opp_ast = "",
  gt_opp_blk = "",
  gt_opp_dreb = "",
  gt_opp_fg3a = "",
  gt_opp_fg3m = "",
  gt_opp_fg3_pct = "",
  gt_opp_fga = "",
  gt_opp_fgm = "",
  gt_opp_fg_pct = "",
  gt_opp_fta = "",
  gt_opp_ftm = "",
  gt_opp_ft_pct = "",
  gt_opp_oreb = "",
  gt_opp_pf = "",
  gt_opp_pts = "",
  gt_opp_pts2nd_chance = "",
  gt_opp_pts_fb = "",
  gt_opp_pts_off_tov = "",
  gt_opp_pts_paint = "",
  gt_opp_reb = "",
  gt_opp_stl = "",
  gt_opp_tov = "",
  gt_oreb = "",
  gt_pf = "",
  gt_pts = "",
  gt_pts2nd_chance = "",
  gt_pts_fb = "",
  gt_pts_off_tov = "",
  gt_pts_paint = "",
  gt_reb = "",
  gt_stl = "",
  gt_td = "",
  gt_tov = "",
  lstreak = "",
  league_id = "10",
  location = "",
  lt_ast = "",
  lt_blk = "",
  lt_dd = "",
  lt_dreb = "",
  lt_fg3a = "",
  lt_fg3m = "",
  lt_fg3_pct = "",
  lt_fga = "",
  lt_fgm = "",
  lt_fg_pct = "",
  lt_fta = "",
  lt_ftm = "",
  lt_ft_pct = "",
  lt_minutes = "",
  lt_opp_ast = "",
  lt_opp_blk = "",
  lt_opp_dreb = "",
  lt_opp_fg3a = "",
  lt_opp_fg3m = "",
  lt_opp_fg3_pct = "",
  lt_opp_fga = "",
  lt_opp_fgm = "",
  lt_opp_fg_pct = "",
  lt_opp_fta = "",
  lt_opp_ftm = "",
  lt_opp_ft_pct = "",
  lt_opp_oreb = "",
  lt_opp_pf = "",
  lt_opp_pts = "",
  lt_opp_pts2nd_chance = "",
  lt_opp_pts_fb = "",
  lt_opp_pts_off_tov = "",
  lt_opp_pts_paint = "",
  lt_opp_reb = "",
  lt_opp_stl = "",
  lt_opp_tov = "",
  lt_oreb = "",
  lt_pf = "",
  lt_pts = "",
  lt_pts2nd_chance = "",
  lt_pts_fb = "",
  lt_pts_off_tov = "",
  lt_pts_paint = "",
  lt_reb = "",
  lt_stl = "",
  lt_td = "",
  lt_tov = "",
  min_games = "",
  outcome = "",
  po_round = "",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  vs_team_id = "",
  wstreak = "",
  wrs_opp_ast = "",
  wrs_opp_blk = "",
  wrs_opp_dreb = "",
  wrs_opp_fg3a = "",
  wrs_opp_fg3m = "",
  wrs_opp_fg3_pct = "",
  wrs_opp_fga = "",
  wrs_opp_fgm = "",
  wrs_opp_fg_pct = "",
  wrs_opp_fta = "",
  wrs_opp_ftm = "",
  wrs_opp_ft_pct = "",
  wrs_opp_oreb = "",
  wrs_opp_pf = "",
  wrs_opp_pts = "",
  wrs_opp_pts2nd_chance = "",
  wrs_opp_pts_fb = "",
  wrs_opp_pts_off_tov = "",
  wrs_opp_pts_paint = "",
  wrs_opp_reb = "",
  wrs_opp_stl = "",
  wrs_opp_tov = "",
  ...
)

Arguments

active_streaks_only

active_streaks_only

active_teams_only

active_teams_only

btr_opp_ast

btr_opp_ast

btr_opp_blk

btr_opp_blk

btr_opp_dreb

btr_opp_dreb

btr_opp_fg3a

btr_opp_fg3a

btr_opp_fg3m

btr_opp_fg3m

btr_opp_fg3_pct

btr_opp_fg3_pct

btr_opp_fga

btr_opp_fga

btr_opp_fgm

btr_opp_fgm

btr_opp_fg_pct

btr_opp_fg_pct

btr_opp_fta

btr_opp_fta

btr_opp_ftm

btr_opp_ftm

btr_opp_ft_pct

btr_opp_ft_pct

btr_opp_oreb

btr_opp_oreb

btr_opp_pf

btr_opp_pf

btr_opp_pts

btr_opp_pts

btr_opp_pts2nd_chance

btr_opp_pts2nd_chance

btr_opp_pts_fb

btr_opp_pts_fb

btr_opp_pts_off_tov

btr_opp_pts_off_tov

btr_opp_pts_paint

btr_opp_pts_paint

btr_opp_reb

btr_opp_reb

btr_opp_stl

btr_opp_stl

btr_opp_tov

btr_opp_tov

conference

conference

date_from

date_from

date_to

date_to

division

division

et_ast

et_ast

et_blk

et_blk

et_dd

et_dd

et_dreb

et_dreb

et_fg3a

et_fg3a

et_fg3m

et_fg3m

et_fg3_pct

et_fg3_pct

et_fga

et_fga

et_fgm

et_fgm

et_fg_pct

et_fg_pct

et_fta

et_fta

et_ftm

et_ftm

et_ft_pct

et_ft_pct

et_minutes

et_minutes

eq_opp_pts2nd_chance

eq_opp_pts2nd_chance

eq_opp_pts_fb

eq_opp_pts_fb

eq_opp_pts_off_tov

eq_opp_pts_off_tov

eq_opp_pts_paint

eq_opp_pts_paint

et_oreb

et_oreb

et_pf

et_pf

et_pts

et_pts

eq_pts2nd_chance

eq_pts2nd_chance

eq_pts_fb

eq_pts_fb

eq_pts_off_tov

eq_pts_off_tov

eq_pts_paint

eq_pts_paint

et_reb

et_reb

et_stl

et_stl

et_td

et_td

et_tov

et_tov

game_id

game_id

gt_ast

gt_ast

gt_blk

gt_blk

gt_dd

gt_dd

gt_dreb

gt_dreb

gt_fg3a

gt_fg3a

gt_fg3m

gt_fg3m

gt_fg3_pct

gt_fg3_pct

gt_fga

gt_fga

gt_fgm

gt_fgm

gt_fg_pct

gt_fg_pct

gt_fta

gt_fta

gt_ftm

gt_ftm

gt_ft_pct

gt_ft_pct

gt_minutes

gt_minutes

gt_opp_ast

gt_opp_ast

gt_opp_blk

gt_opp_blk

gt_opp_dreb

gt_opp_dreb

gt_opp_fg3a

gt_opp_fg3a

gt_opp_fg3m

gt_opp_fg3m

gt_opp_fg3_pct

gt_opp_fg3_pct

gt_opp_fga

gt_opp_fga

gt_opp_fgm

gt_opp_fgm

gt_opp_fg_pct

gt_opp_fg_pct

gt_opp_fta

gt_opp_fta

gt_opp_ftm

gt_opp_ftm

gt_opp_ft_pct

gt_opp_ft_pct

gt_opp_oreb

gt_opp_oreb

gt_opp_pf

gt_opp_pf

gt_opp_pts

gt_opp_pts

gt_opp_pts2nd_chance

gt_opp_pts2nd_chance

gt_opp_pts_fb

gt_opp_pts_fb

gt_opp_pts_off_tov

gt_opp_pts_off_tov

gt_opp_pts_paint

gt_opp_pts_paint

gt_opp_reb

gt_opp_reb

gt_opp_stl

gt_opp_stl

gt_opp_tov

gt_opp_tov

gt_oreb

gt_oreb

gt_pf

gt_pf

gt_pts

gt_pts

gt_pts2nd_chance

gt_pts2nd_chance

gt_pts_fb

gt_pts_fb

gt_pts_off_tov

gt_pts_off_tov

gt_pts_paint

gt_pts_paint

gt_reb

gt_reb

gt_stl

gt_stl

gt_td

gt_td

gt_tov

gt_tov

lstreak

lstreak

league_id

league_id

location

location

lt_ast

lt_ast

lt_blk

lt_blk

lt_dd

lt_dd

lt_dreb

lt_dreb

lt_fg3a

lt_fg3a

lt_fg3m

lt_fg3m

lt_fg3_pct

lt_fg3_pct

lt_fga

lt_fga

lt_fgm

lt_fgm

lt_fg_pct

lt_fg_pct

lt_fta

lt_fta

lt_ftm

lt_ftm

lt_ft_pct

lt_ft_pct

lt_minutes

lt_minutes

lt_opp_ast

lt_opp_ast

lt_opp_blk

lt_opp_blk

lt_opp_dreb

lt_opp_dreb

lt_opp_fg3a

lt_opp_fg3a

lt_opp_fg3m

lt_opp_fg3m

lt_opp_fg3_pct

lt_opp_fg3_pct

lt_opp_fga

lt_opp_fga

lt_opp_fgm

lt_opp_fgm

lt_opp_fg_pct

lt_opp_fg_pct

lt_opp_fta

lt_opp_fta

lt_opp_ftm

lt_opp_ftm

lt_opp_ft_pct

lt_opp_ft_pct

lt_opp_oreb

lt_opp_oreb

lt_opp_pf

lt_opp_pf

lt_opp_pts

lt_opp_pts

lt_opp_pts2nd_chance

lt_opp_pts2nd_chance

lt_opp_pts_fb

lt_opp_pts_fb

lt_opp_pts_off_tov

lt_opp_pts_off_tov

lt_opp_pts_paint

lt_opp_pts_paint

lt_opp_reb

lt_opp_reb

lt_opp_stl

lt_opp_stl

lt_opp_tov

lt_opp_tov

lt_oreb

lt_oreb

lt_pf

lt_pf

lt_pts

lt_pts

lt_pts2nd_chance

lt_pts2nd_chance

lt_pts_fb

lt_pts_fb

lt_pts_off_tov

lt_pts_off_tov

lt_pts_paint

lt_pts_paint

lt_reb

lt_reb

lt_stl

lt_stl

lt_td

lt_td

lt_tov

lt_tov

min_games

min_games

outcome

outcome

po_round

po_round

season

season

season_segment

season_segment

season_type

season_type

team_id

team_id

vs_conference

vs_conference

vs_division

vs_division

vs_team_id

vs_team_id

wstreak

wstreak

wrs_opp_ast

wrs_opp_ast

wrs_opp_blk

wrs_opp_blk

wrs_opp_dreb

wrs_opp_dreb

wrs_opp_fg3a

wrs_opp_fg3a

wrs_opp_fg3m

wrs_opp_fg3m

wrs_opp_fg3_pct

wrs_opp_fg3_pct

wrs_opp_fga

wrs_opp_fga

wrs_opp_fgm

wrs_opp_fgm

wrs_opp_fg_pct

wrs_opp_fg_pct

wrs_opp_fta

wrs_opp_fta

wrs_opp_ftm

wrs_opp_ftm

wrs_opp_ft_pct

wrs_opp_ft_pct

wrs_opp_oreb

wrs_opp_oreb

wrs_opp_pf

wrs_opp_pf

wrs_opp_pts

wrs_opp_pts

wrs_opp_pts2nd_chance

wrs_opp_pts2nd_chance

wrs_opp_pts_fb

wrs_opp_pts_fb

wrs_opp_pts_off_tov

wrs_opp_pts_off_tov

wrs_opp_pts_paint

wrs_opp_pts_paint

wrs_opp_reb

wrs_opp_reb

wrs_opp_stl

wrs_opp_stl

wrs_opp_tov

wrs_opp_tov

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_teamgamestreakfinder()

Value

Return a named list of data frames: TeamGameStreakFinderParametersResults

TeamGameStreakFinderParametersResults

col_name types description
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ID character Unique team identifier.
GAMESTREAK character
STARTDATE character
ENDDATE character
ACTIVESTREAK character
NUMSEASONS character
LASTSEASON character
FIRSTSEASON character
ABBREVIATION character Short abbreviation.

Author(s)

Saiem Gilani

See Also

Other WNBA Team Functions: wnba_leaguedashteamstats(), wnba_teamdashboardbyclutch(), wnba_teamdashlineups(), wnba_teamdetails(), wnba_teamestimatedmetrics(), wnba_teamgamelog(), wnba_teamgamelogs(), wnba_teamhistoricalleaders(), wnba_teaminfocommon(), wnba_teamplayeronoffdetails(), wnba_teams(), wnba_teamvsplayer(), wnba_teamyearbyyearstats()

Other WNBA Game Finder Functions: wnba_leaguegamefinder(), wnba_playergamestreakfinder()


Get WNBA Stats API Team Historical Leaders

Description

Get WNBA Stats API Team Historical Leaders

Get WNBA Stats API Team Historical Leaders

Usage

wnba_teamhistoricalleaders(
  league_id = "10",
  season_id = "22022",
  team_id = "1611661328",
  ...
)

Arguments

league_id

league_id

season_id

season_id

team_id

team_id

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_teamhistoricalleaders(team_id = '1611661328')

Value

Return a named list of data frames: CareerLeadersByTeam

CareerLeadersByTeam

col_name types description
TEAM_ID character Unique team identifier.
PTS character Points scored.
PTS_PERSON_ID character
PTS_PLAYER character
AST character Assists.
AST_PERSON_ID character
AST_PLAYER character
REB character Total rebounds.
REB_PERSON_ID character
REB_PLAYER character
BLK character Blocks.
BLK_PERSON_ID character
BLK_PLAYER character
STL character Steals.
STL_PERSON_ID character
STL_PLAYER character
SEASON_YEAR character Season year string ('YYYY-YY' format).

Author(s)

Saiem Gilani

See Also

Other WNBA Team Functions: wnba_leaguedashteamstats(), wnba_teamdashboardbyclutch(), wnba_teamdashlineups(), wnba_teamdetails(), wnba_teamestimatedmetrics(), wnba_teamgamelog(), wnba_teamgamelogs(), wnba_teamgamestreakfinder(), wnba_teaminfocommon(), wnba_teamplayeronoffdetails(), wnba_teams(), wnba_teamvsplayer(), wnba_teamyearbyyearstats()


Get WNBA Stats API Team Common Info

Description

Get WNBA Stats API Team Common Info

Get WNBA Stats API Team Common Info

Usage

wnba_teaminfocommon(
  league_id = "10",
  season = most_recent_wnba_season() - 1,
  season_type = "Regular Season",
  team_id = "1611661328",
  ...
)

Arguments

league_id

League - default: '10'. Other options include '00': NBA, '20': G-League

season

Season - format 2020-21

season_type

Season Type - Regular Season, Playoffs, All-Star

team_id

Team ID

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_teaminfocommon(team_id = '1611661328')

Value

Return a named list of data frames: AvailableSeasons, TeamInfoCommon, TeamSeasonRanks

TeamInfoCommon

col_name types description
TEAM_ID character Unique team identifier.
SEASON_YEAR character Season year string ('YYYY-YY' format).
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CONFERENCE character
TEAM_DIVISION character
TEAM_CODE character
TEAM_SLUG character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
W character Wins.
L character Losses.
PCT character
CONF_RANK character
DIV_RANK character
MIN_YEAR character
MAX_YEAR character

TeamSeasonRanks

col_name types description
LEAGUE_ID character League identifier ('10' = WNBA).
SEASON_ID character Unique season identifier.
TEAM_ID character Unique team identifier.
PTS_RANK character
PTS_PG character
REB_RANK character
REB_PG character
AST_RANK character
AST_PG character
OPP_PTS_RANK character
OPP_PTS_PG character

AvailableSeasons

col_name types description
SEASON_ID character Unique season identifier.

Author(s)

Saiem Gilani

See Also

Other WNBA Team Functions: wnba_leaguedashteamstats(), wnba_teamdashboardbyclutch(), wnba_teamdashlineups(), wnba_teamdetails(), wnba_teamestimatedmetrics(), wnba_teamgamelog(), wnba_teamgamelogs(), wnba_teamgamestreakfinder(), wnba_teamhistoricalleaders(), wnba_teamplayeronoffdetails(), wnba_teams(), wnba_teamvsplayer(), wnba_teamyearbyyearstats()


Get WNBA Stats API Team Player On/Off Details

Description

Get WNBA Stats API Team Player On/Off Details

Get WNBA Stats API Team Player On/Off Summary

Get WNBA Stats API Team Player Dashboard

Get WNBA Stats API Team Player Dashboard

Usage

wnba_teamplayeronoffdetails(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1611661328",
  vs_conference = "",
  vs_division = "",
  ...
)

wnba_teamplayeronoffsummary(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1611661328",
  vs_conference = "",
  vs_division = "",
  ...
)

wnba_teamplayerdashboard(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1611661328",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from

date_to

date_to

game_segment

game_segment

last_n_games

last_n_games

league_id

league_id

location

location

measure_type

measure_type

month

month

opponent_team_id

opponent_team_id

outcome

outcome

pace_adjust

pace_adjust

plus_minus

plus_minus

po_round

po_round

per_mode

per_mode

period

period

rank

rank

season

season

season_segment

season_segment

season_type

season_type

shot_clock_range

shot_clock_range

team_id

team_id

vs_conference

vs_conference

vs_division

vs_division

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_teamplayeronoffdetails(team_id = '1611661328')
  wnba_teamplayeronoffsummary(team_id = '1611661328')
  wnba_teamplayerdashboard(team_id = '1611661328')

Value

Return a named list of data frames: OverallTeamPlayerOnOffDetails, PlayersOffCourtTeamPlayerOnOffDetails, PlayersOnCourtTeamPlayerOnOffDetails

OverallTeamPlayerOnOffDetails

Columns as documented in the shared wnba_team_summary_overall_schema table.

PlayersOnCourtTeamPlayerOnOffDetails

Columns as documented in the shared wnba_on_off_schema table.

PlayersOffCourtTeamPlayerOnOffDetails

Columns as documented in the shared wnba_on_off_schema table.

Return a named list of data frames: OverallTeamPlayerOnOffSummary, PlayersOffCourtTeamPlayerOnOffSummary, PlayersOnCourtTeamPlayerOnOffSummary

OverallTeamPlayerOnOffSummary

Columns as documented in the shared wnba_team_summary_overall_schema table.

PlayersOnCourtTeamPlayerOnOffSummary

col_name types description
GROUP_SET character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
VS_PLAYER_ID character
VS_PLAYER_NAME character
COURT_STATUS character
GP character Games played.
MIN character Minutes played.
PLUS_MINUS character Plus/minus point differential while on court.
OFF_RATING character Offensive rating (points produced per 100 possessions).
DEF_RATING character Defensive rating (points allowed per 100 possessions).
NET_RATING character Net rating (off rating - def rating).

PlayersOffCourtTeamPlayerOnOffSummary

Same columns as the PlayersOnCourtTeamPlayerOnOffSummary table above.

Return a named list of data frames: PlayersSeasonTotals, TeamOverall

TeamOverall

col_name types description
GROUP_SET character
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
GROUP_VALUE character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

PlayersSeasonTotals

col_name types description
GROUP_SET character
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
NICKNAME character Team or athlete nickname.
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
NBA_FANTASY_PTS character
DD2 character
TD3 character
WNBA_FANTASY_PTS character
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character
NBA_FANTASY_PTS_RANK character
DD2_RANK character
TD3_RANK character
WNBA_FANTASY_PTS_RANK character

Author(s)

Saiem Gilani

See Also

Other WNBA Team Functions: wnba_leaguedashteamstats(), wnba_teamdashboardbyclutch(), wnba_teamdashlineups(), wnba_teamdetails(), wnba_teamestimatedmetrics(), wnba_teamgamelog(), wnba_teamgamelogs(), wnba_teamgamestreakfinder(), wnba_teamhistoricalleaders(), wnba_teaminfocommon(), wnba_teams(), wnba_teamvsplayer(), wnba_teamyearbyyearstats()


Get WNBA Stats API Teams

Description

Get WNBA Stats API Teams

Get WNBA Stats API Teams

Usage

wnba_teams(...)

Arguments

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_teams()

Value

Return a data frame with the following columns:

col_name types description
league_id character League identifier ('10' = WNBA).
season_id character Unique season identifier.
team_id character Unique team identifier.
team_city character Team city or region (e.g. 'Las Vegas').
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
conference character Filter players or teams by conference.
division character Team division.
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_name_full character Team name full.
season character Season identifier (4-digit year or 'YYYY-YY' string).
espn_team_id integer Unique identifier for espn team.
team character Team-side label or team identifier.
mascot character Team mascot.
display_name character Display name.
abbreviation character Short abbreviation.
color character Primary color (hex without leading '#').
alternate_color character Alternate color (hex without leading '#').
logo character Team or league logo URL.
logo_dark character Logo dark.
wnba_logo_svg character Wnba logo svg.

Author(s)

Saiem Gilani

See Also

Other WNBA Team Functions: wnba_leaguedashteamstats(), wnba_teamdashboardbyclutch(), wnba_teamdashlineups(), wnba_teamdetails(), wnba_teamestimatedmetrics(), wnba_teamgamelog(), wnba_teamgamelogs(), wnba_teamgamestreakfinder(), wnba_teamhistoricalleaders(), wnba_teaminfocommon(), wnba_teamplayeronoffdetails(), wnba_teamvsplayer(), wnba_teamyearbyyearstats()


Get WNBA Stats API Team vs Player

Description

Get WNBA Stats API Team vs Player

Get WNBA Stats API Team vs Player

Usage

wnba_teamvsplayer(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "10",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id = "",
  plus_minus = "N",
  rank = "N",
  season = most_recent_wnba_season() - 1,
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1611661328",
  vs_conference = "",
  vs_division = "",
  vs_player_id = "1628932",
  ...
)

Arguments

date_from

date_from

date_to

date_to

game_segment

game_segment

last_n_games

last_n_games

league_id

league_id

location

location

measure_type

measure_type

month

month

opponent_team_id

opponent_team_id

outcome

outcome

po_round

po_round

pace_adjust

pace_adjust

per_mode

per_mode

period

period

player_id

Player ID

plus_minus

plus_minus

rank

rank

season

season

season_segment

season_segment

season_type

season_type

shot_clock_range

shot_clock_range

team_id

team_id

vs_conference

vs_conference

vs_division

vs_division

vs_player_id

vs_player_id

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_teamvsplayer(team_id = '1611661328', vs_player_id = '1628932')

Value

Return a named list of data frames: OnOffCourt, Overall, ShotAreaOffCourt, ShotAreaOnCourt, ShotAreaOverall, ShotDistanceOffCourt, ShotDistanceOnCourt, ShotDistanceOverall, vsPlayerOverall

Overall

col_name types description
GROUP_SET character
GROUP_VALUE character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

vsPlayerOverall

col_name types description
GROUP_SET character
GROUP_VALUE character
PLAYER_ID character Unique player identifier.
GP character Games played.
W character Wins.
L character Losses.
W_PCT character Wins percentage (0-1 decimal).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
NBA_FANTASY_PTS character
DD2 character
TD3 character
WNBA_FANTASY_PTS character
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character
NBA_FANTASY_PTS_RANK character
DD2_RANK character
TD3_RANK character
WNBA_FANTASY_PTS_RANK character

OnOffCourt

Columns as documented in the shared wnba_on_off_schema table.

ShotDistanceOverall

col_name types description
GROUP_SET character
GROUP_VALUE character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).

ShotDistanceOnCourt

col_name types description
GROUP_SET character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
VS_PLAYER_ID character
VS_PLAYER_NAME character
COURT_STATUS character
GROUP_VALUE character
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).

ShotDistanceOffCourt

Same columns as the ShotDistanceOnCourt table above.

ShotAreaOverall

Same columns as the ShotDistanceOverall table above.

ShotAreaOnCourt

Same columns as the ShotDistanceOnCourt table above.

ShotAreaOffCourt

Same columns as the ShotDistanceOnCourt table above.

Author(s)

Saiem Gilani

See Also

Other WNBA Team Functions: wnba_leaguedashteamstats(), wnba_teamdashboardbyclutch(), wnba_teamdashlineups(), wnba_teamdetails(), wnba_teamestimatedmetrics(), wnba_teamgamelog(), wnba_teamgamelogs(), wnba_teamgamestreakfinder(), wnba_teamhistoricalleaders(), wnba_teaminfocommon(), wnba_teamplayeronoffdetails(), wnba_teams(), wnba_teamyearbyyearstats()


Get WNBA Stats API Team Year by Year Stats

Description

Get WNBA Stats API Team Year by Year Stats

Get WNBA Stats API Team Year by Year Stats

Usage

wnba_teamyearbyyearstats(
  league_id = "10",
  per_mode = "Totals",
  season_type = "Regular Season",
  team_id = "1611661328",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League

per_mode

Per Mode

season_type

Season Type - Regular Season, Playoffs, All-Star

team_id

Team ID

...

Additional arguments passed to an underlying function like httr.

Details

 wnba_teamyearbyyearstats(team_id = '1611661328')

Value

Return a named list of data frames: TeamStats

TeamStats

col_name types description
TEAM_ID character Unique team identifier.
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
YEAR character 4-digit year.
GP character Games played.
WINS character Total wins.
LOSSES character Total losses.
WIN_PCT character Win percentage (0-1 decimal).
CONF_RANK character
DIV_RANK character
PO_WINS character
PO_LOSSES character
CONF_COUNT character
DIV_COUNT character
NBA_FINALS_APPEARANCE character
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
PF character Personal fouls.
STL character Steals.
TOV character Turnovers.
BLK character Blocks.
PTS character Points scored.
PTS_RANK character

Author(s)

Saiem Gilani

See Also

Other WNBA Team Functions: wnba_leaguedashteamstats(), wnba_teamdashboardbyclutch(), wnba_teamdashlineups(), wnba_teamdetails(), wnba_teamestimatedmetrics(), wnba_teamgamelog(), wnba_teamgamelogs(), wnba_teamgamestreakfinder(), wnba_teamhistoricalleaders(), wnba_teaminfocommon(), wnba_teamplayeronoffdetails(), wnba_teams(), wnba_teamvsplayer()


Get WNBA Stats API Today's Scoreboard

Description

Get WNBA Stats API Today's Scoreboard

Get WNBA Stats API Today's Scoreboard

Usage

wnba_todays_scoreboard(...)

Arguments

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_todays_scoreboard()

Value

Return a data frame with the following columns:

col_name types description
game_id character Unique game identifier.
game_code character ESPN game code (numeric identifier).
game_status integer Game status label.
game_status_text character Game status display text (e.g. 'Final', '4:32 - 4th').
period integer Period of the game (1-4 quarters; 5+ for OT).
game_clock character Game clock.
game_time_utc character Game start time in UTC (ISO 8601 timestamp).
game_et character Game et.
regulation_periods integer Regulation periods.
series_game_number logical Series game number.
series_text logical Series text.
home_team_id integer Unique identifier for the home team.
home_team_name character Home team name.
home_team_city character Home team city / location.
home_team_tricode character Home team three-letter code.
home_wins integer Home team's wins.
home_losses integer Home team's losses.
home_score integer Home team score at the time of the play.
home_in_bonus character Home team's in bonus.
home_timeouts_remaining integer Home team's timeouts remaining.
home_periods list Home team's periods.
away_team_id integer Unique identifier for the away team.
away_team_name character Away team name.
away_team_city character Away team city / location.
away_team_tricode character Away team three-letter code.
away_wins integer Away team's wins.
away_losses integer Away team's losses.
away_score integer Away team score at the time of the play.
away_in_bonus character Away team's in bonus.
away_timeouts_remaining integer Away team's timeouts remaining.
away_periods list Away team's periods.
home_leaders_person_id integer Unique identifier for home leaders person.
home_leaders_name character Home leaders name.
home_leaders_jersey_num character Home team's leaders jersey num.
home_leaders_position character Home team's leaders position.
home_leaders_team_tricode character Home team's leaders team tricode.
home_leaders_player_slug character Home team's leaders player slug.
home_leaders_points integer Home team's leaders points.
home_leaders_rebounds integer Home team's leaders rebounds.
home_leaders_assists integer Home team's leaders assists.
away_leaders_person_id integer Unique identifier for away leaders person.
away_leaders_name character Away leaders name.
away_leaders_jersey_num character Away team's leaders jersey num.
away_leaders_position character Away team's leaders position.
away_leaders_team_tricode character Away team's leaders team tricode.
away_leaders_player_slug character Away team's leaders player slug.
away_leaders_points integer Away team's leaders points.
away_leaders_rebounds integer Away team's leaders rebounds.
away_leaders_assists integer Away team's leaders assists.
pb_odds_team logical Pb odds team.
pb_odds_odds numeric Pb odds odds.
pb_odds_suspended integer Pb odds suspended.

Author(s)

Saiem Gilani

See Also

Other WNBA Schedule Functions: wnba_schedule(), wnba_scoreboardv2(), wnba_scoreboardv3()

Other WNBA Live Functions: wnba_live_pbp()


Get WNBA Stats API Video Events

Description

Get WNBA Stats API Video Events

Get WNBA Stats API Video Events

Usage

wnba_videoevents(game_id = "1022200075", game_event_id = "10", ...)

Arguments

game_id

game_id

game_event_id

game_event_id

...

Additional arguments passed to an underlying function like httr.

Details

(Possibly Defunct)

  wnba_videoevents(game_id = '1022200075', game_event_id = '10')

Value

Return a list of tibbles: videoUrls, playlist

Author(s)

Saiem Gilani

See Also

Other WNBA Video Functions: wnba_videodetailsasset(), wnba_videostatus()


Get WNBA Stats API Video Status

Description

Get WNBA Stats API Video Status

Get WNBA Stats API Video Status

Usage

wnba_videostatus(game_date = "2022-06-10", league_id = "10", ...)

Arguments

game_date

game_date

league_id

league_id

...

Additional arguments passed to an underlying function like httr.

Details

  wnba_videostatus(game_date = '2022-06-10', league_id = '10')

Value

Return a list of tibbles: VideoStatus

VideoStatus

col_name types description
GAME_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
VISITOR_TEAM_ID character Unique identifier for visitor team.
VISITOR_TEAM_CITY character
VISITOR_TEAM_NAME character
VISITOR_TEAM_ABBREVIATION character
HOME_TEAM_ID character Unique identifier for the home team.
HOME_TEAM_CITY character Home team city / location.
HOME_TEAM_NAME character Home team name.
HOME_TEAM_ABBREVIATION character
GAME_STATUS character Game status label.
GAME_STATUS_TEXT character Game status display text (e.g. 'Final', '4:32 - 4th').
IS_AVAILABLE character
PT_XYZ_AVAILABLE character

Author(s)

Saiem Gilani

See Also

Other WNBA Video Functions: wnba_videodetailsasset(), wnba_videoevents()


Convert a calendar year to a WNBA / NBA season string

Description

Returns a season string of the form YYYY-YY (e.g. 2024 -> "2024-25"). WNBA seasons span a single calendar year, but several Stats API endpoints (and several NBA-derived endpoints used in load helpers) accept the two-year season-string form, so this helper is provided for parity with the analogous helper in the hoopR package.

Usage

year_to_season(year)

Arguments

year

a four-digit calendar year (numeric or character).

Value

A character season string, e.g. "2024-25".