Flashscore Matches Scraper

Extract public Flashscore match listings for any sport and day, or resolve specific public match URLs into venue, city and TV-channel detail. Every row is flat, typed and null-safe for research, alerting, spreadsheets and pipelines.

Why this actor?

• Two buyer-shaped modes: a whole listing day, or one match URL.
• One flat row per match: participants, tournament, status, start time, sets.
• Hard local result limits keep delivery and spend bounded.
• Invalid URLs, empty listing days and blocked requests are free error rows.
• Public pages only: no login, no cookies, no challenge bypass, no media.

Input

{"mode":"matches","listingUrl":"https://www.flashscore.com/tennis/","dayOffset":0,"maxResults":100}

For detail mode, set mode to detail and provide matchUrls.

Input	Meaning
mode	matches (a listing day) or detail (specific match URLs).
listingUrl	A public flashscore.com/<sport>/ listing page.
dayOffset	UTC day to read: 0 today, -1 yesterday, 1 tomorrow (−3…3).
maxResults	Hard local cap on delivered rows and charges in matches mode.
matchUrls	Public match URLs for detail mode; deduplicated, capped at 50.
simulate_upstream_block	Debug hook. Leave disabled.
proxyConfiguration	Proxy for Flashscore requests; datacenter is the default.

Output

{"mode":"matches","input":"https://www.flashscore.com/tennis/","match_id":"4zyfwf9s","sport":"tennis","tournament":"WTA - SINGLES: US Open (USA), hard","tournament_url":"https://www.flashscore.com/tennis/wta-singles/us-open/","title":"Sabalenka A. - Pegula J.","home":"Sabalenka A.","away":"Pegula J.","home_url":"https://www.flashscore.com/player/sabalenka-aryna/vyhksgUB/","away_url":"https://www.flashscore.com/player/pegula-jessica/KdojxrAR/","start_time":"2026-09-10T23:00:00.000Z","status":"scheduled","status_code":"1","url":"https://www.flashscore.com/match/tennis/sabalenka-aryna-vyhksgUB/pegula-jessica-KdojxrAR/?mid=4zyfwf9s","score_home":null,"score_away":null,"set_scores":[],"venue":null,"city":null,"tv_channels":[],"error":null,"scraped_at":"2026-09-10T10:15:55.554Z"}

Field	Meaning
mode	Which mode produced the row: matches or detail.
input	The listing URL or match URL this row came from.
match_id	Flashscore match id, also carried in the match URL.
sport	Sport slug, e.g. tennis.
tournament	Public competition and stage line.
tournament_url	Public tournament page.
title	"home - away".
home	Home/first participant.
away	Away/second participant.
home_url	Public participant page for the home side.
away_url	Public participant page for the away side.
start_time	Scheduled start time, ISO 8601 UTC.
status	scheduled, live or finished.
status_code	Raw upstream status code the status is derived from.
url	Canonical public match URL.
score_home	Home score: sets won in tennis, goals/points elsewhere.
score_away	Away score: sets won in tennis, goals/points elsewhere.
set_scores	Per-set or per-period scores in order; empty before play starts.
venue	Venue, detail mode only.
city	City, detail mode only.
tv_channels	Broadcasters listing the match, detail mode only.
error	Free per-input error; null on match rows.
scraped_at	Extraction timestamp.

Pricing

Pay per event, and the platform usage is on us — the price you see is the price you pay, with no compute bill on top.

Event	Price	What one charge buys
Flashscore match row	$0.001	One delivered public Flashscore match row. An invalid or missing mode/URL, a listing day with no matches, and an upstream block, 5xx or timeout are free error rows and are never charged.
Actor Start	$0.002	One run, whatever it returns.

Higher Apify subscription tiers pay less on every event (Silver −20%, Gold −35%).

Proxy

Requests use the Apify proxy configured in proxyConfiguration. The validated default is datacenter. This actor does not bypass challenges, log in, or read private pages.

Use cases

• Track a tournament day across every court, with scores and start times.
• Alert on a followed match's status change.
• Build a dated results dataset for a sport.
• Find which broadcaster carries a match.

FAQ

Does this need a Flashscore account? No. Only public pages and the site's own public fixture feed are read.

Do scheduled matches have scores? No — score_home, score_away and set_scores are empty until play starts, and the keys are always present.

Why are venue, city and tv_channels empty in matches mode? They come from the per-match detail feed, which only detail mode fetches.

This Actor is an independent tool and is not affiliated with Flashscore.