⚽ Football Matches, Odds & Pre-Match Analytics

Get football matches for any date with pre-match analytics in one run: 1X2 betting odds, head-to-head record with draws, team form, current league position and team rating. The most popular competitions come first: Premier League, Champions League, LaLiga, Serie A, Bundesliga, Ligue 1 and hundreds more. Data comes from SofaScore.

No coding, no API keys, no browser automation. Pick a date, optionally your leagues, and get a clean dataset.

Why this Actor

Most football scrapers give you either fixtures or odds. This Actor combines the data you need to analyze a match:

• 📅 Daily fixtures for any date, sorted by competition popularity
• 💰 1X2 odds (decimal): home win, draw, away win
• ⚔️ Head-to-head: home wins, draws, away wins, optional list of the last 5 meetings with scores
• 📈 Team form (e.g. WWDLW) and current league position of both teams
• 🏆 Country, league, round, status, final score and result for finished matches
• 📊 Match statistics (possession, shots, xG and more) for finished matches, optional
• 🔁 Reliable: automatic retries and proxy rotation

Use cases

• Betting research and value-bet models
• Football analytics and machine learning datasets
• Daily previews for websites, Telegram channels and newsletters
• AI agents that need structured football data
• Scheduled daily runs to build your own historical database

Input

Field	Description	Default
date	Match date YYYY-MM-DD (UTC). Empty = today	today
leagues	Filter by league or country, e.g. England, LaLiga, Champions League. Empty = all	all
maxMatches	Maximum number of matches	50
includeOdds	Add 1X2 odds	true
includeH2H	Add head-to-head record	true
includeForm	Add team form and league position	true
includeLastMeetings	Add last 5 meetings with scores	false
includeStatistics	Add statistics for finished matches	false

Example input:

{
    "leagues": ["England", "Champions League"],
    "maxMatches": 30
}

Output

One item per match. Example (shortened):

{
    "startTimeUtc": "2026-11-03T20:00:00+00:00",
    "country": "England",
    "league": "Premier League",
    "round": 11,
    "homeTeam": "Newcastle United",
    "awayTeam": "Everton",
    "odds": { "home": 2.1, "draw": 3.4, "away": 3.4 },
    "h2hHomeWins": 2,
    "h2hDraws": 2,
    "h2hAwayWins": 6,
    "formHome": { "last": "LWLLW", "wins": 2, "draws": 0, "losses": 3, "leaguePosition": 12 },
    "formAway": { "last": "WDWLW", "wins": 3, "draws": 1, "losses": 1, "leaguePosition": 9 },
    "status": "notstarted",
    "url": "https://www.sofascore.com/football/match/..."
}

Export to JSON, CSV, Excel or connect via API, Make, Zapier, n8n or any AI agent.

Pricing

You pay only for matches you receive (pay per result). Use maxMatches and leagues to control the cost.

Tips

• Run it every morning with Schedules to get the day's previews automatically.
• leagues matches by name, so England returns all English competitions on that date.
• Leave leagues empty to get the most popular matches of the day first.

FAQ

Is it legal? The Actor collects publicly available sports data. You are responsible for using it in line with applicable laws and the source's terms.

Is this an official SofaScore API? No. This Actor is not affiliated with SofaScore.

Something broke? Open an issue on the Issues tab and it will be fixed quickly.