Docs › Reference › Search › Search players

GETSearch players

Players whose name matches q.

/v2.2/search/ with t=player

Try it in the interactive reference All Search operations

Request

GET /v2.2/search/?user=USER&token=TOKEN&t=player&q=ronaldo

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": 155067,
      "name": "Abarca, Ronaldo",
      "type": "player"
    },
    {
      "id": 208615449,
      "name": "Afonso, Ronaldo",
      "type": "player"
    }
  ],
  "meta": {
    "requests_left": 2950,
    "user": "your_username",
    "plan": "Soccer API 50",
    "page": 1,
    "pages": 1,
    "count": 0,
    "total": 0,
    "msg": ""
  }
}