Search
Find matches and football entities by keyword. Results are lightweight: they carry the ID and the display name needed to call the resource endpoints, plus a type discriminator.
Open in the interactive reference
Operations
- GETSearch matches — Upcoming and recent matches whose teams or competition match
q, with kickoff date, teams and league. - GETSearch leagues — Leagues matching
q, with country. - GETSearch teams — Teams whose name matches
q. - GETSearch players — Players whose name matches
q. - GETSearch referees — Referees whose name matches
q. - GETSearch countries — Countries whose name matches
q, with country code. - GETSearch continents — Continents whose name matches
q. - GETSearch TV channels — TV channels matching
q, for use with broadcast operations.
Route reference
Operations
The t query parameter selects the operation. Parameters not listed for an operation are ignored. The theme column marks datasets that themed plans (Odds, Broadcast) include only for their own theme; Free and Standard plans include every theme for their leagues.
t |
Operation | Required | Optional | Theme |
|---|---|---|---|---|
match |
Search matches. Upcoming and recent matches whose teams or competition match q, with kickoff date, teams and league. |
q |
utc |
core |
league |
Search leagues. Leagues matching q, with country. |
q |
— | core |
team |
Search teams. Teams whose name matches q. |
q |
— | core |
player |
Search players. Players whose name matches q. |
q |
— | core |
referee |
Search referees. Referees whose name matches q. |
q |
— | core |
country |
Search countries. Countries whose name matches q, with country code. |
q |
— | core |
continent |
Search continents. Continents whose name matches q. |
q |
— | core |
tv |
Search TV channels. TV channels matching q, for use with broadcast operations. |
q |
— | broadcast |
t=channel is accepted as an alias of t=tv. Search responses are not paginated and report meta.count and meta.total as 0; use the length of data.
Examples
Search matches:
GET /v2.2/search/?user=USER&token=TOKEN&t=match&q=salzburg
Search leagues:
GET /v2.2/search/?user=USER&token=TOKEN&t=league&q=bundesliga
Search teams:
GET /v2.2/search/?user=USER&token=TOKEN&t=team&q=barcelona
Search players:
GET /v2.2/search/?user=USER&token=TOKEN&t=player&q=ronaldo
Search referees:
GET /v2.2/search/?user=USER&token=TOKEN&t=referee&q=clattenburg
Search countries:
GET /v2.2/search/?user=USER&token=TOKEN&t=country&q=austria
Search continents:
GET /v2.2/search/?user=USER&token=TOKEN&t=continent&q=europe
Search TV channels:
GET /v2.2/search/?user=USER&token=TOKEN&t=tv&q=dazn