Get BBL / DBBL Season Player Profile

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).

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.

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

Usage

Arguments

Value

Details

See also