🏆 Flashscore Live Sports & Historical Matches Scraper

Ultra-fast, HTTP-only Apify Actor for Flashscore.com. Extract real-time live scores, finished match results, upcoming fixtures, tournaments, team information, and period breakdowns across 12+ major sports.

---

⚡ Features & Capabilities

• 12+ Major Sports Covered:
  • ⚽ Football / Soccer (Premier League, La Liga, Champions League, MLS, Serie A, etc.)
  • 🏀 Basketball (NBA, EuroLeague, NCAA, etc.)
  • 🎾 Tennis (ATP, WTA, Grand Slams, Challengers)
  • 🏒 Ice Hockey (NHL, KHL, SHL, etc.)
  • ⚾ Baseball (MLB, NPB, KBO)
  • 🏈 American Football (NFL, NCAAF, CFL)
  • 🥊 MMA / Combat Sports (UFC, Bellator, ONE)
  • 🎮 Esports (CS:GO, League of Legends, Dota 2, Valorant)
  • 🤾 Handball, 🏉 Rugby, 🏐 Volleyball, 🏏 Cricket
• Flexible Date Navigation:
  • Extract today's live & upcoming games (dayOffsets: [0]).
  • Scrape yesterday's results (dayOffsets: [-1]).
  • Scan tomorrow's upcoming fixtures (dayOffsets: [1]).
  • Multi-day batch scraping (dayOffsets: [-2, -1, 0, 1, 2]).
• Granular Match Status Filtering:
  • all: All matches for the day.
  • live: Live / In-play matches currently active.
  • finished: Completed fixtures with full-time and period scores.
  • upcoming: Scheduled fixtures with start times.
• Deep Search & Filters:
  • Filter by country (e.g. England, Spain, USA).
  • Filter by tournament or cup name (e.g. Champions League, NBA, LaLiga).
  • Search query across team and tournament names (e.g. Arsenal, Real Madrid, Lakers).
• Direct Match URL / ID Scraping:
  • Input specific Flashscore match links or IDs for targeted data extraction.
• Rich Match Breakdown:
  • Full-time scores, half-time, quarter, or set breakdowns (period_scores).
  • Red cards and disciplinary stats.
  • Team logos and direct tournament links.
• Zero Browser Overhead:
  • 100% HTTP-only TLS fingerprint impersonation (curl_cffi).
  • Fast, reliable, and cost-efficient (PPE ready).

---

📥 Input Parameters

Parameter	Type	Default	Description
sports	array	["football", "basketball", "tennis"]	Sports to extract (football, basketball, tennis, hockey, baseball, american_football, mma, esports, etc.)
dayOffsets	array	[0]	Day offsets relative to today (0 = today, -1 = yesterday, 1 = tomorrow).
status	string	"all"	Filter by status: all, live, finished, or upcoming.
searchQuery	string	""	Optional keyword filter matching team or league names.
countryFilter	string	""	Optional filter for country (e.g. England, Spain).
tournamentFilter	string	""	Optional filter for tournament (e.g. Premier League).
directUrls	array	[]	List of Flashscore match URLs or match IDs.
includeMatchDetails	boolean	false	Deep metadata enrichment (venue, stats availability, lineups).
maxItems	integer	100	Maximum match records to return.
proxyConfiguration	object	{}	Apify residential or datacenter proxy settings.

---

📤 Sample Output JSON

{
  "match_id": "O6FeFQT8",
  "sport": "football",
  "country": "Argentina",
  "tournament": "ARGENTINA: Liga Profesional - Clausura",
  "tournament_url": "https://www.flashscore.com/football/argentina/liga-profesional/",
  "tournament_stage": "",
  "match_url": "https://www.flashscore.com/match/O6FeFQT8/#/match-summary",
  "start_time": "2026-08-24T22:00:00+00:00",
  "timestamp": 1787608800,
  "status": "Finished",
  "status_code": "3",
  "home_team": {
    "name": "Tigre",
    "short_name": "TIG",
    "team_id": "nkwO1uw4",
    "slug": "tigre",
    "score": "2",
    "red_cards": 0,
    "logo": "https://static.flashscore.com/res/image/data/EgYDLGoe-ENHpchZ2.png"
  },
  "away_team": {
    "name": "Central Cordoba",
    "short_name": "CEN",
    "team_id": "0dHZReql",
    "slug": "central-cordoba-santiago-del-estero",
    "score": "1",
    "red_cards": 0,
    "logo": "https://static.flashscore.com/res/image/data/0hgWrqXH-E7RqoQaq.png"
  },
  "period_scores": {
    "1st_period": {
      "home": "0",
      "away": "1"
    },
    "2nd_period": {
      "home": "2",
      "away": "0"
    }
  }
}

---

🎯 Use Cases

1. Sports Betting & Arbitrage Bots: Feed real-time live match events and period scores into betting models and odds arbitrage detectors.
2. Fantasy Sports & Analytics: Aggregate player and team performance indicators, fixture schedules, and historical scores.
3. Sports Media & Live Score Apps: Power sports dashboards, widgets, and automated alerts for goals, half-time, and final results.
4. AI & Quant Sports Models: Build historical training datasets of match scores, league standings, and team momentum.