Sofascore Scraper - Fixtures, Live Scores, Results & Tables

Get one row per match from Sofascore: give it some days, a competition, a few match links or the live board, and each row carries 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 regions for each sport unless you name others, and below football and basketball the coverage often thins to a fixture and a final score.

Input	Days, Sofascore competition, team or match links, or the live board
Output	One row per match: competition, round, teams, kick-off, state, score with half-time, extra time and penalties, winner. One row per team when you ask for league tables
Ceiling	50,000 rows and 60 days per run
Account needed	None
Price	$0.65 per 1,000 rows on the Free plan, a little less on paid plans. The free plan's $5 a month covers about 7,600

🔍 What Sofascore Scraper does

Five ways in. One run can mix them, except teams with days.

• 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. A match counts on its UTC kick-off day.
• 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.
• Teams. A link, id or name, for that team's results, then fixtures.
• 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 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 cost one extra page read per match. A match whose page will not open still arrives without them.

📋 What data you get from each Sofascore match

What you get	Field
The match id, its page and the sport	matchId, url, sport
Competition, the region it is filed under, season and round	country, countryCode, competition, competitionId, competitionUrl, season, seasonId, round, roundName
Kick-off in UTC	startTime, startTimestamp
The state of play	status, statusDetail, statusCode
Both teams, with their ids and countries	homeTeam, homeTeamId, homeTeamCountry, awayTeam, awayTeamId, awayTeamCountry
The score, with half-time, normal time, extra time, penalties and aggregate	homeScore, awayScore, score, homeScoreHalftime, homeScoreNormaltime, homeScoreExtraTime, homeScorePenalties, homeScoreAggregate and the away twins
The winner and red cards	winner, homeRedCards, awayRedCards
Venue and referee, optional	venue, venueCity, venueCountry, venueCapacity, referee
League table rows, optional	position, team, played, wins, draws, losses, goalsFor, goalsAgainst, goalDifference, points, note

▶️ How to scrape Sofascore fixtures and results

1. Open Sofascore Scraper and click Try for free.
2. Pick your Sports.
3. Set Upcoming days or Last days, or a From date and To date. Or paste links into Competitions, Teams or Match links, or switch on Live now.
4. Tick League tables or Venue and referee if you want them, and 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 Apify API.

💰 How much does it cost to scrape Sofascore?

$0.65 per 1,000 rows on the Free plan, less on paid plans. On the free plan, the $5 Apify gives you each month covers about 7,600 rows. A match row and a league-table row cost the same, and two hundred rows, the prefilled cap, come to 13 cents.

Not charged: the sample row, the diagnostic row, matches your statuses filter drops, other days' matches, 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 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
}

Field	Default	What it is
sports	football	Any of 21: football, basketball, tennis, ice-hockey, volleyball, handball, baseball, american-football, rugby, cricket, snooker, darts, table-tennis, badminton, futsal, minifootball, beach-volley, aussie-rules, floorball, waterpolo, esports. A name not on the list is skipped.
upcomingDays	none, the box starts at 1	Today and the days after, 0 to 30. 1 is today only. Matches already under way come back with their live score.
lastDays	none	The last full days, ending yesterday, 0 to 365. 1 is yesterday. It adds to upcomingDays, so 1 and 1 is yesterday plus today.
dateFrom	none	The first day of a fixed range, as YYYY-MM-DD. Once it is filled in, the two counters above are ignored.
dateTo	none	The last day of that range. Empty means today.
live	off	Adds everything being played at that moment, in the sports above. It is one quick read per sport, so it sits fine beside a date range.
countries	none, which reads the 40 busiest regions	Narrows a date range to regions as Sofascore names them: England, Spain, Brazil. "Europe", "World" and "South America" hold the international competitions. A name also matches longer regions containing it, so "England" brings in England Amateur.
tournaments	none	Competition links, such as https://www.sofascore.com/football/tournament/england/premier-league/17, or names. The first 50 are read.
teams	none	Team links, such as https://www.sofascore.com/team/football/arsenal/42, bare ids or names, looked up in sports. You get the team's own list: its most recent played matches first, then the ones to come. The first 50 are read. Not with days yet: a run with both is refused before anything is read, so clear upcomingDays, which the form fills with 1.
matches	none	Match links or bare ids. The first 50 are read.
statuses	none, which keeps every match	Keep only matches in these states: notstarted, inprogress, finished, postponed, canceled, suspended.
includeStandings	off	Adds league tables, one row per team, charged the same as a match.
standingTypes	the box starts at total	total, home or away. Only read when league tables are on.
includeVenue	off	Adds venue, venueCity, venueCountry, venueCapacity and referee. Slows a big run down several times.
maxItems	200	The most rows one run returns, matches and table rows together, 1 to 50,000.
proxyConfiguration	leave it alone	Optional. Add your own servers here if you want the run to go out through them.

