Skip to contents

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 = "bbl")

Arguments

team_id

(required) Club id (team_id in scb_season_teams), e.g. 413 (ALBA BERLIN).

league

(default "bbl") 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).

Value

A hoopR_data tibble: Club profile: names, code, home page, ticket shop, year joined and honours. An empty valid answer raises hoopR_no_data; the columns are always these, in this order (sportsdataverse-py scb_team):

col_nametypedescription
leaguecharacterLeague the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
team_idcharacterClub id, a string; equal to season_team_id in every sample. Joins to scb_team and scb_season_teams.
tlccharacterThree-letter club code.
name_fullcharacterFull club name as the API lists it today.
name_shortcharacterShort name (often the city); null on DBBL.
mascotcharacterClub mascot name (null when none).
homepage_urlcharacterClub website address as sent (it can lack the scheme).
ticket_urlcharacterTicket shop URL.
year_joined_bblintegerYear the club joined the league.
order_idintegerDisplay order of the club on the site; null on some clubs.
best_achievementscharacterHonours, German free text (Deutscher Meister = German champion, Pokalsieger = cup winner, Vizepokalsieger = cup runner-up).

Details

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

 scb_team(team_id = "413")