{ "openapi": "3.0.1", "info": { "title": "Football-Data.co.uk Scraper - Results, Stats & Odds", "description": "Scrape 240,000+ football matches from Football-Data.co.uk: 38 competitions, results, half-time scores, shots, cards, corners, referees, xG, and 1X2 / over-under / Asian handicap odds from 22 bookmakers.", "version": "0.0", "x-build-id": "a1WDamJECYDJNzZcH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~football-data-couk-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-football-data-couk-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/parseforge~football-data-couk-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-football-data-couk-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/parseforge~football-data-couk-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-football-data-couk-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": { "leagues": { "title": "Leagues (1993/94 onward)", "type": "array", "description": "The 22 divisions Football-Data.co.uk publishes as one file per season, with match statistics and per-bookmaker odds. Coverage starts in 1993/94 for the biggest divisions; the National League starts in 2005/06 and the Scottish lower tiers in 1997/98.", "items": { "type": "string", "enum": [ "E0", "E1", "E2", "E3", "EC", "SC0", "SC1", "SC2", "SC3", "D1", "D2", "I1", "I2", "SP1", "SP2", "F1", "F2", "N1", "B1", "P1", "T1", "G1" ], "enumTitles": [ "England — Premier League", "England — Championship", "England — League One", "England — League Two", "England — National League", "Scotland — Premiership", "Scotland — Championship", "Scotland — League One", "Scotland — League Two", "Germany — Bundesliga", "Germany — 2. Bundesliga", "Italy — Serie A", "Italy — Serie B", "Spain — La Liga", "Spain — Segunda Division", "France — Ligue 1", "France — Ligue 2", "Netherlands — Eredivisie", "Belgium — Jupiler Pro League", "Portugal — Primeira Liga", "Turkey — Super Lig", "Greece — Super League" ] }, "default": [] }, "extraLeagues": { "title": "Extra leagues (2012 onward)", "type": "array", "description": "The 16 non-European-core competitions published as one all-seasons file each, from 2012 onward. These carry closing odds only — no shots, cards, corners or referee.", "items": { "type": "string", "enum": [ "ARG", "AUT", "BRA", "CHN", "DNK", "FIN", "IRL", "JPN", "MEX", "NOR", "POL", "ROU", "RUS", "SWE", "SWZ", "USA" ], "enumTitles": [ "Argentina — Liga Profesional", "Austria — Bundesliga", "Brazil — Serie A", "China — Super League", "Denmark — Superliga", "Finland — Veikkausliiga", "Ireland — Premier Division", "Japan — J1 League", "Mexico — Liga MX", "Norway — Eliteserien", "Poland — Ekstraklasa", "Romania — Superliga", "Russia — Premier League", "Sweden — Allsvenskan", "Switzerland — Super League", "USA — MLS" ] }, "default": [] }, "countries": { "title": "Countries", "type": "array", "description": "Shortcut for picking every division a country has. Adds to whatever you selected above; England alone brings in all five English tiers.", "items": { "type": "string", "enum": [ "England", "Scotland", "Germany", "Italy", "Spain", "France", "Netherlands", "Belgium", "Portugal", "Turkey", "Greece", "Argentina", "Austria", "Brazil", "China", "Denmark", "Finland", "Ireland", "Japan", "Mexico", "Norway", "Poland", "Romania", "Russia", "Sweden", "Switzerland", "USA" ] }, "default": [] }, "dataset": { "title": "What to collect", "enum": [ "results", "fixtures", "both" ], "type": "string", "description": "Played matches from the season archives, the upcoming fixtures file with its opening odds, or both.", "default": "results" }, "seasonFrom": { "title": "Season from", "type": "string", "description": "Oldest season to include. Accepts 2020/21, 2020-21, 2020 or the site's own 2021 code. Leave this empty and it starts at the oldest season the league has; leave both season fields empty and the run returns the two most recent seasons." }, "seasonTo": { "title": "Season to", "type": "string", "description": "Newest season to include, same formats as above. Leave it empty to run through to the current season." }, "dateFrom": { "title": "Played on or after", "type": "string", "description": "Drop matches played before this date. Applied on top of the season range." }, "dateTo": { "title": "Played on or before", "type": "string", "description": "Drop matches played after this date." }, "includeMatchStats": { "title": "Match statistics", "type": "boolean", "description": "Referee, shots, shots on target, corners, fouls, free kicks conceded, offsides, woodwork, yellow and red cards, booking points, attendance, expected goals, and the shot-accuracy and conversion rates derived from them. Available from 2000/01 in the main leagues; the extra leagues never carry it.", "default": false }, "includeOdds1x2": { "title": "Pre-match 1X2 odds (per bookmaker)", "type": "boolean", "description": "Home / draw / away prices from every bookmaker in the file — up to 22 books including Bet365, Pinnacle, William Hill, bwin, Interwetten, BetVictor, Ladbrokes, Betfred, BetMGM, Coral, Paddy Power, Sky Bet, 1XBet and the Betfair Exchange.", "default": false }, "includeClosingOdds": { "title": "Closing 1X2 odds (per bookmaker)", "type": "boolean", "description": "The same books priced again just before kick-off. Published from 2019/20 onward. This is the column serious models score themselves against.", "default": false }, "includeOverUnder": { "title": "Over / under 2.5 goals odds", "type": "boolean", "description": "Over and under 2.5-goal prices, pre-match and closing, per bookmaker plus the market maximum and average.", "default": false }, "includeAsianHandicap": { "title": "Asian handicap odds", "type": "boolean", "description": "The handicap line and its home / away prices, pre-match and closing, per bookmaker plus market maximum and average.", "default": false }, "includeMarketConsensus": { "title": "Market maximum and average", "type": "boolean", "description": "Best price and mean price across the whole market for 1X2, over/under and Asian handicap, pre-match and closing, plus how many books each average was built from. Includes the retired BetBrain aggregates for older seasons.", "default": false }, "includeBettingAnalytics": { "title": "Betting analytics (computed)", "type": "boolean", "description": "Implied and margin-free probabilities, bookmaker overround, fair odds, favourite and underdog, best available price, expected-value edge and Kelly fraction, pre-match to closing drift with steamer / drifter flags, closing line value, and the settled profit or loss of a one-unit bet on each outcome.", "default": false }, "includeHeadToHead": { "title": "Head-to-head history", "type": "boolean", "description": "Every previous meeting between the two sides in that competition before this match: record, average goals, both-teams-scored and over-2.5 rates, the last meeting, and the last five scorelines. Downloads and indexes the division's full archive, so it is the most expensive block here.", "default": false }, "includeTeamForm": { "title": "Team form before kick-off", "type": "boolean", "description": "Rolling record for both sides over their previous matches in that competition: points, points per game, goals for and against, clean sheets, W/D/L form string, current streak and unbeaten run. Also indexes the full archive.", "default": false }, "includeStandings": { "title": "League tables (extra rows)", "type": "boolean", "description": "Adds a league-table row per team per competition-season, built from the matches this run collected: position, played, W/D/L, goals, goal difference, points, points per game, split home and away records, clean sheets, both-teams-scored and over-2.5 counts, and recent form.", "default": false }, "formWindow": { "title": "Form window (matches)", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many previous matches the team-form block looks back over. Only used when Team form is on.", "default": 6 }, "teams": { "title": "Teams", "type": "array", "description": "Keep only matches involving these clubs. Case- and punctuation-insensitive, so \"man united\" matches \"Man United\". Football-Data uses short forms — Man United, Tottenham, Ath Madrid, Bayern Munich, Paris SG.", "default": [], "items": { "type": "string" } }, "teamMatchMode": { "title": "Team plays", "enum": [ "either", "home", "away" ], "type": "string", "description": "Whether the team filter should match the home side, the away side, or either.", "default": "either" }, "excludeTeams": { "title": "Exclude teams", "type": "array", "description": "Drop matches involving any of these clubs.", "default": [], "items": { "type": "string" } }, "referees": { "title": "Referees", "type": "array", "description": "Keep only matches with these referees. Football-Data writes them as initial plus surname, e.g. \"M Oliver\", \"A Taylor\".", "default": [], "items": { "type": "string" } }, "fullTimeResults": { "title": "Full-time result", "type": "array", "description": "Keep only these full-time outcomes.", "items": { "type": "string", "enum": [ "H", "D", "A" ], "enumTitles": [ "Home win", "Draw", "Away win" ] }, "default": [] }, "halfTimeResults": { "title": "Half-time result", "type": "array", "description": "Keep only these half-time outcomes.", "items": { "type": "string", "enum": [ "H", "D", "A" ], "enumTitles": [ "Home ahead", "Level", "Away ahead" ] }, "default": [] }, "minTotalGoals": { "title": "Minimum total goals", "minimum": 0, "maximum": 30, "type": "integer", "description": "Matches with at least this many goals." }, "maxTotalGoals": { "title": "Maximum total goals", "minimum": 0, "maximum": 30, "type": "integer", "description": "Matches with at most this many goals." }, "minHomeGoals": { "title": "Minimum home goals", "minimum": 0, "maximum": 30, "type": "integer", "description": "Home side scored at least this many." }, "maxHomeGoals": { "title": "Maximum home goals", "minimum": 0, "maximum": 30, "type": "integer", "description": "Home side scored at most this many." }, "minAwayGoals": { "title": "Minimum away goals", "minimum": 0, "maximum": 30, "type": "integer", "description": "Away side scored at least this many." }, "maxAwayGoals": { "title": "Maximum away goals", "minimum": 0, "maximum": 30, "type": "integer", "description": "Away side scored at most this many." }, "minGoalDifference": { "title": "Minimum winning margin", "minimum": 0, "maximum": 30, "type": "integer", "description": "Keep only matches won by at least this many goals." }, "bothTeamsScored": { "title": "Both teams scored", "enum": [ "any", "yes", "no" ], "type": "string", "description": "Filter on whether both sides got on the scoresheet.", "default": "any" }, "comebacksOnly": { "title": "Comebacks only", "type": "boolean", "description": "Keep only matches where the side trailing at half time did not lose.", "default": false }, "daysOfWeek": { "title": "Days of the week", "type": "array", "description": "Keep only matches played on these days.", "items": { "type": "string", "enum": [ "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ] }, "default": [] }, "kickoffFrom": { "title": "Kick-off from", "type": "string", "description": "Earliest kick-off time to keep, as HH:MM in the time the site publishes. Kick-off times exist from 2019/20 onward." }, "kickoffTo": { "title": "Kick-off to", "type": "string", "description": "Latest kick-off time to keep, as HH:MM." }, "minShots": { "title": "Minimum total shots", "minimum": 0, "maximum": 100, "type": "integer", "description": "Combined shots by both sides. Needs a season that carries match statistics." }, "minShotsOnTarget": { "title": "Minimum shots on target", "minimum": 0, "maximum": 100, "type": "integer", "description": "Combined shots on target by both sides." }, "minCorners": { "title": "Minimum total corners", "minimum": 0, "maximum": 100, "type": "integer", "description": "Combined corners by both sides." }, "minFouls": { "title": "Minimum total fouls", "minimum": 0, "maximum": 100, "type": "integer", "description": "Combined fouls by both sides." }, "minYellowCards": { "title": "Minimum yellow cards", "minimum": 0, "maximum": 30, "type": "integer", "description": "Combined yellow cards." }, "minRedCards": { "title": "Minimum red cards", "minimum": 0, "maximum": 10, "type": "integer", "description": "Combined red cards. Set to 1 for matches with a sending off." }, "minAttendance": { "title": "Minimum attendance", "minimum": 0, "maximum": 200000, "type": "integer", "description": "Crowd size. Only the 2000/01 and 2001/02 English, Scottish and German files carry attendance." }, "minExpectedGoals": { "title": "Minimum total xG", "minimum": 0, "maximum": 20, "type": "number", "description": "Combined expected goals. Football-Data started publishing xG in 2026/27. Decimal, e.g. 2.5." }, "minHomeOdds": { "title": "Minimum home odds", "minimum": 1, "maximum": 1000, "type": "number", "description": "Reference home price, read from the market average and falling back to Pinnacle, then Bet365, then whatever book the file carries. Decimal, e.g. 1.50." }, "maxHomeOdds": { "title": "Maximum home odds", "minimum": 1, "maximum": 1000, "type": "number", "description": "Upper bound on the reference home price. Decimal, e.g. 3.00." }, "minDrawOdds": { "title": "Minimum draw odds", "minimum": 1, "maximum": 1000, "type": "number", "description": "Lower bound on the reference draw price. Decimal, e.g. 3.00." }, "maxDrawOdds": { "title": "Maximum draw odds", "minimum": 1, "maximum": 1000, "type": "number", "description": "Upper bound on the reference draw price. Decimal, e.g. 5.00." }, "minAwayOdds": { "title": "Minimum away odds", "minimum": 1, "maximum": 1000, "type": "number", "description": "Lower bound on the reference away price. Decimal, e.g. 2.00." }, "maxAwayOdds": { "title": "Maximum away odds", "minimum": 1, "maximum": 1000, "type": "number", "description": "Upper bound on the reference away price. Decimal, e.g. 10.00." }, "minOverround": { "title": "Minimum bookmaker margin", "minimum": 0, "maximum": 2, "type": "number", "description": "Lower bound on the overround of the reference 1X2 prices, as a fraction: 0.05 means a 5% margin. Decimal, e.g. 0.05." }, "maxOverround": { "title": "Maximum bookmaker margin", "minimum": 0, "maximum": 2, "type": "number", "description": "Upper bound on the overround. Use it to keep only the sharpest-priced matches. Decimal, e.g. 0.03." }, "minBookmakerCount": { "title": "Minimum bookmakers priced", "minimum": 1, "maximum": 30, "type": "integer", "description": "Keep only matches priced by at least this many bookmakers in the 1X2 market, counting whichever of the pre-match or closing lines the file carries. Useful for dropping thinly-quoted fixtures from a model." }, "favourite": { "title": "Market favourite", "enum": [ "any", "home", "away", "pickem" ], "type": "string", "description": "Keep only matches where the shortest price belonged to this side.", "default": "any" }, "upsetsOnly": { "title": "Upsets only", "type": "boolean", "description": "Keep only matches the longest-priced outcome won.", "default": false }, "upsetMinOdds": { "title": "Upset minimum winning odds", "minimum": 1, "maximum": 1000, "type": "number", "description": "With Upsets only on, also require the winning price to be at least this long. Decimal, e.g. 4.00." }, "oddsMovement": { "title": "Odds movement", "enum": [ "any", "steamer", "drifter" ], "type": "string", "description": "Keep only matches whose price shortened (steamer) or lengthened (drifter) between the pre-match and closing lines. Needs a season with closing odds — 2019/20 onward.", "default": "any" }, "minOddsMovementPct": { "title": "Minimum movement (%)", "minimum": 0, "maximum": 500, "type": "number", "description": "How far the price must have moved, in percent, for the movement filter to keep the match." }, "maxItems": { "title": "Maximum rows", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Total rows to write in this run. Free Apify plans return a 10-row preview." }, "matchesPerLeague": { "title": "Matches per competition", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Cap the matches taken from each competition so one league cannot use up the whole run. Leave empty to let Maximum rows decide." }, "sortBy": { "title": "Sort rows by", "enum": [ "none", "dateDesc", "dateAsc", "totalGoals", "attendance", "homeOdds", "overround" ], "type": "string", "description": "Leave on \"Source order\" to stream results as they download, newest season first. Any other choice buffers the whole selection in memory before writing.", "default": "none" }, "oddsFormat": { "title": "Odds format", "enum": [ "decimal", "fractional", "american" ], "type": "string", "description": "How odds are printed in the odds blocks. Analytics always stay decimal so the maths keeps working.", "default": "decimal" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed — Football-Data.co.uk serves these files anonymously with no rate limit measured. Turn it on only if your own network blocks the site.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }