{ "openapi": "3.0.1", "info": { "title": "Soccer League Results and Standings Scraper", "description": "Get soccer results, league tables at any matchday, team form, head to head records, scorers, cards and referee stats for 40+ leagues since 2010-11. Premier League, La Liga, Bundesliga, Serie A and more with derived stats. Export to CSV or Excel.", "version": "1.0", "x-build-id": "pvwvc3tFaehJEqylI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parselab~soccer-league-results-standings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parselab-soccer-league-results-standings-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/parselab~soccer-league-results-standings-scraper/runs": { "post": { "operationId": "runs-sync-parselab-soccer-league-results-standings-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/parselab~soccer-league-results-standings-scraper/run-sync": { "post": { "operationId": "run-sync-parselab-soccer-league-results-standings-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": { "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000." }, "mode": { "title": "What to collect", "enum": [ "matches", "standings", "teamStats", "headToHead", "players", "referees", "leagueSeasons" ], "type": "string", "description": "Matches gives one row per match with scores, scorers, cards and pre-match table position. Standings builds the league table at any date or matchday. Team stats gives one row per team with form, home and away splits, goal and card rates. Head to head compares two teams across all their meetings. Players and referees need the detailed match files (Premier League, Bundesliga and Austrian Bundesliga 2025-26). League seasons gives one summary row per league and season.", "default": "matches" }, "leagues": { "title": "Leagues", "type": "array", "description": "League codes to read. Leave empty to use the default for the chosen mode (the Premier League for most modes). You can mix countries and divisions.", "items": { "type": "string", "enum": [ "en.1", "en.2", "en.3", "en.4", "es.1", "es.2", "de.1", "de.2", "de.3", "de.cup", "it.1", "it.2", "fr.1", "fr.2", "nl.1", "pt.1", "be.1", "sco.1", "tr.1", "tr.2", "gr.1", "at.1", "at.2", "at.cup", "ch.1", "ch.2", "cz.1", "hu.1", "ru.1", "ru.2", "uefa.cl", "mx.1", "au.1", "dz.1", "eg.1", "ma.1", "ar.1", "br.1", "br.2", "co.1", "cn.1", "jp.1", "mls", "copa.l" ], "enumTitles": [ "England: Premier League", "England: Championship", "England: League One", "England: League Two", "Spain: La Liga", "Spain: La Liga 2", "Germany: Bundesliga", "Germany: 2. Bundesliga", "Germany: 3. Liga", "Germany: DFB-Pokal", "Italy: Serie A", "Italy: Serie B", "France: Ligue 1", "France: Ligue 2", "Netherlands: Eredivisie", "Portugal: Primeira Liga", "Belgium: Pro League", "Scotland: Premiership", "Turkey: Super Lig", "Turkey: 1. Lig", "Greece: Super League", "Austria: Bundesliga", "Austria: 2. Liga", "Austria: Cup", "Switzerland: Super League", "Switzerland: Challenge League", "Czech Republic: First League", "Hungary: NB I", "Russia: Premier League", "Russia: First League", "Europe: Champions League", "Mexico: Liga MX", "Australia: A-League Men", "Algeria: Ligue 1", "Egypt: Premier League", "Morocco: Botola Pro", "Argentina: Primera Division", "Brazil: Serie A", "Brazil: Serie B", "Colombia: Primera A", "China: Super League", "Japan: J1 League", "USA: Major League Soccer", "South America: Copa Libertadores" ] } }, "seasons": { "title": "Seasons", "type": "array", "description": "Seasons to read, for example 2025-26 or just 2025. Use all for every season available (2010-11 onward), or leave empty for the current season. Calendar year leagues such as Brazil, Japan and MLS use the year, for example 2025.", "default": [], "items": { "type": "string" } }, "teams": { "title": "Teams", "type": "array", "description": "Keep only these teams. Part of a name is enough, for example Arsenal, Bayern or Real Madrid. Club suffixes such as FC are ignored.", "items": { "type": "string" } }, "teamSide": { "title": "Team plays at", "enum": [ "any", "home", "away" ], "type": "string", "description": "When teams are given, keep matches where the team plays at home, away or either.", "default": "any" }, "status": { "title": "Match status", "enum": [ "finished", "scheduled", "all" ], "type": "string", "description": "Finished matches only, upcoming fixtures only, or both. Used in the matches mode.", "default": "finished" }, "result": { "title": "Result", "enum": [ "any", "homeWin", "draw", "awayWin" ], "type": "string", "description": "Keep only home wins, draws or away wins. Used in the matches mode.", "default": "any" }, "dateFrom": { "title": "Played from", "type": "string", "description": "Keep matches on or after this date, format YYYY-MM-DD." }, "dateTo": { "title": "Played until", "type": "string", "description": "Keep matches on or before this date, format YYYY-MM-DD." }, "matchdayFrom": { "title": "From matchday", "minimum": 1, "type": "integer", "description": "First matchday to keep (league matches only)." }, "matchdayTo": { "title": "Until matchday", "minimum": 1, "type": "integer", "description": "Last matchday to keep (league matches only)." }, "minTotalGoals": { "title": "Minimum total goals", "minimum": 0, "type": "integer", "description": "Keep finished matches with at least this many goals, for example 4." }, "maxTotalGoals": { "title": "Maximum total goals", "minimum": 0, "type": "integer", "description": "Keep finished matches with at most this many goals, for example 1." }, "includeLineups": { "title": "Include line-ups", "type": "boolean", "description": "Add starters, bench and substitutions to every match row when the detailed file exists. Makes rows much larger.", "default": false }, "sortOrder": { "title": "Match order", "enum": [ "newestFirst", "oldestFirst" ], "type": "string", "description": "Newest matches first or oldest first.", "default": "newestFirst" }, "table": { "title": "Table type", "enum": [ "all", "home", "away" ], "type": "string", "description": "Standings mode: full table, home matches only or away matches only.", "default": "all" }, "asOfDate": { "title": "Table as of date", "type": "string", "description": "Standings mode: build the table using only matches played on or before this date, format YYYY-MM-DD." }, "asOfMatchday": { "title": "Table as of matchday", "minimum": 1, "type": "integer", "description": "Standings mode: build the table after this matchday." }, "groupBy": { "title": "Group results by", "enum": [ "", "team", "teamSeason", "playerTeamSeason", "player", "referee", "refereeSeason" ], "type": "string", "description": "Team statistics: team over all selected seasons or team per season. Players: player over all seasons or player per team and season. Referees: referee over all seasons or per season. Leave empty for the default of the mode.", "default": "" }, "matchPairs": { "title": "Team pairs for head to head", "type": "array", "description": "Pairs written as Team A vs Team B, for example Arsenal vs Chelsea. One row per pair is returned. Without seasons or leagues the pair is searched in the big European leagues and the Champions League since 2010-11.", "items": { "type": "string" } }, "playerNames": { "title": "Player names", "type": "array", "description": "Players mode: keep only these players. Part of a name is enough, for example Haaland or Kane.", "items": { "type": "string" } }, "minMinutes": { "title": "Minimum minutes played", "minimum": 0, "type": "integer", "description": "Players mode: skip players with fewer minutes." }, "minGoals": { "title": "Minimum goals", "minimum": 0, "type": "integer", "description": "Players mode: skip players with fewer goals." }, "minMatches": { "title": "Minimum matches", "minimum": 1, "type": "integer", "description": "Team statistics and referees: skip rows with fewer matches." } } }, "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 } } } } } } } } } }