v1

latestOpenAPI 3.0.32026-07-176925.3 KB

Search entities by name

Full-text search across players, teams, coaches, and competitions by name or alias. Seasons and matches are excluded from default search to avoid noise; use type=season or type=match explicitly when you want those entity classes. Uses prefix matching with BM25 relevance ranking (e.g. "Cole Palm" matches "Cole Palmer"). Diacritics-insensitive ("Muller" matches "Müller").

get/search

Query parameters

namestring required

Name to search for (prefix matching on name and aliases)

type'player' | 'team' | 'coach' | 'competition' | 'season' | 'match'

Filter by entity type

limitinteger

Maximum results to return

targetsstring

Comma-separated list of provider names to include in external_ids. When omitted, the full cross-provider ID map is returned. When set, only the named providers appear in external_ids, and the qid convenience field is populated only if wikidata is in the list. Unknown provider names are silently ignored. Useful for trimming response size when you only need one or two target IDs per match.

Response

Search results ranked by relevance

countinteger