# Transfermarkt API: Get a football club's squad and market values

> Finds a football club on Transfermarkt by name, link or ID and returns its squad for a season with each player's position, age, nationality, market value and contract, highest value first.

Unofficial. Not affiliated with or endorsed by Transfermarkt.

- Page: https://fous.com/methods/transfermarkt.com/get-club-squad
- Method: `transfermarkt.com/get_club_squad`, version 1
- Website: transfermarkt.com
- Returns: club, league, season, squad value, average age, players with shirt number, position, age, nationality, market value, contract end, link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `club` | string | yes | `"Arsenal"` | Club name, Transfermarkt club link, or club ID; for example Arsenal. |
| `season` | string | no | `"2025/26"` | Season start year or full season; for example 2025 or 2025/26. Defaults to the current season. Default "". |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "club": "Arsenal",
  "season": "2025/26"
}
```

Its output:

```json
{
  "club": "Arsenal FC",
  "league": "Premier League",
  "season": "2025/26",
  "club_id": "11",
  "players": [
    {
      "age": 27,
      "name": "Declan Rice",
      "position": "Central Midfield",
      "player_id": "357662",
      "nationality": "England, Ireland",
      "player_link": "https://www.transfermarkt.com/declan-rice/profil/spieler/357662",
      "market_value": 120000000,
      "shirt_number": 41,
      "contract_end_date": null
    },
    {
      "age": 24,
      "name": "Bukayo Saka",
      "position": "Right Winger",
      "player_id": "433177",
      "nationality": "England, Nigeria",
      "player_link": "https://www.transfermarkt.com/bukayo-saka/profil/spieler/433177",
      "market_value": 110000000,
      "shirt_number": 7,
      "contract_end_date": null
    },
    {
      "age": 25,
      "name": "William Saliba",
      "position": "Centre-Back",
      "player_id": "495666",
      "nationality": "France, Cameroon",
      "player_link": "https://www.transfermarkt.com/william-saliba/profil/spieler/495666",
      "market_value": 100000000,
      "shirt_number": 2,
      "contract_end_date": null
    }
  ],
  "currency": "EUR",
  "club_link": "https://www.transfermarkt.com/fc-arsenal/startseite/verein/11",
  "total_squad_value": 1326125000,
  "average_player_age": 23.4
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"transfermarkt.com/get_club_squad","input":{"club":"Arsenal","season":"2025/26"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What's Bayer Leverkusen's current squad worth, and who are their most valuable players?
- Pull the Transfermarkt squad list for Napoli in the 2023/24 season with each player's market value and contract expiry date
- I need Ajax's full roster with positions, ages, nationalities and when each contract ends, sorted by market value
- Show me the total squad value and average age for Aston Villa in 2021, plus the individual player valuations
- On transfermarkt.com, look up club ID 418 and list every player with shirt number and market value for this season

## Input schema

```json
{
  "type": "object",
  "required": [
    "club"
  ],
  "properties": {
    "club": {
      "type": "string",
      "description": "Club name, Transfermarkt club link, or club ID; for example Arsenal."
    },
    "season": {
      "type": "string",
      "default": "",
      "description": "Season start year or full season; for example 2025 or 2025/26. Defaults to the current season."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "club",
    "league",
    "season",
    "total_squad_value",
    "average_player_age",
    "currency",
    "club_link",
    "club_id",
    "players"
  ],
  "properties": {
    "club": {
      "type": "string"
    },
    "league": {
      "type": [
        "string",
        "null"
      ]
    },
    "season": {
      "type": "string"
    },
    "club_id": {
      "type": "string"
    },
    "players": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "shirt_number",
          "position",
          "age",
          "nationality",
          "market_value",
          "contract_end_date",
          "player_link",
          "player_id"
        ],
        "properties": {
          "age": {
            "type": [
              "integer",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "position": {
            "type": [
              "string",
              "null"
            ]
          },
          "player_id": {
            "type": "string"
          },
          "nationality": {
            "type": [
              "string",
              "null"
            ]
          },
          "player_link": {
            "type": "string"
          },
          "market_value": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Value in euros."
          },
          "shirt_number": {
            "type": [
              "integer",
              "null"
            ]
          },
          "contract_end_date": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "currency": {
      "enum": [
        "EUR"
      ],
      "type": "string"
    },
    "club_link": {
      "type": "string"
    },
    "total_squad_value": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Squad value in euros."
    },
    "average_player_age": {
      "type": [
        "number",
        "null"
      ]
    }
  }
}
```

## See more

- [Transfermarkt API: Get a football player's market value and transfers](https://fous.com/methods/transfermarkt.com/get-player-value.md): Finds a football player on Transfermarkt by name (a club picks among namesakes) and returns the current and highest market values, the value history and the transfer history, in euros.
- [Premier League API: Get player stats](https://fous.com/methods/premierleague.com/get-player-stats.md): Looks up a Premier League player by name and returns the profile and either career totals or the stats for a chosen season. If names clash, a current Premier League player is preferred.
- [UEFA API: Get competition matches](https://fous.com/methods/uefa.com/get-competition-matches.md): Gets UEFA club competition matches in a date range, with kick-off times in a chosen time zone, scores, stages and venues. You can limit the list to one club.
- [Premier League API: Get league table](https://fous.com/methods/premierleague.com/get-league-table.md): Gets the Premier League table for the current season or a chosen season, with each club's last five league results.
- [Premier League API: Get fixtures and results](https://fous.com/methods/premierleague.com/get-fixtures-and-results.md): Gets Premier League fixtures and results in a date range, with kickoff times in your chosen time zone. Returns up to 380 matches.
- [SofaScore API: Get football match](https://fous.com/methods/sofascore.com/get-match.md): Finds a football match between two teams on SofaScore (on a given date, or their latest played or live match) and returns its score, goals, red cards, team statistics and player ratings.
- [SofaScore API: Get player season stats](https://fous.com/methods/sofascore.com/get-player-season-stats.md): Gets a football player's season statistics on SofaScore by name, with an optional competition and season (defaults: the player's main league and the current season). Unavailable statistics are null.
- [UEFA API: Get competition table](https://fous.com/methods/uefa.com/get-competition-table.md): Returns the league-phase or group-stage table for a UEFA club competition and season, with qualification labels where shown.
- [All Transfermarkt methods](https://fous.com/methods/transfermarkt.com.md)
