SofaScore Scraper - Live Scores, Fixtures & Stats

Scrape SofaScore across 14 sports - live scores, fixtures, results, lineups with player ratings, expected goals, full match statistics and goal timelines. No login, no API key, no cookies.

Football, tennis, basketball, ice hockey, volleyball, handball, cricket, MMA, rugby, baseball, American football, darts, snooker and table tennis.

---

Four ways to pull data

Mode	What you get
Live now	Everything in play right now for the sports you pick
By tournament	A league's full fixture list and results (past and upcoming)
By team	One team's fixtures and results
By match	Specific matches by id - or just paste the sofascore.com URL

What you get per match

matchId · matchUrl · sport · tournamentName · uniqueTournamentName · categoryName · seasonName · round · statusType · statusDescription · isLive · isFinished · startTime (ISO) · currentMinute · both teams with ids, slugs and countries · homeScore / awayScore · half-time scores · winner · venueName · venueCity

Every row carries every field, so your CSV never has ragged columns.

Optional enrichment

Toggle	Adds
includeStatistics	Up to 47 stat keys - ball possession, expected goals (xG), shots on target, corners, fouls, saves, kilometres covered
includeLineups	Formations plus every player with position, shirt number, rating, minutes, goals, assists and xG
includeIncidents	The full timeline, plus goals and cards pulled out as their own arrays with scorer and assist

Each toggle costs one extra request per match, so they are off by default.

---

Example input

{
  "mode": "tournament",
  "tournamentIds": ["17"],
  "includeStatistics": true,
  "includeIncidents": true,
  "maxResults": 100,
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }
}

Handy tournament ids: 17 Premier League · 8 LaLiga · 35 Bundesliga · 23 Serie A · 34 Ligue 1 · 7 UEFA Champions League. Don't know an id? Open the competition or team on sofascore.com and copy the number out of the URL - in event mode you can paste the whole URL and the actor reads the id out for you.

Example output

{
  "type": "match",
  "matchId": 14025097,
  "sport": "football",
  "tournamentName": "Premier League",
  "seasonName": "Premier League 26/27",
  "statusDescription": "Ended",
  "isFinished": true,
  "startTime": "2026-08-05T19:00:00.000Z",
  "homeTeamName": "Arsenal",
  "homeScore": 3,
  "awayScore": 2,
  "awayTeamName": "Kairat Almaty",
  "winner": "home",
  "venueName": "Emirates Stadium",
  "venueCity": "London",
  "statistics": { "ballPossession": { "name": "Ball possession", "home": 66, "away": 34 } },
  "goals": [{ "type": "goal", "minute": 90, "player": "Ricardinho", "assist": "Valeriy Gromyko" }]
}

---

Pricing

$0.002 per match. You are charged only for rows actually delivered to your dataset. A run that returns nothing - no live matches right now, or an id that doesn't exist - costs $0 and tells you which of those it was.

Honest limits

• Player ratings and xG are published by SofaScore only for higher-profile fixtures. Measured: 31 of 42 players rated on a Champions League tie, 0 of 23 on a women's qualifying match. Those sub-fields are left null when SofaScore has no value - never defaulted to 0.
• venueName / venueCity come from the match detail payload. They are populated in event mode and null in live/tournament/team modes, because fetching detail for every match would triple the cost of a live-scores run.
• currentMinute applies to clock-based sports in progress. Basketball and similar are period-scored, so SofaScore publishes a quarter rather than an elapsed clock.
• Live coverage follows local kick-off times. An empty live run at 4am UTC is not a fault - use tournament or team mode for fixtures and results instead.

Tips

• Schedule live mode every few minutes for a rolling scoreboard; dedupe on matchId.
• For xG analysis, use tournament mode with onlyFinished: true and includeStatistics: true.
• winner is only set once a match ends - deliberately null in progress rather than guessing.

Related actors

• ESPN Sports Scraper - US leagues: scoreboards, odds, standings, rosters
• Sports Betting Odds Scraper - live lines, arbitrage and +EV across books