Skip to contents

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

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_nametypedescription
seasonintegerSeason 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).
competitioncharacterTBF league the row belongs to: bsl, tbl or kbsl (the request's competition, or the league prefix the API reports).
team_process_idintegerTeam-season id of the request (key space: TBF team registrations).
person_idintegerTBF person id (code; key space: TBF persons, stable across seasons and clubs).
jersey_numbercharacterShirt number (oyuncuNo) as a string.
first_namecharacterPlayer's first name.
last_namecharacterPlayer's last name.
gamesintegerGames played (macSayisi).
seconds_playedintegerSeason total time on court in seconds (sureToplam 'hh:mm:ss').
pointsintegerSeason total points (sayiToplam; the API sends it as a string).
fg_madeintegerSeason field goals made (agBasarili; sent as a string).
fg_attemptedintegerSeason field goals attempted (agDeneme).
fg2_madeintegerSeason two-point field goals made (puan20Toplam).
fg2_attemptedintegerSeason two-point field goals attempted (puan21Toplam).
fg3_madeintegerSeason three-point field goals made (puan30Toplam).
fg3_attemptedintegerSeason three-point field goals attempted (puan31Toplam).
ft_madeintegerSeason free throws made (sA0Toplam).
ft_attemptedintegerSeason free throws attempted (sA1Toplam).
def_reboundsintegerSeason defensive rebounds (drToplam).
off_reboundsintegerSeason offensive rebounds (hrToplam).
reboundsintegerSeason total rebounds (trToplam).
assistsintegerSeason assists (asistToplam).
blocksintegerSeason blocks (blokToplam).
stealsintegerSeason steals (topCalmaToplam).
turnoversintegerSeason turnovers (topKaybiToplam).
foulsintegerSeason personal fouls (faulToplam).
plus_minusdoubleSeason plus/minus contribution (oyunaKatki = contribution to the game), a decimal string.
efficiencyintegerSeason efficiency rating total (vpToplam, verimlilik puani).
fg_pctdoubleField-goal percentage 0-100 with two decimals (agYuzdesi).
fg2_pctdoubleTwo-point percentage 0-100 with two decimals (ikilikYuzdesi).
fg3_pctdoubleThree-point percentage 0-100 with two decimals (uclukYuzdesi).
ft_pctdoubleFree-throw percentage 0-100 with two decimals (serbestAtisYuzdesi).
seconds_per_gameintegerAverage time on court per game in seconds (sureOrtalama 'hh:mm:ss').
points_per_gamedoublePoints per game (sayiOrtalama).
rebounds_per_gamedoubleRebounds per game (trOrtalama).
assists_per_gamedoubleAssists per game (asistOrtalama).
steals_per_gamedoubleSteals per game (topCalmaOrtalama).
blocks_per_gamedoubleBlocks per game (blokOrtalama).
turnovers_per_gamedoubleTurnovers per game (topKaybiOrtalama).
efficiency_per_gamedoubleEfficiency rating per game (vpOrtalama).

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)