# Flashscore: Tournament Seasons & Teams (`extractify-labs/flashscore-seasons`) Actor Extract season history and team standings for any Flashscore tournament. Works for football, basketball, tennis and all other sports. - **URL**: https://apify.com/extractify-labs/flashscore-seasons.md - **Developed by:** [Extractify Labs](https://apify.com/extractify-labs) (community) - **Categories:** News, Other - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Flashscore: Tournament Seasons & Teams Extract season history and team standings for any [Flashscore](https://www.flashscore.com) 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](https://apify.com/extractify-labs/flashscore-seasons). 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):** ```json { "tournamentUrls": ["https://www.flashscore.com/football/england/premier-league/"], "onlyCurrent": true } ```` **Sample input — full season archive:** ```json { "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: ```json { "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: ```json { "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](https://apify.com/extractify-labs/flashscore-extractor). For head-to-head records, see [Flashscore H2H](https://apify.com/extractify-labs/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](https://apify.com/extractify-labs/flashscore-extractor). For head-to-head records between specific teams, use [Flashscore H2H](https://apify.com/extractify-labs/flashscore-h2h). For tennis match data, use [Flashscore Tennis Matches](https://apify.com/extractify-labs/flashscore-tennis-matches). #### Can I run this actor on a schedule? Yes. Use [Apify Scheduler](https://docs.apify.com/platform/schedules) 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](https://www.flashscore.com/page/terms-of-service/) and applicable local laws. Apify's [legal guidelines on web scraping](https://apify.com/legal/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](https://apify.com/extractify-labs/flashscore-extractor) | Match results, live scores, and upcoming fixtures (±7 days) | | [Flashscore Live Matches](https://apify.com/extractify-labs/flashscore-live-matches) | Real-time live match data | | [Flashscore H2H](https://apify.com/extractify-labs/flashscore-h2h) | Head-to-head records between two teams | | [Flashscore Tennis Matches](https://apify.com/extractify-labs/flashscore-tennis-matches) | Tennis match results and tournament data | # Actor input Schema ## `sport` (type: `string`): Select the sport you are scraping. This guides you to the correct URL format — paste a tournament URL for the selected sport into the Tournament URLs field below.

Supported sports and example URLs:Note: this field is for guidance only. The sport is automatically detected from the URL you provide. ## `tournamentUrls` (type: `array`): One or more Flashscore tournament or league page URLs. Example: https://www.flashscore.com/football/england/premier-league/. Use the main tournament page, not a match page, team page, or country page. ## `onlyCurrent` (type: `boolean`): When enabled (default), only the current season is returned — fast and low-cost. Disable to retrieve all historical seasons (may trigger 50+ requests per tournament). ## Actor input object example ```json { "sport": "football", "tournamentUrls": [ "https://www.flashscore.com/football/england/premier-league/" ], "onlyCurrent": true } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "tournamentUrls": [ "https://www.flashscore.com/football/england/premier-league/" ] }; // Run the Actor and wait for it to finish const run = await client.actor("extractify-labs/flashscore-seasons").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "tournamentUrls": ["https://www.flashscore.com/football/england/premier-league/"] } # Run the Actor and wait for it to finish run = client.actor("extractify-labs/flashscore-seasons").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "tournamentUrls": [ "https://www.flashscore.com/football/england/premier-league/" ] }' | apify call extractify-labs/flashscore-seasons --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=extractify-labs/flashscore-seasons", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Flashscore: Tournament Seasons & Teams", "description": "Extract season history and team standings for any Flashscore tournament. Works for football, basketball, tennis and all other sports.", "version": "0.0", "x-build-id": "6a7W4hFxXkCygNmsA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/extractify-labs~flashscore-seasons/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-extractify-labs-flashscore-seasons", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/extractify-labs~flashscore-seasons/runs": { "post": { "operationId": "runs-sync-extractify-labs-flashscore-seasons", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/extractify-labs~flashscore-seasons/run-sync": { "post": { "operationId": "run-sync-extractify-labs-flashscore-seasons", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "tournamentUrls" ], "properties": { "sport": { "title": "Sport", "enum": [ "football", "tennis", "basketball", "ice-hockey", "volleyball", "handball", "baseball", "american-football", "cricket" ], "type": "string", "description": "Select the sport you are scraping. This guides you to the correct URL format — paste a tournament URL for the selected sport into the Tournament URLs field below.

Supported sports and example URLs:
  • 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/french-open/
  • 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/
Note: this field is for guidance only. The sport is automatically detected from the URL you provide.", "default": "football" }, "tournamentUrls": { "title": "Tournament URLs", "type": "array", "description": "One or more Flashscore tournament or league page URLs. Example: https://www.flashscore.com/football/england/premier-league/. Use the main tournament page, not a match page, team page, or country page.", "items": { "type": "string" } }, "onlyCurrent": { "title": "Current season only", "type": "boolean", "description": "When enabled (default), only the current season is returned — fast and low-cost. Disable to retrieve all historical seasons (may trigger 50+ requests per tournament).", "default": true } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```