Skip to main content
SofaScore matches of a sport on a day, or live now

Authorizations

x-scrapeunblocker-key
string
header
required

Your ScrapeUnblocker API key. Apply on every request.

Query Parameters

sport
string
default:football

The sport: football, basketball, tennis, ice-hockey, american-football, baseball, handball, volleyball, cricket, rugby, futsal, table-tennis, esports, darts, snooker, mma, aussie-rules, waterpolo, floorball, bandy, badminton, beach-volley, minifootball, padel, motorsport, cycling (soccer, hockey, nba, nfl and the like are accepted).

date
string | null

Day as YYYY-MM-DD, or today / yesterday / tomorrow (in timezone). Default today.

timezone
string | null

Time zone the day is read in: an IANA name ('Europe/London', 'America/New_York') or a UTC offset ('+02:00'). Default UTC.

live
boolean
default:false

true for the matches in progress right now (date is then ignored).

status
string
default:all

Keep only: all, live, upcoming, finished.

country
string | null

Only one country or category, by name, slug, ISO code or id: 'england', 'Spain', 'US', and for tennis 'ATP', 'WTA'.

tournament
string | null

Only one competition: an id, a sofascore.com tournament link or a name such as 'Premier League' or 'NBA'.

max_results
integer
default:100

Matches to return (1-500), the biggest competitions first.

Response

JSON with an events array (empty when there are none).