⚽ Transfermarkt Scraper

Extract structured football data from Transfermarkt — player profiles, competition tables, and injured-player lists — from nothing but a page URL. The Actor auto-detects the page type and returns clean, normalized JSON, complete with full transfer history and season-by-season career statistics for players.

Just paste a URL. The scraper figures out the rest.

---

💡 Why choose this Actor?

• Zero configuration — only a start URL is required; page type is detected automatically.
• Smart proxy escalation — starts with a direct connection and only escalates (datacenter → residential, sticky) when Transfermarkt pushes back, so you stay fast and unblocked.
• Rich, normalized output — dates as DD/MM/YYYY, structured transfer objects (clubs, IDs, market value, fee, contract), and aggregated career stats per competition & season.
• Live results — every row is saved the moment it's scraped, so partial runs never lose data.
• Polished dataset views — separate, labeled views for Players, Competitions and Injured Players.

---

✨ Key features

• 👤 Player profiles — bio, citizenship, position, foot, agent, club, contract dates, outfitter, social media.
• 🔁 Transfer history — every move with season, date, clubs (+ IDs), market value, fee, contract end, age and status.
• 📊 Career statistics — appearances, goals, assists, cards and minutes, bucketed by competition and season.
• 🏆 Competition tables — full standings (rank, club, matches, W/D/L, goals, goal difference, points).
• 🚑 Injured players — player, position, club, injury, expected return date and market value.
• 🕸️ Crawl & pagination depth — optionally follow links and paginated pages from each start URL.

---

🚀 How to use the Actor (via Apify Console)

1. Log in at console.apify.com → Actors.
2. Open Transfermarkt Scraper.
3. Paste one or more Transfermarkt URLs into the input.
4. (Optional) Adjust proxy, crawl depth, and pagination depth.
5. Click Start and watch results stream into the Output tab in real time.
6. Export to JSON / CSV / Excel / XML.

---

📥 Input

Field	Type	Description
urls (required)	array	Transfermarkt page URLs (player / competition / injured). Page type is detected automatically.
proxyConfiguration	object	Proxy settings (datacenter tier of the escalation chain). Apify Proxy recommended.
crawlDepth	integer	How deep to follow links discovered on each page. 0 = provided URLs only. Default 1.
pageDepth	integer	How many pagination pages to follow from each page. 0 = first page only. Default 1.

{
  "urls": [
    { "url": "https://www.transfermarkt.com/lionel-messi/profil/spieler/28003" },
    { "url": "https://www.transfermarkt.com/premier-league/tabelle/wettbewerb/GB1/saison_id/2023" }
  ],
  "proxyConfiguration": { "useApifyProxy": true },
  "crawlDepth": 1,
  "pageDepth": 1
}

💡 The legacy field names startUrls and proxyConfig are also accepted for backwards compatibility.

---

📤 Output

Each scraped page yields one or more dataset rows. Field names and structure match the canonical output schema.

Player

{
  "givenUrl": "https://www.transfermarkt.com/lionel-messi/profil/spieler/28003",
  "id": "28003",
  "url": "https://www.transfermarkt.com/lionel-messi/profil/spieler/28003",
  "type": "player",
  "Name in home country": "Lionel Andrés Messi Cuccitini",
  "Date of birth/Age": "24/06/1987 (38)",
  "Place of birth": "Rosario",
  "Height": "1,70 m",
  "Citizenship": ["Argentina", "Spain"],
  "Position": "Attack - Right Winger",
  "Foot": "left",
  "Player agent": "Relatives",
  "Current club": "Inter Miami CF",
  "Joined": "15/07/2023",
  "Contract expires": "31/12/2028",
  "Last contract extension": "23/10/2025",
  "Outfitter": "adidas",
  "Social-Media": "http://www.facebook.com/LeoMessi, http://instagram.com/leomessi",
  "transfers": [
    {
      "id": "4418847", "season": "23/24", "date": "15/07/2023",
      "clubFrom": "Paris Saint-Germain", "clubFromId": "583",
      "clubTo": "Inter Miami CF", "clubToId": "69261",
      "marketValue": "€35.00M", "fee": "Free Transfer",
      "contractUntil": "31/12/2028", "age": 36, "status": "completed"
    }
  ],
  "careerStats": [
    {
      "competitionDescription": "Major League Soccer", "competitionId": "MLS1",
      "nameSeason": "25/26", "gamesPlayed": 14, "goalsScored": 12, "assists": 7,
      "yellowCards": 2, "secondYellowCards": 0, "redCards": 0, "minutesPlayed": 1243
    }
  ]
}

Competition — { "type": "competition", "id": "2023", "url": "...", "clubs": [ { "#": "1", "Club_0": "Manchester City", "Club_1": "Man City", "Matches": "38", "W": "28", "D": "7", "L": "3", "Goals": "96:34", "+/-": "62", "Pts": "91" } ] }

Injured player — { "id": "...", "url": "...", "Player/Position": ["Name", "Position"], "Club": "...", "Injury": "...", "until": "...", "Market Value": "..." }

---

🛡️ Proxy & anti-blocking strategy

The Actor uses browser impersonation (TLS + HTTP fingerprinting) and a tiered proxy escalation chain for every request:

1. 📡 Direct connection (no proxy) — fastest, used by default.
2. ⚠️ Datacenter proxy — used automatically if a request is blocked.
3. 🔁 Residential proxy — used if datacenter is blocked, retried up to 3×.
4. 🔒 Sticky residential — once residential succeeds, all remaining requests reuse it.

This keeps runs cheap when the site is permissive and resilient when it isn't.

---

🎯 Best use cases

• Building football/soccer analytics and prediction datasets.
• Monitoring squad values, transfers, and contract timelines.
• Tracking injuries across competitions.
• Aggregating league standings season over season.

---

❓ Frequently asked questions

Which URLs are supported? Player profiles, competition tables, and injured-player pages. Other pages (e.g. club squads) are crawled for links but produce no rows themselves.

Do I need a proxy? No, but it's recommended. Without one the Actor runs direct-only; with Apify Proxy it can escalate to residential when blocked.

Will one bad URL stop the run? No. Each page is handled independently and rows are saved as they are scraped.

---

💬 Support & feedback

Found a bug or want a new field? Open an issue on the Actor's Issues tab in the Apify Console.

---

⚖️ Legal note

Only publicly available data is collected. You are responsible for complying with Transfermarkt's Terms of Service and applicable data-protection laws (GDPR/CCPA).