# Flashscore Data Extractor (`dataizi-srl/flashscore-data-extractor`) Actor

Flashscore Match Scraper - fast, reliable extractor of fixtures and match metadata from Flashscore. Outputs clean JSON with team names, team IDs, tournament info, datetimes, and match URLs - ready for analytics, dashboards, arbitrage and betting models.

- **URL**: https://apify.com/dataizi-srl/flashscore-data-extractor.md
- **Developed by:** [Dataizi SRL](https://apify.com/dataizi-srl) (community)
- **Categories:** Automation, Other, Integrations
- **Stats:** 373 total users, 8 monthly users, 100.0% runs succeeded, 5 bookmarks
- **User rating**: 1.00 out of 5 stars

## Pricing

from $10.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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 Scraper: Real-Time Sports Data & Live Scores API

Extract high-fidelity sports data from **Flashscore** in real-time. This Actor bypasses complex anti-bot measures to deliver structured data for football and more directly into your apps.

***

### ✨ Key Features & Benefits

- **⚡ Real-Time Live Scores:** Track match minutes (e.g., "1st Half - 24'") and evolving scores as they happen.
- **🌍 Multi-Sport Support:** Get data for Football (Soccer) and Basketball. Tennis, Hockey, and Volleyball will be implemented soon.
- **📅 Historical & Future Coverage:** Access results from previous days or upcoming schedules using simple date offsets.
- **🔗 Deep Linking:** Includes unique `match_id` and formatted `match_url` for easy integration with your own platform.
- **📦 Flexible Export:** Download data in **JSON, CSV, Excel, or XML**.

***

### 🚀 How to Use

1. **Configure Input:** Select your target sports and the day offset (e.g., `0` for today, `1` for tomorrow).
2. **Run the Actor:** Click **Start**. The Actor will fetch match data and live updates.
3. **Get Data:** Once the run finishes, navigate to the **Dataset** tab to view or export your results.

***

### 📥 Input Parameters

The Actor is designed with a user-friendly UI. You can toggle these settings in the **Input** tab:

| Field | Type | Description                                                                                            | Default |
| :--- | :--- |:-------------------------------------------------------------------------------------------------------| :--- |
| **Sports** | `Array` | List of sports to scrape. Full supported list is: `football`, `basketball`. <br/>Other sports, soon to come. | `["football"]` |
| **Date Offsets** | `Array` | `0` = Today, `1` = Tomorrow, `-1` = Yesterday.                                                         | `[0]` |
| **Match Status** | `Array` | Filter by `LIVE`, `FINISHED`, `SCHEDULED`, `ALL`.                                                      | `["ALL"]` |
| **League / Tournament Filter** | `Array` | Filter to specific leagues or tournaments by name (e.g. `"LaLiga"`, `"Premier League"`, `"Champions League"`). Case-insensitive. Leave empty to return all leagues. | `[]` |

***

### 📤 Output Example

The data is delivered in a clean, structured format. Each item represents a single match:

```json
  {
    "home_team_name": "Namibia W",
    "home_team_short_name": "NAM",
    "home_team_id": "O6oWzKNA",
    "away_team_name": "Madagascar W",
    "away_team_short_name": "MAD",
    "away_team_id": "CUFJyZR2",
    "category_name": "Africa",
    "sport_name": "football",
    "sport_id": "1",
    "tournament_name": "COSAFA Cup Women",
    "tournament_id": "b3KP3GQo",
    "tournament_url": "https://www.flashscore.com/football/africa/cosafa-cup-women/",
    "match_id": "YoFnhYSb",
    "match_date": "2026-02-23 13:00:00",
    "match_url": "https://www.flashscore.com/match/football/namibia-O6oWzKNA/madagascar-CUFJyZR2/?mid=YoFnhYSb",
    "match_score_home_goals": "0",
    "match_score_away_goals": "1",
    "stage_description": "Half Time",
    "match_status": "live"
  }
```

See a structured version of the extraction [here](https://api.apify.com/v2/datasets/deKyjVgq9BxtmsrsX/items?format=html\&clean=true).

***

### 💡 Use Cases

- **Betting Platforms**: Feed real-time scores and match stages into your odds algorithms.
- **Sports News**: Automate the creation of daily results summaries or upcoming match lists.
- **Data Science**: Analyze historical scores and match performance for predictive modeling.
- **Fantasy Leagues**: Update player statistics and match outcomes instantly.

***

### ❓ Frequently Asked Questions

#### **Q: How "Live" is the data?**

**A:** The scraper hits the same high-speed endpoints as the Flashscore web app. You can expect data latency as low as **5-15 seconds**, depending on your run frequency.

#### **Q: Can I filter for specific leagues (e.g., only Premier League)?**

**A:** Yes. The output includes `tournament_id` and `tournament_name`. You can filter these results using Apify's built-in filtering or via a simple post-processing script in your integration.

#### **Q: Does this include player-level stats?**

**A:** This version focuses on **Match-Level** data (scores, status, time, tournament info) for now. Other feature extractions like player level stats and others will be implemented. But please get in touch and let us know what other data you would like to see extracted, this way we can better prioritise it.

#### **Q: What happens if a match is postponed?**

**A:** The `match_status` field will update accordingly, and the `stage_description` will contain the specific status label (e.g., "Postponed", "Interrupted", or "Walkover") provided by the feed.

***

### 🛡️ Support

If you encounter any issues or have a feature request, please open a ticket in the Issues tab or contact us via the Apify Console.

**SEO Keywords**: Flashscore Scraper, Live Scores API, Football Data Extractor, Real-time Sports API, Tennis Scores Scraper, Betting Data API.

# Actor input Schema

## `mode` (type: `string`):

Select the type of data you want to extract.

**Available Modes:**

- **score\_mode** - Finished, Live & Scheduled Matches: Extracts match timelines, current scores, and historic results based on your date/status filters. This is the equivalent of going to the homepage of Flashscore and getting all the matches listed there

*(More modes like 'Teams' and 'Leagues' are in development!)*

## `scoreModeOptions` (type: `object`):

Configure parameters specific to the '\[score\_mode] Finished, Live & Scheduled Matches' mode.

## `sports` (type: `array`):

List the sports you want to scrape. Currently, only 'Football' and 'Basketball' are supported. Others will be available soon

## `matchStatuses` (type: `array`):

Filter by match status. Only get finished matches, or maybe you want to see only live matches

## `leagues` (type: `array`):

Filter results to specific leagues or tournaments. Enter names as they appear on Flashscore (e.g. "LaLiga", "Premier League", "Champions League"). Matching is case-insensitive. Leave empty to return all leagues.

## `dayOffsets` (type: `array`):

Select the specific days you want to scrape relative to today (range: -7 to 7). For example: \[0] for today, \[-1, 0, 1] for yesterday, today, and tomorrow.

## `overallRules` (type: `object`):

Configure general settings, applicable to all modes.

## `maxItems` (type: `integer`):

Limit the maximum number of results to scrape. Leave blank to scrape all available data points.

## Actor input object example

```json
{
  "mode": "score_mode",
  "sports": [
    "football"
  ],
  "matchStatuses": [
    "all"
  ],
  "leagues": [
    "LaLiga",
    "Premier League"
  ],
  "dayOffsets": [
    "0"
  ]
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "score_mode",
    "sports": [
        "football"
    ],
    "dayOffsets": [
        "0"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("dataizi-srl/flashscore-data-extractor").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "score_mode",
    "sports": ["football"],
    "dayOffsets": ["0"],
}

# Run the Actor and wait for it to finish
run = client.actor("dataizi-srl/flashscore-data-extractor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "score_mode",
  "sports": [
    "football"
  ],
  "dayOffsets": [
    "0"
  ]
}' |
apify call dataizi-srl/flashscore-data-extractor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dataizi-srl/flashscore-data-extractor"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/uaYU7wt4eHvVIn0DP/builds/Ps711QvumSUDRvBSv/openapi.json