Sofascore Scraper

Sofascore Scraper: fixtures, results, live scores and league tables for 21 sports

Give it some days, a competition, a few match links or the live board, and it returns one row per match: the competition and round, both teams, kick-off in UTC, the state of play and the score. Switch on league tables and every competition the run touched adds one row per team as well. Know this before you buy: a date range reads only the 40 busiest countries for each sport unless you name others, and below football and basketball the coverage often thins to a fixture and a final score.

🔍 What Sofascore Scraper does

There are four ways in, and one run can mix them.

• Days. upcomingDays counts forward from today, lastDays back from yesterday, or you give a

fixed dateFrom and dateTo. Each day is read region by region: the 40 busiest per sport, or the ones you list in countries.

• Competitions. A link or a name. This replaces the region sweep: with dates you get those days

of it, without them the current season, played matches first.

• Matches. One link or bare id per match. These always come with the venue and referee.
• The live board. Everything in play at that moment.

A match reached twice comes back once.

winner comes from the score. Only a level score falls back on Sofascore's own flag, which is what settles a shootout. A drawn league game reads "draw"; an unfinished match reads null.

League tables follow the competitions the run touched, one row per team. Cups have none. With tables on, half your Maximum rows (up to 400) is kept for them, so matches cannot use up the whole allowance.

Venue and referee take one extra page read per match, so they make a big run several times slower. A match whose page will not open still arrives, without them.

📥 What you give it

Yesterday's results in England and Spain, with the tables behind them:

{
  "sports": ["football"],
  "lastDays": 1,
  "countries": ["England", "Spain"],
  "includeStandings": true,
  "maxItems": 500
}

📤 What you get back

A real match row from a real run, with Venue and referee switched on:

{
  "rowType": "match",
  "matchId": 16363249,
  "url": "https://www.sofascore.com/football/match/chelsea-brighton-and-hove-albion/FsN#id:16363249",
  "sport": "football",
  "country": "England",
  "countryCode": "EN",
  "competition": "Premier League",
  "competitionId": 17,
  "competitionUrl": "https://www.sofascore.com/football/tournament/england/premier-league/17",
  "season": "Premier League 26/27",
  "seasonId": 96668,
  "round": 2,
  "roundName": null,
  "startTime": "2026-08-30T13:00:00.000Z",
  "startTimestamp": 1788094800,
  "status": "finished",
  "statusDetail": "Ended",
  "statusCode": 100,
  "homeTeam": "Chelsea",
  "homeTeamId": 38,
  "homeTeamCountry": "England",
  "awayTeam": "Brighton & Hove Albion",
  "awayTeamId": 30,
  "awayTeamCountry": "England",
  "homeScore": 4,
  "awayScore": 3,
  "score": "4 - 3",
  "homeScoreHalftime": 3,
  "awayScoreHalftime": 1,
  "homeScoreNormaltime": 4,
  "awayScoreNormaltime": 3,
  "homeScoreExtraTime": null,
  "awayScoreExtraTime": null,
  "homeScorePenalties": null,
  "awayScorePenalties": null,
  "homeScoreAggregate": null,
  "awayScoreAggregate": null,
  "winner": "Chelsea",
  "homeRedCards": null,
  "awayRedCards": null,
  "venue": "Stamford Bridge",
  "venueCity": "London",
  "venueCountry": "England",
  "venueCapacity": 40341,
  "referee": "Michael Oliver",
  "scrapedAt": "2026-09-20T01:11:04.535Z"
}

And a league-table row from the same run:

{
  "rowType": "standing",
  "sport": "football",
  "country": "England",
  "countryCode": "EN",
  "competition": "Premier League",
  "competitionId": 17,
  "competitionUrl": "https://www.sofascore.com/football/tournament/england/premier-league/17",
  "season": "Premier League 26/27",
  "seasonId": 96668,
  "standingType": "total",
  "groupName": "Premier League 26/27",
  "position": 1,
  "team": "Manchester City",
  "teamId": 17,
  "played": 4,
  "wins": 4,
  "draws": 0,
  "losses": 0,
  "goalsFor": 8,
  "goalsAgainst": 2,
  "goalDifference": 6,
  "points": 12,
  "note": "Champions League",
  "updatedAt": "2026-09-19T18:23:53.000Z",
  "scrapedAt": "2026-09-20T01:11:29.425Z"
}

🧾 Reading the output

The free sample row says match too, so rowType alone does not separate data from notices.

The diagnostic row explains itself in note and lists up to ten problems, each with a code:

Every run also writes RUN_REPORT to its key-value store: what was asked for, what came back, what was left out and why, and why the run stopped. Problems on a run that did deliver rows go there, not into the dataset, and so does NO_TABLES when nothing touched had a table.

To keep only real data, drop rows carrying _sample or _diagnostic, then split on rowType. The Matches and League tables views choose columns. They do not filter rows.

▶️ How to run it

1. Open Sofascore Scraper and click Try for free. 2. Pick your Sports. Then set Upcoming days or Last days, or a From date and To date. Or paste links into Competitions or Match links, or switch on Live now. 3. Tick League tables or Venue and referee if you want them. 4. Set Maximum rows on purpose. One busy football day across the default regions runs to several thousand. 5. Click Start, then download the dataset as JSON, CSV or Excel, or read it from the API.

💰 How much does it cost?

$0.65 per 1,000 rows, flat on every Apify plan. A match row and a league-table row cost the same. Two hundred rows, the prefilled cap, come to 13 cents.

Not charged: the sample row, the diagnostic row, matches your statuses filter drops, a match reached twice, and anything the run could not read. If you set a maximum charge for the run, it stops at the last row that fits.

💡 What people use it for

• Posting yesterday's results somewhere every morning. "lastDays": 1 on a daily schedule gives

exactly that, with no date arithmetic to maintain.

• Keeping one league's fixtures, results and table in a spreadsheet for a tipping competition.
• Finding every postponed or suspended match across a weekend with Only these states.
• Backfilling a season of results, 60 days a run, before you start collecting day by day.

🚧 What it does not do

• No statistics. No lineups, player ratings, shot maps, possession, expected goals or odds.
• Not every country on a date range. The 40 busiest regions per sport, unless you name others in

Countries and regions.

• No more than 60 days in one run. A longer backfill is several runs.
• No stream. Live scores are one reading of the board. Schedule the run for a running score.
• Not much depth in the smaller sports. Several carry the fixture and the final score and

nothing else. Try a small Maximum rows first.

• No tables for cups. Group stages do have them.
• No gap filling. If a page cannot be read, the run carries on without it. Those matches are

missing and not charged, and RUN_REPORT lists what was missed.

• No local times. Everything is UTC.

🧭 Which sports scraper do you need?

❓ Questions people ask

Do I need an API key or a Sofascore account? No. There is nothing to sign up for.

How do I get one league and nothing else? Paste its Sofascore link into Competitions. A typed name works too, but a link is safer when a name is shared: half a dozen countries have something called a Super Cup.

Why is venue empty? Venue and referee was off, or that match's own page would not open.

Why did I get fewer rows than I asked for? Sofascore listed fewer, the run reached Maximum rows (or the match share of it, with tables on), or a page could not be read. RUN_REPORT says which.

Is it legal to use? Fixtures and scores are public, and nothing here needs a login. Check the site's terms against your plans for the data. Apify's write-up on the legality of web scraping is a fair starting point, and we are not lawyers.

🆘 If something breaks

Open the Issues tab on the actor page and send the input and the run ID. The run's RUN_REPORT usually names the reason already.