🏆 Flashscore Scraper: Real-Time Sports Data & Live Scores API

Extract high-fidelity sports data from Flashscore in real-time. This Actor bypasses complex anti-bot measures to deliver structured data for football and more directly into your apps.

---

✨ Key Features & Benefits

• ⚡ Real-Time Live Scores: Track match minutes (e.g., "1st Half - 24'") and evolving scores as they happen.
• 🌍 Multi-Sport Support: Get data for Football (Soccer) and Basketball. Tennis, Hockey, and Volleyball will be implemented soon.
• 📅 Historical & Future Coverage: Access results from previous days or upcoming schedules using simple date offsets.
• 🔗 Deep Linking: Includes unique match_id and formatted match_url for easy integration with your own platform.
• 📦 Flexible Export: Download data in JSON, CSV, Excel, or XML.

---

🚀 How to Use

1. Configure Input: Select your target sports and the day offset (e.g., 0 for today, 1 for tomorrow).
2. Run the Actor: Click Start. The Actor will fetch match data and live updates.
3. Get Data: Once the run finishes, navigate to the Dataset tab to view or export your results.

---

📥 Input Parameters

The Actor is designed with a user-friendly UI. You can toggle these settings in the Input tab:

Field	Type	Description	Default
Sports	Array	List of sports to scrape. Full supported list is: football, basketball. Other sports, soon to come.	["football"]
Date Offsets	Array	0 = Today, 1 = Tomorrow, -1 = Yesterday.	[0]
Match Status	Array	Filter by LIVE, FINISHED, SCHEDULED, ALL.	["ALL"]
League / Tournament Filter	Array	Filter to specific leagues or tournaments by name (e.g. "LaLiga", "Premier League", "Champions League"). Case-insensitive. Leave empty to return all leagues.	[]

---

📤 Output Example

The data is delivered in a clean, structured format. Each item represents a single match:

{
    "home_team_name": "Namibia W",
    "home_team_short_name": "NAM",
    "home_team_id": "O6oWzKNA",
    "away_team_name": "Madagascar W",
    "away_team_short_name": "MAD",
    "away_team_id": "CUFJyZR2",
    "category_name": "Africa",
    "sport_name": "football",
    "sport_id": "1",
    "tournament_name": "COSAFA Cup Women",
    "tournament_id": "b3KP3GQo",
    "tournament_url": "https://www.flashscore.com/football/africa/cosafa-cup-women/",
    "match_id": "YoFnhYSb",
    "match_date": "2026-02-23 13:00:00",
    "match_url": "https://www.flashscore.com/match/football/namibia-O6oWzKNA/madagascar-CUFJyZR2/?mid=YoFnhYSb",
    "match_score_home_goals": "0",
    "match_score_away_goals": "1",
    "stage_description": "Half Time",
    "match_status": "live"
  }

See a structured version of the extraction here.

---

💡 Use Cases

• Betting Platforms: Feed real-time scores and match stages into your odds algorithms.
• Sports News: Automate the creation of daily results summaries or upcoming match lists.
• Data Science: Analyze historical scores and match performance for predictive modeling.
• Fantasy Leagues: Update player statistics and match outcomes instantly.

---

❓ Frequently Asked Questions

Q: How "Live" is the data?

A: The scraper hits the same high-speed endpoints as the Flashscore web app. You can expect data latency as low as 5-15 seconds, depending on your run frequency.

Q: Can I filter for specific leagues (e.g., only Premier League)?

A: Yes. The output includes tournament_id and tournament_name. You can filter these results using Apify's built-in filtering or via a simple post-processing script in your integration.

Q: Does this include player-level stats?

A: This version focuses on Match-Level data (scores, status, time, tournament info) for now. Other feature extractions like player level stats and others will be implemented. But please get in touch and let us know what other data you would like to see extracted, this way we can better prioritise it.

Q: What happens if a match is postponed?

A: The match_status field will update accordingly, and the stage_description will contain the specific status label (e.g., "Postponed", "Interrupted", or "Walkover") provided by the feed.

---

🛡️ Support

If you encounter any issues or have a feature request, please open a ticket in the Issues tab or contact us via the Apify Console.

SEO Keywords: Flashscore Scraper, Live Scores API, Football Data Extractor, Real-time Sports API, Tennis Scores Scraper, Betting Data API.