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
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. |
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).
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
# \donttest{
try(tbf_seasons())
#> ── TBF Seasons ───────────────────────────────────────────────── wehoop 3.1.0 ──
#> ℹ Data updated: 2026-10-22 03:25:45 UTC
#> # A tibble: 20 × 6
#> season_id season_label season start_date end_date international
#> <int> <chr> <int> <date> <date> <lgl>
#> 1 175 UA-2026-2027 2027 2026-10-01 2027-09-30 TRUE
#> 2 174 2026-2027 2027 2026-07-01 2027-06-30 FALSE
#> 3 173 UA-2025-2026 2026 2025-10-01 2026-09-30 TRUE
#> 4 172 2025-2026 2026 2025-07-01 2026-06-30 FALSE
#> 5 171 UA-2024-2025 2025 2024-10-01 2025-09-30 TRUE
#> 6 170 2024-2025 2025 2024-07-01 2025-06-30 FALSE
#> 7 169 UA-2023-2024 2024 2023-10-01 2024-09-30 TRUE
#> 8 168 2023-2024 2024 2023-07-01 2024-06-30 FALSE
#> 9 167 UA-2022-2023 2023 2022-10-01 2023-09-30 TRUE
#> 10 166 2022-2023 2023 2022-07-01 2023-06-30 FALSE
#> 11 165 UA-2021-2022 2022 2021-10-01 2022-09-30 TRUE
#> 12 164 2021-2022 2022 2021-07-01 2022-06-30 FALSE
#> 13 163 UA-2020-2021 2021 2020-10-01 2021-09-30 TRUE
#> 14 162 2020-2021 2021 2020-07-01 2021-06-30 FALSE
#> 15 161 UA-2019-2020 2020 2019-10-01 2020-09-30 TRUE
#> 16 160 2019-2020 2020 2019-07-01 2020-06-30 FALSE
#> 17 159 UA-2018-2019 2019 2018-10-01 2019-09-30 TRUE
#> 18 158 2018-2019 2019 2018-07-01 2019-06-30 FALSE
#> 19 157 UA-2017-2018 2018 2017-10-01 2018-09-30 TRUE
#> 20 156 2017-2018 2018 2017-07-01 2018-06-30 FALSE
# }