Flashscore: Tournament Seasons & Teams

Extract season history and team standings for any Flashscore tournament — no proxy required. Flashscore does not provide a public API; this actor provides structured, API-like access to season data for all sports on the platform, including football, basketball, tennis, ice hockey, volleyball, handball, baseball, American football, and cricket. By default it returns only the current season in 3 requests per tournament — keeping costs minimal. Set onlyCurrent to false to retrieve the full season archive (up to 50 seasons) including every season champion, final standings, and team roster.

What does this actor extract?

Every season record contains 12 top-level fields plus a nested teams array. Each team object contains 13 fields.

Season fields

Field	Type	Example
tournament_url	string	"https://www.flashscore.com/football/england/premier-league/"
tournament_template_id	string	"dYlOSQOD"
tournament_id	string	"KKay4EE8"
tournament_stage_id	string	"OEEq9Yvp"
season_name	string	"2025/2026" (cross-year) or "2025" (single-year)
season_start	string	"2025"
season_end	string	"2026"
is_current	boolean	true
stage_name	string	"Main"
winner	object or null	{"team_id": "...", "name": "...", "url": "...", "logo_url": "..."}
teams	array	See team fields below
scraped_at	string (ISO 8601 UTC)	"2026-04-24T17:16:05Z"

Team fields (nested in teams[])

Field	Type	Example
team_id	string	"Wtn9Stg0"
name	string	"Manchester City"
url	string	"https://www.flashscore.com/team/manchester-city/Wtn9Stg0/"
logo_url	string or null	CDN URL
position	integer	1
played	integer or null	35
wins	integer or null	21
draws	integer or null	8
losses	integer or null	6
goals	string or null	"66:29"
points	integer or null	71
position_label	string or null	"q1" (Champions League spot)
group_name	string or null	null for single-table leagues, group name for multi-group tournaments

Who is this for?

• Football data analysts building historical databases: Retrieve every Premier League or La Liga season from the 1970s to today — champion, full standings table, and team roster — in a single run.
• Fantasy sports and gaming developers: Pull the current season's team roster and standings for any league the moment the season starts, without waiting for match results to aggregate.
• Researchers studying promotion and relegation: Use the position_label field to extract which teams earned Champions League spots or faced relegation in each season across decades of data.
• Sports betting platforms: Seed a historical odds model with season-level outcomes (champion, final standings) across multiple leagues and sports in batch.
• App developers integrating sports data: Use onlyCurrent: true (default) to cheaply refresh current-season team lists on a schedule without retrieving the full archive on every run.

Why use this actor?

Multi-sport breadth — 9 sports, one actor. Unlike football-only scrapers, this actor works identically for any Flashscore sport — football, basketball, tennis, ice hockey, volleyball, handball, baseball, American football, and cricket. A Premier League URL and an NBA URL are processed by the same pipeline; no configuration changes needed.

No proxy required. The actor fetches directly from Flashscore's internal API endpoints. You are charged only for standard Apify compute — no residential or datacenter proxy costs.

Efficient default mode. With onlyCurrent: true (default), the actor retrieves the current season in 3 requests per tournament. There are no unnecessary API calls and no waiting for a full historical crawl when all you need is this season's teams.

Historical depth. Set onlyCurrent: false to retrieve up to 50 seasons per tournament. Premier League data goes back to 1976/1977. Each season record includes the champion and the full final standings.

Structured nested output. Season metadata, the winner, and the complete team standings are all returned in a single structured item per season — ready to insert directly into your database or pipeline without further joins.

How to use it

1. Open the actor on the Apify Store.
2. (Optional) Use the sport selector to see an example URL for your sport. This field does not affect the crawl — the sport is detected from the URL path automatically.
3. Paste one or more Flashscore tournament URLs into tournamentUrls. Use the URL from the tournament's main page on flashscore.com (e.g. https://www.flashscore.com/football/england/premier-league/).
4. Leave onlyCurrent at true (default) to get only the current season. Set it to false to retrieve up to 50 historical seasons.
5. Click Start and download results as JSON, CSV, or XLSX when the run completes.

Sample input — current season only (fastest, lowest cost):

{
  "tournamentUrls": ["https://www.flashscore.com/football/england/premier-league/"],
  "onlyCurrent": true
}

Sample input — full season archive:

{
  "tournamentUrls": [
    "https://www.flashscore.com/football/england/premier-league/",
    "https://www.flashscore.com/basketball/usa/nba/"
  ],
  "onlyCurrent": false
}

Input parameters

Parameter	Type	Default	Description
tournamentUrls	array of strings	—	Required. One or more Flashscore tournament or league page URLs. At least 1 URL is required. Example: ["https://www.flashscore.com/football/england/premier-league/"].
onlyCurrent	boolean	true	true = current season only (3 requests per tournament, fast and low-cost). false = full season archive up to 50 seasons per tournament.
sport	string enum	"football"	UI hint only — select your sport to see a correctly formatted example URL in the editor. Has no effect on the crawl; sport is detected automatically from the URL. Values: football, tennis, basketball, ice-hockey, volleyball, handball, baseball, american-football, cricket.

Output format

A complete record for the current Premier League season looks like this:

