Skip to contents

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 hoopR_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. Default: every competition.

Value

A hoopR_data tibble with one row per game with its group_name. Its columns are listed in return_columns (subset(return_columns, fn == "tbf_daily_matches")) and in the searchable return columns article.

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. TBF's terms were not reviewed; check them before you republish the data. 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 hoopR_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 hoopR_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: hoopR_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); hoopR_bad_request for an invalid argument or HTTP 400 / 422; hoopR_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 hoopR_error. Timestamps are Turkey local time (Europe/Istanbul).

See also

family_tbf lists every function in this family.

Examples

# \donttest{
  try(tbf_daily_matches(match_date = "2026-10-11"))
#> ── TBF Daily Matches ──────────────────────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:17:47 UTC
#> # A tibble: 11 × 27
#>    group_name  match_id match_code genius_id activity_id activity_name 
#>    <chr>          <int> <chr>          <int>       <int> <chr>         
#>  1 Lig Maçları   346293 1EA4931      2934620       22214 BSL 2026-2027 
#>  2 Lig Maçları   345705 1BA3543      2934717       22209 KBSL 2026-2027
#>  3 Lig Maçları   345955 2EA5768      2934688       22215 TBL 2026-2027 
#>  4 Lig Maçları   346294 1EA4932      2934621       22214 BSL 2026-2027 
#>  5 Lig Maçları   345804 2BA5083      2935642       22210 TKBL 2026-2027
#>  6 Lig Maçları   345954 2EA5767      2934698       22215 TBL 2026-2027 
#>  7 Lig Maçları   346639 3EA3359      2935638       22223 TB2L 2026-2027
#>  8 Lig Maçları   346640 3EA3360      2935639       22223 TB2L 2026-2027
#>  9 Lig Maçları   345953 2EA5766      2934702       22215 TBL 2026-2027 
#> 10 Lig Maçları   345958 2EA5771      2934705       22215 TBL 2026-2027 
#> 11 Lig Maçları   346292 1EA4930      2934625       22214 BSL 2026-2027 
#> # ℹ 21 more variables: competition <chr>, season_id <int>, season_label <chr>,
#> #   season <int>, tipoff <dttm>, match_date <date>, week <chr>, phase <int>,
#> #   status_id <int>, home_team_process_id <int>, home_team <chr>,
#> #   home_score <int>, away_team_process_id <int>, away_team <chr>,
#> #   away_score <int>, venue <chr>, province <chr>, gender <chr>,
#> #   broadcast_channel <chr>, has_overtime <lgl>, status <chr>
# }