Overview

Returns structured overview information for a football club identified by its TransferMarkt club ID. Use it to retrieve the club’s identity, basic attributes, squad valuation summary, preferences, historical names and images, and crest URL.

Inputs

id (string, required): TransferMarkt club identifier. Example: 418 for Real Madrid.

Response

The endpoint returns a JSON object with success, message, and data fields.

The data object includes:

id (string): Club identifier.
name (string): Current club name.
baseDetails (object): Core club metadata, including shortName, abbreviation, isNationalTeam, countryId, mainClubId, clubTypeId, primaryCompetitionId, and optional parent/superior club information.
squadDetails (object): Squad summary, including squadSize, averageAge, averageAgeDisplay, and market-value totals such as averageMarketValue, acquisitionValue, top18PlayersMarketValue, top18SharePercentage, and currentMarketValue. Monetary values contain a numeric value, currency, compact display fields, and a determined date.
preferences (object): Club display preferences such as themeId and clubCode.
metadata (object): Source timestamps, including created and updated when available.
relativeUrl (string): Relative TransferMarkt club URL.
isSpecialClub (boolean): Whether the club is marked as a special club.
historical (object): Historical club names and images. Arrays may be shortened in sampled responses.
identifier (string): Display identifier combining the club name and ID.
crestUrl (string): URL for the current club crest image.

Auth & browser

No authentication is required by the endpoint. The request is sent directly to the configured API URL and does not require a browser context.

Examples

Request

{
  "id": "418"
}

Success response

{
  "success": true,
  "message": "OK",
  "data": {
    "id": "418",
    "name": "Real Madrid",
    "baseDetails": {
      "shortName": "Real Madrid",
      "abbreviation": "RMCF",
      "isNationalTeam": false,
      "countryId": 157,
      "mainClubId": "418",
      "clubTypeId": 1,
      "primaryCompetitionId": "ES1"
    },
    "squadDetails": {
      "squadSize": 27,
      "averageAge": 25.99,
      "averageAgeDisplay": "26.0",
      "averageMarketValue": {
        "value": 53944444,
        "currency": "EUR",
        "compact": { "prefix": "€", "content": "53.94", "suffix": "M" },
        "determined": "2026-09-23"
      },
      "currentMarketValue": {
        "value": 1456500000,
        "currency": "EUR",
        "compact": { "prefix": "€", "content": "1.46", "suffix": "B" },
        "determined": "2026-09-23"
      }
    },
    "preferences": { "themeId": 0, "clubCode": "RMA" },
    "relativeUrl": "/real-madrid/startseite/verein/418",
    "isSpecialClub": false,
    "identifier": "Real Madrid (418)",
    "crestUrl": "https://img.a.transfermarkt.technology/wappen/big/418.png?lm=1789459190"
  }
}

The verified response also included superiorClub, acquisitionValue, top18PlayersMarketValue, top18SharePercentage, metadata, and historical data. The example is shortened from the verified result; historical arrays can contain additional entries.

Notes

Club IDs are strings in the request and response.
Market-value amounts provide both raw numeric values and compact, presentation-oriented values. Use the raw value for calculations and compact for display.
The market-value determined date identifies when the valuation was recorded.
Historical names and images are variable-length arrays and may be absent or empty for some clubs.