{ "openapi": "3.0.1", "info": { "title": "Soccer Fixtures, Live Scores & Results Scraper", "description": "Get football fixtures, live scores and results from 219 soccer leagues: Premier League, LaLiga, Serie A, Bundesliga, Champions League, MLS, Liga MX and more. Goalscorers, cards, team form, venues and betting odds. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "2VZcu7bwKWJV1vT9j" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hgservices~soccer-fixtures-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hgservices-soccer-fixtures-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/hgservices~soccer-fixtures-scraper/runs": { "post": { "operationId": "runs-sync-hgservices-soccer-fixtures-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/hgservices~soccer-fixtures-scraper/run-sync": { "post": { "operationId": "run-sync-hgservices-soccer-fixtures-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", "type": "array", "description": "Competitions to scrape. The list holds all 219 competitions — type a name to search it. This field adds together with League Groups and Countries.", "items": { "type": "string", "enum": [ "eng.1", "esp.1", "ita.1", "ger.1", "fra.1", "uefa.champions", "uefa.europa", "uefa.europa.conf", "usa.1", "mex.1", "bra.1", "arg.1", "ned.1", "por.1", "tur.1", "bel.1", "sco.1", "ksa.1", "jpn.1", "eng.2", "eng.3", "eng.4", "eng.5", "esp.2", "ita.2", "ger.2", "fra.2", "eng.fa", "eng.league_cup", "esp.copa_del_rey", "ita.coppa_italia", "ger.dfb_pokal", "fra.coupe_de_france", "conmebol.libertadores", "conmebol.sudamericana", "concacaf.champions", "concacaf.leagues.cup", "fifa.world", "uefa.euro", "conmebol.america", "concacaf.gold", "caf.nations", "afc.asian.cup", "uefa.nations", "fifa.friendly", "usa.nwsl", "eng.w.1", "uefa.wchampions", "fifa.wwc", "afc.cupq", "afc.champions", "afc.champions_qual", "afc.cup", "afc.cup_qual", "afc.w.asian.cup", "aff.championship", "afc.saff.championship", "aus.1", "aus.w.1", "chn.1", "chn.1.promotion.relegation", "ind.1", "jpn.world_challenge", "ksa.kings.cup", "caf.nations_qual", "caf.championship", "caf.champions", "caf.confed", "caf.cosafa", "caf.w.nations", "rsa.1", "campeones.cup", "concacaf.central.american.cup", "concacaf.champions_cup", "concacaf.confederations_playoff", "concacaf.gold_qual", "concacaf.nations.league", "concacaf.u23", "concacaf.w.champions_cup", "concacaf.womens.championship", "concacaf.w.gold", "can.w.nsl", "crc.1", "slv.1", "gua.1", "hon.1", "mex.campeon", "mex.w.1", "mex.2", "usa.ncaa.m.1", "usa.ncaa.w.1", "usa.nwsl.cup", "usa.open", "usa.usl.1", "usa.usl.l1.cup", "usa.usl.l1", "usa.w.usl.1", "conmebol.recopa", "conmebol.america.femenina", "arg.copa_de_la_superliga", "arg.2", "arg.3", "arg.supercopa", "arg.supercopa.internacional", "arg.trofeo_de_la_campeones", "arg.copa", "bol.1", "bol.ply.rel", "bol.copa", "bra.camp.carioca", "bra.camp.gaucho", "bra.camp.mineiro", "bra.camp.paulista", "bra.2", "bra.supercopa_do_brazil", "bra.copa_do_brazil", "chi.1", "chi.1.promotion.relegation", "chi.super_cup", "chi.copa_chi", "col.1", "col.superliga", "col.copa", "ecu.1", "par.1", "par.1.supercopa", "per.1", "uru.1", "uru.2", "ven.1", "global.gulf_cup", "global.arnold.clark_cup", "club.friendly", "fifa.w.concacaf.olympicsq", "fifa.conmebol.olympicsq", "global.club_challenge", "global.finalissima", "global.u20.intercontinental_cup", "global.w.finalissima", "friendly.emirates_cup", "fifa.cwc", "fifa.intercontinental_cup", "fifa.wworld.u17", "fifa.world.u17", "fifa.world.u20", "fifa.w.champions_cup", "fifa.wwcq.ply", "fifa.wworldq.uefa", "fifa.worldq.afc", "fifa.worldq.caf", "fifa.worldq.concacaf", "fifa.worldq.conmebol", "fifa.worldq.ofc", "fifa.wcq.ply", "fifa.worldq.uefa", "fifa.intercontinental.cup", "fifa.concacaf.olympicsq", "fifa.olympics", "nonfifa", "global.pinatar_cup", "fifa.shebelieves", "fifa.friendly_u21", "fifa.friendly.w", "fifa.w.olympics", "uefa.champions_qual", "uefa.europa.conf_qual", "uefa.europa_qual", "uefa.euroq", "uefa.euro.u19", "uefa.euro_u21", "uefa.euro_u21_qual", "uefa.super_cup", "uefa.wchampions_qual", "uefa.w.europa", "uefa.weuro", "uefa.w.nations", "aut.1", "bel.promotion.relegation", "den.1", "eng.trophy", "eng.charity", "eng.fa_qual", "eng.w.fa", "eng.w.promotion.relegation", "eng.w.league_cup", "fra.1.promotion.relegation", "fra.w.1", "fra.super_cup", "ger.2.promotion.relegation", "ger.playoff.relegation", "ger.super_cup", "gre.1", "ita.super_cup", "ned.playoff.relegation", "ned.supercup", "ned.2", "ned.cup", "ned.w.knvb_cup", "ned.3.promotion.relegation", "ned.w.1", "nor.1", "nor.1.promotion.relegation", "por.1.promotion.relegation", "por.taca.portugal", "rus.1", "rus.1.promotion.relegation", "sco.2", "sco.2.promotion.relegation", "sco.tennents", "sco.tennents_qual", "sco.challenge", "sco.cis", "sco.1.promotion.relegation", "esp.copa_de_la_reina", "esp.w.1", "esp.super_cup", "esp.joan_gamper", "swe.1", "swe.1.promotion.relegation" ], "enumTitles": [ "English Premier League (England) — eng.1", "Spanish LALIGA (Spain) — esp.1", "Italian Serie A (Italy) — ita.1", "German Bundesliga (Germany) — ger.1", "French Ligue 1 (France) — fra.1", "UEFA Champions League (UEFA) — uefa.champions", "UEFA Europa League (UEFA) — uefa.europa", "UEFA Conference League (UEFA) — uefa.europa.conf", "MLS (United States) — usa.1", "Mexican Liga BBVA MX (Mexico) — mex.1", "Brazilian Serie A (Brazil) — bra.1", "Argentine Liga Profesional de Fútbol (Argentina) — arg.1", "Dutch Eredivisie (Netherlands) — ned.1", "Portuguese Primeira Liga (Portugal) — por.1", "Turkish Super Lig (Turkey) — tur.1", "Belgian Pro League (Belgium) — bel.1", "Scottish Premiership (Scotland) — sco.1", "Saudi Pro League (Saudi Arabia) — ksa.1", "Japanese J.League (Japan) — jpn.1", "English League Championship (England) — eng.2", "English League One (England) — eng.3", "English League Two (England) — eng.4", "English National League (England) — eng.5", "Spanish LALIGA 2 (Spain) — esp.2", "Italian Serie B (Italy) — ita.2", "German 2. Bundesliga (Germany) — ger.2", "French Ligue 2 (France) — fra.2", "English FA Cup (England) — eng.fa", "English Carabao Cup (England) — eng.league_cup", "Spanish Copa del Rey (Spain) — esp.copa_del_rey", "Coppa Italia (Italy) — ita.coppa_italia", "German Cup (Germany) — ger.dfb_pokal", "Coupe de France (France) — fra.coupe_de_france", "CONMEBOL Libertadores (CONMEBOL) — conmebol.libertadores", "CONMEBOL Sudamericana (CONMEBOL) — conmebol.sudamericana", "Concacaf Champions Cup (CONCACAF) — concacaf.champions", "Leagues Cup (CONCACAF) — concacaf.leagues.cup", "FIFA World Cup (FIFA) — fifa.world", "UEFA European Championship (UEFA) — uefa.euro", "Copa América (CONMEBOL) — conmebol.america", "Concacaf Gold Cup (CONCACAF) — concacaf.gold", "Africa Cup of Nations (CAF) — caf.nations", "AFC Asian Cup (AFC) — afc.asian.cup", "UEFA Nations League (UEFA) — uefa.nations", "International Friendly (FIFA) — fifa.friendly", "NWSL (United States) — usa.nwsl", "English Women's Super League (England) — eng.w.1", "UEFA Women's Champions League (UEFA) — uefa.wchampions", "FIFA Women's World Cup (FIFA) — fifa.wwc", "AFC Asian Cup Qualifiers (AFC) — afc.cupq", "AFC Champions League Elite (AFC) — afc.champions", "AFC Champions League Elite Qualifying (AFC) — afc.champions_qual", "AFC Champions League Two (AFC) — afc.cup", "AFC Champions League Two Qualifying (AFC) — afc.cup_qual", "AFC Women's Asian Cup (AFC) — afc.w.asian.cup", "ASEAN Championship (AFC) — aff.championship", "SAFF Championship (AFC) — afc.saff.championship", "Australian A-League Men (Australia) — aus.1", "Australian A-League Women (Australia) — aus.w.1", "Chinese Super League (China) — chn.1", "Chinese Super League Promotion/Relegation Playoffs (China) — chn.1.promotion.relegation", "Indian Super League (India) — ind.1", "Japanese J.League World Challenge (Japan) — jpn.world_challenge", "Saudi King's Cup (Saudi Arabia) — ksa.kings.cup", "Africa Cup of Nations Qualifying (CAF) — caf.nations_qual", "African Nations Championship (CAF) — caf.championship", "CAF Champions League (CAF) — caf.champions", "CAF Confederation Cup (CAF) — caf.confed", "COSAFA Cup (CAF) — caf.cosafa", "Women's Africa Cup of Nations (CAF) — caf.w.nations", "South African Premiership (South Africa) — rsa.1", "Campeones Cup (CONCACAF) — campeones.cup", "Concacaf Central American Cup (CONCACAF) — concacaf.central.american.cup", "CONCACAF Champions Cup (CONCACAF) — concacaf.champions_cup", "Concacaf Cup (CONCACAF) — concacaf.confederations_playoff", "Concacaf Gold Cup Qualifying (CONCACAF) — concacaf.gold_qual", "Concacaf Nations League (CONCACAF) — concacaf.nations.league", "CONCACAF U23 Tournament (CONCACAF) — concacaf.u23", "Concacaf W Champions Cup (CONCACAF) — concacaf.w.champions_cup", "Concacaf W Championship (CONCACAF) — concacaf.womens.championship", "Concacaf W Gold Cup (CONCACAF) — concacaf.w.gold", "Northern Super League (Canada) — can.w.nsl", "Costa Rican Primera Division (Costa Rica) — crc.1", "Salvadoran Primera Division (El Salvador) — slv.1", "Guatemalan Liga Nacional (Guatemala) — gua.1", "Honduran Liga Nacional (Honduras) — hon.1", "Mexican Campeon de Campeones (Mexico) — mex.campeon", "Mexican Liga BBVA MX Femenil (Mexico) — mex.w.1", "Mexican Liga de Expansión MX (Mexico) — mex.2", "NCAA Men's Soccer (United States) — usa.ncaa.m.1", "NCAA Women's Soccer (United States) — usa.ncaa.w.1", "NWSL Challenge Cup (United States) — usa.nwsl.cup", "U.S. Open Cup (United States) — usa.open", "USL Championship (United States) — usa.usl.1", "USL Cup (United States) — usa.usl.l1.cup", "USL League One (United States) — usa.usl.l1", "USL Super League (United States) — usa.w.usl.1", "CONMEBOL Recopa (CONMEBOL) — conmebol.recopa", "Copa América Femenina (CONMEBOL) — conmebol.america.femenina", "Argentine Copa de la Superliga (Argentina) — arg.copa_de_la_superliga", "Argentine Nacional B (Argentina) — arg.2", "Argentine Primera B (Argentina) — arg.3", "Argentine Supercopa (Argentina) — arg.supercopa", "Argentine Supercopa Internacional (Argentina) — arg.supercopa.internacional", "Argentine Trofeo de Campeones (Argentina) — arg.trofeo_de_la_campeones", "Copa Argentina (Argentina) — arg.copa", "Bolivian Liga Profesional (Bolivia) — bol.1", "Bolivian Liga Profesional Promotion/Relegation Playoffs (Bolivia) — bol.ply.rel", "Copa Bolivia (Bolivia) — bol.copa", "Brazilian Campeonato Carioca (Brazil) — bra.camp.carioca", "Brazilian Campeonato Gaucho (Brazil) — bra.camp.gaucho", "Brazilian Campeonato Mineiro (Brazil) — bra.camp.mineiro", "Brazilian Campeonato Paulista (Brazil) — bra.camp.paulista", "Brazilian Serie B (Brazil) — bra.2", "Brazilian Supercopa Rei (Brazil) — bra.supercopa_do_brazil", "Copa do Brasil (Brazil) — bra.copa_do_brazil", "Chilean Primera División (Chile) — chi.1", "Chilean Primera División Promotion/Relegation Playoffs (Chile) — chi.1.promotion.relegation", "Chilean Supercopa (Chile) — chi.super_cup", "Copa Chile (Chile) — chi.copa_chi", "Colombian Primera A (Colombia) — col.1", "Colombian Superliga (Colombia) — col.superliga", "Copa Colombia (Colombia) — col.copa", "LigaPro Ecuador (Ecuador) — ecu.1", "Paraguayan Primera División (Paraguay) — par.1", "Paraguayan Supercopa (Paraguay) — par.1.supercopa", "Peruvian Liga 1 (Peru) — per.1", "Liga AUF Uruguaya (Uruguay) — uru.1", "Segunda División de Uruguay (Uruguay) — uru.2", "Venezuelan Primera División (Venezuela) — ven.1", "Arabian Gulf Cup (FIFA) — global.gulf_cup", "Arnold Clark Cup (FIFA) — global.arnold.clark_cup", "Club Friendly (FIFA) — club.friendly", "Concacaf Women's Olympic Qualifying (FIFA) — fifa.w.concacaf.olympicsq", "CONMEBOL Pre-Olympic Tournament (FIFA) — fifa.conmebol.olympicsq", "CONMEBOL-UEFA Club Challenge (FIFA) — global.club_challenge", "CONMEBOL-UEFA Cup of Champions (FIFA) — global.finalissima", "CONMEBOL-UEFA U20 Intercontinental Cup (FIFA) — global.u20.intercontinental_cup", "CONMEBOL-UEFA Women's Cup of Champions (FIFA) — global.w.finalissima", "Emirates Cup (FIFA) — friendly.emirates_cup", "FIFA Club World Cup (FIFA) — fifa.cwc", "FIFA Intercontinental Cup (FIFA) — fifa.intercontinental_cup", "FIFA Under-17 Women's World Cup (FIFA) — fifa.wworld.u17", "FIFA Under-17 World Cup (FIFA) — fifa.world.u17", "FIFA Under-20 World Cup (FIFA) — fifa.world.u20", "FIFA Women's Champions Cup (FIFA) — fifa.w.champions_cup", "FIFA Women's World Cup Qualifying - Playoff Tournament (FIFA) — fifa.wwcq.ply", "FIFA Women's World Cup Qualifying - UEFA (FIFA) — fifa.wworldq.uefa", "FIFA World Cup Qualifying - AFC (FIFA) — fifa.worldq.afc", "FIFA World Cup Qualifying - CAF (FIFA) — fifa.worldq.caf", "FIFA World Cup Qualifying - Concacaf (FIFA) — fifa.worldq.concacaf", "FIFA World Cup Qualifying - CONMEBOL (FIFA) — fifa.worldq.conmebol", "FIFA World Cup Qualifying - OFC (FIFA) — fifa.worldq.ofc", "FIFA World Cup Qualifying - Playoff Tournament (FIFA) — fifa.wcq.ply", "FIFA World Cup Qualifying - UEFA (FIFA) — fifa.worldq.uefa", "Intercontinental Cup (India) (FIFA) — fifa.intercontinental.cup", "Men's Olympic Qualifying Playoff (FIFA) — fifa.concacaf.olympicsq", "Men's Olympic Soccer Tournament (FIFA) — fifa.olympics", "Non-FIFA Friendly (FIFA) — nonfifa", "Pinatar Cup (FIFA) — global.pinatar_cup", "SheBelieves Cup (FIFA) — fifa.shebelieves", "Under-21 International Friendly (FIFA) — fifa.friendly_u21", "Women's International Friendly (FIFA) — fifa.friendly.w", "Women's Olympic Soccer Tournament (FIFA) — fifa.w.olympics", "UEFA Champions League Qualifying (UEFA) — uefa.champions_qual", "UEFA Conference League Qualifying (UEFA) — uefa.europa.conf_qual", "UEFA Europa League Qualifying (UEFA) — uefa.europa_qual", "UEFA European Championship Qualifying (UEFA) — uefa.euroq", "UEFA European Under-19 Championship (UEFA) — uefa.euro.u19", "UEFA European Under-21 Championship (UEFA) — uefa.euro_u21", "UEFA European Under-21 Championship Qualifying (UEFA) — uefa.euro_u21_qual", "UEFA Super Cup (UEFA) — uefa.super_cup", "UEFA Women's Champions League Qualifying (UEFA) — uefa.wchampions_qual", "UEFA Women's Europa Cup (UEFA) — uefa.w.europa", "UEFA Women's European Championship (UEFA) — uefa.weuro", "UEFA Women's Nations League (UEFA) — uefa.w.nations", "Austrian Bundesliga (Austria) — aut.1", "Belgian Pro League Promotion/Relegation Playoffs (Belgium) — bel.promotion.relegation", "Danish Superliga (Denmark) — den.1", "English EFL Trophy (England) — eng.trophy", "English FA Community Shield (England) — eng.charity", "English FA Cup Qualifying (England) — eng.fa_qual", "English Women's FA Cup (England) — eng.w.fa", "English Women's Super League Promotion/Relegation Playoff (England) — eng.w.promotion.relegation", "English WSL Players Cup (England) — eng.w.league_cup", "French Ligue 1 Promotion/Relegation Playoffs (France) — fra.1.promotion.relegation", "French Première Ligue (France) — fra.w.1", "French Trophee des Champions (France) — fra.super_cup", "German Bundesliga 2. Promotion/Relegation Playoffs (Germany) — ger.2.promotion.relegation", "German Bundesliga Promotion/Relegation Playoff (Germany) — ger.playoff.relegation", "German Supercup (Germany) — ger.super_cup", "Greek Super League (Greece) — gre.1", "Italian Supercoppa (Italy) — ita.super_cup", "Dutch Eredivisie Promotion/Relegation Playoffs (Netherlands) — ned.playoff.relegation", "Dutch Johan Cruyff Shield (Netherlands) — ned.supercup", "Dutch Keuken Kampioen Divisie (Netherlands) — ned.2", "Dutch KNVB Beker (Netherlands) — ned.cup", "Dutch KNVB Beker Vrouwen (Netherlands) — ned.w.knvb_cup", "Dutch Tweede Divisie Promotion/Relegation Playoffs (Netherlands) — ned.3.promotion.relegation", "Dutch Vrouwen Eredivisie (Netherlands) — ned.w.1", "Norwegian Eliteserien (Norway) — nor.1", "Norwegian Eliteserien Promotion/Relegation Playoffs (Norway) — nor.1.promotion.relegation", "Portuguese Primeira Liga Promotion/Relegation Playoffs (Portugal) — por.1.promotion.relegation", "Taca de Portugal (Portugal) — por.taca.portugal", "Russian Premier League (Russia) — rus.1", "Russian Premier League Relegation/Promotion Playoffs (Russia) — rus.1.promotion.relegation", "Scottish Championship (Scotland) — sco.2", "Scottish Championship Promotion/Relegation Playoffs (Scotland) — sco.2.promotion.relegation", "Scottish Cup (Scotland) — sco.tennents", "Scottish Cup Qualifying (Scotland) — sco.tennents_qual", "Scottish League Challenge Cup (Scotland) — sco.challenge", "Scottish League Cup (Scotland) — sco.cis", "Scottish Premiership Promotion/Relegation Playoffs (Scotland) — sco.1.promotion.relegation", "Spanish Copa de la Reina (Spain) — esp.copa_de_la_reina", "Spanish Liga F (Spain) — esp.w.1", "Spanish Supercopa (Spain) — esp.super_cup", "Trofeo Joan Gamper (Spain) — esp.joan_gamper", "Swedish Allsvenskan (Sweden) — swe.1", "Swedish Allsvenskan Promotion/Relegation Playoffs (Sweden) — swe.1.promotion.relegation" ] } }, "leagueGroups": { "title": "League Groups", "type": "array", "description": "Named bundles of leagues, added to the Leagues above. \"all\" is every one of the 219 competitions.", "items": { "type": "string", "enum": [ "top5", "europeTop", "englishPyramid", "uefaClub", "domesticCups", "americasTop", "asiaTop", "africaTop", "internationalMen", "womens", "uefa", "conmebol", "concacaf", "afc", "caf", "all" ], "enumTitles": [ "Top 5 European leagues (5)", "Top European leagues (16)", "English pyramid, tiers 1-5 (5)", "UEFA club competitions (4)", "Major domestic cups (13)", "Top leagues and cups of the Americas (16)", "Top leagues and cups of Asia (7)", "Top leagues and cups of Africa (4)", "Men's international competitions (15)", "Every women's competition (39)", "Every UEFA competition (86)", "Every CONMEBOL competition (38)", "Every CONCACAF competition (32)", "Every AFC competition (18)", "Every CAF competition (8)", "Every competition (219)" ] }, "default": [] }, "countries": { "title": "Countries", "type": "array", "description": "Add every competition of a country, by name or by code. For example, England or eng adds the Premier League, the Championship, the FA Cup and the WSL. Codes include eng, esp, ita, ger, fra, ned, por, sco, bel, tur, bra, arg, mex, usa, jpn, ksa.", "items": { "type": "string" }, "default": [] }, "dateMode": { "title": "Date Range", "enum": [ "today", "tomorrow", "yesterday", "thisWeek", "thisWeekend", "next7Days", "last7Days", "next30Days", "last30Days", "thisMonth", "single", "range", "season" ], "type": "string", "description": "Which dates to cover. Days are counted in the Output Timezone below, so a Saturday means your Saturday.", "default": "next7Days" }, "date": { "title": "Date", "type": "string", "description": "Used by the \"A single date\" mode. Format YYYYMMDD or YYYY-MM-DD, for example 2026-09-20. Defaults to today." }, "startDate": { "title": "Start Date", "type": "string", "description": "Used by the \"A date range\" mode. Format YYYYMMDD or YYYY-MM-DD. Defaults to today." }, "endDate": { "title": "End Date", "type": "string", "description": "Used by the \"A date range\" mode. Format YYYYMMDD or YYYY-MM-DD. Defaults to today plus six days. A range is capped at 400 days." }, "seasonYear": { "title": "Season Year", "minimum": 1990, "maximum": 2100, "type": "integer", "description": "Used by the \"A whole season\" mode. Give the year the season starts in: 2025 means 2025-26 for the Premier League and the 2025 calendar year for Brazil or MLS. Leagues on different calendars can go in the same run. Defaults to the current season." }, "teams": { "title": "Team Filter", "type": "array", "description": "Only return fixtures involving these teams. A term matches a team ID or an abbreviation exactly, or any part of a club name — \"liverpool\", \"LIV\" and \"364\" all find the same club. Use full names across many leagues, because abbreviations repeat between countries.", "items": { "type": "string" }, "default": [] }, "homeAwayFilter": { "title": "Home or Away", "enum": [ "all", "home", "away" ], "type": "string", "description": "Narrow the Team Filter to home or away fixtures. Ignored when no team is named.", "default": "all" }, "matchStatus": { "title": "Match Status", "type": "array", "description": "Keep only fixtures in these states. Leave empty for all three.", "items": { "type": "string", "enum": [ "pre", "in", "post" ], "enumTitles": [ "Scheduled", "In play", "Finished" ] }, "default": [] }, "results": { "title": "Result Filter", "type": "array", "description": "Keep only finished matches with these outcomes. This drops every fixture that has not been played. A match level after extra time counts as a draw, whoever won the shootout.", "items": { "type": "string", "enum": [ "home", "away", "draw" ], "enumTitles": [ "Home win", "Away win", "Draw" ] }, "default": [] }, "liveOnly": { "title": "In-Play Only", "type": "boolean", "description": "Keep only matches being played right now.", "default": false }, "startingWithinHours": { "title": "Kicking Off Within (Hours)", "minimum": 1, "maximum": 168, "type": "integer", "description": "Keep scheduled matches starting within this many hours. In-play and finished matches are not affected." }, "minGoals": { "title": "Minimum Goals", "minimum": 0, "maximum": 20, "type": "integer", "description": "Keep only matches with at least this many goals in total. Drops fixtures with no score yet." }, "players": { "title": "Player Filter", "type": "array", "description": "Keep only matches in which one of these players scored or was booked. Case insensitive, partial match. Needs Include Goals & Cards switched on, because that is the data it reads.", "items": { "type": "string" }, "default": [] }, "includeMatchEvents": { "title": "Include Goals & Cards", "type": "boolean", "description": "Add the goal and card timeline to every row: minute, scorer, and whether it was a penalty, an own goal, a yellow or a red. Substitutions and assists are not included.", "default": true }, "includeTeamStats": { "title": "Include Team Statistics", "type": "boolean", "description": "Add possession, shots, shots on target, corners and fouls for each side. Published only for matches that have kicked off, and not by every league.", "default": false }, "includeOdds": { "title": "Include Betting Odds", "type": "boolean", "description": "Add the moneyline, the total and the spread where a price is available. Mostly available for upcoming fixtures in the larger leagues; absent from most finished matches.", "default": false }, "maxMatches": { "title": "Maximum Fixtures", "minimum": 1, "maximum": 200000, "type": "integer", "description": "Stop after this many rows, counted after filtering and sorting by kick-off. Leave empty for all of them." }, "timezone": { "title": "Output Timezone", "type": "string", "description": "IANA timezone, for example Europe/London, America/New_York or Asia/Tokyo. It sets dateLocal and dayLocal, and it decides which calendar day each match belongs to. Defaults to UTC.", "default": "UTC" } } }, "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 } } } } } } } } } }