# FlashScore Scraper Live (`statanow/flashscore-scraper-live`) Actor Use this alternative FlashScore API to scrape live matches from FlashScore, including scores, status, league, kick-off time, odds detailed event history, and other sport stats. Export live match data, run the scraper using the API, manage and schedule runs, or integrate with external tools. - **URL**: https://apify.com/statanow/flashscore-scraper-live.md - **Developed by:** [statanow](https://apify.com/statanow) (community) - **Categories:** News, Other, E-commerce - **Stats:** 415 total users, 24 monthly users, 100.0% runs succeeded, 11 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $0.001 / result This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ### ⚽ What can Flashscore Scraper do? FlashScore live scraper **extracts all currently live matches from FlashScore**, giving you real-time scores, timelines, and match events in a clean JSON format. Just run the Actor and you instantly get: πŸ”— Match URL and league 🏟️ Home and away teams ⏱️ Live score, minutes played, odds and match status πŸ“… Kick-off time πŸ“œ Full event history (goals, cards, substitutions, period summaries…) β™ŸοΈΒ Structured live football data inΒ **JSON, CSV, Excel, or HTML** ⌚️ Scheduling, export, and integrations viaΒ **API Endpoints &**Β **webhooks**Β  Use this scraper to monitor live games, build dashboards, automate alerts, support betting workflows, or analyze match momentum using live event data. ### πŸ“Š What data can I scrape from FlashScore? Each live match includes structured details:
🏠 Home team πŸ›« Away team ⚽ Home score πŸ₯… Away score
πŸ“‘ Status ⏱️ Status time πŸ“… Start time 🌍 League
πŸ“„ History (summary) 🏟️ Score&time πŸ₯… Player name πŸƒβ€β™‚οΈ Action&side
πŸ’° Odds
The final output includes the `source_url`, a `scraped_at` timestamp, the number of live matches, and a `matches[]` array with full match and event data. ### How to scrape FlashScore live data 1. [Create](https://console.apify.com/) a free Apify account. 2. Open [Flashscore Live Football Scraper](https://apify.com/statanow/flashscore-scraper-live). 3. Click **Start** and wait. 4. Download your sports dataset in **JSON, CSV, Excel, or XML**, or access it via API. 5. Schedule the scraper to extract football data automatically every minute, hour, day, etc. ### Sports available
⚽ Football πŸ€ Basketball 🏈 American football ⚾ Baseball 🏐 Volleyball
πŸ’ Hockey 🎾 Tennis 🏏 Cricket πŸ₯… Futsal 🏸 Badminton
πŸ“ Table tennis πŸ‰ Rugby union\league 🀾 Handball 🎯 Darts 🎱 Snooker
### ⬇️ Input FlashScore Scraper works out of the box, but **requires an input that tells it which sport** to scrape. #### In the Actor input, you may set: - **`sport`** *(required)* β€” which sport to scrape. - **`dayOffsets`** *(optional)* β€” one or more days to scrape, relative to today. `0` = Today, `-1` = Yesterday, `1` = Tomorrow. You can select multiple days at once. Range: `-7` … `+7`. Defaults to `["0"]` (today). Matches are always fetched from the **All Games** tab. Example: `{"sport": "football", "dayOffsets": ["0", "-1", "1"]}` Available sports name: `"football", "basketball", "american-football", "futsal", "rugby union", "rugby league", "handball", "baseball", "hockey", "cricket", "tennis", "volleyball", "badminton", "table-tennis", "darts", "snooker"` Available day offsets: `"-7", "-6", "-5", "-4", "-3", "-2", "-1", "0", "1", "2", "3", "4", "5", "6", "7"` In Apify Console you can set these variables underΒ **Actor β†’ Settings β†’ Environment variables**. ### ⬆️ Output When FlashScore Live Data Scraper finishes the run, it saves a single JSON file under the key **Output** in the default key-value store. You can view it in the **Storage** tab, download it, or connect it to your workflow via API. Flashscore Data Scraper live output #### Sample of extracted live data from FlashScore ```json [{ "home_team": "Morocco U17", "away_team": "Brazil U17", "home_score": 1, "away_score": 1, "status": "Live", "status_time": "2nd Half - 58'", "start_time": "21.11.2025 16:45", "league": "WORLD: World Cup U17 - Play Offs", "history": [ { "kind": "summary", "time": "1st Half: 1:1", "score": "0 - 1" }, { "kind": "event", "time": "16", "score": "0 - 1", "side": "away", "player": "Dell (Ruan Pablo)", "action": "Goal" }, { "kind": "summary", "time": "2nd Half", "score": "0 - 1" }, { "kind": "event", "time": "57", "side": "home", "player": "Eddaoudi A.", "action": "Yellow card" } ] }, { "home_team": "Beroe", "away_team": "Spartak Varna", "home_score": 0, "away_score": 0, "status": "Live", "status_time": "2nd Half - 57'", "start_time": "21.11.2025 16:45", "league": "BULGARIA: efbet League", "history": [ { "kind": "summary", "time": "1st Half: 0:0", "score": "0 - 0" }, { "kind": "event", "time": "40", "side": "away", "player": "Lozev D.", "action": "Yellow card" }, { "kind": "event", "time": "44", "side": "home", "player": "Salomoni J.", "action": "Red card" }, { "kind": "summary", "time": "2nd Half", "score": "0 - 0" }, { "kind": "event", "time": "50", "side": "away", "player": "Yordanov D.", "action": "Yellow card" } ] }, { "home_team": "Pafos", "away_team": "Aris", "home_score": 0, "away_score": 0, "status": "Live", "status_time": "1st Half - 6'", "start_time": "21.11.2025 18:00", "league": "CYPRUS: Cyprus League", "history": [ { "kind": "summary", "time": "1st Half: 0:0", "score": "0 - 0" } ] }, { "home_team": "Pisek", "away_team": "Bohemians 1905 B", "home_score": 0, "away_score": 0, "status": "Live", "status_time": "1st Half - 6'", "start_time": "21.11.2025 18:00", "league": "CZECH REPUBLIC: 3. CFL - Group A", "history": [ { "kind": "summary", "time": "1st Half: 0:0", "score": "0 - 0" } ] }, { "home_team": "Dinamo Batumi", "away_team": "Dila Gori", "home_score": 1, "away_score": 0, "status": "Live", "status_time": "21'", "start_time": "21.11.2025 17:00", "league": "GEORGIA: Crystalbet Erovnuli Liga", "history": [ { "kind": "summary", "time": "1st Half: 1:0", "score": "1 - 0" }, { "kind": "event", "time": "21", "score": "1 - 0", "side": "home", "player": "Khozrevanidze L. (Chiteishvili R.) ()", "action": "Goal" }, { "kind": "event", "time": "37", "side": "away", "player": "Boansi E. -> Joao Araujo", "action": "Substitution" } ] }, { "home_team": "Slaven Belupo", "away_team": "Vukovar 1991", "home_score": 0, "away_score": 0, "status": "Live", "status_time": "1st Half - 6'", "start_time": "21.11.2025 18:00", "league": "CROATIA: HNL", "history": [ { "kind": "summary", "time": "1st Half: 0:0", "score": "0 - 0" } ] }, { "home_team": "Tersana", "away_team": "El Mansoura", "home_score": 0, "away_score": 0, "status": "Live", "status_time": "1st Half - 6'", "start_time": "21.11.2025 18:00", "league": "EGYPT: Division 2 A", "history": [ { "kind": "summary", "time": "1st Half: 0:0", "score": "0 - 0" } ] }, { "home_team": "FAR Rabat W", "away_team": "ASEC Mimosas W", "home_score": 0, "away_score": 0, "status": "Live", "status_time": "1st Half - 6'", "start_time": "21.11.2025 18:00", "league": "AFRICA: CAF Champions League Women - Play Offs", "history": [ { "kind": "summary", "time": "1st Half: 0:0", "score": "0 - 0" } ] }, { "home_team": "AS Douanes", "away_team": "ASF Dioulasso", "home_score": 0, "away_score": 0, "status": "Live", "status_time": "2nd Half - 77'", "start_time": "21.11.2025 16:30", "league": "BURKINA FASO: Premier League", "history": [ { "kind": "summary", "time": "1st Half: 0:0", "score": "0 - 0" }, { "kind": "summary", "time": "2nd Half", "score": "0 - 0" } ] }, { "home_team": "Al Naft", "away_team": "Al Mosul", "home_score": 0, "away_score": 0, "status": "Live", "status_time": "1st Half - 36'", "start_time": "21.11.2025 17:30", "league": "IRAQ: Stars League", "history": [ { "kind": "summary", "time": "1st Half: 0:0", "score": "0 - 0" } ] }] ```` ### ❓ FAQ #### Does it scrape finished or scheduled matches? No. This Actor only extracts **currently live** matches available on FlashScore. #### Can I use this in automations or external code? Yes. You can trigger it via API, connect it to webhooks, or integrate it using the Node.js and Python SDKs. #### Can FlashScore Data Scraper scrape other sports? This version focuses on **football (soccer)**. FlashScore uses different layouts for other sports, but it can be extended if needed. Let me know in a review if you'd like other sports scrapers. #### FlashScore Live Scraper not working? We continuously update and improve scraper reliability. If you notice bugs or changes in FlashScore website structure, please report them on the Actor’sΒ [**Issues tab**](https://apify.com/statanow/flashscore-scraper-live/issues/open)Β so we can fix them quickly. # Actor input Schema ## `sport` (type: `string`): Choose a sport for matches scraping. ## `dayOffsets` (type: `array`): Choose which days to scrape. 0 = Today, -1 = Yesterday, 1 = Tomorrow. Select multiple to scrape several days at once. ## Actor input object example ```json { "sport": "football", "dayOffsets": [ "0" ] } ``` # Actor output Schema ## `overview` (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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("statanow/flashscore-scraper-live").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 = {} # Run the Actor and wait for it to finish run = client.actor("statanow/flashscore-scraper-live").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 '{}' | apify call statanow/flashscore-scraper-live --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=statanow/flashscore-scraper-live", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "FlashScore Scraper Live", "description": "Use this alternative FlashScore API to scrape live matches from FlashScore, including scores, status, league, kick-off time, odds detailed event history, and other sport stats. Export live match data, run the scraper using the API, manage and schedule runs, or integrate with external tools.", "version": "0.0", "x-build-id": "72IDB81yCPjhKsYoo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/statanow~flashscore-scraper-live/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-statanow-flashscore-scraper-live", "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/statanow~flashscore-scraper-live/runs": { "post": { "operationId": "runs-sync-statanow-flashscore-scraper-live", "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/statanow~flashscore-scraper-live/run-sync": { "post": { "operationId": "run-sync-statanow-flashscore-scraper-live", "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": [ "sport" ], "properties": { "sport": { "title": "Sport", "enum": [ "football", "basketball", "american-football", "futsal", "rugby union", "rugby league", "handball", "baseball", "hockey", "cricket", "tennis", "volleyball", "badminton", "table-tennis", "darts", "snooker" ], "type": "string", "description": "Choose a sport for matches scraping.", "default": "football" }, "dayOffsets": { "title": "Days to fetch", "type": "array", "description": "Choose which days to scrape. 0 = Today, -1 = Yesterday, 1 = Tomorrow. Select multiple to scrape several days at once.", "items": { "type": "string", "enum": [ "-7", "-6", "-5", "-4", "-3", "-2", "-1", "0", "1", "2", "3", "4", "5", "6", "7" ], "enumTitles": [ "7 Days Ago (-7)", "6 Days Ago (-6)", "5 Days Ago (-5)", "4 Days Ago (-4)", "3 Days Ago (-3)", "2 Days Ago (-2)", "Yesterday (-1)", "Today (0)", "Tomorrow (+1)", "In 2 Days (+2)", "In 3 Days (+3)", "In 4 Days (+4)", "In 5 Days (+5)", "In 6 Days (+6)", "In 7 Days (+7)" ] }, "default": [ "0" ] } } }, "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 } } } } } } } } } } ```