{ "openapi": "3.0.1", "info": { "title": "SofaScore Live Scores, Standings & Team Search Data", "description": "Get SofaScore live scores, scheduled fixtures, league standings and team/player/tournament search results across 17 sports including football, basketball and tennis.", "version": "1.1", "x-build-id": "q6GdIjB6lSnB3zonj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vexaloom-labs~sofascore-live-scores-standings-and-team-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vexaloom-labs-sofascore-live-scores-standings-and-team-search", "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/vexaloom-labs~sofascore-live-scores-standings-and-team-search/runs": { "post": { "operationId": "runs-sync-vexaloom-labs-sofascore-live-scores-standings-and-team-search", "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/vexaloom-labs~sofascore-live-scores-standings-and-team-search/run-sync": { "post": { "operationId": "run-sync-vexaloom-labs-sofascore-live-scores-standings-and-team-search", "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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "live", "scheduled", "team", "player", "tournament", "standings", "event", "rankings" ], "type": "string", "description": "What to fetch from SofaScore.", "default": "search" }, "searchQueries": { "title": "Search Queries", "type": "array", "description": "Team, player, tournament or match names to resolve (mode=search).", "items": { "type": "string" } }, "searchType": { "title": "Search Result Type", "enum": [ "all", "team", "player", "tournament", "event" ], "type": "string", "description": "Restrict search results to one entity type (mode=search).", "default": "all" }, "sports": { "title": "Sports", "type": "array", "description": "Sports for live and scheduled modes. Supported: football, basketball, tennis, american-football, aussie-rules, ice-hockey, handball, rugby, futsal, minifootball, floorball, volleyball, badminton, table-tennis, padel, snooker, baseball, cricket, esports, darts, mma, cycling, motorsport, waterpolo, bandy.", "items": { "type": "string" }, "default": [ "football" ] }, "date": { "title": "Date", "type": "string", "description": "Start date for fixtures (mode=scheduled), format YYYY-MM-DD. Defaults to today UTC." }, "daysAhead": { "title": "Days Ahead", "minimum": 0, "maximum": 31, "type": "integer", "description": "Number of extra days after Date to include (mode=scheduled).", "default": 0 }, "teamIds": { "title": "Team IDs or URLs", "type": "array", "description": "SofaScore team IDs or team page URLs (mode=team).", "items": { "type": "string" } }, "playerIds": { "title": "Player IDs or URLs", "type": "array", "description": "SofaScore player IDs or player page URLs (mode=player).", "items": { "type": "string" } }, "tournamentIds": { "title": "Tournament IDs or URLs", "type": "array", "description": "SofaScore unique-tournament IDs or tournament page URLs (modes tournament, standings).", "items": { "type": "string" } }, "eventIds": { "title": "Match IDs or URLs", "type": "array", "description": "SofaScore match IDs or match page URLs (mode=event).", "items": { "type": "string" } }, "seasonId": { "title": "Season ID", "minimum": 1, "type": "integer", "description": "Optional season ID for standings or tournament mode. If omitted, the latest season with a table is used." }, "tableType": { "title": "Table Type", "enum": [ "total", "home", "away" ], "type": "string", "description": "Standings table to fetch (modes standings, tournament).", "default": "total" }, "rankingType": { "title": "Ranking Type", "enum": [ "uefa-countries", "fifa", "rugby-union", "rugby-league", "atp", "wta", "atp-live", "wta-live", "uefa-clubs", "ufc-flyweight", "ufc-bantamweight", "ufc-featherweight", "ufc-lightweight", "ufc-welterweight", "ufc-middleweight", "ufc-light-heavyweight", "ufc-heavyweight", "ufc-womens-strawweight", "ufc-womens-flyweight", "ufc-womens-bantamweight", "ufc-womens-featherweight", "utr-men", "utr-women", "fip-men", "fip-women", "fnc-bantamweight", "fnc-featherweight", "fnc-lightweight", "fnc-welterweight", "fnc-middleweight", "fnc-light-heavyweight" ], "type": "string", "description": "Ranking table to fetch (mode=rankings).", "default": "fifa" }, "includeStatistics": { "title": "Include Statistics", "type": "boolean", "description": "Add team and player statistics to match records.", "default": true }, "includeLineups": { "title": "Include Lineups", "type": "boolean", "description": "Add lineups, formations and player ratings to match records.", "default": true }, "includeIncidents": { "title": "Include Incidents", "type": "boolean", "description": "Add goals, cards and substitutions to match records.", "default": true }, "includeOdds": { "title": "Include Odds", "type": "boolean", "description": "Add pre-match odds markets to match records.", "default": false }, "includeVotes": { "title": "Include Votes", "type": "boolean", "description": "Add crowd prediction polls to match records.", "default": false }, "includeH2h": { "title": "Include Head-to-Head", "type": "boolean", "description": "Add head-to-head win/draw tallies to match records.", "default": false }, "includeAdvanced": { "title": "Include Advanced Match Data", "type": "boolean", "description": "Add shotmap, momentum, average positions, best players, win probability, managers, streaks and pre-game form.", "default": false }, "includeComments": { "title": "Include Commentary", "type": "boolean", "description": "Add the text commentary feed to match records. This is a large payload.", "default": false }, "includeSquad": { "title": "Include Squad", "type": "boolean", "description": "Add the full squad to team records (mode=team).", "default": false }, "includePlayerStats": { "title": "Include Player Statistics", "type": "boolean", "description": "Add per-competition season statistics to player records (mode=player).", "default": false }, "includeStandings": { "title": "Include Standings", "type": "boolean", "description": "Add the league table to tournament records (mode=tournament).", "default": false }, "includeEvents": { "title": "Include Team Events", "type": "boolean", "description": "Add recent and upcoming events to team records (mode=team).", "default": false }, "maxItems": { "title": "Max Items", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Maximum number of records to return. 0 means no user limit (hard cap 10,000).", "default": 50 } } }, "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 } } } } } } } } } }