📤 What you get back

A real match row from a run on 20 September 2026, 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"
}

Field	How to read it
rowType	match or standing. A diagnostic row says diagnostic.
country, countryCode	The region Sofascore files the competition under, such as England, Europe or World. The teams' own countries are in homeTeamCountry and awayTeamCountry.
startTime, startTimestamp	Kick-off in UTC as an ISO string, and the same moment as a Unix timestamp.
status, statusDetail, statusCode	Sofascore's own word for the state of the match, the longer label it shows ("Ended", "Halftime"), and its numeric code.
homeScore, awayScore, score	The current or final score. Null while nothing has been played.
homeScoreHalftime and the rest	Filled only when they apply, so a league game leaves extra time, penalties and aggregate null. That is a game that ended after ninety minutes, not a gap.
winner	The winning team, "draw", or null until the match has finished.
homeRedCards, awayRedCards	Filled when Sofascore lists red cards, null otherwise.
venue to referee	Null unless Venue and referee was on or the match was pasted in.
groupName, standingType, note	On a table row: the group the table belongs to, whether it is the overall, home or away table, and the label Sofascore puts beside the team ("Champions League", "Relegation").

🧾 Reading the output

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

Row	How to spot it	Charged
A match	rowType is match and there is no _sample field	yes
A table row	rowType is standing	yes
The sample row	_sample: true and charged: false. Written only when the input asks for nothing at all	no
The diagnostic row	rowType is diagnostic, _diagnostic: true, charged: false. Written only when a run delivered no rows	no

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

Code	What it means
EMPTY_DAY	Sofascore lists nothing for that sport and day in the regions read.
NO_SUCH_REGION	None of your countries match a Sofascore region for that sport.
REGIONS_UNREADABLE, REGION_DAY_UNREADABLE	The region list for a sport, or one region on one day, could not be read.
BAD_COMPETITION, COMPETITION_NOT_FOUND, SEARCH_FAILED	Not a competition link, no competition by that name, or the name lookup failed.
SEASON_UNREADABLE, COMPETITION_PAGE_UNREADABLE, COMPETITION_DAY_UNREADABLE	Part of a named competition could not be read.
BAD_MATCH, MATCH_NOT_FOUND, MATCH_UNREADABLE	Not a match link or id, not on Sofascore, or the match could not be read.
BAD_TEAM, TEAM_NOT_FOUND, TEAM_PAGE_UNREADABLE	Not a team link, id or name, no team by that name in your sports or no matches listed under that id, or a page of a team's list could not be read.
LIVE_UNREADABLE	The live board for one sport could not be read.
NO_SEASON, TABLE_UNREADABLE	A league table was skipped.
DELIVERY_FAILED	Rows could not be written, so the run stopped.
BUDGET_TOO_LOW	The maximum charge you set does not cover one row, so nothing was read. This one is in the row's problem field.
TEAMS_WITH_DAYS	Teams and days were both set, so nothing was read. Also in the row's problem field.

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.

💡 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.
• A day can bring in its neighbours. Sofascore's list for a region and day can hold matches played on the day next to it, and those come back as rows and are charged like any other. Filter on startTime when the exact day matters.
• 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.
• It is not an official Sofascore tool. Dami's Studio is independent and is not affiliated with or endorsed by Sofascore, or by any other company named on this page.

🧭 Which sports data scraper do you need?

If you want	Use
Fixtures, results, live scores and league tables across 21 sports	This one
Sportsbook lines and player props	Sports Odds Scraper
Tennis results with set scores, tiebreaks and average odds	Tennis Results & Odds Scraper
Prediction-market prices, sport included	Kalshi Markets Scraper

❓ 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.

Can I call it from code or connect it to an AI assistant?

Yes. The API tab has ready-made code for Python, JavaScript and the command line. For Claude, ChatGPT or another MCP client, connect https://mcp.apify.com/?tools=fetch-actor-details,dami_studio/sofascore-scraper. Either way the run happens on your Apify account at the same price.

Is it legal to scrape Sofascore?

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.