Transfermarkt Scraper — Players, Clubs & Transfers

The only fully working Transfermarkt scraper on the Apify Store. Extract football player market values, transfer histories, contract expiry dates, agent information, and complete career statistics from Transfermarkt.com — the gold standard database for football market valuations.

What Data Can You Extract?

Field	Description
Market value (current + history)	Current EUR value + full historical chart
Transfer history	All transfers with fees, loan detection, free transfers
Contract expiry date	Critical for scouting — when a player is available
Agent / advisor	Player's representation info
Club & league	Current club, league, country
Career stats	Goals, assists, appearances per season
National team	Caps, goals, debut date
Youth career	Full youth club history
Injuries	Past injury records and days missed
Achievements	Club and international trophies

How to Use

Search by player name:

{
  "playerNames": ["Erling Haaland", "Kylian Mbappé"],
  "maxPlayers": 2
}

Club roster:

{
  "mode": "club",
  "clubUrls": ["https://www.transfermarkt.com/manchester-city/startseite/verein/281"]
}

League-wide scraping:

{
  "mode": "league",
  "leagueUrls": ["https://www.transfermarkt.com/premier-league/startseite/wettbewerb/GB1"]
}

Free agent scouting:

{
  "mode": "club",
  "clubUrls": ["https://www.transfermarkt.com/..."],
  "contractExpiryBefore": "2025-06-30"
}

Input Configuration

Parameter	Type	Default	Description
mode	string	"players"	players, club, league, transfers
playerNames	string[]	["Erling Haaland"]	Player names to search
maxPlayers	integer	1	Maximum player or club summary records emitted across the run
playerUrls	string[]	[]	Direct Transfermarkt player profile URLs
clubUrls	string[]	[]	Club page URLs for roster scraping
leagueUrls	string[]	[]	League page URLs
includeMarketValueHistory	boolean	false	Historical market value chart
includeTransferHistory	boolean	false	All transfers with fees
includeStats	boolean	false	Career stats (extra requests)
contractExpiryBefore	string	null	ISO 8601 date filter for scouting
maxConcurrency	integer	1	Max concurrent requests (keep low)
requestDelay	integer	1500	Delay between requests (ms)

Output Format

{
  "playerId": "418560",
  "name": "Erling Haaland",
  "dateOfBirth": "2000-07-21",
  "age": 24,
  "nationalities": ["Norway"],
  "position": { "main": "Centre-Forward", "other": [] },
  "currentClub": {
    "name": "Manchester City",
    "contractExpiry": "2027-06-30"
  },
  "marketValue": {
    "current": 180000000,
    "currentFormatted": "€180m",
    "peak": 200000000
  },
  "transferHistory": [
    {
      "season": "22/23",
      "fromClub": { "name": "Borussia Dortmund" },
      "toClub": { "name": "Manchester City" },
      "fee": 60000000,
      "feeType": "fee",
      "isLoan": false
    }
  ],
  "scrapedAt": "2026-03-11T12:00:00.000Z"
}

Use Cases

• Fantasy football optimization — Contract expiry + market value for FPL/FanDuel tools
• Transfer window monitoring — Track incoming/outgoing transfers in real time
• Football analytics — Build scouting databases with full career data
• Journalism and research — Structured data for football reporting
• Sports betting — Player form and team news monitoring

Pricing

Pay-Per-Event: $0.01719 per source page processed ($17.19 per 1,000 source pages) using the live Store pricing entry and source-page-processed event. A one-time actor-start event is scheduled at $0.02 per run.

Platform usage handling follows the actor's live Store pricing entry.

Scenario	Estimated Source Pages	Cost
Single player lookup	1	$0.04
Club roster summary	25	$0.45
Full Premier League (20 clubs × 27)	540	$1.08
Top 5 leagues	~2,700	$5.40

Related Actors

• Finance News Scraper — Financial news with ticker filtering
• Google News Scraper — General news monitoring

FAQ

How current is the market value data?

Transfermarkt updates market values periodically (typically every 3-6 months for top players). The actor scrapes the current displayed value plus full historical chart.

Can I get market value history?

Yes — set includeMarketValueHistory: true. Returns an array of {date, value, club} entries.

Does it work for all leagues and countries?

Yes — Transfermarkt covers all professional leagues globally, from the Premier League to lower domestic leagues.

What's the difference between market value and transfer fee?

Market value is Transfermarkt's estimate. Transfer fee is the actual fee paid when a transfer occurred (from transferHistory).

Can I monitor contract expiry dates automatically with scheduled runs?

Yes — use the contractExpiryBefore filter with Apify's scheduled runs to get daily alerts on expiring contracts.

Is Transfermarkt scraping permitted?

Transfermarkt data is publicly accessible without login. We use respectful rate limiting (1.5s delay) to avoid server strain. Data sourced from Transfermarkt.com — attribution required when republishing.