# SofaScore Scraper: Live Scores, Stats & Fixtures (`getascraper/sofascore-live-events-scraper`) Actor Scrape SofaScore live scores, fixtures, and results across 13 sports, plus deep match statistics, incidents, lineups, and player/team search. No login or API key. $0.80 per 1,000 results. - **URL**: https://apify.com/getascraper/sofascore-live-events-scraper.md - **Developed by:** [GetAScraper](https://apify.com/getascraper) (community) - **Categories:** News, Other, Developer tools - **Stats:** 5 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.13 / 1,000 match or 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/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 ## ⚽ SofaScore Scraper: Live scores, stats and fixtures **Pull live scores, fixtures, final results, and deep match statistics from SofaScore across 13 sports, with no login and no API key.** Track in-play matches minute by minute, download a full day of fixtures and results by date, grab detailed match statistics with lineups and incidents, or look up any player, team, manager, or referee by name. Export everything to JSON, CSV, or Excel. This scraper covers football, basketball, tennis, ice hockey, baseball, handball, volleyball, snooker, rugby, MMA, cricket, American football, and esports. ### 🔍 What does the SofaScore Scraper do? The SofaScore Scraper collects public sports data from [SofaScore](https://www.sofascore.com/) and turns it into clean, structured rows you can use anywhere. Point it at a sport, a date, or a match, choose a mode, and press start. There are four modes: - **Live events**: every in-play match for a sport, with current score, status, and tournament. - **Scheduled events**: all fixtures and results for a chosen date, across every competition. - **Event detail**: deep statistics for specific matches, including possession, shots, expected goals, the incident timeline (goals, cards, substitutions), and starting lineups. - **Search**: look up players, teams, managers, and referees by name, with followers, country, position, and team. Because it runs on the Apify platform, you also get scheduling, ready-made integrations, automatic proxy rotation, run monitoring, and clean exports in JSON, CSV, Excel, XML, or RSS. ### 💡 Why use the SofaScore Scraper? Most SofaScore tools stop at a flat list of scores. This one goes deeper: it also gives you the per-match statistics, expected goals, lineups, and incident timelines that power real analysis. - **Betting and trading models**: feed live scores and match statistics into your own models and dashboards. - **Sports analytics and research**: build datasets of results, expected goals, and player ratings across seasons. - **Fantasy and prediction tools**: refresh fixtures, results, and lineups automatically before each round. - **Media and content sites**: power live score widgets, match previews, and result tables. - **Data journalists**: pull a whole day of fixtures and results in one run and analyse them in a spreadsheet. ### 🚀 How to use the SofaScore Scraper 1. Click **Try for free** at the top of this page. 2. Pick a **mode**: Live events, Scheduled events, Event detail, or Search. 3. Choose a **sport** (football is the default), and set a **date** or **search query** if your mode needs one. 4. Set **Max items** to cap how many records you want. 5. Press **Start** and watch the results fill the Output tab in seconds. 6. Download the dataset in JSON, CSV, or Excel, or connect it to Google Sheets, Make, Zapier, or your own app. New here? SofaScore data appears almost instantly, so a first run of 10 to 20 items is a great way to see the output shape before scaling up. ### 📥 Input Set these fields in the Console form, or pass them as JSON. Most fields only apply to some modes. | Field | Type | Required | Description | |---|---|---|---| | Scrape mode | enum | Yes | What to scrape: `liveEvents`, `scheduledEvents`, `eventDetail`, or `search`. | | Sport | enum | Yes | One of 13 sports. Applies to live, scheduled, and search modes. | | Date | string | No | Day to fetch fixtures and results for, as `YYYY-MM-DD`. Empty means today. Scheduled mode only. | | Status filter | enum | No | Keep only `all`, `live`, `scheduled`, or `finished` matches. Live and scheduled modes. | | Search query | string | No | Name of a player, team, manager, or referee. Search mode only. | | Events | array of IDs or URLs | No | Match IDs or SofaScore match URLs to fetch detail for. Event detail mode only. | | Include match statistics | boolean | No | Attach possession, shots, expected goals, and more. Event detail mode. | | Include incidents | boolean | No | Attach the goal, card, and substitution timeline. Event detail mode. | | Include lineups | boolean | No | Attach starting lineups, formations, and player ratings. Event detail mode. | | Max items | integer | No | Maximum records to return. Use 0 for no limit. | | Proxy configuration | object | No | Proxy settings. Residential is the recommended default. | ### 📤 Output Every match becomes one clean row. Here is a shortened example from **Live events** mode: ```json { "rowType": "event", "id": 16269305, "matchName": "Finland U17 - Latvia U17", "sport": "football", "tournament": "Baltic Cup U17", "category": "Europe", "season": "2026", "round": 3, "statusType": "inprogress", "statusDescription": "1st half", "startTime": "2026-07-02T12:00:00.000Z", "homeTeam": "Finland U17", "awayTeam": "Latvia U17", "homeScore": 0, "awayScore": 0, "eventUrl": "https://www.sofascore.com/latvia-u17-finland-u17/ccjsxcj" } ```` A **Search** result looks like this: ```json { "rowType": "searchResult", "entityType": "player", "name": "Lionel Messi", "country": "Argentina", "teamName": "Inter Miami CF", "position": "F", "jerseyNumber": "10", "userCount": 2688466, "entityUrl": "https://www.sofascore.com/player/lionel-messi/12994" } ``` You can download the dataset in various formats such as JSON, HTML, CSV, or Excel. The Output tab has four ready-made views: Matches, Fixtures and results, Search results, and Match detail. ### 📊 Data table Main fields returned for matches and search results. Empty fields are dropped, so every value you see is real. | Field | Type | Description | |---|---|---| | rowType | string | Row kind: `event`, `eventDetail`, or `searchResult`. | | id | number | SofaScore event or entity ID. | | matchName | string | Home and away teams combined, e.g. "Home - Away". | | sport | string | Sport of the match. | | tournament | string | Competition name. | | category | string | Region or country group of the competition. | | country | string | Country of the competition or entity. | | season | string | Season the match belongs to. | | round | number | Round or matchday number. | | statusType | string | `inprogress`, `notstarted`, `finished`, `postponed`, and similar. | | statusDescription | string | Human status, e.g. "1st half", "Ended". | | startTime | string | Kickoff time in ISO 8601 UTC. | | homeTeam / awayTeam | string | Team or player names. | | homeScore / awayScore | number | Current score. Absent before kickoff. | | winnerCode | number | Which side won, once a match is finished. | | hasStatistics | boolean | Whether deep player statistics are available. | | eventUrl | string | Direct link to the match on SofaScore. | | statistics | array | Match statistics such as possession, shots, and expected goals. Event detail mode. | | incidents | array | Timeline of goals, cards, and substitutions. Event detail mode. | | lineups | object | Starting lineups, formations, and ratings. Event detail mode. | | entityType | string | For search rows: player, team, manager, or referee. | | name | string | For search rows: the entity name. | | teamName | string | For search rows: the player's current team. | | position | string | For search rows: player position. | | userCount | number | For search rows: number of followers on SofaScore. | | entityUrl | string | For search rows: link to the entity on SofaScore. | ### 💰 Pricing This Actor uses **pay per result**, so you only pay for the records you actually receive. Runs that return nothing cost nothing, and there are no monthly subscriptions or hidden fees. Set **Max items** to keep any run within your budget, and start small to preview the data before scaling up. ### ❓ FAQ #### Is scraping SofaScore legal? This Actor collects only public data that anyone can view on SofaScore without logging in. Scraping public data is generally legal, but you are responsible for how you use the results. Do not collect private data, and follow SofaScore's terms and applicable laws. #### Do I need a SofaScore account or API key? No. The Actor needs no login, no password, and no API key. Just choose a mode and press start. #### How do I get statistics and lineups for a match? Run **Live events** or **Scheduled events** first to collect match IDs. Then run **Event detail** mode with those IDs and switch on statistics, incidents, and lineups. Note that some lower-league matches do not publish full statistics or lineups. #### Which sports are supported? Football, basketball, tennis, ice hockey, baseball, handball, volleyball, snooker, rugby, MMA, cricket, American football, and esports. #### Can I schedule automatic runs? Yes. Use the Apify Scheduler to run the Actor every few minutes for live data, or once a day for fixtures and results, and send the output straight to your app or spreadsheet. ### 🛟 Support Found a bug, or need an extra field? Open an issue on the **Issues** tab of this Actor and it will be reviewed. Custom versions and larger data pulls are available on request. # Actor input Schema ## `mode` (type: `string`): What to scrape. 'Live events' returns all in-play matches. 'Scheduled events' returns fixtures and results for a given date. 'Event detail' returns deep statistics, incidents and lineups for specific matches. 'Search' looks up players, teams, managers and referees. ## `sport` (type: `string`): Which sport to scrape. Applies to Live events, Scheduled events and Search. ## `date` (type: `string`): Day to fetch fixtures and results for, in YYYY-MM-DD format. Leave empty to use today (UTC). Only used in Scheduled events mode. ## `statusFilter` (type: `string`): Only keep matches with this status. Applies to Live events and Scheduled events modes. ## `query` (type: `string`): Name of a player, team, manager or referee to look up. Only used in Search mode. ## `events` (type: `array`): SofaScore event IDs (e.g. 12836554) or full match URLs to fetch deep detail for. You can copy the numeric 'id' from a Live/Scheduled events run. Only used in Event detail mode. ## `includeStatistics` (type: `boolean`): Attach possession, shots, xG and other match statistics to each event. Not available for every match. ## `includeIncidents` (type: `boolean`): Attach the incident timeline (goals, cards, substitutions, VAR, period markers) to each event. ## `includeLineups` (type: `boolean`): Attach starting lineups, formations and player ratings to each event. Not available for every match. ## `maxItems` (type: `integer`): Maximum number of records to push to the dataset. Use 0 for no limit. You are billed per record returned. ## `proxyConfiguration` (type: `object`): SofaScore blocks datacenter IPs at its edge, so Residential proxy is required and set as the default. Switching to datacenter typically returns zero results. ## Actor input object example ```json { "mode": "liveEvents", "sport": "football", "date": "2026-07-02", "statusFilter": "all", "query": "Lionel Messi", "events": [ "12836554" ], "includeStatistics": true, "includeIncidents": true, "includeLineups": false, "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("getascraper/sofascore-live-events-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], } } # Run the Actor and wait for it to finish run = client.actor("getascraper/sofascore-live-events-scraper").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 '{ "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call getascraper/sofascore-live-events-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getascraper/sofascore-live-events-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SofaScore Scraper: Live Scores, Stats & Fixtures", "description": "Scrape SofaScore live scores, fixtures, and results across 13 sports, plus deep match statistics, incidents, lineups, and player/team search. No login or API key. $0.80 per 1,000 results.", "version": "0.1", "x-build-id": "bpKxIYA8mHkcqsOPD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~sofascore-live-events-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-sofascore-live-events-scraper", "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/getascraper~sofascore-live-events-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-sofascore-live-events-scraper", "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/getascraper~sofascore-live-events-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-sofascore-live-events-scraper", "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", "properties": { "mode": { "title": "Scrape mode", "enum": [ "liveEvents", "scheduledEvents", "eventDetail", "search" ], "type": "string", "description": "What to scrape. 'Live events' returns all in-play matches. 'Scheduled events' returns fixtures and results for a given date. 'Event detail' returns deep statistics, incidents and lineups for specific matches. 'Search' looks up players, teams, managers and referees.", "default": "liveEvents" }, "sport": { "title": "Sport", "enum": [ "football", "basketball", "tennis", "ice-hockey", "baseball", "handball", "volleyball", "snooker", "rugby", "mma", "cricket", "american-football", "esports" ], "type": "string", "description": "Which sport to scrape. Applies to Live events, Scheduled events and Search.", "default": "football" }, "date": { "title": "Date (Scheduled events mode)", "type": "string", "description": "Day to fetch fixtures and results for, in YYYY-MM-DD format. Leave empty to use today (UTC). Only used in Scheduled events mode." }, "statusFilter": { "title": "Status filter", "enum": [ "all", "live", "scheduled", "finished" ], "type": "string", "description": "Only keep matches with this status. Applies to Live events and Scheduled events modes.", "default": "all" }, "query": { "title": "Search query (Search mode)", "type": "string", "description": "Name of a player, team, manager or referee to look up. Only used in Search mode." }, "events": { "title": "Events (Event detail mode)", "type": "array", "description": "SofaScore event IDs (e.g. 12836554) or full match URLs to fetch deep detail for. You can copy the numeric 'id' from a Live/Scheduled events run. Only used in Event detail mode.", "items": { "type": "string" } }, "includeStatistics": { "title": "Include match statistics", "type": "boolean", "description": "Attach possession, shots, xG and other match statistics to each event. Not available for every match.", "default": true }, "includeIncidents": { "title": "Include incidents", "type": "boolean", "description": "Attach the incident timeline (goals, cards, substitutions, VAR, period markers) to each event.", "default": true }, "includeLineups": { "title": "Include lineups", "type": "boolean", "description": "Attach starting lineups, formations and player ratings to each event. Not available for every match.", "default": false }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Maximum number of records to push to the dataset. Use 0 for no limit. You are billed per record returned.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "SofaScore blocks datacenter IPs at its edge, so Residential proxy is required and set as the default. Switching to datacenter typically returns zero results.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```