Skip to contents

Search players, teams and coaches by name.

One row per hit; kind is player, team or coach. The sample holds players only (teams and coaches came back empty), so the team and coach row shapes are unverified. person_id is the licence number for players and coaches (a team hit carries its team entry id).

Endpoint: GET https://api2.acb.com/api/seasondata/Search/search

Usage

acb_search(search_term, limit = NULL)

Arguments

search_term

(required) Name fragment (accent-insensitive on the player rows); a blank term is refused.

limit

(default NULL) Maximum results per kind (players, teams, coaches). A whole number; a whole double is accepted.

Value

A hoopR_data tibble, one row per record described above; the columns are always these, in this order (sportsdataverse-py acb_search):

col_nametypedescription
kindcharacterplayer, team or coach.
person_idintegerACB licence number (players, coaches) or the team entry id (teams).
namecharacterDisplay name (nickname) of a player or coach; the team name of a team.
short_namecharacterShort display name ('T. Martin').
first_namecharacterLegal first name(s)
last_namecharacterLegal last name(s)
shirt_numbercharacterShirt number, a string (” or null when unknown)
game_rolecharacterPosition or staff role, in Spanish: Base (point guard), Escolta (shooting guard), Alero (small forward), Ala-pivot (power forward), Pivot (centre); Entrenador (head coach), Segundo Entrenador / Entrenador Ayudante (assistant coach). Null or ” in many rows
is_license_activelogicalThe licence is active in the current season
club_idintegerStable club id of a team hit; null for players.
edition_idintegerSeason id of the record; null in search results.
seasonintegerSeason END year (2027 = 2026-27) = edition_id + 1936: the key the wrappers take.

Details

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

 acb_search(limit = 5, search_term = "tavares")