🔍 Transfermarkt Player & Club Scraper

Transform your football analytics with our comprehensive Transfermarkt Player & Club Scraper! Whether you're analyzing player careers, evaluating club performance, monitoring transfer markets, or conducting sports research, this powerful tool efficiently collects and structures detailed data from Transfermarkt. Extract comprehensive player profiles including market values, contract details, transfer history, and season-by-season statistics across multiple competitions. Dive deep into club data with complete squad information, coaching staff details, trophy cabinets, league standings, and transfer market activity.

💎 Why Choose Our Transfermarkt Scraper?

• 🎯 Flexible search: scrape by names or direct Transfermarkt URLs (players or clubs)
• 🚀 Batch processing: process up to 20 items per run
• 🌐 Broad coverage: works across leagues and countries supported by Transfermarkt
• 📊 Rich player profiles: market value, contract details, trophies, transfer history
• 📈 Multi-season stats: by default, last 4 seasons (current + 3 previous) with competition breakdowns, or choose a specific season
• 🏆 Full transfer history: complete career transfers via the Transfermarkt API endpoints
• 🏟️ Deep club data: league info, trophies, total market value, club URL
• 👥 Squad & Staff: club squad players plus staff from the dedicated pages

🔮 How to Power Up Your Search Queries?

• 1. 🔤 Name Search: Simply enter the player's name to find their profile
• 2. 🔗 Direct URL: Enter the exact Transfermarkt profile URL for precise targeting
• 3. 📋 Batch Processing: Enter multiple names or URLs to process up to 10 players in one run

✨ What You'll Get

🏃 Player Data Structure

Field	Description
Player Name	Player Name
Jersey Number	Current jersey number
Club	Current club of the player
League	League information including name, country, and division
Market Value	Current market value with currency
Arrival Date	Date when player joined current club
Contract End	Contract expiration date
Transfer History	Complete history of all player transfers
Trophies	List of trophies won by the player
Player Details	Additional information including age, nationality, position, etc.
Player Stats	Performance statistics for current and 3 previous seasons, organized by competition
URL	Transfermarkt profile URL

🏟️ Club Data Structure

Field	Description
Club Name	Official name of the club
League	League information including name, country, division, table position, and tenure
Total Market Value	Current total market value of the squad with currency
Trophies	List of trophies won by the club with counts
Club Details	Additional information including stadium, founding date, members, etc.
Staff	Coaching and technical staff information including manager, assistants, and specialists
Squad	Complete list of current players with detailed information
Top Arrivals	Recent significant player arrivals with transfer details
Top Departures	Recent significant player departures with transfer details
URL	Transfermarkt club URL

🚀 Performance Features

⚡️ Lightning Fast:

• Efficient proxy rotation
• Optimized resource usage
• Smart retry mechanism

🛠️ Smart Handling:

• Automatic URL standardization
• Proxy health monitoring

🌍 Global Coverage:

• Works with any Transfermarkt profile
• Supports multiple languages
• Standardizes output format

📋 Quick Start

Input Parameters

Parameter	Type	Default	Description
scrapeType	string	players	What to scrape: players or clubs.
items	array	[]	List of players/clubs names or Transfermarkt URLs (max 20)
proxyConfiguration	object	{useApifyProxy: true}	Proxy configuration
playersWithoutStatistics	boolean	false	Players only. If true, fetches profile information only (no seasonal statistics).
playerStatsSelection	string	"last_4"	Players only. "last_4" (current + 3 previous) or a start year: "2025","2024","2023","2022","2021","2020".

Input Example

{
  "players": [
    "Lionel Messi",
    "https://www.transfermarkt.com/kylian-mbappe/profil/spieler/342229",
    "Cristiano Ronaldo"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["DATACENTER"]
  }
}

Output Example Player

{
  "nom": "Lionel Messi",
  "numero": "10",
  "club": "Inter Miami CF",
  "league": {
    "name": "MLS",
    "country": "United States",
    "division": "First Tier"
  },
  "valeur_marchande": "35.00M€",
  "arrival_date": "2023-07-15",
  "contract_end": "2025-12-31",
  "transfer_history": [
    {
      "season": "23/24",
      "date": "2023-07-15",
      "left": "Paris SG",
      "joined": "Miami",
      "market_value": "€35.00m",
      "fee": "free transfer"
    },
    {
      "season": "21/22",
      "date": "2021-08-10",
      "left": "Barcelona",
      "joined": "Paris SG",
      "market_value": "€80.00m",
      "fee": "free transfer"
    }
  ],
  "trophees": [
    {
      "trophee": "World Cup",
      "nombre": "1"
    },
    {
      "trophee": "Champions League",
      "nombre": "4"
    }
  ],
  "player_details": {
    "Date of birth": "1987-06-24",
    "Age": "36",
    "Citizenship": "Argentina",
    "Position": "Right Winger",
    "Foot": "left",
    "Height": "1,70m",
    "Weight": "72kg"
  },
  "player_stats": [
    {
        "season": "2024/25",
        "stats": [
            {
                "competition": "Premier League",
                "competition_img": "https://tmssl.akamaized.net/images/logo/tiny/gb1.png",
                "appearances": "30",
                "goals": "25",
                "assists": "10",
                "yellow_cards": "3",
                "minutes_played": "2650"
                // Stats vary by player position
            },
            // Other competitions for this season
        ]
    },
    {
        "season": "2023/24",
        "stats": [
            // Statistics for previous season
        ]
    },
    // Up to 4 seasons total
  ],
  "url": "https://www.transfermarkt.com/lionel-messi/profil/spieler/28003"
}

