Skip to contents

The teams of a season.

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

Usage

atrium_teams(
  website_id,
  season = NULL,
  season_id = NULL,
  competition_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.

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 wehoop_data tibble, one row per (season_id, entity_id); entity_id is stable across seasons:

col_nametypedescription
website_idintegerSite config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_idcharacterSeason UUID of the team list.
entity_idcharacterTeam UUID (entity): one id per club across seasons, shared by every site that shows the team.
namecharacterTeam name in the site's language.
image_urlcharacterURL of the Sportradar-hosted image (400 px).

Details

Unofficial. This is the public endpoint the Sportradar Atrium / Synergy "Connect" widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last to the host, and it is not republished as release assets. Keep crawls small and incremental.

Sites and seasons. website_id picks the league site; one site carries many competitions. Seasons are END years (season = 2026): the site's own year is the START year on LNB and the calendar year elsewhere, and a year can hold several competitions, so pair season with competition_id (see atrium_seasons()) or pass season_id. atrium_end_year() maps a site's own year to that END year, and atrium_season_id() finds the season UUID.

Columns are configured per site: a statistic one site omits is NA. A key the documented columns do not list is appended with an inferred type. Player and team ids (UUIDs, character) are shared across sites; the player stat tables carry names only, so person_id there is decoded from the widget link beside each name.

Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when the site has nothing for the request (HTTP 404, no such season, an empty fixture list, a game with no play-by-play yet, or a fixture id the site does not serve: an unknown id or a game of another site, which the API answers alike with an empty fixture); wehoop_bad_request for HTTP 400 / 422 or an argument that cannot be mapped (an ambiguous END year, season with season_id); wehoop_asset_fetch for any other failed fetch, an error / stub body, or a body that belongs to another site, type, season, game, player or team than the one asked for.

Examples

# \donttest{
  try(atrium_teams(
    website_id = 12, season = 2026, competition_id = "3f4064bb-51ad-11f0-aaaf-2923c944b404"
  ))
#> ── Atrium teams from embed-api.eui.connect.sportradar.com ────── wehoop 3.1.0 ──
#> ℹ Data updated: 2026-10-22 02:33:55 UTC
#> # A tibble: 16 × 5
#>    website_id season_id                            entity_id     name  image_url
#>         <int> <chr>                                <chr>         <chr> <chr>    
#>  1         12 df310a05-51ad-11f0-bd89-c735508e1e09 238ad480-55b… Dijon https://…
#>  2         12 df310a05-51ad-11f0-bd89-c735508e1e09 25bcb29d-55b… Lyon… https://…
#>  3         12 df310a05-51ad-11f0-bd89-c735508e1e09 506c2d71-55b… Grav… https://…
#>  4         12 df310a05-51ad-11f0-bd89-c735508e1e09 689d1a0a-55b… Sain… https://…
#>  5         12 df310a05-51ad-11f0-bd89-c735508e1e09 703aa4cc-55b… Bour… https://…
#>  6         12 df310a05-51ad-11f0-bd89-c735508e1e09 736b73ae-55b… Mona… https://…
#>  7         12 df310a05-51ad-11f0-bd89-c735508e1e09 7e9f3d8d-55b… Le M… https://…
#>  8         12 df310a05-51ad-11f0-bd89-c735508e1e09 88bff512-55b… Stra… https://…
#>  9         12 df310a05-51ad-11f0-bd89-c735508e1e09 989c44aa-55b… Chal… https://…
#> 10         12 df310a05-51ad-11f0-bd89-c735508e1e09 9ebf8651-55b… Le P… https://…
#> 11         12 df310a05-51ad-11f0-bd89-c735508e1e09 c281453b-55b… Chol… https://…
#> 12         12 df310a05-51ad-11f0-bd89-c735508e1e09 c3b5d870-55b… Boul… https://…
#> 13         12 df310a05-51ad-11f0-bd89-c735508e1e09 ca771ea2-55b… Limo… https://…
#> 14         12 df310a05-51ad-11f0-bd89-c735508e1e09 da0b634d-55b… Nancy https://…
#> 15         12 df310a05-51ad-11f0-bd89-c735508e1e09 e796c4fa-55b… Nant… https://…
#> 16         12 df310a05-51ad-11f0-bd89-c735508e1e09 f43b1b0f-55b… Paris https://…
# }