# Sofascore Scraper — Live Scores, Events & Results | $1.9/1K (`bovi/sofascore-live-events`) Actor Scrape Sofascore live scores, scheduled events and results by sport and date. Returns teams, score, status (live/finished/scheduled), start time, tournament, country, event ID and URL. Football, basketball, tennis, baseball and 15+ sports supported. - **URL**: https://apify.com/bovi/sofascore-live-events.md - **Developed by:** [Vitalii Bondarev](https://apify.com/bovi) (community) - **Categories:** News, Automation, MCP servers - **Stats:** 1 total users, 1 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.90 / 1,000 events 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 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, Events & Results Extract live scores, scheduled fixtures and results from **Sofascore** for **18+ sports** — football, basketball, tennis, baseball, hockey, and more. Ideal for **live odds models**, **sports data feeds**, **betting analytics pipelines**, and **match-tracking applications**. --- #### Use cases - **Live odds & in-play betting models** — poll live scores and match minute in real-time - **Sports data feeds** — collect daily fixture/result data across dozens of leagues - **Betting analytics** — compare pre-match schedules vs. final results - **Fantasy sports automation** — track scores and status across multiple events - **Research & journalism** — pull historical results or monitor ongoing tournaments --- #### What you get | Field | Description | |---|---| | `home_team` / `away_team` | Full team names | | `home_score` / `away_score` | Current scores (null = not yet played) | | `home_score_period1/2` | Period-level breakdown (halves, quarters, sets) | | `status` | `scheduled` / `live` / `finished` / `postponed` / `cancelled` | | `status_description` | Sofascore label: `1st half`, `Halftime`, `2nd half`, etc. | | `live_minute` | In-game minute for live events | | `start_time` | ISO-8601 UTC kickoff time | | `tournament` / `league` / `country` | Competition hierarchy | | `round` / `round_name` | Round number + name | | `event_id` / `event_url` | Sofascore IDs and direct link | | `parse_confidence` | Data quality: 1.0 = full API data | --- #### Sample output ```json { "event_id": "16092698", "event_url": "https://www.sofascore.com/japan-south-africa/VsaMsas#id:16092698", "sport": "football", "country": "World", "tournament": "International Friendly Games, Women", "league": "International Friendly Games, Women", "tournament_id": "1361", "round": null, "round_name": "", "home_team": "Japan", "away_team": "South Africa", "home_team_id": "5781", "away_team_id": "38024", "home_score": 0, "away_score": 1, "home_score_period1": 0, "away_score_period1": 1, "home_score_period2": 0, "away_score_period2": 0, "status": "live", "status_code": 8, "status_description": "2nd half", "live_minute": 72, "start_time": "2026-06-09T08:00:00+00:00", "start_timestamp": 1749456000, "scraped_at": "2026-06-09T10:31:00+00:00", "parse_confidence": 1.0 } ```` *** #### Input | Field | Type | Default | Description | |---|---|---|---| | `sport` | select | `football` | Sport slug: football, basketball, tennis, baseball, hockey… | | `mode` | select | `by-date` | `by-date` = all events on a given date; `live` = in-play events only | | `date` | string | today UTC | Date filter `YYYY-MM-DD`. Only used in `by-date` mode. | | `statusFilter` | select | `all` | Filter by `scheduled`, `live`, `finished`, or `all` | | `maxItems` | integer | `100` | Maximum records to return (0 = unlimited) | | `proxyConfiguration` | proxy | RESIDENTIAL | Apify RESIDENTIAL proxy (billed to your run) | **Tip:** `by-date` mode is the most reliable — it returns events regardless of time of day and is the best choice for scheduled pipelines. *** #### Supported sports Football/Soccer, Basketball, Tennis, Baseball, Ice Hockey, Volleyball, Handball, American Football, Rugby, Cricket, Badminton, Table Tennis, Cycling, Golf, MMA, Boxing, Snooker, Darts *** #### Technical notes - **Transport:** Sofascore's clean internal JSON API — no HTML parsing, no browser needed. - **Anti-bot:** Apify RESIDENTIAL proxy handles IP-based restrictions. No external keys. - **Reliability:** Automatic proxy rotation and retry on temporary blocks. - **Live fallback:** When `live` mode returns 0 in-play events (off-peak hours), the actor automatically falls back to today's full schedule. - **Pricing:** Pay per event item returned. ### 💰 Pricing & how we compare **Pay-per-result (PPE): $0.99 / 1K results.** You are billed per `event-item` actually returned — plus the tiny `apify-actor-start` fee Apify waives for short runs. No subscription, no API key, no proxy fee on top. **Our edge:** Cheapest credible PAID Sofascore source · live + scheduled by sport & date · 15+ sports · no API key. **Pricing examples** (pay only for what you get, minus Apify's 20%): | Volume | Cost | |---|---| | 100 results | $0.10 | | 1,000 results | $0.99 | | 10,000 results | $9.90 | #### How rivals price the same job (live Apify Store, checked 2026-06-09) | Actor | Their price | What they lack vs us | |---|---|---| | `parseforge/sofascore-live-scraper` | $33.50/1K | 100% success but ~34× our price per result | | `maximedupre/sofascore-live-events-scraper` | $30.15/1K | ~30× our price | | `azzouzana/sofascore-scraper-pro` | FREE | 569 users, but free tier = no support guarantee, URL-only input | *Prices above are competitors' live Store prices at the time of writing; ours is set to sit just below the strongest comparable while returning richer, quality-scored data.* ### 🤖 Use with AI agents (MCP) This actor is agent-ready (category **MCP\_SERVERS**). Point any MCP client (Claude Desktop, Cursor, n8n AI, LangGraph) at it: ```json { "mcpServers": { "apify": { "url": "https://mcp.apify.com/?actors=bovi/sofascore-live-events", "headers": { "Authorization": "Bearer " } } } } ``` # Actor input Schema ## `sport` (type: `string`): Sport to scrape. Default: football (soccer). Supports: football, basketball, tennis, baseball, hockey, volleyball, handball, american-football, rugby, cricket, badminton, table-tennis, cycling, golf, mma, boxing, snooker, darts. ## `mode` (type: `string`): Fetch mode. 'by-date' returns all events on the specified date (default: today UTC). 'live' returns only currently in-play events — falls back to today's schedule when 0 live events found. ## `date` (type: `string`): Calendar date to fetch events for. Format: YYYY-MM-DD, e.g. '2026-06-09'. Defaults to today UTC when left blank. Only applies in 'by-date' mode. ## `statusFilter` (type: `string`): Return only events with a specific status, or all. 'live' = currently in-play; 'scheduled' = not yet started; 'finished' = completed. ## `maxItems` (type: `integer`): Maximum number of event records to push. Set to 0 for all available (football can return 100+ events per day). Default 100. You are charged per record returned. ## `proxyConfiguration` (type: `object`): Apify Residential proxy recommended for best reliability. Sofascore may block datacenter IPs. No external proxy account required — Apify built-in residential proxy is billed to your run. ## Actor input object example ```json { "sport": "football", "mode": "by-date", "statusFilter": "all", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "date": "", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("bovi/sofascore-live-events").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 = { "date": "", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("bovi/sofascore-live-events").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 '{ "date": "", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call bovi/sofascore-live-events --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=bovi/sofascore-live-events", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Sofascore Scraper — Live Scores, Events & Results | $1.9/1K", "description": "Scrape Sofascore live scores, scheduled events and results by sport and date. Returns teams, score, status (live/finished/scheduled), start time, tournament, country, event ID and URL. Football, basketball, tennis, baseball and 15+ sports supported.", "version": "0.1", "x-build-id": "W5K7s5G8z9yfmN0GI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bovi~sofascore-live-events/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bovi-sofascore-live-events", "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/bovi~sofascore-live-events/runs": { "post": { "operationId": "runs-sync-bovi-sofascore-live-events", "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/bovi~sofascore-live-events/run-sync": { "post": { "operationId": "run-sync-bovi-sofascore-live-events", "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": { "sport": { "title": "Sport", "enum": [ "football", "basketball", "tennis", "baseball", "hockey", "volleyball", "handball", "american-football", "rugby", "cricket", "badminton", "table-tennis", "cycling", "golf", "mma", "boxing", "snooker", "darts" ], "type": "string", "description": "Sport to scrape. Default: football (soccer). Supports: football, basketball, tennis, baseball, hockey, volleyball, handball, american-football, rugby, cricket, badminton, table-tennis, cycling, golf, mma, boxing, snooker, darts.", "default": "football" }, "mode": { "title": "Mode", "enum": [ "by-date", "live" ], "type": "string", "description": "Fetch mode. 'by-date' returns all events on the specified date (default: today UTC). 'live' returns only currently in-play events — falls back to today's schedule when 0 live events found.", "default": "by-date" }, "date": { "title": "Date (YYYY-MM-DD)", "type": "string", "description": "Calendar date to fetch events for. Format: YYYY-MM-DD, e.g. '2026-06-09'. Defaults to today UTC when left blank. Only applies in 'by-date' mode." }, "statusFilter": { "title": "Status filter", "enum": [ "all", "scheduled", "live", "finished" ], "type": "string", "description": "Return only events with a specific status, or all. 'live' = currently in-play; 'scheduled' = not yet started; 'finished' = completed.", "default": "all" }, "maxItems": { "title": "Max event items to return", "minimum": 0, "type": "integer", "description": "Maximum number of event records to push. Set to 0 for all available (football can return 100+ events per day). Default 100. You are charged per record returned.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Residential proxy recommended for best reliability. Sofascore may block datacenter IPs. No external proxy account required — Apify built-in residential proxy is billed to your run.", "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 } } } } } } } } } } ```