Docs › Reference › Search › Search leagues

GETSearch leagues

Leagues matching q, with country.

/v2.2/search/ with t=league

Try it in the interactive reference All Search operations

Request

GET /v2.2/search/?user=USER&token=TOKEN&t=league&q=bundesliga

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`

Example response

{
  "data": [
    {
      "id": 1855,
      "name": "2. Bundesliga, Women",
      "country_name": "Germany",
      "cc": "de",
      "type": "league"
    },
    {
      "id": 592,
      "name": "2nd Bundesliga",
      "country_name": "Germany",
      "cc": "de",
      "type": "league"
    }
  ],
  "meta": {
    "requests_left": 2950,
    "user": "your_username",
    "plan": "Soccer API 50",
    "page": 1,
    "pages": 1,
    "count": 0,
    "total": 0,
    "msg": ""
  }
}