Docs › Reference › Search › Search matches

GETSearch matches

Upcoming and recent matches whose teams or competition match q, with kickoff date, teams and league.

/v2.2/search/ with t=match

Try it in the interactive reference All Search operations

Request

GET /v2.2/search/?user=USER&token=TOKEN&t=match&q=salzburg

Every request needs the user and token query parameters of the account.

Parameters

Name	Required	Description	Example
`q`	yes	Search text: part of a team, league, player, referee, country, continent or TV channel name. At least 3 characters; shorter terms return `400`.	`salzburg`
`utc`	no	UTC offset applied to returned date/time values; `time.timezone` reports it, for example `UTC+4.5`. Decimal offsets are accepted and invalid values fall back to UTC.	`2`

Example response

{
  "data": [
    {
      "id": 2612624,
      "startdate": "2026-09-04 17:00:00",
      "name": "Sak salzburg vs Atsv salzburg",
      "home": "Sak salzburg",
      "away": "Atsv salzburg",
      "league_name": "Regionalliga Salzburg",
      "country_name": "Austria",
      "cc": "at",
      "type": "match"
    },
    {
      "id": 2598573,
      "startdate": "2026-09-05 14:30:00",
      "name": "Austria salzburg vs First vienna",
      "home": "Austria salzburg",
      "away": "First vienna",
      "league_name": "OFB Cup",
      "country_name": "Austria",
      "cc": "at",
      "type": "match"
    }
  ],
  "meta": {
    "requests_left": 2950,
    "user": "your_username",
    "plan": "Soccer API 50",
    "page": 1,
    "pages": 1,
    "count": 0,
    "total": 0,
    "msg": ""
  }
}