Search

The search tool is usually the right starting point. Use it to find the ID of a player, team, or league before calling other tools.

Tool

Tool	Description
search	Search players, teams, leagues, or all entity types by name

Parameters

Parameter	Type	Required	Description
query	string	Yes	Name or partial name to search for
type	string	No	Entity type to search: player, team, league, or all. Defaults to all

Response

Returns up to 25 results sorted alphabetically. Each result includes:

{
  "id": 123,
  "entity_type": "team",
  "name": "Arsenal",
  "country": "England"
}

The country field helps disambiguate results where many entities share the same name (e.g. multiple leagues named "Super League" across different countries).

Example prompts

• Search for "Arsenal"

• Search for players named "Silva"

• Find the league ID for the Premier League

• Search for "Haaland" - player only