# Flashscore Scraper - Live Scores, Results, Stats & Lineups (`benthepythondev/flashscore-scraper`) Actor

Scrape Flashscore live scores, fixtures and results for 16 sports (football, tennis, basketball, hockey, cricket…): teams, scores, status, league, start time, plus optional match details with period scores, goals and cards, statistics incl. xG, lineups with ratings, referee and venue. No browser.

- **URL**: https://apify.com/benthepythondev/flashscore-scraper.md
- **Developed by:** [Ben](https://apify.com/benthepythondev) (community)
- **Categories:** News, Automation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## ⚽ Flashscore Scraper (Live Scores, Results, Stats & Lineups)

Get Flashscore's live scores, fixtures and results for 16 sports as clean rows: teams, score, status, league, start time and logos, with optional match details: period scores, referee, venue and attendance, goals, cards and substitutions, statistics with expected goals (xG), and lineups with player ratings. No browser, so a full day of football with details takes seconds. Export to JSON/CSV/Excel, run on a schedule, call via API, or connect to Make, Zapier or n8n.

**What a run costs:** $0.0005 per match on the Free plan, $0.00048 on Bronze, $0.00046 on Silver and $0.00044 from Gold up. Match details are $0.001 per match more ($0.00095, $0.0009, $0.00085), only when you switch them on. Plus $0.00005 per run start.

### 🔎 What is the Flashscore Scraper?

It reads the same data feed Flashscore's own pages load: every match of a sport for one day, seven days back to seven days ahead, and per match the detail tabs (summary, statistics, lineups). Sports: football, tennis, basketball, hockey, American football, baseball, handball, floorball, futsal, volleyball, cricket, darts, badminton, water polo, table tennis, esports.

#### What data does it extract?

- **Match:** `id`, `url`, `sport`, `startTime`, `status` (scheduled, live, finished, postponed, cancelled, walkover, retired, interrupted, abandoned), `stage`, `homeScore`, `awayScore`, `winner`, `note`, `updatedAt`
- **League:** `league.name`, `league.country`, `league.category` (for tennis: ATP, WTA, Challenger…), `league.fullName`, `league.url`
- **Teams or players:** `home` and `away` with `id`, `name`, `shortName`, `slug`, `country` (tennis), `logo`
- **Details (optional):**
  - `details.info`: `periods[]` (halves, quarters, sets), `referee`, `venue`, `town`, `attendance`, `capacity`
  - `details.incidents[]`: goals with the running score, cards, substitutions, penalties: minute, team, players with links, reason, commentary
  - `details.statistics[]`: per period and group, every statistic with home and away value (xG, possession, shots, passes, corners…)
  - `details.lineups`: formation, starters, substitutes and coaches per team, player ratings

### ⬇️ Input

| Field | Type | Description |
|---|---|---|
| `sports` | array | Sports to read (default `football`) |
| `days` | array | Day offsets from today, -7 to 7 (default `[0]`) |
| `status` | string | `all`, `live`, `scheduled` or `finished` |
| `leagues` | array | Keep leagues whose name or link contains one of these words (`premier league`, `laliga`, `atp`, `nba`) |
| `includeDetails` | boolean | Add match details (default off) |
| `detailParts` | array | Which details: `info`, `incidents`, `statistics`, `lineups` (default all) |
| `maxItems` | integer | Stop after this many matches (default 1000) |

#### Example input

```json
{
  "sports": ["football"],
  "days": [-1],
  "leagues": ["england: premier league", "spain: laliga"],
  "status": "finished",
  "includeDetails": true
}
```

### ⬆️ Output

One row per match (shortened, a real Premier League match):

```json
{
  "id": "tW4rOkzg",
  "url": "https://www.flashscore.com/match/football/coventry-GOvB22xg/newcastle-utd-p6ahwuwJ/?mid=tW4rOkzg",
  "sport": "football",
  "league": { "name": "Premier League", "country": "England", "fullName": "ENGLAND: Premier League", "url": "https://www.flashscore.com/football/england/premier-league/" },
  "startTime": "2026-10-12T19:00:00Z",
  "status": "finished",
  "home": { "id": "GOvB22xg", "name": "Coventry", "shortName": "COV", "logo": "https://static.flashscore.com/res/image/data/QHmiKlDN-SSMx8z8I.png" },
  "away": { "id": "p6ahwuwJ", "name": "Newcastle", "shortName": "NEW" },
  "homeScore": 4,
  "awayScore": 1,
  "winner": "home",
  "details": {
    "info": {
      "periods": [{ "home": 1, "away": 0 }, { "home": 3, "away": 1 }],
      "referee": "Brooks J.",
      "venue": "Coventry Building Society Arena",
      "attendance": 30811,
      "capacity": 32753
    },
    "incidents": [
      { "period": "2nd Half", "minute": "48'", "team": "home", "type": "Goal", "score": "2-0", "players": [{ "name": "Cherif S.", "url": "https://www.flashscore.com/player/cherif-sidiki/tSVHHLjn/" }] }
    ],
    "statistics": [
      { "period": "Match", "group": "Top stats", "name": "Expected goals (xG)", "home": "1.43", "away": "1.85" },
      { "period": "Match", "group": "Top stats", "name": "Ball possession", "home": "33%", "away": "67%" }
    ],
    "lineups": {
      "home": { "formation": "1-4-2-3-1", "starters": [{ "name": "Cherif S.", "rating": 6.9 }] }
    }
  }
}
```

### 💡 Use cases

- 📊 **Sports data products:** feed live scores and results into an app, a bot or a betting model.
- 🧮 **Analytics:** xG, possession and shots per match and half for whole leagues.
- 📰 **Media:** daily fixtures and results lists for your site or newsletter.
- 🎾 **Tennis and more:** every ATP, WTA, Challenger and ITF match of the day with player nationality.

### 🤖 For AI agents

```json
{ "sports": ["football"], "days": [0], "status": "live" }
```

No credentials. `includeDetails: true` adds statistics, lineups and incidents.

### 📏 Limits

- **Days:** seven days back to seven days ahead, as Flashscore's own day list. Older results need the league pages, which are not read.
- **Details depend on the league:** top leagues have statistics, xG and lineups; small leagues may only have goals and cards, and some none. Empty parts are returned empty.
- **Odds** are not included in this version.
- **Live data** is a snapshot of the moment the run reads it. Schedule the Actor for regular updates.

### ❓ FAQ

**How fast is it?** About a second per hundred matches without details; with details, six matches at a time.

**Which sports?** Football, tennis, basketball, hockey, American football, baseball, handball, floorball, futsal, volleyball, cricket, darts, badminton, water polo, table tennis and esports.

**Can I get only one league?** Yes, put words of its name in `leagues`, for example `england: premier league`.

**Am I charged for details I did not ask for?** No. Details are a separate charge, only with `includeDetails`.

**Is it legal?** It reads data Flashscore shows every visitor. Check the terms of Flashscore and of the competitions for your use, especially for commercial redistribution.

### 🔗 You might also like

- [Football Data Competitions Scraper](https://apify.com/benthepythondev/football-data-competitions-scraper)
- [TheSportsDB Scraper](https://apify.com/benthepythondev/thesportsdb-scraper)

**Keywords:** Flashscore scraper, live scores API, football results API, soccer scores scraper, tennis results scraper, basketball scores, hockey scores, cricket scores, xG data, match statistics scraper, lineups scraper, sports data API, fixtures and results, Flashscore API alternative

# Actor input Schema

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

One or more of: football, tennis, basketball, hockey, american-football, baseball, handball, floorball, futsal, volleyball, cricket, darts, badminton, water-polo, table-tennis, esports.

## `days` (type: `array`):

Day offsets from today, -7 to 7: 0 is today, -1 yesterday, 1 tomorrow. Example: \[-1, 0, 1].

## `status` (type: `string`):

Keep only live, scheduled or finished matches.

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

Keep only leagues whose name or link contains one of these words, for example premier league, laliga, atp, nba. Empty keeps every league.

## `includeDetails` (type: `boolean`):

Adds per match: period scores, referee, venue and attendance; goals, cards and substitutions; statistics (xG for football); lineups with ratings. Charged as match-details.

## `detailParts` (type: `array`):

Which details to read: info, incidents, statistics, lineups. Empty reads all four.

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

Stops after this many matches.

## Actor input object example

```json
{
  "sports": [
    "football"
  ],
  "days": [
    0
  ],
  "status": "all",
  "includeDetails": false,
  "detailParts": [
    "info",
    "incidents",
    "statistics",
    "lineups"
  ],
  "maxItems": 1000
}
```

# 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 = {
    "sports": [
        "football"
    ],
    "days": [
        0
    ],
    "detailParts": [
        "info",
        "incidents",
        "statistics",
        "lineups"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("benthepythondev/flashscore-scraper").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 = {
    "sports": ["football"],
    "days": [0],
    "detailParts": [
        "info",
        "incidents",
        "statistics",
        "lineups",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("benthepythondev/flashscore-scraper").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 '{
  "sports": [
    "football"
  ],
  "days": [
    0
  ],
  "detailParts": [
    "info",
    "incidents",
    "statistics",
    "lineups"
  ]
}' |
apify call benthepythondev/flashscore-scraper --silent --output-dataset

```

## MCP server setup

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

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/uxhSEg8V5wWE1C1Ma/builds/4dp4J91cast0LIYt7/openapi.json