Skip to contents

The players of a season, with position, nationality, birth date, age and height.

Endpoint: GET https://embed-api.eui.connect.sportradar.com/v1/embed/{website_id}/persons

height is an integer where the site gives one (centimetres; unit unverified). position_code / position_name follow the site locale (the name is translated, the code is not). person_id is stable across seasons and sites.

Usage

atrium_players(
  website_id,
  season = NULL,
  season_id = NULL,
  competition_id = NULL,
  entity_id = NULL,
  locale = NULL
)

Arguments

website_id

(integer required): Site config id: which league site's widget this is (12 LNB France, 14 LNBP Mexico, 3 NBL1 Australia, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro). Not a league id: one site serves several competitions.

season

(integer optional): Season END year (2026 = 2025-26 on LNB, site 12, whose own year is the START year; the calendar year on the other sites). Needs competition_id when several competitions share that year (see atrium_seasons()). Omit season and season_id for the site's default season.

season_id

(character optional): Season UUID (season_id in atrium_seasons()); sent as is, skipping the END-year lookup of season.

competition_id

(character optional): Competition UUID (competition_id in atrium_seasons()). Picks the season together with season, and is then not sent; with neither season nor season_id the API filters by it.

entity_id

(character optional): Team UUID (entity_id in atrium_teams() or any fixture row).

locale

(character optional): Locale of the labels, e.g. "en-EN" or "fr-FR". Omitted = the site's own language. Ids and codes never change.

Value

A hoopR_data tibble with one row per (season_id, person_id). Its columns are listed in return_columns (subset(return_columns, fn == "atrium_players")) and in the searchable return columns article.

Details

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

Examples

# \donttest{
  try(atrium_players(
    website_id = 12, season = 2026, competition_id = "3f4064bb-51ad-11f0-aaaf-2923c944b404"
  ))
#> ── Atrium players from embed-api.eui.connect.sportradar.com ───── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:10:40 UTC
#> # A tibble: 294 × 15
#>    website_id season_id  person_id name  bib   entity_id team_name position_code
#>         <int> <chr>      <chr>     <chr> <chr> <chr>     <chr>     <chr>        
#>  1         12 df310a05-… 01173036… Isma… 21    f43b1b0f… Paris     C            
#>  2         12 df310a05-… 03e0ef50… Juha… 23    736b73ae… Monaco    GF           
#>  3         12 df310a05-… 0602120f… Jare… NA    f43b1b0f… Paris     NA           
#>  4         12 df310a05-… 06ded7ee… Dayl… 2     c281453b… Cholet    SG           
#>  5         12 df310a05-… 08ee670c… John… 8     7e9f3d8d… Le Mans   GF           
#>  6         12 df310a05-… 095e7eb6… Davi… 4     7e9f3d8d… Le Mans   FC           
#>  7         12 df310a05-… 0a26b3fe… Just… 1     238ad480… Dijon     PG           
#>  8         12 df310a05-… 0b6849a9… Just… 5     f43b1b0f… Paris     PG           
#>  9         12 df310a05-… 0c8e19b5… Cat … 1     689d1a0a… Saint-Qu… GF           
#> 10         12 df310a05-… 16742263… Aaro… 79    c281453b… Cholet    PG           
#> # ℹ 284 more rows
#> # ℹ 7 more variables: position_name <chr>, nationality <chr>,
#> #   date_of_birth <date>, age <int>, height <int>, status <chr>,
#> #   image_url <chr>
# }