⚽ Flashscore Injuries & Suspensions Tracker

High-performance, real-time Flashscore Injuries & Suspensions Scraper. Extract missing players, absence reasons (e.g. Thigh Injury, Achilles Tendon Injury, Yellow Cards, Red Card), and estimated return dates across top European leagues, active worldwide competitions, or custom teams.

---

🚀 Key Features & Advantages

Feature	Advantage
🏥 Real-Time Absence Tracking	Captures injured, suspended, and questionable players updated directly from official club squad pages.
📅 Isolated Return Dates & Reasons	Cleanly separates absence reasons (Knee Injury, Red Card) from estimated return dates (31.12.2026, 16.08.2026).
⚽ Worldwide League Presets	Preset options for Serie A, Premier League, LaLiga, Bundesliga, Ligue 1, Liga Portugal, Eliteserien (Norway), MLS (USA), and Brasileirão (Brazil).
🔗 Custom League & Team URL Mode	Supports ANY custom Flashscore league standings URL or individual team squad URL.
⚡ Stealth Network Pipeline	Fast extraction via Puppeteer Stealth with full TLS/JA3 fingerprint consistency.

---

📊 Dataset Output Format (JSON)

Below is an authentic example of the clean JSON dataset produced by this Actor:

[
  {
    "teamName": "Malmo FF",
    "playerName": "Jansson Pontus",
    "playerId": "4toh0E9q",
    "playerUrl": "https://www.flashscore.com/player/jansson-pontus/4toh0E9q/",
    "status": "Injured",
    "reason": "Knee Injury",
    "estimatedReturnDate": "31.12.2026",
    "extractedAt": "2026-07-31T12:00:00.000Z"
  },
  {
    "teamName": "Hacken",
    "playerName": "Lindberg Julius",
    "playerId": "tS9JaXba",
    "playerUrl": "https://www.flashscore.com/player/julius-lindberg/tS9JaXba/",
    "status": "Suspended",
    "reason": "Yellow Cards",
    "estimatedReturnDate": "",
    "extractedAt": "2026-07-31T12:00:00.000Z"
  },
  {
    "teamName": "Brommapojkarna",
    "playerName": "Hansen Mads",
    "playerId": "44I4AOGU",
    "playerUrl": "https://www.flashscore.com/player/hansen-mads/44I4AOGU/",
    "status": "Suspended",
    "reason": "Red Card",
    "estimatedReturnDate": "",
    "extractedAt": "2026-07-31T12:00:00.000Z"
  },
  {
    "teamName": "GAIS",
    "playerName": "Lundgren Gustav",
    "playerId": "tpRO8VlL",
    "playerUrl": "https://www.flashscore.com/player/lundgren-gustav/tpRO8VlL/",
    "status": "Injured",
    "reason": "Achilles Tendon Injury",
    "estimatedReturnDate": "",
    "extractedAt": "2026-07-31T12:00:00.000Z"
  }
]

---

⚙️ Input Parameters

Parameter	Type	Default	Description
league	Enum	"Serie A"	Preset league selection (Serie A, Premier League, LaLiga, Bundesliga, Ligue 1, Liga Portugal, Eliteserien, MLS, Brasileirão, or Custom URL Mode).
customUrl	String	""	Optional Flashscore League Standings URL or Team Squad URL when using Custom URL Mode.
statusFilter	Enum	"All Absences"	Filter by absence type: "All Absences", "Injuries Only", or "Suspensions Only".
maxTeams	Integer	20	Maximum teams to extract per run (1 to 50, safety limit).
includePlayerProfile	Boolean	true	Include player profile ID and URL link.
proxyConfig	Object	{}	Apify Proxy settings (Residential Proxies recommended).

---

💡 Architecture Overview

Under the hood, the Actor follows a robust 3-stage scraping pipeline:

1. Target Discovery (session_manager.ts & main.ts): Navigates to the selected league standings URL using Puppeteer Stealth, waits for dynamic DOM hydration, and extracts real team squad links.
2. Universal DOM Extraction (main.ts): Loads each team's squad page (/squad/), inspects medical badges and absence status indicators, and parses missing player names, profile IDs, absence reasons (Red Card, Yellow Cards, Knee Injury), and return estimates.
3. Dataset Ingestion (apify.pushData): Validates extracted records against strict Apify Dataset schemas and stores clean, structured JSON output ready for Excel, Python Pandas, or SQL databases.

---

⚖️ Legal Disclaimer & Terms of Use

This Actor is provided for academic, research, and data analytical purposes only. Users are responsible for complying with the data provider's Terms of Service. No liability is assumed for the misuse of this tool or the accuracy of external data.

---

🇮🇹 Sintesi in Italiano

Questo Apify Actor consente di tracciare in tempo reale gli infortuni, le squalifiche ed i tempi di rientro stimati dei calciatori per tutte le squadre delle principali leghe mondiali.

È ideale per:

• Match Analyst & Quantitative Bettors: Integrare l'impatto delle assenze chiave nei modelli di probabilità (xG e quote).
• Fantasy Football (Fantacalcio): Monitorare infortunati e squalificati prima della chiusura delle formazioni.
• Sports Portals: Alimentare widget e feed di notizie con dati sempre aggiornati.

Disclaimer: Questo strumento è fornito esclusivamente per scopi di ricerca e analisi. L'utente è responsabile dell'osservanza dei termini di servizio del provider dei dati.

---

Optimized for & Supported Categories: Flashscore Injuries Scraper, Football Injury Tracker, Soccer Suspensions API, Missing Players Data, Fantasy Football Injury Feed, Betting Absence Tracker, Squad Injuries Scraper.

For support or custom feature requests, contact us via the Apify Console.