Transfermarkt Scraper

ENDPOINTS
GET/clubs/profile

Club Details

Club card: league, squad size and value, stadium, address, transfer record, top signings and top scorers.

QUERY PARAMS

Transfermarkt club ID or any transfermarkt.com club URL (national teams are clubs too).

Examples:

  • ID: 418
  • URL: https://www.transfermarkt.com/real-madrid/startseite/verein/418
{
  "id": 418,
  "name": "Real Madrid",
  "short_name": "Real Madrid",
  "abbreviation": "RMCF",
  "official_name": "Real Madrid Club de Fútbol",
  "link": "https://www.transfermarkt.com/real-madrid/startseite/verein/418",
  "crest": "https://img.a.transfermarkt.technology/wappen/big/418.png?lm=1789459190",
  "country": {
    "id": 157,
    "name": "Spain",
    "code": "ESP"
  },
  "is_national_team": false,
  "competition": {
    "id": "ES1",
    "name": "LaLiga",
    "link": "https://www.transfermarkt.com/laliga/startseite/wettbewerb/ES1",
    "logo": "https://img.a.transfermarkt.technology/logo/medium/es1.png?lm=1789377130",
    "country": {
      "id": 157,
      "name": "Spain",
      "code": "ESP"
    },
    "confederation": {
      "id": 6,
      "name": "UEFA"
    },
    "tier": "First Tier",
    "is_tournament": false
  },
  "league_tier": "First Tier",
  "table_position": 2,
  "in_league_since": "88 years",
  "founded": "1902-03-06",
  "members": 95612,
  "colors": [
    "#FFFFFF",
    "#004996"
  ],
  "address": {
    "street": "Avenida de Concha Espina 1",
    "postcode": "28036",
    "city": "Madrid",
    "country": {
      "id": 157,
      "name": "Spain",
      "code": "ESP"
    },
    "latitude": 40.4523571,
    "longitude": -3.6867885
  },
  "address_text": "Avenida de Concha Espina 1 28036 Madrid Spain",
  "phone": "+34 91 3984300",
  "fax": "+34 91 3984382",
  "website": "https://realmadrid.com",
  "stadium": {
    "name": "Santiago Bernabéu",
    "capacity": 83186,
    "link": "https://www.transfermarkt.com/real-madrid/stadion/verein/418"
  },
  "squad": {
    "size": 27,
    "average_age": 25.98,
    "foreigners_count": 20,
    "foreigners_percent": 74.1,
    "national_team_players": 20,
    "total_market_value": {
      "amount": 1456500000,
      "currency": "EUR",
      "updated_at": "2026-09-18"
    },
    "average_market_value": {
      "amount": 53944444,
      "currency": "EUR",
      "updated_at": "2026-09-18"
    },
    "acquisition_value": {
      "amount": 909500000,
      "currency": "EUR",
      "updated_at": "2026-09-18"
    },
    "top_18_market_value": {
      "amount": 1312000000,
      "currency": "EUR",
      "updated_at": "2026-09-18"
    },
    "top_18_share_percent": 90.08
  },
  "transfer_record": {
    "current_balance": {
      "amount": -166500000,
      "currency": "EUR"
    },
    "income": {
      "players": 9,
      "total": {
        "amount": 58500000,
        "currency": "EUR"
      }
    },
    "expenditure": {
      "players": 10,
      "total": {
        "amount": 225000000,
        "currency": "EUR"
      }
    }
  },
  "top_arrivals": [
    {
      "player": {
        "id": 1390649,
        "name": null,
        "link": "https://www.transfermarkt.com/yan-diomande/profil/spieler/1390649",
        "image": "https://img.a.transfermarkt.technology/portrait/medium/1390649-1759779499.jpg?lm=4711",
        "position": null
      },
      "club": {
        "id": 23826,
        "name": "RB Leipzig",
        "link": "https://www.transfermarkt.com/rasenballsport-leipzig/startseite/verein/23826",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/23826.png?lm=1789460400"
      },
      "fee": {
        "amount": 125000000,
        "currency": "EUR",
        "type": "transfer"
      }
    },
    {
      "player": {
        "id": 284857,
        "name": null,
        "link": "https://www.transfermarkt.com/marc-cucurella/profil/spieler/284857",
        "image": "https://img.a.transfermarkt.technology/portrait/medium/284857-1765185117.jpg?lm=4711",
        "position": null
      },
      "club": {
        "id": 631,
        "name": "Chelsea FC",
        "link": "https://www.transfermarkt.com/fc-chelsea/startseite/verein/631",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/631.png?lm=1789459205"
      },
      "fee": {
        "amount": 55000000,
        "currency": "EUR",
        "type": "transfer"
      }
    },
    {
      "player": {
        "id": 357119,
        "name": null,
        "link": "https://www.transfermarkt.com/ibrahima-konate/profil/spieler/357119",
        "image": "https://img.a.transfermarkt.technology/portrait/medium/357119-1669190550.jpg?lm=4711",
        "position": null
      },
      "club": {
        "id": 31,
        "name": "Liverpool FC",
        "link": "https://www.transfermarkt.com/fc-liverpool/startseite/verein/31",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/31.png?lm=1789459168"
      },
      "count": null
    },
    {
      "player": {
        "id": 321528,
        "name": null,
        "link": "https://www.transfermarkt.com/denzel-dumfries/profil/spieler/321528",
        "image": "https://img.a.transfermarkt.technology/portrait/medium/321528-1746042223.jpg?lm=4711",
        "position": null
      },
      "club": {
        "id": 46,
        "name": "Inter Milan",
        "link": "https://www.transfermarkt.com/inter-mailand/startseite/verein/46",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/46.png?lm=1789459168"
      },
      "fee": {
        "amount": 20000000,
        "currency": "EUR",
        "type": "transfer"
      }
    },
    {
      "player": {
        "id": 1063338,
        "name": null,
        "link": "https://www.transfermarkt.com/carlos-espi/profil/spieler/1063338",
        "image": "https://img.a.transfermarkt.technology/portrait/medium/1063338-1759409131.jpg?lm=4711",
        "position": null
      },
      "club": {
        "id": 3368,
        "name": "Levante UD",
        "link": "https://www.transfermarkt.com/ud-levante/startseite/verein/3368",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/3368.png?lm=1789459344"
      },
      "fee": {
        "amount": 25000000,
        "currency": "EUR",
        "type": "transfer"
      }
    }
  ],
  "top_departures": [
    {
      "player": {
        "id": 1057316,
        "name": null,
        "link": "https://www.transfermarkt.com/franco-mastantuono/profil/spieler/1057316",
        "image": "https://img.a.transfermarkt.technology/portrait/medium/1057316-1755702696.jpg?lm=4711",
        "position": null
      },
      "club": {
        "id": 430,
        "name": "ACF Fiorentina",
        "link": "https://www.transfermarkt.com/ac-florenz/startseite/verein/430",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/430.png?lm=1789459191"
      },
      "count": null
    },
    {
      "player": {
        "id": 935230,
        "name": null,
        "link": "https://www.transfermarkt.com/gonzalo-garcia/profil/spieler/935230",
        "image": "https://img.a.transfermarkt.technology/portrait/medium/935230-1780664637.jpg?lm=4711",
        "position": null
      },
      "club": {
        "id": 931,
        "name": "Fulham FC",
        "link": "https://www.transfermarkt.com/fc-fulham/startseite/verein/931",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/931.png?lm=1789459221"
      },
      "fee": {
        "amount": 40000000,
        "currency": "EUR",
        "type": "transfer"
      }
    },
    {
      "player": {
        "id": 948273,
        "name": null,
        "link": "https://www.transfermarkt.com/mario-martin/profil/spieler/948273",
        "image": "https://img.a.transfermarkt.technology/portrait/medium/948273-1707861820.jpg?lm=4711",
        "position": null
      },
      "club": {
        "id": 3709,
        "name": "Getafe CF",
        "link": "https://www.transfermarkt.com/fc-getafe/startseite/verein/3709",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/3709.png?lm=1789459359"
      },
      "fee": {
        "amount": 3500000,
        "currency": "EUR",
        "type": "transfer"
      }
    },
    {
      "player": {
        "id": 341264,
        "name": null,
        "link": "https://www.transfermarkt.com/fran-garcia/profil/spieler/341264",
        "image": "https://img.a.transfermarkt.technology/portrait/medium/341264-1688119965.jpg?lm=4711",
        "position": null
      },
      "club": {
        "id": 150,
        "name": "Real Betis Balompié",
        "link": "https://www.transfermarkt.com/real-betis-sevilla/startseite/verein/150",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/150.png?lm=1789459175"
      },
      "fee": {
        "amount": 4000000,
        "currency": "EUR",
        "type": "transfer"
      }
    },
    {
      "player": {
        "id": 948272,
        "name": null,
        "link": "https://www.transfermarkt.com/cesar-palacios/profil/spieler/948272",
        "image": "https://img.a.transfermarkt.technology/portrait/medium/948272-1707907926.jpg?lm=4711",
        "position": null
      },
      "club": {
        "id": 931,
        "name": "Fulham FC",
        "link": "https://www.transfermarkt.com/fc-fulham/startseite/verein/931",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/931.png?lm=1789459221"
      },
      "fee": {
        "amount": 10000000,
        "currency": "EUR",
        "type": "transfer"
      }
    }
  ],
  "top_goalscorers": [
    {
      "player": {
        "id": 342229,
        "name": null,
        "link": "https://www.transfermarkt.com/kylian-mbappe/profil/spieler/342229",
        "image": "https://img.a.transfermarkt.technology/portrait/medium/342229-1682683695.jpg?lm=4711",
        "position": null
      },
      "count": 7
    },
    {
      "player": {
        "id": 581678,
        "name": null,
        "link": "https://www.transfermarkt.com/jude-bellingham/profil/spieler/581678",
        "image": "https://img.a.transfermarkt.technology/portrait/medium/581678-1748102891.jpg?lm=4711",
        "position": null
      },
      "count": 3
    },
    {
      "player": {
        "id": 1063338,
        "name": null,
        "link": "https://www.transfermarkt.com/carlos-espi/profil/spieler/1063338",
        "image": "https://img.a.transfermarkt.technology/portrait/medium/1063338-1759409131.jpg?lm=4711",
        "position": null
      },
      "count": 2
    },
    {
      "player": {
        "id": 371998,
        "name": null,
        "link": "https://www.transfermarkt.com/vinicius-junior/profil/spieler/371998",
        "image": "https://img.a.transfermarkt.technology/portrait/medium/371998-1761575144.jpg?lm=4711",
        "position": null
      },
      "count": 1
    },
    {
      "player": {
        "id": 861410,
        "name": null,
        "link": "https://www.transfermarkt.com/arda-guler/profil/spieler/861410",
        "image": "https://img.a.transfermarkt.technology/portrait/medium/861410-1699472585.jpg?lm=4711",
        "position": null
      },
      "count": 1
    }
  ],
  "most_assists": [
    {
      "player": {
        "id": 581678,
        "name": null,
        "link": "https://www.transfermarkt.com/jude-bellingham/profil/spieler/581678",
        "image": "https://img.a.transfermarkt.technology/portrait/medium/581678-1748102891.jpg?lm=4711",
        "position": null
      },
      "count": 3
    },
    {
      "player": {
        "id": 861410,
        "name": null,
        "link": "https://www.transfermarkt.com/arda-guler/profil/spieler/861410",
        "image": "https://img.a.transfermarkt.technology/portrait/medium/861410-1699472585.jpg?lm=4711",
        "position": null
      },
      "count": 3
    },
    {
      "player": {
        "id": 371998,
        "name": null,
        "link": "https://www.transfermarkt.com/vinicius-junior/profil/spieler/371998",
        "image": "https://img.a.transfermarkt.technology/portrait/medium/371998-1761575144.jpg?lm=4711",
        "position": null
      },
      "count": 3
    },
    {
      "player": {
        "id": 342229,
        "name": null,
        "link": "https://www.transfermarkt.com/kylian-mbappe/profil/spieler/342229",
        "image": "https://img.a.transfermarkt.technology/portrait/medium/342229-1682683695.jpg?lm=4711",
        "position": null
      },
      "count": 2
    },
    {
      "player": {
        "id": 811778,
        "name": null,
        "link": "https://www.transfermarkt.com/alvaro-carreras/profil/spieler/811778",
        "image": "https://img.a.transfermarkt.technology/portrait/medium/811778-1737497415.jpg?lm=4711",
        "position": null
      },
      "count": 1
    }
  ],
  "historical_names": [
    {
      "name": "Real Madrid FC",
      "short_name": "Real Madrid",
      "season": {
        "id": 1939,
        "name": "39/40"
      }
    },
    {
      "name": "Madrid Foot-ball Club",
      "short_name": "Madrid FC",
      "season": {
        "id": 1938,
        "name": "38/39"
      }
    },
    {
      "name": "Real Madrid FC",
      "short_name": "Real Madrid",
      "season": {
        "id": 1930,
        "name": "30/31"
      }
    },
    {
      "name": "Madrid Foot-ball Club",
      "short_name": "Madrid FC",
      "season": {
        "id": 1919,
        "name": "19/20"
      }
    },
    {
      "name": "Madrid-Moderno FC",
      "short_name": "Madrid-Moderno",
      "season": {
        "id": 1903,
        "name": "03/04"
      }
    },
    {
      "name": "Madrid Foot-ball Club",
      "short_name": "Madrid FC",
      "season": {
        "id": 1902,
        "name": "02/03"
      }
    }
  ],
  "historical_crests": [
    {
      "image": "https://img.a.transfermarkt.technology/wappen/big/418.png?lm=1789459190",
      "season": null
    },
    {
      "image": "https://img.a.transfermarkt.technology/wappen/big/418_1400793229.png?lm=1789459190",
      "season": {
        "id": 2000,
        "name": "00/01"
      }
    },
    {
      "image": "https://img.a.transfermarkt.technology/wappen/big/418_1400793229.png?lm=1789459190",
      "season": {
        "id": 1939,
        "name": "39/40"
      }
    },
    {
      "image": "https://img.a.transfermarkt.technology/wappen/big/418_1400793205.png?lm=1789459190",
      "season": {
        "id": 1938,
        "name": "38/39"
      }
    },
    {
      "image": "https://img.a.transfermarkt.technology/wappen/big/418_1400793167.png?lm=1789459190",
      "season": {
        "id": 1930,
        "name": "30/31"
      }
    },
    {
      "image": "https://img.a.transfermarkt.technology/wappen/big/418_1400793130.png?lm=1789459190",
      "season": {
        "id": 1919,
        "name": "19/20"
      }
    },
    {
      "image": "https://img.a.transfermarkt.technology/wappen/big/418_1400793115.png?lm=1789459190",
      "season": {
        "id": 1903,
        "name": "03/04"
      }
    },
    {
      "image": "https://img.a.transfermarkt.technology/wappen/big/418_1400793115.png?lm=1789459190",
      "season": {
        "id": 1902,
        "name": "02/03"
      }
    }
  ]
}