Output Example Club

{
  "clubName": "FC Barcelona",
  "clubUrl": "https://www.transfermarkt.com/fc-barcelona/profil/verein/131",
  "clubLeague": {
    "name": "LaLiga",
    "country": "Spain",
    "division": "First Tier",
    "tablePosition": "2nd",
    "inLeagueSince": "1929"
  },
  "totalMarketValue": "€937.50m",
  "clubTrophies": [
    {
      "name": "Champions League",
      "count": "5"
    },
    {
      "name": "LaLiga",
      "count": "27"
    },
    {
      "name": "Copa del Rey",
      "count": "31"
    },
    {
      "name": "Club World Cup",
      "count": "3"
    }
  ],
  "clubDetails": {
    "Full name": "Futbol Club Barcelona",
    "Address": "Avinguda Arístides Maillol s/n 08028 Barcelona",
    "Tel": "+34 902189900",
    "Founded": "Nov 29, 1899",
    "Members": "143,086",
    "Stadium": "Spotify Camp Nou",
    "Current transfer record": "+€135.00m"
  },
  "staff": [
    {
      "name": "Hansi Flick",
      "position": "Manager",
      "age": "59",
      "nationality": ["Germany"],
      "appointed": "Jul 1, 2024"
    },
    {
      "name": "Marcus Sorg",
      "position": "Assistant Manager",
      "age": "58",
      "nationality": ["Germany"],
      "appointed": "Jul 1, 2024"
    },
    {
      "name": "Deco",
      "position": "Sporting Director",
      "age": "46",
      "nationality": ["Portugal", "Brazil"],
      "appointed": "Jul 1, 2023"
    }
  ],
  "topArrivals": [
    {
      "playerName": "Dani Olmo",
      "playerPosition": "Attacking Midfield",
      "playerUrl": "https://www.transfermarkt.com/dani-olmo/profil/spieler/293385",
      "fromClub": "RB Leipzig",
      "fromClubUrl": "https://www.transfermarkt.com/rb-leipzig/startseite/verein/23826",
      "fee": "€55.00m"
    },
    {
      "playerName": "Pau Victor",
      "playerPosition": "Centre-Forward",
      "playerUrl": "https://www.transfermarkt.com/pau-victor/profil/spieler/683634",
      "fromClub": "Girona FC B",
      "fromClubUrl": "https://www.transfermarkt.com/girona-fc-b/startseite/verein/31053",
      "fee": "€3.00m"
    }
  ],
  "topDepartures": [
    {
      "playerName": "Ilkay Gündogan",
      "playerPosition": "Central Midfield",
      "playerUrl": "https://www.transfermarkt.com/ilkay-gundogan/profil/spieler/53622",
      "toClub": "Manchester City",
      "toClubUrl": "https://www.transfermarkt.com/manchester-city/startseite/verein/281",
      "fee": "free transfer"
    },
    {
      "playerName": "Clément Lenglet",
      "playerPosition": "Centre-Back",
      "playerUrl": "https://www.transfermarkt.com/clement-lenglet/profil/spieler/182904",
      "toClub": "Atlético Madrid",
      "toClubUrl": "https://www.transfermarkt.com/atletico-madrid/startseite/verein/13",
      "fee": "€7.50m"
    }
  ],
  "clubSquad": [
    {
      "number": "1",
      "name": "Marc-André ter Stegen",
      "position": "Goalkeeper",
      "specificPosition": "Goalkeeper",
      "age": "32",
      "nationalities": ["Germany"],
      "contract": "Jun 30, 2028",
      "marketValue": "€35.00m",
      "playerUrl": "https://www.transfermarkt.com/marc-andre-ter-stegen/profil/spieler/74857"
    },
    {
      "number": "23",
      "name": "Jules Koundé",
      "position": "Defender",
      "specificPosition": "Right-Back",
      "age": "25",
      "nationalities": ["France", "Benin"],
      "contract": "Jun 30, 2027",
      "marketValue": "€60.00m",
      "playerUrl": "https://www.transfermarkt.com/jules-kounde/profil/spieler/411975"
    },
    {
      "number": "9",
      "name": "Robert Lewandowski",
      "position": "Attack",
      "specificPosition": "Centre-Forward",
      "age": "36",
      "nationalities": ["Poland"],
      "contract": "Jun 30, 2026",
      "marketValue": "€30.00m",
      "playerUrl": "https://www.transfermarkt.com/robert-lewandowski/profil/spieler/38253"
    },
    {
      "number": "10",
      "name": "Lamine Yamal",
      "position": "Attack",
      "specificPosition": "Right Winger",
      "age": "17",
      "nationalities": ["Spain", "Morocco", "Equatorial Guinea"],
      "contract": "Jun 30, 2026",
      "marketValue": "€120.00m",
      "playerUrl": "https://www.transfermarkt.com/lamine-yamal/profil/spieler/941968"
    }
  ]
}

🤝 Support & Resources

Need help? Have questions? We're here to help! If you encounter any issues or have feature requests, please don't hesitate to open an issue.

❤️ Love our scraper? Please leave a review here