{ "openapi": "3.0.1", "info": { "title": "SofaScore Scraper: Live Scores, Fixtures & Stats for 13 Sports", "description": "Scrape live scores, fixtures, and results from SofaScore across 13 sports including football, basketball, and tennis. Pull deep match statistics, incident timelines, and starting lineups for any match, plus player, team, manager, and referee search. No login or API key needed.", "version": "0.4", "x-build-id": "kBCH0V6Nr27Oh3Brl" }, "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. 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": "Event detail mode only. Attach possession, shots, xG and other match statistics to each event. Ignored in the other modes. Not available for every match.", "default": true }, "includeIncidents": { "title": "Include incidents", "type": "boolean", "description": "Event detail mode only. Attach the incident timeline (goals, cards, substitutions, VAR, period markers) to each event. Ignored in the other modes.", "default": true }, "includeLineups": { "title": "Include lineups", "type": "boolean", "description": "Event detail mode only. 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": 25 }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }