Flashscore Scraper

Scrape Flashscore tennis matches, scores, players, and tournaments from public pages and export Flashscore data to CSV, JSON, or Excel. This Flashscore API alternative turns repeatable inputs into structured matches for tennis results tracking and match analysis.

Each dataset row represents a public matche or a documented alternate record type. The output includes source identifiers and links where available, so you can verify a row, compare later runs, and distinguish missing source data from an omitted column.

What data can you extract from Flashscore?

The dataset schema defines every field below. Examples come from one successful published run; null means that field was not exposed for that particular record. Availability may differ by input mode, page, and record type.

Field	Description	Example
matchId	Stable match identifier.	M3TdTTy8
matchUrl	Direct match page URL.	https://www.flashscore.com/match/M3TdTTy8/
matchDate	Scheduled start time in UTC ISO 8601 format.	2026-09-25T05:10:00+00:00
matchEndTimestamp	Reported end time in UTC ISO 8601 format.	2026-09-25T06:13:17+00:00
matchStatus	Scheduled, live, finished, or unknown match phase.	FINISHED
matchType	Singles or doubles.	singles
resultType	Normal finish, retirement, or walkover when identified.	NORMAL
winner	Winning side: home or away.	away
walkoverNote	Public note attached to a walkover.	null
setsWonHome	Sets won by the home side.	0
setsWonAway	Sets won by the away side.	2
totalMatchDuration	Elapsed time estimated from listed start and end timestamps, H:MM.	1:03
sets	Set game scores and available tiebreak points. Duration is unavailable in the daily feed.	[{"home":2,"away":6,"duration":null,"tiebreakHome":null,"tiebreakAway":null},…
homePlayers	Home participant details.	[{"name":"Kopriva V.","shortName":"KOP","id":"EHGKxKDL","id2":"ziiOISWN","slu…
awayPlayers	Away participant details.	[{"name":"Shapovalov D.","shortName":"SHA","id":"zXddgn9o","id2":"6ZsfD6fo","…
homeName	Displayed home side name.	Kopriva V.
awayName	Displayed away side name.	Shapovalov D.
tournamentName	Tournament name and location.	Chengdu (China)
tournamentId	Tournament identifier.	WndHHPG1
tournamentUrl	Tournament page URL.	https://www.flashscore.com/tennis/atp-singles/chengdu/
categoryName	Full category label, including singles or doubles.	ATP - Singles
tour	Recognized tour family.	atp
surface	Playing surface when listed.	hard
roundName	Round name; unavailable from this daily feed.	null
currentServer	Serving side during a live match, 1 or 2.	null
currentGameScoreHome	Live point score for the home side.	null
currentGameScoreAway	Live point score for the away side.	null
dayOffset	Requested day relative to today.	-1

Use the identifier and URL fields as your join keys before comparing snapshots. Fields that describe a page, search, category, author, or tournament establish where the record came from; keep them when you export a subset. Numeric values and boolean flags reflect the public page at collection time, not a permanent claim about the underlying item.

How to scrape Flashscore

1. Open the actor input form and choose a narrow public source: a search phrase, page URL, item URL, or ID supported by the input fields below.
2. Set the relevant per-source page or result limit and the total item limit. Start with a small sample to check which optional fields the public source exposes.
3. Run the actor. Its dataset contains one structured row per saved result; inspect the first rows and their source links for the chosen input.
4. Download the dataset as JSON, CSV, or Excel. Preserve identifiers when combining runs so repeated results can be deduplicated.

For this actor, dayOffsets select dates relative to the run. Filters can narrow statuses, tours, and tournaments; startUrls can specify tournament pages. The feed reports matches for the selected day, including live or scheduled rows where present.

Input

Use only the parameters relevant to your collection mode. An omitted optional filter uses the schema default shown here; an empty array, zero, and an omitted value can have different meanings, so keep intentional settings in your saved input.

| Parameter | Type | Default | Description | | --- | --- | --- | | dayOffsets | array | ["0"] | Days relative to today, from -7 through 7. Zero is today. | | matchStatuses | array | ["all"] | Return all matches, or select finished, live, and scheduled matches. | | tours | array | [] | Limit matches to ATP, WTA, ITF, or Challenger. Empty includes every tennis category. | | tournaments | array | [] | Optional case-insensitive fragments of tournament names. Ignored when start URLs are provided. | | startUrls | array | [] | Optional tennis tournament or results URLs on flashscore.com. Limits results to those tournaments and overrides tournament names. | | maxItems | integer | 0 | Stop after this many matches across all selected days. Zero means no cap. | | proxyConfiguration | object | {"useApifyProxy":true} | Connection settings for tennis pages and feeds. |

Example input based on the published golden run (long URL lists are shortened):

{
  "dayOffsets": [
    "-1"
  ],
  "matchStatuses": [
    "finished"
  ],
  "maxItems": 80
}

The example is a starting shape, not a guarantee of a particular result count. Source inventory and page accessibility change. When you need repeatable comparisons, save the exact input JSON with the run date and inspect the returned source or record-type field.

Output example

The following is one real item from a successful published dataset. Long text and media arrays are shortened for readability; the actual dataset keeps the original values and all schema fields.

{
  "matchId": "M3TdTTy8",
  "matchUrl": "https://www.flashscore.com/match/M3TdTTy8/",
  "matchDate": "2026-09-25T05:10:00+00:00",
  "matchEndTimestamp": "2026-09-25T06:13:17+00:00",
  "matchStatus": "FINISHED",
  "matchType": "singles",
  "resultType": "NORMAL",
  "winner": "away",
  "setsWonHome": 0,
  "setsWonAway": 2,
  "totalMatchDuration": "1:03",
  "sets": [
    {
      "home": 2,
      "away": 6,
      "duration": null,
      "tiebreakHome": null,
      "tiebreakAway": null
    },
    {
      "home": 3,
      "away": 6,
      "duration": null,
      "tiebreakHome": null,
      "tiebreakAway": null
    }
  ],
  "homePlayers": [
    {
      "name": "Kopriva V.",
      "shortName": "KOP",
      "id": "EHGKxKDL",
      "id2": "ziiOISWN",
      "slug": "kopriva-vit",
      "nationality": "Czech Republic",
      "ranking": null,
      "photoUrl": "https://static.flashscore.com/res/image/data/GzfnH16k-YJrvxxT3.png"
    }
  ],
  "awayPlayers": [
    {
      "name": "Shapovalov D.",
      "shortName": "SHA",
      "id": "zXddgn9o",
      "id2": "6ZsfD6fo",
      "slug": "shapovalov-denis",
      "nationality": "Canada",
      "ranking": null,
      "photoUrl": "https://static.flashscore.com/res/image/data/0pJDiOUH-8tZx1kbA.png"
    }
  ],
  "homeName": "Kopriva V.",
  "awayName": "Shapovalov D.",
  "tournamentName": "Chengdu (China)",
  "tournamentId": "WndHHPG1",
  "tournamentUrl": "https://www.flashscore.com/tennis/atp-singles/chengdu/",
  "categoryName": "ATP - Singles",
  "tour": "atp",
  "surface": "hard",
  "dayOffset": -1
}

This row illustrates the observed output structure, including its identifiers and public links. Empty values elsewhere in the dataset should be interpreted field by field; a field shown in this example is not promised for every matche.

Use cases

• Sports desks can populate daily tennis results with tournament and player context.
• Analysts can compare match duration and set scores across tours and surfaces.
• Fan apps can monitor public live status and current game scores where available.
• Historical datasets can key rows by matchId to avoid duplicate matches across runs.

The strongest analyses keep source context. A field such as price, rating, engagement, or rank has meaning only with its associated item, query, date, and public URL. Keep the raw export and create a separate cleaned view for charts or alerts.

How much does it cost to scrape Flashscore?

The price is $0.80 per 1,000 saved results. Platform usage is included. The charge scales with output rows, so a restrictive filter or inaccessible page can produce fewer billable results than the requested maximum.

• 100 matches: $0.08. This is useful for checking a small cohort and confirming which optional fields are present.
• 1,000 matches: $0.80. This is the reference price for a larger export.
• 5,000 matches: $4.00. Reaching this size may require multiple focused sources or scheduled runs, depending on public inventory and source caps.

Compute any other estimate as saved result count × $0.80 / 1,000. A maximum input is a ceiling, not a purchase of that many rows. For planning, use the actual saved-item count from an initial representative run.

Tips for best results

Use dayOffsets such as -1 for completed previous-day results, then filter matchStatuses to finished for stable score analysis. Keep tournaments and tours focused when building a repeatable competition dataset.

Collect a small baseline first, record the exact input and date, and inspect both a typical row and a sparse row. Expand by adding focused sources instead of assuming one broad input can reveal the full public inventory. When comparing two runs, match stable IDs or canonical URLs and use the same filters so changes reflect the source rather than a changed query.

Export the full JSON when nested arrays or objects matter. CSV and Excel are convenient for sorting and joins, but nested structures may need flattening before spreadsheet analysis. Keep numeric fields numeric and preserve source URLs as text; do not infer a zero from a null.

Limits

Player rankings, surface, round, game scores, and set durations may be absent. Live fields change during matches; a completed-match snapshot is more stable for historical comparisons.

Public pages can change, disappear, or expose different fields for different records. The schema is a list of possible output columns, not a promise that each column is filled in each row. The maxItems-style input limits cap saved results; they do not bypass source pagination, public visibility, or a site-specific result ceiling.

Treat a saved result as a snapshot. If a later run returns fewer rows, first compare the input, source access, and public inventory before concluding that the underlying market changed. If you need an audit trail, retain the source URL, stable identifier, and run timestamp with the export.

Use with AI agents (MCP)

An agent can supply the documented input JSON, run this actor, and work from its dataset. Ask it to keep source links and identify null values explicitly when summarizing results. Example prompts:

Run Flashscore Scraper for the sample input above. Return the first 20 matches with their source URLs and the fields needed for tennis results tracking and match analysis. Mark unavailable fields as null.

Schedule a repeat Flashscore collection with the same filters. Compare records by stable ID or canonical URL and report only new, removed, or changed public values.

FAQ

Is it legal to scrape Flashscore?

This actor collects public data. Check the site’s terms, applicable law, and the rights of people whose data appears in your export. Follow GDPR and other privacy rules where relevant; do not use personal data for misuse, intrusive profiling, or unauthorized contact.

Do I need to configure proxies?

The input includes proxyConfiguration and defaults to Apify Proxy. Usually the default is enough to start. Availability can vary by page and region; changing network settings cannot make private or login-only information public.

How fast will a run finish?

Duration depends on the number of inputs, pages, detail requests, and source responses. A small sample is the best way to measure your workload. Increase the limits gradually, then use the observed run duration for scheduling and monitoring.

Can I schedule and monitor recurring runs?

Yes. Save the input and schedule recurring runs in Apify. Monitor run status, item count, and any missing-field changes; store the run date alongside exports when comparing snapshots.

Can I export to Google Sheets or Excel?

Yes. Download CSV or Excel from the dataset, or pass JSON to a spreadsheet integration. For nested fields, flatten the specific child values you need rather than losing the original JSON.

What if a field is empty?

An empty or null field means it was not available from that public source record in that run. Check the source URL, input mode, and record type. Do not replace missing prices, counts, dates, or flags with zero unless your own analysis has a documented rule for doing so.

Does this cover every sport on Flashscore?

No. This actor uses the public tennis daily feed and returns tennis match records.

Integrations

Use the Apify API to start runs and retrieve the dataset, webhooks to react when a run finishes, or Zapier, Make, and n8n to route records into other systems. Google Sheets supports lightweight review, while scheduled runs provide repeat snapshots. Keep the raw JSON when downstream workflows need nested fields or exact null values.

Support

Open an issue on the Issues tab; we reply within 24h and add fields on request.