For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

Last updated

Was this helpful?