{
  "description": "Choose a mode, a league, and a date, season, week, team, or event IDs. The actor reads ESPN's public JSON endpoints without credentials or proxy setup.",
  "properties": {
    "date": {
      "description": "A day (YYYY-MM-DD or YYYYMMDD), a month (YYYY-MM), or a year (YYYY). Leave empty to use today, or use Season / Week instead. (mode=scoreboard, schedule, odds, gameDetail)",
      "editor": "textfield",
      "prefill": "20240115",
      "title": "Date",
      "type": "string"
    },
    "endDate": {
      "description": "Last day of a custom window (YYYY-MM-DD or YYYYMMDD). Maximum 366 days. (mode=scoreboard, schedule, odds, gameDetail)",
      "editor": "textfield",
      "title": "End date",
      "type": "string"
    },
    "eventIds": {
      "default": [],
      "description": "ESPN event IDs for game detail or odds, for example 401585183. Leave empty to discover games from the date or season. (mode=odds, gameDetail)",
      "editor": "stringList",
      "prefill": [],
      "title": "Event IDs",
      "type": "array"
    },
    "includeDetails": {
      "default": false,
      "description": "Add leaders, odds, attendance, officials, article text, team stats, player stats and injuries to each game. (mode=scoreboard, schedule)",
      "editor": "checkbox",
      "prefill": false,
      "title": "Include game details",
      "type": "boolean"
    },
    "league": {
      "description": "Competition to read. Choose All supported leagues only with a specific sport when you need broad coverage. Defaults to NBA when omitted.",
      "editor": "select",
      "enum": [
        "all",
        "nba",
        "wnba",
        "ncaam",
        "ncaaw",
        "nfl",
        "ncaaf",
        "mlb",
        "college-baseball",
        "nhl",
        "college-hockey",
        "mls",
        "nwsl",
        "epl",
        "eng.2",
        "eng.fa",
        "eng.league_cup",
        "laliga",
        "esp.2",
        "esp.copa_del_rey",
        "bundesliga",
        "ger.2",
        "seriea",
        "ita.2",
        "ita.coppa_italia",
        "ligue1",
        "fra.2",
        "eredivisie",
        "primeira-liga",
        "super-lig",
        "pro-league",
        "scottish-premiership",
        "greek-super-league",
        "russian-premier-league",
        "austrian-bundesliga",
        "swiss-super-league",
        "danish-superliga",
        "eliteserien",
        "allsvenskan",
        "romanian-liga-1",
        "saudi-pro-league",
        "a-league",
        "j1-league",
        "chinese-super-league",
        "ligamx",
        "argentina-primera",
        "brasileirao",
        "brasileirao-serie-b",
        "chile-primera",
        "colombia-primera-a",
        "ecuador-liga-pro",
        "peru-liga-1",
        "uruguay-primera",
        "paraguay-primera",
        "bolivia-primera",
        "venezuela-primera",
        "ucl",
        "uel",
        "uecl",
        "libertadores",
        "concacaf-champions",
        "world-cup",
        "club-world-cup"
      ],
      "enumTitles": [
        "All supported leagues",
        "NBA",
        "WNBA",
        "NCAA Men's Basketball",
        "NCAA Women's Basketball",
        "NFL",
        "NCAA Football",
        "MLB",
        "NCAA Baseball",
        "NHL",
        "NCAA Men's Hockey",
        "MLS",
        "NWSL",
        "English Premier League",
        "English Championship",
        "FA Cup",
        "English League Cup",
        "La Liga",
        "Spanish Segunda Division",
        "Copa del Rey",
        "Bundesliga",
        "2. Bundesliga",
        "Serie A",
        "Serie B",
        "Coppa Italia",
        "Ligue 1",
        "Ligue 2",
        "Eredivisie",
        "Primeira Liga",
        "Super Lig",
        "Belgian Pro League",
        "Scottish Premiership",
        "Greek Super League",
        "Russian Premier League",
        "Austrian Bundesliga",
        "Swiss Super League",
        "Danish Superliga",
        "Eliteserien",
        "Allsvenskan",
        "Romanian Liga I",
        "Saudi Pro League",
        "A-League",
        "J1 League",
        "Chinese Super League",
        "Liga MX",
        "Argentine Primera Division",
        "Brasileirao Serie A",
        "Brasileirao Serie B",
        "Chilean Primera Division",
        "Colombian Primera A",
        "Ecuadorian Liga Pro",
        "Peruvian Liga 1",
        "Uruguayan Primera Division",
        "Paraguayan Primera Division",
        "Bolivian Primera Division",
        "Venezuelan Primera Division",
        "UEFA Champions League",
        "UEFA Europa League",
        "UEFA Conference League",
        "Copa Libertadores",
        "CONCACAF Champions Cup",
        "FIFA World Cup",
        "FIFA Club World Cup"
      ],
      "prefill": "nba",
      "title": "League",
      "type": "string"
    },
    "maxItems": {
      "default": 100,
      "description": "Hard cap on records returned across all selected leagues.",
      "editor": "number",
      "maximum": 10000,
      "minimum": 1,
      "prefill": 3,
      "title": "Maximum records",
      "type": "integer"
    },
    "mode": {
      "default": "scoreboard",
      "description": "What to return: games for a scoreboard, a schedule, the league team directory, one record per sportsbook odds line, or a full game detail record.",
      "editor": "select",
      "enum": [
        "scoreboard",
        "schedule",
        "teams",
        "odds",
        "gameDetail"
      ],
      "enumTitles": [
        "Scoreboard games",
        "Schedule games",
        "League teams",
        "Sportsbook odds",
        "Full game detail"
      ],
      "prefill": "scoreboard",
      "title": "Mode",
      "type": "string"
    },
    "season": {
      "description": "ESPN season year, for example 2024. Use it with Week for a single football week, or alone for the whole season. (mode=scoreboard, schedule, odds, gameDetail)",
      "editor": "number",
      "maximum": 2100,
      "minimum": 2000,
      "title": "Season",
      "type": "integer"
    },
    "seasonType": {
      "default": "2",
      "description": "Which part of the season to read when Season is set. (mode=scoreboard, schedule, odds, gameDetail)",
      "editor": "select",
      "enum": [
        "1",
        "2",
        "3",
        "4",
        "5"
      ],
      "enumTitles": [
        "Preseason",
        "Regular season",
        "Postseason",
        "Offseason",
        "Play-in"
      ],
      "prefill": "2",
      "title": "Season type",
      "type": "string"
    },
    "sport": {
      "default": "any",
      "description": "Optional sport filter. Use it with League = All supported leagues to cover every supported competition in one sport.",
      "editor": "select",
      "enum": [
        "any",
        "basketball",
        "football",
        "baseball",
        "hockey",
        "soccer"
      ],
      "enumTitles": [
        "Any sport",
        "Basketball",
        "Football",
        "Baseball",
        "Hockey",
        "Soccer"
      ],
      "prefill": "any",
      "title": "Sport",
      "type": "string"
    },
    "startDate": {
      "description": "First day of a custom window (YYYY-MM-DD or YYYYMMDD). Requires End date. (mode=scoreboard, schedule, odds, gameDetail)",
      "editor": "textfield",
      "title": "Start date",
      "type": "string"
    },
    "status": {
      "default": "any",
      "description": "Keep only games in this state. Postponed and cancelled games are reported as their own values.",
      "editor": "select",
      "enum": [
        "any",
        "scheduled",
        "in_progress",
        "final",
        "postponed",
        "cancelled"
      ],
      "enumTitles": [
        "Any status",
        "Scheduled",
        "In progress",
        "Final",
        "Postponed",
        "Cancelled"
      ],
      "prefill": "any",
      "title": "Game status",
      "type": "string"
    },
    "team": {
      "description": "Keep only games or teams matching this ESPN team ID, abbreviation, or name, for example 13, LAL, or Lakers. Prefix with a league code to disambiguate: nba:LAL. (mode=scoreboard, schedule, teams, odds, gameDetail)",
      "editor": "textfield",
      "title": "Team",
      "type": "string"
    },
    "timezone": {
      "default": "UTC",
      "description": "IANA timezone used for today/yesterday/tomorrow and for dateLocal, for example America/New_York.",
      "editor": "textfield",
      "prefill": "UTC",
      "title": "Timezone",
      "type": "string"
    },
    "week": {
      "description": "Week number for football and other week-based competitions. Requires Season. (mode=scoreboard, schedule, odds, gameDetail)",
      "editor": "number",
      "maximum": 30,
      "minimum": 1,
      "title": "Week",
      "type": "integer"
    }
  },
  "required": [
    "mode"
  ],
  "schemaVersion": 1,
  "title": "ESPN Scores & Schedules Input",
  "type": "object"
}