{
  "tournament_url": "https://www.flashscore.com/football/england/premier-league/",
  "tournament_template_id": "dYlOSQOD",
  "tournament_id": "KKay4EE8",
  "tournament_stage_id": "OEEq9Yvp",
  "season_name": "2025/2026",
  "season_start": "2025",
  "season_end": "2026",
  "is_current": true,
  "stage_name": "Main",
  "winner": null,
  "teams": [
    {
      "team_id": "Wtn9Stg0",
      "name": "Manchester City",
      "url": "https://www.flashscore.com/team/manchester-city/Wtn9Stg0/",
      "logo_url": "https://static.flashscore.com/res/image/data/Glb3yYRq-4bqaxRtQ.png",
      "position": 1,
      "played": 35,
      "wins": 21,
      "draws": 8,
      "losses": 6,
      "goals": "66:29",
      "points": 71,
      "position_label": "q1",
      "group_name": null
    }
  ],
  "scraped_at": "2026-04-24T17:16:05Z"
}

For completed seasons, winner is an object:

{
  "winner": {
    "team_id": "K7ByYnH0",
    "name": "Liverpool",
    "url": "https://www.flashscore.com/team/liverpool/K7ByYnH0/",
    "logo_url": "https://static.flashscore.com/res/image/data/lId4TMwf-Hd7bNp2A.png"
  }
}

Which sports are supported?

All nine sports listed below are fully supported via the same URL-based interface. Paste the tournament URL from flashscore.com and the actor detects the sport automatically.

Sport	Example tournament URL
Football	https://www.flashscore.com/football/england/premier-league/
Basketball	https://www.flashscore.com/basketball/usa/nba/
Tennis	https://www.flashscore.com/tennis/atp-singles/wimbledon/
Ice Hockey	https://www.flashscore.com/ice-hockey/usa/nhl/
Volleyball	https://www.flashscore.com/volleyball/world/world-championship/
Handball	https://www.flashscore.com/handball/world/world-championship-men/
Baseball	https://www.flashscore.com/baseball/usa/mlb/
American Football	https://www.flashscore.com/american-football/usa/nfl/
Cricket	https://www.flashscore.com/cricket/world/icc-cricket-world-cup/

No proxy required

This actor fetches tournament data directly from Flashscore's internal API without residential or datacenter proxies. You are not charged for proxy bandwidth — only standard Apify compute costs apply. This makes it significantly cheaper to run at scale compared to scrapers that require proxy infrastructure.

What this actor does not cover

This actor is focused on season structure and team standings. It does not extract:

• Live match scores or match-by-match results
• Player-level statistics or player profiles
• Betting odds or bookmaker lines
• Match statistics (shots, cards, possession)
• News articles or editorial content
• More than 50 historical seasons per tournament
• Multiple winners per season (only the primary champion is returned; multi-winner scenarios are not yet supported)

For match listings, scores, and live fixtures, see Flashscore: Match Listings, Scores & Fixtures. For head-to-head records, see Flashscore H2H.

FAQ

Does this actor require a proxy?

No. The actor fetches tournament data directly from Flashscore's internal API without any residential or datacenter proxy. You do not need a proxy subscription to use it.

Which sports are supported?

All nine sports available under the Flashscore umbrella: football, basketball, tennis, ice hockey, volleyball, handball, baseball, American football, and cricket. Sport is detected automatically from the tournament URL — no configuration is needed.

Why is winner null for the current season?

The current season is still in progress, so no champion has been crowned yet. winner: null is expected behaviour for any season that has not yet concluded. For completed seasons (all historical seasons), winner is an object containing the champion's name, URL, and logo.

Why is teams an empty array for some tournaments?

Knockout-format tournaments (such as Wimbledon or the NBA Playoffs) do not have a standings table — there is no league table to extract. For these tournaments, teams is returned as [] (an empty array, not null). This is expected behaviour.

What is onlyCurrent and when should I use false?

onlyCurrent: true (default) returns only the current season for each URL — fast and low-cost at 3 requests per tournament. Use this when you only need the current team roster or standings.

Set onlyCurrent: false when you need the full historical archive. The actor returns up to 50 seasons per tournament. For Premier League, this covers back to the 1976/1977 season.

How much does a full historical run cost?

A full archive run for one tournament returns up to 50 season records. At standard Apify pricing, a run of this size costs well under $0.10. For 10 tournaments with full history (up to 500 season records total), the cost is typically below $1.

How is this actor different from the Flashscore match scraper?

This actor extracts season structure and standings: which seasons existed, who won each one, and which teams participated. It does not return individual match results.

For live scores, match results, and fixtures, use Flashscore: Match Listings, Scores & Fixtures. For head-to-head records between specific teams, use Flashscore H2H. For tennis match data, use Flashscore Tennis Matches.

Can I run this actor on a schedule?

Yes. Use Apify Scheduler to run the actor automatically at any interval. With onlyCurrent: true, a scheduled daily run is an efficient way to keep your current-season team roster and standings up to date.

Is scraping Flashscore legal?

Web scraping publicly available data is generally permitted for personal use and research purposes. Users are responsible for complying with Flashscore's terms of service and applicable local laws. Apify's legal guidelines on web scraping provide further context.

Related actors

These actors are part of the same Extractify Labs Flashscore portfolio and can be combined with this one:

Actor	What it extracts
Flashscore: Match Listings, Scores & Fixtures	Match results, live scores, and upcoming fixtures (±7 days)
Flashscore Live Matches	Real-time live match data
Flashscore H2H	Head-to-head records between two teams
Flashscore Tennis Matches	Tennis match results and tournament data