Overview

Searches Transfermarkt entities by a free-text term and returns matching IDs grouped by entity type. Use it to resolve clubs, coaches, competitions, consultants, players, or referees before calling a detail endpoint.

Inputs

term (string, optional): Search phrase. Defaults to an empty string. Example: Arsenal.

Response

A successful response has:

success (boolean)
message (string)
data.result (object) containing arrays of string IDs grouped as clubIds, coachIds, competitionIds, consultantIds, playerIds, and refereeIds.
data.totalCount (object) containing numeric counts for clubs, coaches, competitions, consultantCompanies, players, and referees.

Auth & browser

Authentication is not required. The endpoint is a direct GET request and does not require browser context or fetch execution.

Examples

Request

{"term":"Arsenal"}

Success response

Verified response (IDs shortened only by omission where appropriate):

{
  "success": true,
  "message": "OK",
  "data": {
    "result": {
      "clubIds": ["11", "41571", "9249", "3729", "72822", "19077", "37989", "4673", "4093", "5679"],
      "coachIds": ["35588"],
      "competitionIds": [],
      "consultantIds": [],
      "playerIds": [],
      "refereeIds": []
    },
    "totalCount": {
      "clubs": 77,
      "coaches": 1,
      "competitions": 0,
      "consultantCompanies": 0,
      "players": 0,
      "referees": 0
    }
  }
}

Notes

Entity ID arrays are returned separately, so the same term can match multiple entity types.
The verified Arsenal search returned 77 club matches and one coach match; empty arrays indicate no matches for that entity type.
The response contains IDs rather than full entity records. Use the appropriate detail endpoint with a returned ID.