# SofaScore Scraper - Live Scores, Fixtures & Stats (`scrapesage/sofascore-scraper`) Actor

Scrape SofaScore live scores, fixtures and results across 14 sports, with lineups, player ratings, expected goals, match statistics and goal timelines. No login or API key needed.

- **URL**: https://apify.com/scrapesage/sofascore-scraper.md
- **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community)
- **Categories:** Automation, AI, News
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$2.00 / 1,000 match scrapeds

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

## SofaScore Scraper - Live Scores, Fixtures & Stats

Scrape **SofaScore** across **14 sports** - live scores, fixtures, results, lineups with player ratings, expected goals, full match statistics and goal timelines. **No login, no API key, no cookies.**

Football, tennis, basketball, ice hockey, volleyball, handball, cricket, MMA, rugby, baseball, American football, darts, snooker and table tennis.

***

### Four ways to pull data

| Mode | What you get |
|---|---|
| **Live now** | Everything in play right now for the sports you pick |
| **By tournament** | A league's full fixture list and results (past *and* upcoming) |
| **By team** | One team's fixtures and results |
| **By match** | Specific matches by id - or just paste the sofascore.com URL |

### What you get per match

`matchId` · `matchUrl` · `sport` · `tournamentName` · `uniqueTournamentName` · `categoryName` · `seasonName` · `round` · `statusType` · `statusDescription` · `isLive` · `isFinished` · `startTime` (ISO) · `currentMinute` · both teams with ids, slugs and countries · `homeScore` / `awayScore` · half-time scores · `winner` · `venueName` · `venueCity`

Every row carries every field, so your CSV never has ragged columns.

### Optional enrichment

| Toggle | Adds |
|---|---|
| `includeStatistics` | Up to **47 stat keys** - ball possession, **expected goals (xG)**, shots on target, corners, fouls, saves, kilometres covered |
| `includeLineups` | Formations plus every player with position, shirt number, **rating**, minutes, goals, assists and xG |
| `includeIncidents` | The full timeline, plus `goals` and `cards` pulled out as their own arrays with scorer and assist |

Each toggle costs one extra request per match, so they are off by default.

***

### Example input

```json
{
  "mode": "tournament",
  "tournamentIds": ["17"],
  "includeStatistics": true,
  "includeIncidents": true,
  "maxResults": 100,
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }
}
```

Handy tournament ids: **17** Premier League · **8** LaLiga · **35** Bundesliga · **23** Serie A · **34** Ligue 1 · **7** UEFA Champions League.
Don't know an id? Open the competition or team on sofascore.com and copy the number out of the URL - in `event` mode you can paste the whole URL and the actor reads the id out for you.

### Example output

```json
{
  "type": "match",
  "matchId": 14025097,
  "sport": "football",
  "tournamentName": "Premier League",
  "seasonName": "Premier League 26/27",
  "statusDescription": "Ended",
  "isFinished": true,
  "startTime": "2026-08-05T19:00:00.000Z",
  "homeTeamName": "Arsenal",
  "homeScore": 3,
  "awayScore": 2,
  "awayTeamName": "Kairat Almaty",
  "winner": "home",
  "venueName": "Emirates Stadium",
  "venueCity": "London",
  "statistics": { "ballPossession": { "name": "Ball possession", "home": 66, "away": 34 } },
  "goals": [{ "type": "goal", "minute": 90, "player": "Ricardinho", "assist": "Valeriy Gromyko" }]
}
```

***

### Pricing

**$0.002 per match.** You are charged only for rows actually delivered to your dataset. A run that returns nothing - no live matches right now, or an id that doesn't exist - costs **$0** and tells you which of those it was.

### Honest limits

- **Player ratings and xG are published by SofaScore only for higher-profile fixtures.** Measured: 31 of 42 players rated on a Champions League tie, 0 of 23 on a women's qualifying match. Those sub-fields are left null when SofaScore has no value - never defaulted to 0.
- **`venueName` / `venueCity` come from the match detail payload.** They are populated in `event` mode and null in live/tournament/team modes, because fetching detail for every match would triple the cost of a live-scores run.
- **`currentMinute`** applies to clock-based sports in progress. Basketball and similar are period-scored, so SofaScore publishes a quarter rather than an elapsed clock.
- **Live coverage follows local kick-off times.** An empty live run at 4am UTC is not a fault - use tournament or team mode for fixtures and results instead.

### Tips

- Schedule `live` mode every few minutes for a rolling scoreboard; dedupe on `matchId`.
- For xG analysis, use `tournament` mode with `onlyFinished: true` and `includeStatistics: true`.
- `winner` is only set once a match ends - deliberately null in progress rather than guessing.

### Related actors

- **ESPN Sports Scraper** - US leagues: scoreboards, odds, standings, rosters
- **Sports Betting Odds Scraper** - live lines, arbitrage and +EV across books

# Actor input Schema

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

live = everything in play right now for the sports you pick. tournament = a league's fixtures and results. team = one team's fixtures and results. event = specific matches by id or URL.

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

Which sports to pull live matches for.

## `tournamentIds` (type: `array`):

SofaScore unique-tournament ids. For example 17 = Premier League, 8 = LaLiga, 35 = Bundesliga, 23 = Serie A, 34 = Ligue 1, 7 = UEFA Champions League.

## `seasonIds` (type: `array`):

Leave empty to use each tournament's current season.

## `teamIds` (type: `array`):

SofaScore team ids, for example 42 = Arsenal, 44 = Manchester United.

## `eventIds` (type: `array`):

SofaScore match ids.

## `startUrls` (type: `array`):

Paste sofascore.com match URLs - the match id is read out of the URL for you.

## `includeStatistics` (type: `boolean`):

Possession, shots, corners, cards and the rest, as a keyed object on each match. Costs one extra request per match.

## `includeLineups` (type: `boolean`):

Formations plus every player with position, shirt number and - on matches where SofaScore publishes them - rating, minutes, goals and expected goals. Costs one extra request per match.

## `includeIncidents` (type: `boolean`):

The match timeline with goals, cards and substitutions, plus goals and cards pulled out as their own arrays. Costs one extra request per match.

## `onlyLive` (type: `boolean`):

Keep only matches currently in progress.

## `onlyFinished` (type: `boolean`):

Keep only matches that have ended.

## `maxResults` (type: `integer`):

Total cap across every source. Set 0 for no limit (explicit opt-in).

## `concurrency` (type: `integer`):

Parallel enrichment requests. Higher is faster but harder on the proxy pool.

## `proxyConfiguration` (type: `object`):

A residential proxy is recommended.

## Actor input object example

```json
{
  "mode": "live",
  "sports": [
    "football",
    "tennis"
  ],
  "tournamentIds": [
    "17"
  ],
  "teamIds": [
    "42"
  ],
  "includeStatistics": false,
  "includeLineups": false,
  "includeIncidents": false,
  "onlyLive": false,
  "onlyFinished": false,
  "maxResults": 100,
  "concurrency": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Every scraped match as a JSON item in the default dataset.

# 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"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapesage/sofascore-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"] }

# Run the Actor and wait for it to finish
run = client.actor("scrapesage/sofascore-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"
  ]
}' |
apify call scrapesage/sofascore-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapesage/sofascore-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/LFnS2WDYEtrwq7HbC/builds/LvbdCPWucKomTp0dL/openapi.json