Search entities by free-text query

General-purpose lookup for finding entities by name. Unlike exact-match endpoints (e.g. /countries), this endpoint tolerates misspellings, abbreviations, and alternate phrasings — useful for search-as-you-type UI and for mapping a free-text mention onto a canonical entity ID that can be passed to other endpoints.
Results are grouped by entity type; only the types requested are included in the response. Currently supported: country, league, team, fixture.
fixture search only covers matches in a rolling window from a few hours ago to about a week ahead, in top-tier leagues — i.e. upcoming fixtures and recently finished ones.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

The search text.

types
array of strings
required

Comma-separated list of entity types to search. Currently: country, league, team, fixture.

types*
Allowed:
integer
1 to 20
Defaults to 5

Maximum results per type.

string
enum
Defaults to en

Language for localized entity names.

Allowed:
Responses

403

Unauthorized — missing or insufficient permissions.

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json