{ "data": { "id": "nXre0KcQ0wFMsE4p4", "actId": "gfEsNaZg6cUWKfAcj", "userId": "IYgBDiXtHOijAaUel", "startedAt": "2026-11-03T08:02:37.481Z", "finishedAt": "2026-11-03T08:02:48.728Z", "status": "SUCCEEDED", "meta": { "origin": "CLI" }, "stats": { "durationMillis": 11135, "runTimeSecs": 11.135, "computeUnits": 0.012372222222222222, "imageSizeBytes": 320166912 }, "options": { "useCache": true, "betaPackages": false, "memoryMbytes": 4096, "diskMbytes": 8192 }, "createdByOrganizationMemberUserId": "QYo53EZkJk0prePWY", "exitCode": 0, "inputSchema": "{\n \"title\": \"ESPN Scores & Schedules Input\",\n \"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.\",\n \"type\": \"object\",\n \"schemaVersion\": 1,\n \"properties\": {\n \"mode\": {\n \"title\": \"Mode\",\n \"type\": \"string\",\n \"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.\",\n \"editor\": \"select\",\n \"enum\": [\n \"scoreboard\",\n \"schedule\",\n \"teams\",\n \"odds\",\n \"gameDetail\"\n ],\n \"enumTitles\": [\n \"Scoreboard games\",\n \"Schedule games\",\n \"League teams\",\n \"Sportsbook odds\",\n \"Full game detail\"\n ],\n \"default\": \"scoreboard\",\n \"prefill\": \"scoreboard\"\n },\n \"sport\": {\n \"title\": \"Sport\",\n \"type\": \"string\",\n \"description\": \"Optional sport filter. Use it with League = All supported leagues to cover every supported competition in one sport.\",\n \"editor\": \"select\",\n \"enum\": [\n \"any\",\n \"basketball\",\n \"football\",\n \"baseball\",\n \"hockey\",\n \"soccer\"\n ],\n \"enumTitles\": [\n \"Any sport\",\n \"Basketball\",\n \"Football\",\n \"Baseball\",\n \"Hockey\",\n \"Soccer\"\n ],\n \"default\": \"any\",\n \"prefill\": \"any\"\n },\n \"league\": {\n \"title\": \"League\",\n \"type\": \"string\",\n \"description\": \"Competition to read. Choose All supported leagues only with a specific sport when you need broad coverage. Defaults to NBA when omitted.\",\n \"editor\": \"select\",\n \"enum\": [\n \"all\",\n \"nba\",\n \"wnba\",\n \"ncaam\",\n \"ncaaw\",\n \"nfl\",\n \"ncaaf\",\n \"mlb\",\n \"college-baseball\",\n \"nhl\",\n \"college-hockey\",\n \"mls\",\n \"nwsl\",\n \"epl\",\n \"eng.2\",\n \"eng.fa\",\n \"eng.league_cup\",\n \"laliga\",\n \"esp.2\",\n \"esp.copa_del_rey\",\n \"bundesliga\",\n \"ger.2\",\n \"seriea\",\n \"ita.2\",\n \"ita.coppa_italia\",\n \"ligue1\",\n \"fra.2\",\n \"eredivisie\",\n \"primeira-liga\",\n \"super-lig\",\n \"pro-league\",\n \"scottish-premiership\",\n \"greek-super-league\",\n \"russian-premier-league\",\n \"austrian-bundesliga\",\n \"swiss-super-league\",\n \"danish-superliga\",\n \"eliteserien\",\n \"allsvenskan\",\n \"romanian-liga-1\",\n \"saudi-pro-league\",\n \"a-league\",\n \"j1-league\",\n \"chinese-super-league\",\n \"ligamx\",\n \"argentina-primera\",\n \"brasileirao\",\n \"brasileirao-serie-b\",\n \"chile-primera\",\n \"colombia-primera-a\",\n \"ecuador-liga-pro\",\n \"peru-liga-1\",\n \"uruguay-primera\",\n \"paraguay-primera\",\n \"bolivia-primera\",\n \"venezuela-primera\",\n \"ucl\",\n \"uel\",\n \"uecl\",\n \"libertadores\",\n \"concacaf-champions\",\n \"world-cup\",\n \"club-world-cup\"\n ],\n \"enumTitles\": [\n \"All supported leagues\",\n \"NBA\",\n \"WNBA\",\n \"NCAA Men's Basketball\",\n \"NCAA Women's Basketball\",\n \"NFL\",\n \"NCAA Football\",\n \"MLB\",\n \"NCAA Baseball\",\n \"NHL\",\n \"NCAA Men's Hockey\",\n \"MLS\",\n \"NWSL\",\n \"English Premier League\",\n \"English Championship\",\n \"FA Cup\",\n \"English League Cup\",\n \"La Liga\",\n \"Spanish Segunda Division\",\n \"Copa del Rey\",\n \"Bundesliga\",\n \"2. Bundesliga\",\n \"Serie A\",\n \"Serie B\",\n \"Coppa Italia\",\n \"Ligue 1\",\n \"Ligue 2\",\n \"Eredivisie\",\n \"Primeira Liga\",\n \"Super Lig\",\n \"Belgian Pro League\",\n \"Scottish Premiership\",\n \"Greek Super League\",\n \"Russian Premier League\",\n \"Austrian Bundesliga\",\n \"Swiss Super League\",\n \"Danish Superliga\",\n \"Eliteserien\",\n \"Allsvenskan\",\n \"Romanian Liga I\",\n \"Saudi Pro League\",\n \"A-League\",\n \"J1 League\",\n \"Chinese Super League\",\n \"Liga MX\",\n \"Argentine Primera Division\",\n \"Brasileirao Serie A\",\n \"Brasileirao Serie B\",\n \"Chilean Primera Division\",\n \"Colombian Primera A\",\n \"Ecuadorian Liga Pro\",\n \"Peruvian Liga 1\",\n \"Uruguayan Primera Division\",\n \"Paraguayan Primera Division\",\n \"Bolivian Primera Division\",\n \"Venezuelan Primera Division\",\n \"UEFA Champions League\",\n \"UEFA Europa League\",\n \"UEFA Conference League\",\n \"Copa Libertadores\",\n \"CONCACAF Champions Cup\",\n \"FIFA World Cup\",\n \"FIFA Club World Cup\"\n ],\n \"prefill\": \"nba\"\n },\n \"date\": {\n \"title\": \"Date\",\n \"type\": \"string\",\n \"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)\",\n \"editor\": \"textfield\",\n \"prefill\": \"20240115\"\n },\n \"startDate\": {\n \"title\": \"Start date\",\n \"type\": \"string\",\n \"description\": \"First day of a custom window (YYYY-MM-DD or YYYYMMDD). Requires End date. (mode=scoreboard, schedule, odds, gameDetail)\",\n \"editor\": \"textfield\"\n },\n \"endDate\": {\n \"title\": \"End date\",\n \"type\": \"string\",\n \"description\": \"Last day of a custom window (YYYY-MM-DD or YYYYMMDD). Maximum 366 days. (mode=scoreboard, schedule, odds, gameDetail)\",\n \"editor\": \"textfield\"\n },\n \"season\": {\n \"title\": \"Season\",\n \"type\": \"integer\",\n \"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)\",\n \"minimum\": 2000,\n \"maximum\": 2100,\n \"editor\": \"number\"\n },\n \"seasonType\": {\n \"title\": \"Season type\",\n \"type\": \"string\",\n \"description\": \"Which part of the season to read when Season is set. (mode=scoreboard, schedule, odds, gameDetail)\",\n \"editor\": \"select\",\n \"enum\": [\n \"1\",\n \"2\",\n \"3\",\n \"4\",\n \"5\"\n ],\n \"enumTitles\": [\n \"Preseason\",\n \"Regular season\",\n \"Postseason\",\n \"Offseason\",\n \"Play-in\"\n ],\n \"default\": \"2\",\n \"prefill\": \"2\"\n },\n \"week\": {\n \"title\": \"Week\",\n \"type\": \"integer\",\n \"description\": \"Week number for football and other week-based competitions. Requires Season. (mode=scoreboard, schedule, odds, gameDetail)\",\n \"minimum\": 1,\n \"maximum\": 30,\n \"editor\": \"number\"\n },\n \"team\": {\n \"title\": \"Team\",\n \"type\": \"string\",\n \"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)\",\n \"editor\": \"textfield\"\n },\n \"eventIds\": {\n \"title\": \"Event IDs\",\n \"type\": \"array\",\n \"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)\",\n \"editor\": \"stringList\",\n \"default\": [],\n \"prefill\": []\n },\n \"status\": {\n \"title\": \"Game status\",\n \"type\": \"string\",\n \"description\": \"Keep only games in this state. Postponed and cancelled games are reported as their own values.\",\n \"editor\": \"select\",\n \"enum\": [\n \"any\",\n \"scheduled\",\n \"in_progress\",\n \"final\",\n \"postponed\",\n \"cancelled\"\n ],\n \"enumTitles\": [\n \"Any status\",\n \"Scheduled\",\n \"In progress\",\n \"Final\",\n \"Postponed\",\n \"Cancelled\"\n ],\n \"default\": \"any\",\n \"prefill\": \"any\"\n },\n \"includeDetails\": {\n \"title\": \"Include game details\",\n \"type\": \"boolean\",\n \"description\": \"Add leaders, odds, attendance, officials, article text, team stats, player stats and injuries to each game. (mode=scoreboard, schedule)\",\n \"default\": false,\n \"prefill\": false,\n \"editor\": \"checkbox\"\n },\n \"maxItems\": {\n \"title\": \"Maximum records\",\n \"type\": \"integer\",\n \"description\": \"Hard cap on records returned across all selected leagues.\",\n \"default\": 100,\n \"prefill\": 3,\n \"minimum\": 1,\n \"maximum\": 10000,\n \"editor\": \"number\"\n },\n \"timezone\": {\n \"title\": \"Timezone\",\n \"type\": \"string\",\n \"description\": \"IANA timezone used for today/yesterday/tomorrow and for dateLocal, for example America/New_York.\",\n \"editor\": \"textfield\",\n \"default\": \"UTC\",\n \"prefill\": \"UTC\"\n }\n },\n \"required\": [\n \"mode\"\n ]\n}", "readme": "# ESPN Game Center Scraper: Scores, Schedules, Teams & Odds\r\n\r\nRead ESPN game centers without an account, API key, or proxy setup. Pick a competition and a day, month, season, or week to get live scoreboards, final results, upcoming fixtures, team directories, sportsbook lines, and full game details in one dataset.\r\n\r\nThe actor covers more than 60 team competitions across basketball, football, baseball, hockey, and soccer, including the NBA, WNBA, NFL, MLB, NHL, MLS, NWSL, the Premier League, La Liga, Bundesliga, Serie A, Ligue 1, Liga MX, the Champions League, and many more. Every field ESPN publishes for the selected record type is mapped, and fields ESPN does not provide for a particular game are left out instead of being sent empty.\r\n\r\n## What this actor does\r\n\r\n- **Five modes:** `scoreboard`, `schedule`, `teams`, `odds`, and `gameDetail`\r\n- **Date and season control:** a single day, a month, a year, a custom range up to 366 days, a season, or a football-style season week\r\n- **Team filtering:** match a team by ESPN ID, abbreviation, or name, with an optional league prefix\r\n- **Full odds records:** one row per sportsbook line with spread, total, moneylines, and open, close, and current values when ESPN publishes them\r\n- **Deep game detail:** leaders, officials, venue, broadcasts, attendance, article text, team stats, player stats, and injuries\r\n- **Empty fields are omitted:** empty values are omitted at every depth, and every record carries `recordType`, `sourceUrl` where available, and `scrapedAt`\r\n\r\n## Output per game (`mode = scoreboard` or `schedule`)\r\n\r\n- `gameId`, `competitionId` - ESPN event and competition IDs\r\n- `league`, `sport` - league code and sport\r\n- `status` - `scheduled`, `in_progress`, `final`, `postponed`, or `cancelled`\r\n- `statusState`, `statusDescription`, `statusShortDetail`, `completed`, `period`, `clock`, `displayClock` - live state details\r\n- `date` - kickoff in ISO 8601 UTC\r\n- `dateLocal` - kickoff in the requested timezone\r\n- `name`, `shortName` - full and abbreviated matchup\r\n- `seasonYear`, `seasonType`, `week` - season context when ESPN provides it\r\n- `homeTeam`, `awayTeam` - team objects with `id`, `name`, `abbreviation`, `logo`, `score`, `winner`, `record`, `lineScores`, colors, and location when published\r\n- `venue` - `name`, `city`, `state`, `country`, `indoor`, `grass`, and `imageUrl`\r\n- `broadcasts` - TV and streaming network names\r\n- `attendance`, `neutralSite`, `conferenceCompetition`, `competitionType`\r\n- `headlines`, `gameNotes` - game-specific notes\r\n- `odds` - the line shown on the scoreboard, when present\r\n- `sourceUrl`, `recordType`, `scrapedAt`\r\n\r\n## Output per team (`mode = teams`)\r\n\r\n- `teamId`, `league`, `sport`\r\n- `name`, `abbreviation`, `location`, `nickname`, `shortDisplayName`, `slug`\r\n- `logo`, `color`, `alternateColor`, `isActive`, `isAllStar`\r\n- `venue` - `name`, `city`, `state`, `country`, `indoor`, `grass`, and `imageUrl`\r\n- `groupId`, `groupName`, `conferenceId`, `standingSummary`\r\n- `recordStats` - ESPN overall-record statistics as a name/value object\r\n- `sourceUrl`, `recordType`, `scrapedAt`\r\n\r\n## Output per odds line (`mode = odds`)\r\n\r\n- `gameId`, `league`, `sport`, `gameName`, `gameDate`\r\n- `homeTeamId`, `homeTeamName`, `homeTeamAbbreviation`\r\n- `awayTeamId`, `awayTeamName`, `awayTeamAbbreviation`\r\n- `provider`, `providerId` - sportsbook name and ESPN provider ID\r\n- `details`, `spread`, `overUnder`, `overOdds`, `underOdds`\r\n- `homeMoneyline`, `awayMoneyline`, `drawMoneyline` - when the sport supports them\r\n- `homeSpreadOdds`, `awaySpreadOdds`\r\n- `homeTeamOdds`, `awayTeamOdds`, `drawOdds` - full side detail with favorite/underdog flags\r\n- `open`, `close`, `current` - period values when ESPN keeps them\r\n- `sourceUrl`, `recordType`, `scrapedAt`\r\n\r\n## Output per game detail (`mode = gameDetail`)\r\n\r\nA game-detail record includes every game field above, plus:\r\n\r\n- `leaders` - top performers grouped as `home` and `away`, each with `name`, `position`, `stat`, and `value`\r\n- `officials` - referee names and positions\r\n- `articleDescription`, `articleStory`, `articlePublished`, `articleUrl`, `articleImage`\r\n- `teamStats` - team totals with stat name, label, abbreviation, and display value\r\n- `playerStats` - player stat categories, labels, and per-player values\r\n- `injuries` - team injury entries with athlete, status, date, and detail\r\n- `headline`, `gameNotes`, `attendance`, `venue`, `broadcasts`, `odds`\r\n- `recordType: \"gameDetail\"`, `sourceUrl`, `scrapedAt`\r\n\r\nIf ESPN fails to answer for a league, the actor writes a diagnostic record with `type`, `reason`, `message`, `inputLeague`, `inputDate`, `error`, `recordType`, and `scrapedAt`. Game, team, odds, and detail records are never replaced by placeholders.\r\n\r\n## Input\r\n\r\n| Field | Type | Default | Description |\r\n|---|---|---|---|\r\n| `mode` | string | `scoreboard` | `scoreboard`, `schedule`, `teams`, `odds`, or `gameDetail` |\r\n| `sport` | string | `any` | Sport filter; use with League = All supported leagues |\r\n| `league` | string | - | Competition code or All supported leagues; the daily prefill uses `nba` |\r\n| `date` | string | - | Day, month, or year; empty means today; the daily prefill uses `20240115` |\r\n| `startDate` | string | - | First day of a custom window; requires `endDate` |\r\n| `endDate` | string | - | Last day of a custom window; up to 366 days |\r\n| `season` | integer | - | ESPN season year, e.g. `2024` |\r\n| `seasonType` | string | `2` | `1` preseason, `2` regular, `3` postseason, `4` offseason, `5` play-in |\r\n| `week` | integer | - | Week number; requires `season` |\r\n| `team` | string | - | ESPN team ID, abbreviation, or name; prefix with a league code if needed |\r\n| `eventIds` | array | `[]` | Event IDs for `odds` or `gameDetail`; requires one specific league, not All supported leagues |\r\n| `status` | string | `any` | `any`, `scheduled`, `in_progress`, `final`, `postponed`, or `cancelled` |\r\n| `includeDetails` | boolean | `false` | Add leaders, stats, officials, article text, and injuries to each game |\r\n| `maxItems` | integer | `100` | Hard cap from 1 to 10,000 records |\r\n| `timezone` | string | `UTC` | IANA timezone for relative dates and `dateLocal` |\r\n\r\n### Example: today's NBA and NHL scoreboard\r\n\r\n```json\r\n{\r\n \"mode\": \"scoreboard\",\r\n \"league\": \"nba\",\r\n \"date\": \"2026-11-02\",\r\n \"maxItems\": 50\r\n}\r\n```\r\n\r\n### Example: NFL Week 1\r\n\r\n```json\r\n{\r\n \"mode\": \"schedule\",\r\n \"league\": \"nfl\",\r\n \"season\": 2023,\r\n \"seasonType\": \"2\",\r\n \"week\": 1,\r\n \"maxItems\": 50\r\n}\r\n```\r\n\r\n### Example: every Arsenal fixture in a season\r\n\r\n```json\r\n{\r\n \"mode\": \"schedule\",\r\n \"league\": \"epl\",\r\n \"season\": 2024,\r\n \"team\": \"Arsenal\",\r\n \"maxItems\": 100\r\n}\r\n```\r\n\r\nFor current and future soccer seasons, the actor falls back to scoreboard windows when ESPN's team-schedule feed returns only completed matches, so upcoming fixtures are included.\r\n\r\n### Example: sportsbook lines for a day\r\n\r\n```json\r\n{\r\n \"mode\": \"odds\",\r\n \"league\": \"nba\",\r\n \"date\": \"2024-01-15\",\r\n \"maxItems\": 100\r\n}\r\n```\r\n\r\n### Example: full detail for two games\r\n\r\n```json\r\n{\r\n \"mode\": \"gameDetail\",\r\n \"league\": \"nba\",\r\n \"eventIds\": [\"401585183\", \"401585184\"],\r\n \"maxItems\": 2\r\n}\r\n```\r\n\r\n## Use cases\r\n\r\n- **Live scoreboards** - refresh a dashboard with every game in one or more leagues\r\n- **Fixture calendars** - export a team's or league's upcoming schedule for a season or date range\r\n- **Results archives** - collect final scores, venues, and broadcasts across a historical window\r\n- **Betting analysis** - capture spread, total, moneyline, and line movement snapshots\r\n- **Fantasy and media tools** - pull leaders, team stats, player stats, and recaps for recaps and previews\r\n- **Research and data pipelines** - join stable ESPN IDs to internal models, spreadsheets, or warehouses\r\n\r\n## FAQ\r\n\r\n**Do I need an ESPN account, API key, cookie, or proxy?**\r\n\r\nNo. The actor reads ESPN's public game data directly. You only choose the mode and the competition or date.\r\n\r\n**Which competitions are supported?**\r\n\r\nMore than 60 team competitions across basketball, football, baseball, hockey, and soccer. The League dropdown lists every supported code, from the NBA and NFL to the Premier League, La Liga, Bundesliga, Serie A, Ligue 1, Liga MX, the Champions League, and many national leagues.\r\n\r\n**Why does a date return no games?**\r\n\r\nNot every league plays every day. Use a season or a date range for fixtures, or pick a day when the league is active. The terminal run status message explains the mode, league, and record count, including zero-record runs.\r\n\r\n**What is the largest date range?**\r\n\r\nA custom range can cover up to 366 days. Long windows are read month by month, and a month that hits ESPN's per-request event cap is re-read day by day so games are not skipped.\r\n\r\n**Why are some odds fields missing?**\r\n\r\nESPN publishes one line per sportsbook provider per game and often removes lines after the game ends, so provider coverage varies by event. Soccer lines can use moneyline and draw prices instead of a spread and total, and some providers publish fractional moneyline strings such as `20/1` or `1/28`; the actor returns the value ESPN publishes. The actor includes only the values ESPN actually returns.\r\n\r\n**Why do some games have no stats or leaders?**\r\n\r\nESPN does not publish every section for every sport, game state, or competition. Missing sections are omitted from the record rather than filled with placeholders.\r\n\r\n**Can I get games for a team by name?**\r\n\r\nYes. Set `team` to the ESPN ID, abbreviation, or a name such as `Lakers` or `Arsenal`. If the same abbreviation exists in multiple leagues, prefix it with the league code, for example `nba:LAL`.\r\n\r\n**How fresh is the data?**\r\n\r\nEvery run reads ESPN's live game data at run time. Schedule the actor every few minutes during game windows for live scores, or daily for schedules and results.\r\n\r\n**Does this actor cover golf, tennis, MMA, or racing?**\r\n\r\nNo. It focuses on team-game records. Individual sports use different event and leaderboard shapes and are not part of this actor.\r\n\r\n**Does it include news, standings, or rosters?**\r\n\r\nNo. This actor focuses on scoreboards, schedules, teams, odds, and game detail. News, standings, and roster data are separate jobs.\r\n\r\n**Does it include play-by-play or win-probability timelines?**\r\n\r\nNo. Game detail covers box-score data: leaders, team and player stats, officials, injuries, venue, broadcasts, attendance, and recaps. Play-by-play feeds are much larger and are outside this actor's record contract.\r\n\r\n**Why can a game in a date window show the next UTC day?**\r\n\r\nESPN assigns games to its own local event date. The `date` field is UTC, so a late local game can fall on the next UTC day. This affects single days, months, years, and custom ranges. Use `dateLocal` for the requested timezone, or widen the window by one day when joining on UTC dates.\r\n\r\n**What happens if I use event IDs with All supported leagues?**\r\n\r\nEvent IDs need one specific league because ESPN's summary path includes the sport and league. With All supported leagues the actor returns a diagnostic record asking you to choose a league; it does not guess across 60+ competitions.\r\n\r\n**Is `seasonType` the same across sports?**\r\n\r\nFor US sports it is a canonical label such as `Regular season`, `Preseason`, `Postseason`, or `Play-in`. For soccer ESPN often publishes a season slug such as `2024-25 English Premier League`, so treat `seasonType` as source text rather than a stable cross-sport enum.\r\n\r\n**What are the hard limits?**\r\n\r\nESPN removes some odds and stat sections after a game, so those fields are omitted when the source no longer has them. One scoreboard response is capped at 1,000 events; month and year requests are split automatically, but a single day above 1,000 events is not subdivided. Date windows follow ESPN's local event date, so the UTC `date` can fall on the next day. Individual sports (golf, tennis, MMA, racing), news, standings, and rosters are outside this actor.\r\n\r\n**Is this affiliated with ESPN?**\r\n\r\nNo. This is an independent, third-party actor that reads ESPN's public game data. It is not affiliated with or endorsed by ESPN.\r\n", "actorDefinition": { "actorSpecification": 1, "name": "espn-live-scores-schedules-and-game-odds-scraper", "title": "ESPN Game Center Scraper: Scores, Schedules, Teams & Odds", "description": "Read ESPN game centers for 60+ competitions: scoreboards, date and season schedules, team directories, per-book odds with open/close/current lines, and full game details with leaders, officials, stats, injuries, and recaps.", "version": "2.0", "buildTag": "latest", "environmentVariables": {}, "dockerfile": "./Dockerfile", "readme": "# ESPN Game Center Scraper: Scores, Schedules, Teams & Odds\r\n\r\nRead ESPN game centers without an account, API key, or proxy setup. Pick a competition and a day, month, season, or week to get live scoreboards, final results, upcoming fixtures, team directories, sportsbook lines, and full game details in one dataset.\r\n\r\nThe actor covers more than 60 team competitions across basketball, football, baseball, hockey, and soccer, including the NBA, WNBA, NFL, MLB, NHL, MLS, NWSL, the Premier League, La Liga, Bundesliga, Serie A, Ligue 1, Liga MX, the Champions League, and many more. Every field ESPN publishes for the selected record type is mapped, and fields ESPN does not provide for a particular game are left out instead of being sent empty.\r\n\r\n## What this actor does\r\n\r\n- **Five modes:** `scoreboard`, `schedule`, `teams`, `odds`, and `gameDetail`\r\n- **Date and season control:** a single day, a month, a year, a custom range up to 366 days, a season, or a football-style season week\r\n- **Team filtering:** match a team by ESPN ID, abbreviation, or name, with an optional league prefix\r\n- **Full odds records:** one row per sportsbook line with spread, total, moneylines, and open, close, and current values when ESPN publishes them\r\n- **Deep game detail:** leaders, officials, venue, broadcasts, attendance, article text, team stats, player stats, and injuries\r\n- **Empty fields are omitted:** empty values are omitted at every depth, and every record carries `recordType`, `sourceUrl` where available, and `scrapedAt`\r\n\r\n## Output per game (`mode = scoreboard` or `schedule`)\r\n\r\n- `gameId`, `competitionId` - ESPN event and competition IDs\r\n- `league`, `sport` - league code and sport\r\n- `status` - `scheduled`, `in_progress`, `final`, `postponed`, or `cancelled`\r\n- `statusState`, `statusDescription`, `statusShortDetail`, `completed`, `period`, `clock`, `displayClock` - live state details\r\n- `date` - kickoff in ISO 8601 UTC\r\n- `dateLocal` - kickoff in the requested timezone\r\n- `name`, `shortName` - full and abbreviated matchup\r\n- `seasonYear`, `seasonType`, `week` - season context when ESPN provides it\r\n- `homeTeam`, `awayTeam` - team objects with `id`, `name`, `abbreviation`, `logo`, `score`, `winner`, `record`, `lineScores`, colors, and location when published\r\n- `venue` - `name`, `city`, `state`, `country`, `indoor`, `grass`, and `imageUrl`\r\n- `broadcasts` - TV and streaming network names\r\n- `attendance`, `neutralSite`, `conferenceCompetition`, `competitionType`\r\n- `headlines`, `gameNotes` - game-specific notes\r\n- `odds` - the line shown on the scoreboard, when present\r\n- `sourceUrl`, `recordType`, `scrapedAt`\r\n\r\n## Output per team (`mode = teams`)\r\n\r\n- `teamId`, `league`, `sport`\r\n- `name`, `abbreviation`, `location`, `nickname`, `shortDisplayName`, `slug`\r\n- `logo`, `color`, `alternateColor`, `isActive`, `isAllStar`\r\n- `venue` - `name`, `city`, `state`, `country`, `indoor`, `grass`, and `imageUrl`\r\n- `groupId`, `groupName`, `conferenceId`, `standingSummary`\r\n- `recordStats` - ESPN overall-record statistics as a name/value object\r\n- `sourceUrl`, `recordType`, `scrapedAt`\r\n\r\n## Output per odds line (`mode = odds`)\r\n\r\n- `gameId`, `league`, `sport`, `gameName`, `gameDate`\r\n- `homeTeamId`, `homeTeamName`, `homeTeamAbbreviation`\r\n- `awayTeamId`, `awayTeamName`, `awayTeamAbbreviation`\r\n- `provider`, `providerId` - sportsbook name and ESPN provider ID\r\n- `details`, `spread`, `overUnder`, `overOdds`, `underOdds`\r\n- `homeMoneyline`, `awayMoneyline`, `drawMoneyline` - when the sport supports them\r\n- `homeSpreadOdds`, `awaySpreadOdds`\r\n- `homeTeamOdds`, `awayTeamOdds`, `drawOdds` - full side detail with favorite/underdog flags\r\n- `open`, `close`, `current` - period values when ESPN keeps them\r\n- `sourceUrl`, `recordType`, `scrapedAt`\r\n\r\n## Output per game detail (`mode = gameDetail`)\r\n\r\nA game-detail record includes every game field above, plus:\r\n\r\n- `leaders` - top performers grouped as `home` and `away`, each with `name`, `position`, `stat`, and `value`\r\n- `officials` - referee names and positions\r\n- `articleDescription`, `articleStory`, `articlePublished`, `articleUrl`, `articleImage`\r\n- `teamStats` - team totals with stat name, label, abbreviation, and display value\r\n- `playerStats` - player stat categories, labels, and per-player values\r\n- `injuries` - team injury entries with athlete, status, date, and detail\r\n- `headline`, `gameNotes`, `attendance`, `venue`, `broadcasts`, `odds`\r\n- `recordType: \"gameDetail\"`, `sourceUrl`, `scrapedAt`\r\n\r\nIf ESPN fails to answer for a league, the actor writes a diagnostic record with `type`, `reason`, `message`, `inputLeague`, `inputDate`, `error`, `recordType`, and `scrapedAt`. Game, team, odds, and detail records are never replaced by placeholders.\r\n\r\n## Input\r\n\r\n| Field | Type | Default | Description |\r\n|---|---|---|---|\r\n| `mode` | string | `scoreboard` | `scoreboard`, `schedule`, `teams`, `odds`, or `gameDetail` |\r\n| `sport` | string | `any` | Sport filter; use with League = All supported leagues |\r\n| `league` | string | - | Competition code or All supported leagues; the daily prefill uses `nba` |\r\n| `date` | string | - | Day, month, or year; empty means today; the daily prefill uses `20240115` |\r\n| `startDate` | string | - | First day of a custom window; requires `endDate` |\r\n| `endDate` | string | - | Last day of a custom window; up to 366 days |\r\n| `season` | integer | - | ESPN season year, e.g. `2024` |\r\n| `seasonType` | string | `2` | `1` preseason, `2` regular, `3` postseason, `4` offseason, `5` play-in |\r\n| `week` | integer | - | Week number; requires `season` |\r\n| `team` | string | - | ESPN team ID, abbreviation, or name; prefix with a league code if needed |\r\n| `eventIds` | array | `[]` | Event IDs for `odds` or `gameDetail`; requires one specific league, not All supported leagues |\r\n| `status` | string | `any` | `any`, `scheduled`, `in_progress`, `final`, `postponed`, or `cancelled` |\r\n| `includeDetails` | boolean | `false` | Add leaders, stats, officials, article text, and injuries to each game |\r\n| `maxItems` | integer | `100` | Hard cap from 1 to 10,000 records |\r\n| `timezone` | string | `UTC` | IANA timezone for relative dates and `dateLocal` |\r\n\r\n### Example: today's NBA and NHL scoreboard\r\n\r\n```json\r\n{\r\n \"mode\": \"scoreboard\",\r\n \"league\": \"nba\",\r\n \"date\": \"2026-11-02\",\r\n \"maxItems\": 50\r\n}\r\n```\r\n\r\n### Example: NFL Week 1\r\n\r\n```json\r\n{\r\n \"mode\": \"schedule\",\r\n \"league\": \"nfl\",\r\n \"season\": 2023,\r\n \"seasonType\": \"2\",\r\n \"week\": 1,\r\n \"maxItems\": 50\r\n}\r\n```\r\n\r\n### Example: every Arsenal fixture in a season\r\n\r\n```json\r\n{\r\n \"mode\": \"schedule\",\r\n \"league\": \"epl\",\r\n \"season\": 2024,\r\n \"team\": \"Arsenal\",\r\n \"maxItems\": 100\r\n}\r\n```\r\n\r\nFor current and future soccer seasons, the actor falls back to scoreboard windows when ESPN's team-schedule feed returns only completed matches, so upcoming fixtures are included.\r\n\r\n### Example: sportsbook lines for a day\r\n\r\n```json\r\n{\r\n \"mode\": \"odds\",\r\n \"league\": \"nba\",\r\n \"date\": \"2024-01-15\",\r\n \"maxItems\": 100\r\n}\r\n```\r\n\r\n### Example: full detail for two games\r\n\r\n```json\r\n{\r\n \"mode\": \"gameDetail\",\r\n \"league\": \"nba\",\r\n \"eventIds\": [\"401585183\", \"401585184\"],\r\n \"maxItems\": 2\r\n}\r\n```\r\n\r\n## Use cases\r\n\r\n- **Live scoreboards** - refresh a dashboard with every game in one or more leagues\r\n- **Fixture calendars** - export a team's or league's upcoming schedule for a season or date range\r\n- **Results archives** - collect final scores, venues, and broadcasts across a historical window\r\n- **Betting analysis** - capture spread, total, moneyline, and line movement snapshots\r\n- **Fantasy and media tools** - pull leaders, team stats, player stats, and recaps for recaps and previews\r\n- **Research and data pipelines** - join stable ESPN IDs to internal models, spreadsheets, or warehouses\r\n\r\n## FAQ\r\n\r\n**Do I need an ESPN account, API key, cookie, or proxy?**\r\n\r\nNo. The actor reads ESPN's public game data directly. You only choose the mode and the competition or date.\r\n\r\n**Which competitions are supported?**\r\n\r\nMore than 60 team competitions across basketball, football, baseball, hockey, and soccer. The League dropdown lists every supported code, from the NBA and NFL to the Premier League, La Liga, Bundesliga, Serie A, Ligue 1, Liga MX, the Champions League, and many national leagues.\r\n\r\n**Why does a date return no games?**\r\n\r\nNot every league plays every day. Use a season or a date range for fixtures, or pick a day when the league is active. The terminal run status message explains the mode, league, and record count, including zero-record runs.\r\n\r\n**What is the largest date range?**\r\n\r\nA custom range can cover up to 366 days. Long windows are read month by month, and a month that hits ESPN's per-request event cap is re-read day by day so games are not skipped.\r\n\r\n**Why are some odds fields missing?**\r\n\r\nESPN publishes one line per sportsbook provider per game and often removes lines after the game ends, so provider coverage varies by event. Soccer lines can use moneyline and draw prices instead of a spread and total, and some providers publish fractional moneyline strings such as `20/1` or `1/28`; the actor returns the value ESPN publishes. The actor includes only the values ESPN actually returns.\r\n\r\n**Why do some games have no stats or leaders?**\r\n\r\nESPN does not publish every section for every sport, game state, or competition. Missing sections are omitted from the record rather than filled with placeholders.\r\n\r\n**Can I get games for a team by name?**\r\n\r\nYes. Set `team` to the ESPN ID, abbreviation, or a name such as `Lakers` or `Arsenal`. If the same abbreviation exists in multiple leagues, prefix it with the league code, for example `nba:LAL`.\r\n\r\n**How fresh is the data?**\r\n\r\nEvery run reads ESPN's live game data at run time. Schedule the actor every few minutes during game windows for live scores, or daily for schedules and results.\r\n\r\n**Does this actor cover golf, tennis, MMA, or racing?**\r\n\r\nNo. It focuses on team-game records. Individual sports use different event and leaderboard shapes and are not part of this actor.\r\n\r\n**Does it include news, standings, or rosters?**\r\n\r\nNo. This actor focuses on scoreboards, schedules, teams, odds, and game detail. News, standings, and roster data are separate jobs.\r\n\r\n**Does it include play-by-play or win-probability timelines?**\r\n\r\nNo. Game detail covers box-score data: leaders, team and player stats, officials, injuries, venue, broadcasts, attendance, and recaps. Play-by-play feeds are much larger and are outside this actor's record contract.\r\n\r\n**Why can a game in a date window show the next UTC day?**\r\n\r\nESPN assigns games to its own local event date. The `date` field is UTC, so a late local game can fall on the next UTC day. This affects single days, months, years, and custom ranges. Use `dateLocal` for the requested timezone, or widen the window by one day when joining on UTC dates.\r\n\r\n**What happens if I use event IDs with All supported leagues?**\r\n\r\nEvent IDs need one specific league because ESPN's summary path includes the sport and league. With All supported leagues the actor returns a diagnostic record asking you to choose a league; it does not guess across 60+ competitions.\r\n\r\n**Is `seasonType` the same across sports?**\r\n\r\nFor US sports it is a canonical label such as `Regular season`, `Preseason`, `Postseason`, or `Play-in`. For soccer ESPN often publishes a season slug such as `2024-25 English Premier League`, so treat `seasonType` as source text rather than a stable cross-sport enum.\r\n\r\n**What are the hard limits?**\r\n\r\nESPN removes some odds and stat sections after a game, so those fields are omitted when the source no longer has them. One scoreboard response is capped at 1,000 events; month and year requests are split automatically, but a single day above 1,000 events is not subdivided. Date windows follow ESPN's local event date, so the UTC `date` can fall on the next day. Individual sports (golf, tennis, MMA, racing), news, standings, and rosters are outside this actor.\r\n\r\n**Is this affiliated with ESPN?**\r\n\r\nNo. This is an independent, third-party actor that reads ESPN's public game data. It is not affiliated with or endorsed by ESPN.\r\n", "input": { "title": "ESPN Scores & Schedules Input", "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.", "type": "object", "schemaVersion": 1, "properties": { "mode": { "title": "Mode", "type": "string", "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" ], "default": "scoreboard", "prefill": "scoreboard" }, "sport": { "title": "Sport", "type": "string", "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" ], "default": "any", "prefill": "any" }, "league": { "title": "League", "type": "string", "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" }, "date": { "title": "Date", "type": "string", "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" }, "startDate": { "title": "Start date", "type": "string", "description": "First day of a custom window (YYYY-MM-DD or YYYYMMDD). Requires End date. (mode=scoreboard, schedule, odds, gameDetail)", "editor": "textfield" }, "endDate": { "title": "End date", "type": "string", "description": "Last day of a custom window (YYYY-MM-DD or YYYYMMDD). Maximum 366 days. (mode=scoreboard, schedule, odds, gameDetail)", "editor": "textfield" }, "season": { "title": "Season", "type": "integer", "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)", "minimum": 2000, "maximum": 2100, "editor": "number" }, "seasonType": { "title": "Season type", "type": "string", "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" ], "default": "2", "prefill": "2" }, "week": { "title": "Week", "type": "integer", "description": "Week number for football and other week-based competitions. Requires Season. (mode=scoreboard, schedule, odds, gameDetail)", "minimum": 1, "maximum": 30, "editor": "number" }, "team": { "title": "Team", "type": "string", "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" }, "eventIds": { "title": "Event IDs", "type": "array", "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", "default": [], "prefill": [] }, "status": { "title": "Game status", "type": "string", "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" ], "default": "any", "prefill": "any" }, "includeDetails": { "title": "Include game details", "type": "boolean", "description": "Add leaders, odds, attendance, officials, article text, team stats, player stats and injuries to each game. (mode=scoreboard, schedule)", "default": false, "prefill": false, "editor": "checkbox" }, "maxItems": { "title": "Maximum records", "type": "integer", "description": "Hard cap on records returned across all selected leagues.", "default": 100, "prefill": 3, "minimum": 1, "maximum": 10000, "editor": "number" }, "timezone": { "title": "Timezone", "type": "string", "description": "IANA timezone used for today/yesterday/tomorrow and for dateLocal, for example America/New_York.", "editor": "textfield", "default": "UTC", "prefill": "UTC" } }, "required": [ "mode" ] }, "output": { "actorOutputSchemaVersion": 1, "title": "ESPN Game Center Output", "description": "Game, team, odds, and full game-detail records from ESPN public data, including scores, schedules, venue, broadcasts, team records, sportsbook lines, leaders, officials, stats, injuries, and recaps.", "type": "object", "properties": { "results": { "type": "string", "title": "Records", "description": "All game, team, odds, and game-detail records in the default dataset.", "template": "{{links.apiDefaultDatasetUrl}}/items" } } }, "categories": [ "SPORTS", "NEWS" ], "storages": { "dataset": { "actorSpecification": 1, "title": "ESPN Game Center Output", "description": "One record per game, team, odds line, or full game detail.", "fields": {}, "views": { "overview": { "title": "Game Center", "transformation": { "fields": [ "recordType", "gameId", "league", "sport", "status", "statusDetail", "date", "dateLocal", "seasonYear", "week", "shortName", "homeTeam", "awayTeam", "venue", "broadcasts", "attendance", "odds", "headline", "sourceUrl", "scrapedAt" ] }, "display": { "component": "table", "properties": { "recordType": { "label": "Type", "format": "text" }, "gameId": { "label": "Game ID", "format": "text" }, "league": { "label": "League", "format": "text" }, "sport": { "label": "Sport", "format": "text" }, "status": { "label": "Status", "format": "text" }, "statusDetail": { "label": "Detail", "format": "text" }, "date": { "label": "Date (UTC)", "format": "text" }, "dateLocal": { "label": "Date (Local)", "format": "text" }, "seasonYear": { "label": "Season", "format": "number" }, "week": { "label": "Week", "format": "number" }, "shortName": { "label": "Matchup", "format": "text" }, "homeTeam": { "label": "Home", "format": "object" }, "awayTeam": { "label": "Away", "format": "object" }, "venue": { "label": "Venue", "format": "object" }, "broadcasts": { "label": "Broadcasts", "format": "array" }, "attendance": { "label": "Attendance", "format": "number" }, "odds": { "label": "Odds", "format": "object" }, "headline": { "label": "Headline", "format": "text" }, "sourceUrl": { "label": "Source", "format": "text" }, "scrapedAt": { "label": "Scraped At", "format": "text" } } } } } } } }, "buildNumber": "2.0.1", "imageDigest": "8f4864e4bb962a559b7b82007df8cc8849f7f5647516d89196c0c4d1bb3f1423", "actVersion": { "sourceType": "SOURCE_FILES", "buildTag": "latest", "versionNumber": "2.0" }, "usage": { "ACTOR_COMPUTE_UNITS": 0.012372222222222222 } } }