🔍 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 json { "players": [ "Lionel Messi", "https://www.transfermarkt.com/kylian-mbappe/profil/spieler/342229", "Cristiano Ronaldo" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["DATACENTER"] } } ### Output Example Player json { "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 json { "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