{ "openapi": "3.0.1", "info": { "title": "SofaScore Matches & Stats Scraper", "description": "Sofascore Scraper SD - Sofascore Scraper is a sports data tool that extracts Sofascore events by sport and day or live, with tournament, teams, scores, status, venue and referee, plus match statistics (xG, possession, shots), lineups with player ratings and incidents.", "version": "1.0", "x-build-id": "JfiMrBGoiIS5LrMLz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neuro-scraper~sofascore-matches-stats-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neuro-scraper-sofascore-matches-stats-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/neuro-scraper~sofascore-matches-stats-scraper/runs": { "post": { "operationId": "runs-sync-neuro-scraper-sofascore-matches-stats-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/neuro-scraper~sofascore-matches-stats-scraper/run-sync": { "post": { "operationId": "run-sync-neuro-scraper-sofascore-matches-stats-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": "What to scrape", "enum": [ "eventsByDate", "live", "eventDetails" ], "type": "string", "description": "eventsByDate = every event of a sport on the chosen days; live = events in play right now; eventDetails = full details (statistics, lineups, incidents) for the event links you give.", "default": "eventsByDate" }, "sport": { "title": "Sport", "type": "string", "description": "Sofascore sport slug: football, tennis, basketball, ice-hockey, baseball, american-football, handball, volleyball, cricket, rugby, esports, table-tennis, futsal, darts, snooker, mma ...", "default": "football" }, "dates": { "title": "Days (eventsByDate)", "type": "array", "description": "Days as YYYY-MM-DD. Empty = today in the chosen time zone.", "items": { "type": "string" } }, "timezoneOffset": { "title": "Time zone offset (hours)", "minimum": -12, "maximum": 14, "type": "integer", "description": "Where the day starts and ends, in hours from UTC (0 = UTC, 1 = CET, -5 = New York, 6 = Dhaka). Start times in the output are UTC.", "default": 0 }, "tournamentFilter": { "title": "Tournament filter", "type": "array", "description": "Keep only events whose 'Category: Tournament' text contains one of these (not case-sensitive), e.g. England: Premier League, LaLiga, ATP. Saves requests: other categories are not read.", "items": { "type": "string" } }, "includeStatistics": { "title": "Statistics", "type": "boolean", "description": "Add match statistics per period (possession, xG, shots, passes, duels ...): 1 extra request per event.", "default": false }, "includeLineups": { "title": "Lineups", "type": "boolean", "description": "Add formations and players with position, shirt number, rating and minutes: 1 extra request per event.", "default": false }, "includeIncidents": { "title": "Incidents", "type": "boolean", "description": "Add goals, cards, substitutions and period markers with minute and player: 1 extra request per event.", "default": false }, "eventUrls": { "title": "Event links (eventDetails)", "type": "array", "description": "Sofascore event links with #id:, e.g. https://www.sofascore.com/football/match/fulham-manchester-united/KsT#id:16363652, or plain event ids. Statistics, lineups and incidents are always included in this mode.", "items": { "type": "string" } }, "maxItems": { "title": "Max events per day", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Maximum events per day (eventsByDate) or in total (live). A football day has well over 1,000 events on Sofascore.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxy is the default; Sofascore's edge rejects non-browser clients and has blocked datacenter IPs in public reports.", "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 } } } } } } } } } }