SoccersAPIDocsv2.2

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

Route reference

Operations

The t query parameter selects the operation. Parameters not listed for an operation are ignored.

t Operation Required Optional
match Search matches. Upcoming and recent matches whose teams or competition match q, with kickoff date, teams and league. q utc
league Search leagues. Leagues matching q, with country. q —
team Search teams. Teams whose name matches q. q —
player Search players. Players whose name matches q. q —
referee Search referees. Referees whose name matches q. q —
country Search countries. Countries whose name matches q, with country code. q —
continent Search continents. Continents whose name matches q. q —
tv Search TV channels. TV channels matching q, for use with broadcast operations. q —

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/?api_key=API_KEY&t=match&q=salzburg

Search leagues:

GET /v2.2/search/?api_key=API_KEY&t=league&q=bundesliga

Search teams:

GET /v2.2/search/?api_key=API_KEY&t=team&q=barcelona

Search players:

GET /v2.2/search/?api_key=API_KEY&t=player&q=ronaldo

Search referees:

GET /v2.2/search/?api_key=API_KEY&t=referee&q=clattenburg

Search countries:

GET /v2.2/search/?api_key=API_KEY&t=country&q=austria

Search continents:

GET /v2.2/search/?api_key=API_KEY&t=continent&q=europe

Search TV channels:

GET /v2.2/search/?api_key=API_KEY&t=tv&q=dazn