{ "data": { "id": "LQ5zzKBf9U6Ues2Nj", "actId": "9euiAfrRYDea19ZZ9", "userId": "NL4ThgItAwaoBlffQ", "startedAt": "2026-11-02T02:44:56.749Z", "finishedAt": "2026-11-02T02:45:00.758Z", "status": "SUCCEEDED", "meta": { "origin": "CLI" }, "stats": { "durationMillis": 3855, "runTimeSecs": 3.855, "computeUnits": 0.0042833333333333334, "imageSizeBytes": 319120384 }, "options": { "useCache": true, "betaPackages": false, "memoryMbytes": 4096, "diskMbytes": 8192 }, "createdByOrganizationMemberUserId": "zifX0mkAFMHe8CatY", "exitCode": 0, "inputSchema": "{\n \"title\": \"ESPN Scraper Input\",\n \"description\": \"Pull ESPN scores, game details, standings, teams, players, news, schedules, rankings and odds for 36 leagues — no key, cookie or proxy.\",\n \"type\": \"object\",\n \"schemaVersion\": 1,\n \"properties\": {\n \"mode\": {\n \"title\": \"Mode\",\n \"type\": \"string\",\n \"description\": \"What to fetch from ESPN.\",\n \"editor\": \"select\",\n \"enum\": [\n \"scoreboard\",\n \"gameDetail\",\n \"standings\",\n \"teams\",\n \"teamDetail\",\n \"news\",\n \"players\",\n \"schedule\",\n \"rankings\",\n \"odds\"\n ],\n \"enumTitles\": [\n \"Scoreboard — games, matches, leaderboards and fight cards\",\n \"Game Detail — box score, player lines, odds and win probability\",\n \"Standings — league tables plus F1 drivers and constructors\",\n \"Teams — every team in a league\",\n \"Team Detail — record, venue and next event for selected teams\",\n \"News — league headlines or the global ESPN feed\",\n \"Players — rosters, athlete search, profiles, stats and game logs\",\n \"Schedule — a team's season schedule with results\",\n \"Rankings — ATP, WTA, UFC and college polls\",\n \"Odds — primary sportsbook line per game\"\n ],\n \"default\": \"news\",\n \"prefill\": \"news\"\n },\n \"league\": {\n \"title\": \"League\",\n \"type\": \"string\",\n \"description\": \"League slug. The sport is derived automatically.\",\n \"editor\": \"select\",\n \"enum\": [\n \"nfl\",\n \"college-football\",\n \"ufl\",\n \"nba\",\n \"wnba\",\n \"mens-college-basketball\",\n \"womens-college-basketball\",\n \"mlb\",\n \"college-baseball\",\n \"nhl\",\n \"usa.1\",\n \"eng.1\",\n \"esp.1\",\n \"ger.1\",\n \"ita.1\",\n \"fra.1\",\n \"ned.1\",\n \"por.1\",\n \"mex.1\",\n \"bra.1\",\n \"arg.1\",\n \"uefa.champions\",\n \"uefa.europa\",\n \"uefa.europa.conf\",\n \"eng.fa\",\n \"eng.league_cup\",\n \"fifa.world\",\n \"fifa.cwc\",\n \"concacaf.champions\",\n \"atp\",\n \"wta\",\n \"pga\",\n \"lpga\",\n \"ufc\",\n \"pfl\",\n \"f1\"\n ],\n \"enumTitles\": [\n \"NFL\",\n \"College Football\",\n \"UFL\",\n \"NBA\",\n \"WNBA\",\n \"Men's College Basketball\",\n \"Women's College Basketball\",\n \"MLB\",\n \"College Baseball\",\n \"NHL\",\n \"MLS\",\n \"English Premier League\",\n \"Spanish La Liga\",\n \"German Bundesliga\",\n \"Italian Serie A\",\n \"French Ligue 1\",\n \"Dutch Eredivisie\",\n \"Portuguese Primeira Liga\",\n \"Mexican Liga MX\",\n \"Brazilian Serie A\",\n \"Argentine Liga Profesional\",\n \"UEFA Champions League\",\n \"UEFA Europa League\",\n \"UEFA Conference League\",\n \"English FA Cup\",\n \"English Carabao Cup\",\n \"FIFA World Cup\",\n \"FIFA Club World Cup\",\n \"Concacaf Champions Cup\",\n \"ATP Tennis\",\n \"WTA Tennis\",\n \"PGA Tour Golf\",\n \"LPGA Golf\",\n \"UFC\",\n \"PFL\",\n \"Formula 1\"\n ],\n \"default\": \"nba\",\n \"prefill\": \"nba\"\n },\n \"leagues\": {\n \"title\": \"Extra leagues\",\n \"type\": \"array\",\n \"description\": \"Optional multi-league override for modes that iterate leagues (scoreboard, odds, standings, teams, teamDetail, news, players, schedule, rankings), e.g. [\\\"nba\\\",\\\"nfl\\\"].\",\n \"editor\": \"stringList\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"datePreset\": {\n \"title\": \"Date preset\",\n \"type\": \"string\",\n \"description\": \"Date window for scoreboard and odds. ESPN accepts one date per request, so ranges are fetched one day at a time.\",\n \"editor\": \"select\",\n \"enum\": [\n \"today\",\n \"tomorrow\",\n \"yesterday\",\n \"last7Days\",\n \"next7Days\",\n \"custom\"\n ],\n \"enumTitles\": [\n \"Today\",\n \"Tomorrow\",\n \"Yesterday\",\n \"Last 7 days\",\n \"Next 7 days\",\n \"Custom range\"\n ],\n \"default\": \"today\",\n \"prefill\": \"today\"\n },\n \"startDate\": {\n \"title\": \"Start date (custom)\",\n \"type\": \"string\",\n \"description\": \"First date for datePreset=custom, in YYYYMMDD or YYYY-MM-DD.\",\n \"editor\": \"textfield\"\n },\n \"endDate\": {\n \"title\": \"End date (custom)\",\n \"type\": \"string\",\n \"description\": \"Last date for datePreset=custom (inclusive), in YYYYMMDD or YYYY-MM-DD. Maximum 366 days.\",\n \"editor\": \"textfield\"\n },\n \"season\": {\n \"title\": \"Season year\",\n \"type\": \"integer\",\n \"description\": \"ESPN season year for standings, schedule, players and rankings (e.g. 2025). Leave blank for the current season.\",\n \"minimum\": 1900,\n \"maximum\": 2100\n },\n \"seasonType\": {\n \"title\": \"Season type (mode=schedule)\",\n \"type\": \"string\",\n \"description\": \"Filter a team schedule by season phase (ignored for soccer schedules, which ESPN reports as one league season).\",\n \"editor\": \"select\",\n \"enum\": [\n \"preseason\",\n \"regular\",\n \"postseason\"\n ],\n \"enumTitles\": [\n \"Preseason\",\n \"Regular season\",\n \"Postseason\"\n ]\n },\n \"teamIds\": {\n \"title\": \"Team IDs or abbreviations\",\n \"type\": \"array\",\n \"description\": \"Teams for teams/teamDetail/schedule/players. Accepts 2, BOS or nba/BOS. Get IDs from mode=teams.\",\n \"editor\": \"stringList\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"eventIds\": {\n \"title\": \"Event IDs\",\n \"type\": \"array\",\n \"description\": \"Games for gameDetail/odds. Accepts 401909904 or nba/401909904. Get IDs from mode=scoreboard.\",\n \"editor\": \"stringList\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"athleteQueries\": {\n \"title\": \"Athlete searches (mode=players)\",\n \"type\": \"array\",\n \"description\": \"Player names to search, e.g. [\\\"LeBron James\\\", \\\"Jannik Sinner\\\"].\",\n \"editor\": \"stringList\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"athleteIds\": {\n \"title\": \"Athlete IDs (mode=players)\",\n \"type\": \"array\",\n \"description\": \"ESPN athlete IDs for direct profiles, e.g. [\\\"1966\\\"].\",\n \"editor\": \"stringList\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"rankingType\": {\n \"title\": \"Ranking (mode=rankings)\",\n \"type\": \"string\",\n \"description\": \"Which poll to return. 'all' includes every poll ESPN publishes for the league.\",\n \"editor\": \"select\",\n \"enum\": [\n \"all\",\n \"ap\",\n \"coaches\",\n \"cfp\",\n \"pound-for-pound\"\n ],\n \"enumTitles\": [\n \"All rankings\",\n \"AP Top 25\",\n \"Coaches Poll\",\n \"College Football Playoff\",\n \"Pound-for-pound\"\n ],\n \"default\": \"all\",\n \"prefill\": \"all\"\n },\n \"statusFilter\": {\n \"title\": \"Game status\",\n \"type\": \"string\",\n \"description\": \"Filter scoreboard, odds or schedule rows by game state.\",\n \"editor\": \"select\",\n \"enum\": [\n \"all\",\n \"pre\",\n \"in\",\n \"post\"\n ],\n \"enumTitles\": [\n \"All games\",\n \"Upcoming\",\n \"Live\",\n \"Completed\"\n ],\n \"default\": \"all\",\n \"prefill\": \"all\"\n },\n \"liveOnly\": {\n \"title\": \"Live only\",\n \"type\": \"boolean\",\n \"description\": \"Keep only in-progress games (scoreboard and odds).\",\n \"default\": false,\n \"prefill\": false\n },\n \"newsScope\": {\n \"title\": \"News scope (mode=news)\",\n \"type\": \"string\",\n \"description\": \"League news is capped at 50 articles by ESPN. Global pages the ESPN now feed and filters to the selected league.\",\n \"editor\": \"select\",\n \"enum\": [\n \"league\",\n \"global\"\n ],\n \"enumTitles\": [\n \"Selected league\",\n \"Global ESPN feed (paginated)\"\n ],\n \"default\": \"league\",\n \"prefill\": \"league\"\n },\n \"includeTeamDetails\": {\n \"title\": \"Include team details (mode=teams)\",\n \"type\": \"boolean\",\n \"description\": \"Fetch each team's record, venue and next event. Adds one request per team.\",\n \"default\": true,\n \"prefill\": false\n },\n \"includeGameDetails\": {\n \"title\": \"Include game details (mode=scoreboard)\",\n \"type\": \"boolean\",\n \"description\": \"Attach the full game summary to every team-sport game. Adds one request per game.\",\n \"default\": false,\n \"prefill\": false\n },\n \"includePlayerStats\": {\n \"title\": \"Include player stats\",\n \"type\": \"boolean\",\n \"description\": \"Attach latest season stats to player rows and the player box score to gameDetail. Adds requests per player.\",\n \"default\": false,\n \"prefill\": false\n },\n \"includeGameLog\": {\n \"title\": \"Include game log (mode=players)\",\n \"type\": \"boolean\",\n \"description\": \"Attach the current-season game log to each player. Adds one request per athlete.\",\n \"default\": false,\n \"prefill\": false\n },\n \"includePlayByPlay\": {\n \"title\": \"Include every play\",\n \"type\": \"boolean\",\n \"description\": \"Include the full play-by-play list in gameDetail (scoring plays are always included).\",\n \"default\": false,\n \"prefill\": false\n },\n \"maxItems\": {\n \"title\": \"Max items\",\n \"type\": \"integer\",\n \"description\": \"Hard cap on data records. Notice rows explain unsupported or empty requests.\",\n \"minimum\": 1,\n \"maximum\": 5000,\n \"default\": 50,\n \"prefill\": 1\n }\n },\n \"required\": [\n \"mode\"\n ]\n}", "readme": "# ESPN Scores, Teams, Players, News & Odds\n\nScrape **ESPN** for live and historical scores, full game boxscores, league tables, team directories, rosters, player stats, schedules, college and individual-sport rankings, news, and the primary sportsbook line. Ten modes cover 36 leagues across football, basketball, baseball, hockey, soccer, tennis, golf, MMA and Formula 1 — all from public JSON endpoints with **no key, login, cookie or proxy setup**.\n\nEvery row carries a `recordType`, so mixed datasets stay easy to filter: `game`, `event`, `gameDetail`, `standing`, `team`, `teamDetail`, `player`, `article`, `scheduleGame`, `ranking`, `oddsLine` and `notice`.\n\n## What this actor does\n\n- **Ten modes:** `scoreboard`, `gameDetail`, `standings`, `teams`, `teamDetail`, `news`, `players`, `schedule`, `rankings`, `odds`\n- **36 leagues:** US major leagues, college sports, 19 soccer competitions, ATP/WTA, PGA/LPGA, UFC/PFL and F1\n- **Dates and ranges:** today, tomorrow, yesterday, last/next seven days, or a custom range of up to 366 days, fetched one date per request\n- **Multi-league runs:** combine leagues in one scoreboard, odds, standings or news run\n- **Deep game detail:** team stats, optional player boxscore, leaders, officials, venue, injuries, series, scoring plays, win probability and news\n- **Player coverage:** team rosters (flat and grouped), athlete search, profiles, latest-season stats, game logs and rankings\n- **Primary odds:** provider, spread, total and moneyline from the first line ESPN publishes\n- **Clean output:** empty fields are omitted at every depth; no nulls or placeholder values\n\n## Supported leagues\n\n| Family | League slugs |\n|---|---|\n| Football | `nfl`, `college-football`, `ufl` |\n| Basketball | `nba`, `wnba`, `mens-college-basketball`, `womens-college-basketball` |\n| Baseball | `mlb`, `college-baseball` |\n| Hockey | `nhl` |\n| Soccer | `usa.1`, `eng.1`, `esp.1`, `ger.1`, `ita.1`, `fra.1`, `ned.1`, `por.1`, `mex.1`, `bra.1`, `arg.1`, `uefa.champions`, `uefa.europa`, `uefa.europa.conf`, `eng.fa`, `eng.league_cup`, `fifa.world`, `fifa.cwc`, `concacaf.champions` |\n| Tennis | `atp`, `wta` |\n| Golf | `pga`, `lpga` |\n| MMA | `ufc`, `pfl` |\n| Racing | `f1` |\n\nMode coverage follows the data ESPN publishes: team leagues support every team mode; F1 supports scoreboard, teams, team detail and driver/constructor standings; tennis, golf and MMA return event records with matches, leaderboards or fight cards instead of home/away fields.\n\n## Output\n\n### Scoreboard and odds\n\nTeam games include `eventId`, `name`, `shortName`, `url`, `date`, `dateLocal`, `seasonYear`, `seasonType`, `week`, `status`, `statusState`, `statusCompleted`, `venue`, `venueCity`, `venueState`, `venueCountry`, `venueIndoor`, `broadcast`, `broadcasts`, `attendance`, `headlines`, `notes`, `homeTeam`, `homeTeamId`, `homeAbbr`, `homeLogo`, `homeScore`, `homeWinner`, `homeRecord`, `homeForm`, `awayTeam`, `awayTeamId`, `awayAbbr`, `awayLogo`, `awayScore`, `awayWinner`, `awayRecord`, `awayForm`, `competitors[]` and `odds`.\n\n`odds` contains `provider`, `details`, `spread`, `overUnder`, `homeMoneyLine`, `awayMoneyLine`, `homeSpreadOdds`, `awaySpreadOdds`, `overOdds`, `underOdds`, `favoriteTeamId` and `underdogTeamId` when ESPN publishes them. The `odds` mode returns the same line as its own `oddsLine` row.\n\nTennis rows add `groupings[]` and a flat `matches[]` list with `matchId`, `round`, `court`, `notes`, `status` and `competitors[]`. Golf rows add a ranked `competitors[]` leaderboard with `score` and round-by-round `rounds[]`, plus `leader`, `leaderScore` and `competitorCount`. UFC/PFL rows add `fights[]` with weight class, winner and fighter records. F1 rows add `raceName`, `raceDate`, `circuitName` and a `drivers[]` classification.\n\n### Game detail\n\n`gameDetail` includes the scoreboard identity fields plus `statusState`, `attendance`, `officials[]`, `teamStats[]`, `leaders[]`, `odds`, `winProbability[]`, `predictor`, `recentForm[]`, `scoringPlays[]`, `injuries[]`, `series`, `news[]`, `videos[]`, `recap` and `links`. `includePlayerStats` adds `playerStats[]` with per-athlete stat lines; `includePlayByPlay` adds the complete `plays[]` list.\n\n### Standings\n\nStanding rows keep `team`, `teamId`, `abbreviation`, `conference`, `wins`, `losses`, `winPct`, `rank`, `division`, `gamesBehind` and `pointDifferential`, and add `groupName`, `groupType`, `seasonYear`, `overall`, `gamesPlayed`, `ties`, `points`, `pointsFor`, `pointsAgainst`, `streak`, `homeRecord`, `awayRecord`, `divisionRecord`, `conferenceRecord`, `playoffSeed`, `rankChange`, `logoUrl`, `url` and a complete `stats` map.\n\nF1 driver rows use `athleteId`, `athleteName` and `championshipPoints`; constructor rows use `team`, `teamId` and `championshipPoints`.\n\n### Teams\n\nTeam rows include `teamId`, `uid`, `name`, `shortDisplayName`, `abbreviation`, `location`, `color`, `alternateColor`, `slug`, `isActive`, `isAllStar`, `logoUrl`, `darkLogoUrl`, `url`, `rosterUrl`, `competitors`-style `links`, and — when details are fetched — `recordSummary`, `overallRecord`, `homeRecord`, `awayRecord`, `divisionRecord`, `conferenceRecord`, `wins`, `losses`, `winPct`, `gamesPlayed`, `pointsFor`, `pointsAgainst`, `standingSummary`, `conference`, `division`, `venueName`, `venueCity`, `venueState`, `venueIndoor`, `venueLocation`, `nextEvent` and `recordItems[]`.\n\n### Players\n\nPlayer rows include `athleteId`, `playerId`, `name`, `firstName`, `lastName`, `shortName`, `jersey`, `position`, `positionAbbr`, `age`, `dateOfBirth`, `height`, `displayHeight`, `weight`, `displayWeight`, `birthPlace`, `college`, `collegeId`, `headshot`, `status`, `experienceYears`, `displayExperience`, `debutYear`, `draft`, `teamId`, `teamName`, `teamAbbr`, `salary`, `contractYearsRemaining`, `contractSeason`, `statsSummary` and `url`. Search rows also carry `source: \"search\"` and `description`; ESPN search is global, so each result keeps the athlete's own `sport` and `league` even when you search from a different league. `stats[]` and `gameLog[]` are attached when the matching toggles are enabled; season stats are published for NBA, NFL, MLB and NHL, while game logs also work for soccer.\n\n### News\n\nArticles include `articleId`, `headline`, `description`, `publishDate`, `lastModified`, `url`, `imageUrl`, `imageCaption`, `imageCredit`, `author`, `category`, `type`, `section`, `source`, `teams[]`, `athletes[]`, `leagues[]`, `gameId`, `videoUrl`, `premium` and `links`. Set `newsScope: \"global\"` to page the wider ESPN feed; the actor filters those pages down to the selected league.\n\n### Schedule\n\n`scheduleGame` rows combine scoreboard-style fields with `teamId`, `team`, `teamAbbr`, `teamScore`, `teamRecord`, `homeAway`, `opponent`, `opponentId`, `opponentAbbr`, `opponentLogo`, `opponentScore`, `opponentRecord`, `forTeamResult` (`W`, `L` or `D`), `seasonType`, `seasonYear` and `ticketsAvailable`.\n\n### Rankings\n\nRanking rows include `rankingId`, `rankingName`, `rankingShortName`, `rankingSourceType`, `rank`, `previousRank`, `trend`, `points`, `firstPlaceVotes`, `recordSummary`, `defenses`, `athleteId`, `athleteName`, `team`, `teamId`, `abbreviation`, `logoUrl`, `url`, `date`, `lastUpdated`, `occurrence` and `seasonYear`.\n\n### Notices\n\nWhen a request is valid but ESPN has nothing to return, or a mode does not apply to a league, the actor pushes a `notice` row with `code`, `message`, `mode`, `league`, `sport` and `hint`. The run still succeeds.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | select | `news` | One of the ten modes |\n| `league` | select | `nba` | League slug; the sport is derived automatically |\n| `leagues` | array | – | Extra leagues for multi-league runs |\n| `datePreset` | select | `today` | `today`, `tomorrow`, `yesterday`, `last7Days`, `next7Days`, `custom` |\n| `startDate` | string | – | First date for `custom`, as `YYYYMMDD` or `YYYY-MM-DD` |\n| `endDate` | string | – | Last date for `custom`, inclusive; maximum 366 days |\n| `season` | integer | – | Season year for standings, schedule, players and rankings; blank uses the current season |\n| `seasonType` | select | – | `preseason`, `regular`, `postseason` (schedule; ignored for soccer) |\n| `teamIds` | array | – | Team IDs, abbreviations or `league/id` references |\n| `eventIds` | array | – | Event IDs or `league/eventId` references |\n| `athleteQueries` | array | – | Player names to search |\n| `athleteIds` | array | – | ESPN athlete IDs for direct profiles |\n| `rankingType` | select | `all` | `all`, `ap`, `coaches`, `cfp`, `pound-for-pound` |\n| `statusFilter` | select | `all` | `all`, `pre`, `in`, `post` |\n| `liveOnly` | boolean | `false` | Keep only in-progress games |\n| `newsScope` | select | `league` | `league` or the paginated `global` feed |\n| `includeTeamDetails` | boolean | `true` | Fetch team record, venue and next event |\n| `includeGameDetails` | boolean | `false` | Attach full summaries to scoreboard games |\n| `includePlayerStats` | boolean | `false` | Add player stats / player boxscore |\n| `includeGameLog` | boolean | `false` | Add a player's current-season game log |\n| `includePlayByPlay` | boolean | `false` | Add every play to `gameDetail` |\n| `maxItems` | integer | `50` | Hard cap (1–5000); notices are metadata rows |\n\n### Example: scoreboard for two leagues\n\n```json\n{\n \"mode\": \"scoreboard\",\n \"leagues\": [\"nba\", \"nfl\"],\n \"datePreset\": \"yesterday\",\n \"statusFilter\": \"post\",\n \"maxItems\": 40\n}\n```\n\n### Example: full NBA game detail\n\n```json\n{\n \"mode\": \"gameDetail\",\n \"league\": \"nba\",\n \"eventIds\": [\"401909904\"],\n \"includePlayerStats\": true,\n \"includePlayByPlay\": false,\n \"maxItems\": 1\n}\n```\n\n### Example: Premier League schedule and standings\n\n```json\n{\n \"mode\": \"schedule\",\n \"league\": \"eng.1\",\n \"teamIds\": [\"eng.1/364\"],\n \"seasonType\": \"regular\",\n \"maxItems\": 38\n}\n```\n\n```json\n{\n \"mode\": \"standings\",\n \"league\": \"eng.1\",\n \"maxItems\": 20\n}\n```\n\n### Example: player search with stats\n\n```json\n{\n \"mode\": \"players\",\n \"league\": \"nba\",\n \"athleteQueries\": [\"LeBron James\", \"Jannik Sinner\"],\n \"includePlayerStats\": true,\n \"maxItems\": 10\n}\n```\n\n### Example: F1 race and driver standings\n\n```json\n{\n \"mode\": \"scoreboard\",\n \"league\": \"f1\",\n \"datePreset\": \"yesterday\",\n \"maxItems\": 5\n}\n```\n\n```json\n{\n \"mode\": \"standings\",\n \"league\": \"f1\",\n \"maxItems\": 30\n}\n```\n\n## Use cases\n\n- **Fantasy and betting dashboards** — pull slates, primary lines and player boxscores into one normalized feed\n- **Media and newsroom bots** — monitor league headlines or the global ESPN feed and filter to the teams you cover\n- **Team and league trackers** — follow schedules, results, standings and roster changes across multiple leagues\n- **Sports research** — build historical datasets from date ranges and full game summaries\n- **Player scouting** — search athletes, compare latest-season stats and inspect game logs\n- **Broadcast graphics** — feed scoreboards, rankings and leaderboards into live displays\n\n## FAQ\n\n**Do I need an API key, account or proxy?**\nNo. The actor reads ESPN's public JSON feeds anonymously. There is no credential or proxy input.\n\n**Why did I get a notice row instead of games?**\nA notice explains the empty result: no games on that date, no odds published yet, an off-season schedule, or a mode ESPN does not support for that league. The notice `code` and `hint` tell you what to change.\n\n**How many news articles can I get per league?**\nESPN's league news endpoint returns at most 50 articles. Use `newsScope: \"global\"` to page the wider feed; the actor filters those pages client-side to the selected league.\n\n**Why are some odds fields missing?**\nESPN publishes a primary line for many upcoming games but not every game, and moneyline/spread components vary by sport and provider. Empty odds fields are omitted rather than guessed. The actor ships the first published line only; it does not promise open-line history or every sportsbook.\n\n**Can I scrape tennis, golf, MMA or F1 game summaries?**\nTheir scoreboards are fully supported with matches, leaderboards, fight cards and driver classifications. ESPN does not expose the same team-style summary for these sports, so `gameDetail` returns a notice for them.\n\n**Why is a team venue missing?**\nESPN only includes venue details for some teams (for example, many NBA/NFL clubs). Soccer and F1 team endpoints commonly omit a home venue. The field is omitted when the source has no value.\n\n**Can I fetch historical seasons and dates?**\nYes. Scoreboard and odds accept a custom date range of up to 366 days. Standings, schedules, players and rankings accept a `season` year. Coverage depends on what ESPN keeps for each league.\n\n**Does the actor return duplicate rows?**\nNo. Rows are de-duplicated by their natural key (league + event, article, team, athlete or ranking), even when several leagues or player sources overlap.\n\n**Is this affiliated with ESPN?**\nNo. This is an independent actor that reads publicly accessible ESPN data and is not endorsed by or affiliated with ESPN, Inc.\n", "actorDefinition": { "actorSpecification": 1, "name": "espn-scores-standings-teams-and-news-by-league", "title": "ESPN Scores, Teams, Players, News & Odds", "description": "Scrape ESPN scores, boxscores, standings, teams, rosters, player stats, schedules, rankings, news and odds across 36 leagues. HTTP-only, with no key, cookie or proxy required.", "version": "1.0", "buildTag": "latest", "dockerfile": "./Dockerfile", "readme": "# ESPN Scores, Teams, Players, News & Odds\n\nScrape **ESPN** for live and historical scores, full game boxscores, league tables, team directories, rosters, player stats, schedules, college and individual-sport rankings, news, and the primary sportsbook line. Ten modes cover 36 leagues across football, basketball, baseball, hockey, soccer, tennis, golf, MMA and Formula 1 — all from public JSON endpoints with **no key, login, cookie or proxy setup**.\n\nEvery row carries a `recordType`, so mixed datasets stay easy to filter: `game`, `event`, `gameDetail`, `standing`, `team`, `teamDetail`, `player`, `article`, `scheduleGame`, `ranking`, `oddsLine` and `notice`.\n\n## What this actor does\n\n- **Ten modes:** `scoreboard`, `gameDetail`, `standings`, `teams`, `teamDetail`, `news`, `players`, `schedule`, `rankings`, `odds`\n- **36 leagues:** US major leagues, college sports, 19 soccer competitions, ATP/WTA, PGA/LPGA, UFC/PFL and F1\n- **Dates and ranges:** today, tomorrow, yesterday, last/next seven days, or a custom range of up to 366 days, fetched one date per request\n- **Multi-league runs:** combine leagues in one scoreboard, odds, standings or news run\n- **Deep game detail:** team stats, optional player boxscore, leaders, officials, venue, injuries, series, scoring plays, win probability and news\n- **Player coverage:** team rosters (flat and grouped), athlete search, profiles, latest-season stats, game logs and rankings\n- **Primary odds:** provider, spread, total and moneyline from the first line ESPN publishes\n- **Clean output:** empty fields are omitted at every depth; no nulls or placeholder values\n\n## Supported leagues\n\n| Family | League slugs |\n|---|---|\n| Football | `nfl`, `college-football`, `ufl` |\n| Basketball | `nba`, `wnba`, `mens-college-basketball`, `womens-college-basketball` |\n| Baseball | `mlb`, `college-baseball` |\n| Hockey | `nhl` |\n| Soccer | `usa.1`, `eng.1`, `esp.1`, `ger.1`, `ita.1`, `fra.1`, `ned.1`, `por.1`, `mex.1`, `bra.1`, `arg.1`, `uefa.champions`, `uefa.europa`, `uefa.europa.conf`, `eng.fa`, `eng.league_cup`, `fifa.world`, `fifa.cwc`, `concacaf.champions` |\n| Tennis | `atp`, `wta` |\n| Golf | `pga`, `lpga` |\n| MMA | `ufc`, `pfl` |\n| Racing | `f1` |\n\nMode coverage follows the data ESPN publishes: team leagues support every team mode; F1 supports scoreboard, teams, team detail and driver/constructor standings; tennis, golf and MMA return event records with matches, leaderboards or fight cards instead of home/away fields.\n\n## Output\n\n### Scoreboard and odds\n\nTeam games include `eventId`, `name`, `shortName`, `url`, `date`, `dateLocal`, `seasonYear`, `seasonType`, `week`, `status`, `statusState`, `statusCompleted`, `venue`, `venueCity`, `venueState`, `venueCountry`, `venueIndoor`, `broadcast`, `broadcasts`, `attendance`, `headlines`, `notes`, `homeTeam`, `homeTeamId`, `homeAbbr`, `homeLogo`, `homeScore`, `homeWinner`, `homeRecord`, `homeForm`, `awayTeam`, `awayTeamId`, `awayAbbr`, `awayLogo`, `awayScore`, `awayWinner`, `awayRecord`, `awayForm`, `competitors[]` and `odds`.\n\n`odds` contains `provider`, `details`, `spread`, `overUnder`, `homeMoneyLine`, `awayMoneyLine`, `homeSpreadOdds`, `awaySpreadOdds`, `overOdds`, `underOdds`, `favoriteTeamId` and `underdogTeamId` when ESPN publishes them. The `odds` mode returns the same line as its own `oddsLine` row.\n\nTennis rows add `groupings[]` and a flat `matches[]` list with `matchId`, `round`, `court`, `notes`, `status` and `competitors[]`. Golf rows add a ranked `competitors[]` leaderboard with `score` and round-by-round `rounds[]`, plus `leader`, `leaderScore` and `competitorCount`. UFC/PFL rows add `fights[]` with weight class, winner and fighter records. F1 rows add `raceName`, `raceDate`, `circuitName` and a `drivers[]` classification.\n\n### Game detail\n\n`gameDetail` includes the scoreboard identity fields plus `statusState`, `attendance`, `officials[]`, `teamStats[]`, `leaders[]`, `odds`, `winProbability[]`, `predictor`, `recentForm[]`, `scoringPlays[]`, `injuries[]`, `series`, `news[]`, `videos[]`, `recap` and `links`. `includePlayerStats` adds `playerStats[]` with per-athlete stat lines; `includePlayByPlay` adds the complete `plays[]` list.\n\n### Standings\n\nStanding rows keep `team`, `teamId`, `abbreviation`, `conference`, `wins`, `losses`, `winPct`, `rank`, `division`, `gamesBehind` and `pointDifferential`, and add `groupName`, `groupType`, `seasonYear`, `overall`, `gamesPlayed`, `ties`, `points`, `pointsFor`, `pointsAgainst`, `streak`, `homeRecord`, `awayRecord`, `divisionRecord`, `conferenceRecord`, `playoffSeed`, `rankChange`, `logoUrl`, `url` and a complete `stats` map.\n\nF1 driver rows use `athleteId`, `athleteName` and `championshipPoints`; constructor rows use `team`, `teamId` and `championshipPoints`.\n\n### Teams\n\nTeam rows include `teamId`, `uid`, `name`, `shortDisplayName`, `abbreviation`, `location`, `color`, `alternateColor`, `slug`, `isActive`, `isAllStar`, `logoUrl`, `darkLogoUrl`, `url`, `rosterUrl`, `competitors`-style `links`, and — when details are fetched — `recordSummary`, `overallRecord`, `homeRecord`, `awayRecord`, `divisionRecord`, `conferenceRecord`, `wins`, `losses`, `winPct`, `gamesPlayed`, `pointsFor`, `pointsAgainst`, `standingSummary`, `conference`, `division`, `venueName`, `venueCity`, `venueState`, `venueIndoor`, `venueLocation`, `nextEvent` and `recordItems[]`.\n\n### Players\n\nPlayer rows include `athleteId`, `playerId`, `name`, `firstName`, `lastName`, `shortName`, `jersey`, `position`, `positionAbbr`, `age`, `dateOfBirth`, `height`, `displayHeight`, `weight`, `displayWeight`, `birthPlace`, `college`, `collegeId`, `headshot`, `status`, `experienceYears`, `displayExperience`, `debutYear`, `draft`, `teamId`, `teamName`, `teamAbbr`, `salary`, `contractYearsRemaining`, `contractSeason`, `statsSummary` and `url`. Search rows also carry `source: \"search\"` and `description`; ESPN search is global, so each result keeps the athlete's own `sport` and `league` even when you search from a different league. `stats[]` and `gameLog[]` are attached when the matching toggles are enabled; season stats are published for NBA, NFL, MLB and NHL, while game logs also work for soccer.\n\n### News\n\nArticles include `articleId`, `headline`, `description`, `publishDate`, `lastModified`, `url`, `imageUrl`, `imageCaption`, `imageCredit`, `author`, `category`, `type`, `section`, `source`, `teams[]`, `athletes[]`, `leagues[]`, `gameId`, `videoUrl`, `premium` and `links`. Set `newsScope: \"global\"` to page the wider ESPN feed; the actor filters those pages down to the selected league.\n\n### Schedule\n\n`scheduleGame` rows combine scoreboard-style fields with `teamId`, `team`, `teamAbbr`, `teamScore`, `teamRecord`, `homeAway`, `opponent`, `opponentId`, `opponentAbbr`, `opponentLogo`, `opponentScore`, `opponentRecord`, `forTeamResult` (`W`, `L` or `D`), `seasonType`, `seasonYear` and `ticketsAvailable`.\n\n### Rankings\n\nRanking rows include `rankingId`, `rankingName`, `rankingShortName`, `rankingSourceType`, `rank`, `previousRank`, `trend`, `points`, `firstPlaceVotes`, `recordSummary`, `defenses`, `athleteId`, `athleteName`, `team`, `teamId`, `abbreviation`, `logoUrl`, `url`, `date`, `lastUpdated`, `occurrence` and `seasonYear`.\n\n### Notices\n\nWhen a request is valid but ESPN has nothing to return, or a mode does not apply to a league, the actor pushes a `notice` row with `code`, `message`, `mode`, `league`, `sport` and `hint`. The run still succeeds.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | select | `news` | One of the ten modes |\n| `league` | select | `nba` | League slug; the sport is derived automatically |\n| `leagues` | array | – | Extra leagues for multi-league runs |\n| `datePreset` | select | `today` | `today`, `tomorrow`, `yesterday`, `last7Days`, `next7Days`, `custom` |\n| `startDate` | string | – | First date for `custom`, as `YYYYMMDD` or `YYYY-MM-DD` |\n| `endDate` | string | – | Last date for `custom`, inclusive; maximum 366 days |\n| `season` | integer | – | Season year for standings, schedule, players and rankings; blank uses the current season |\n| `seasonType` | select | – | `preseason`, `regular`, `postseason` (schedule; ignored for soccer) |\n| `teamIds` | array | – | Team IDs, abbreviations or `league/id` references |\n| `eventIds` | array | – | Event IDs or `league/eventId` references |\n| `athleteQueries` | array | – | Player names to search |\n| `athleteIds` | array | – | ESPN athlete IDs for direct profiles |\n| `rankingType` | select | `all` | `all`, `ap`, `coaches`, `cfp`, `pound-for-pound` |\n| `statusFilter` | select | `all` | `all`, `pre`, `in`, `post` |\n| `liveOnly` | boolean | `false` | Keep only in-progress games |\n| `newsScope` | select | `league` | `league` or the paginated `global` feed |\n| `includeTeamDetails` | boolean | `true` | Fetch team record, venue and next event |\n| `includeGameDetails` | boolean | `false` | Attach full summaries to scoreboard games |\n| `includePlayerStats` | boolean | `false` | Add player stats / player boxscore |\n| `includeGameLog` | boolean | `false` | Add a player's current-season game log |\n| `includePlayByPlay` | boolean | `false` | Add every play to `gameDetail` |\n| `maxItems` | integer | `50` | Hard cap (1–5000); notices are metadata rows |\n\n### Example: scoreboard for two leagues\n\n```json\n{\n \"mode\": \"scoreboard\",\n \"leagues\": [\"nba\", \"nfl\"],\n \"datePreset\": \"yesterday\",\n \"statusFilter\": \"post\",\n \"maxItems\": 40\n}\n```\n\n### Example: full NBA game detail\n\n```json\n{\n \"mode\": \"gameDetail\",\n \"league\": \"nba\",\n \"eventIds\": [\"401909904\"],\n \"includePlayerStats\": true,\n \"includePlayByPlay\": false,\n \"maxItems\": 1\n}\n```\n\n### Example: Premier League schedule and standings\n\n```json\n{\n \"mode\": \"schedule\",\n \"league\": \"eng.1\",\n \"teamIds\": [\"eng.1/364\"],\n \"seasonType\": \"regular\",\n \"maxItems\": 38\n}\n```\n\n```json\n{\n \"mode\": \"standings\",\n \"league\": \"eng.1\",\n \"maxItems\": 20\n}\n```\n\n### Example: player search with stats\n\n```json\n{\n \"mode\": \"players\",\n \"league\": \"nba\",\n \"athleteQueries\": [\"LeBron James\", \"Jannik Sinner\"],\n \"includePlayerStats\": true,\n \"maxItems\": 10\n}\n```\n\n### Example: F1 race and driver standings\n\n```json\n{\n \"mode\": \"scoreboard\",\n \"league\": \"f1\",\n \"datePreset\": \"yesterday\",\n \"maxItems\": 5\n}\n```\n\n```json\n{\n \"mode\": \"standings\",\n \"league\": \"f1\",\n \"maxItems\": 30\n}\n```\n\n## Use cases\n\n- **Fantasy and betting dashboards** — pull slates, primary lines and player boxscores into one normalized feed\n- **Media and newsroom bots** — monitor league headlines or the global ESPN feed and filter to the teams you cover\n- **Team and league trackers** — follow schedules, results, standings and roster changes across multiple leagues\n- **Sports research** — build historical datasets from date ranges and full game summaries\n- **Player scouting** — search athletes, compare latest-season stats and inspect game logs\n- **Broadcast graphics** — feed scoreboards, rankings and leaderboards into live displays\n\n## FAQ\n\n**Do I need an API key, account or proxy?**\nNo. The actor reads ESPN's public JSON feeds anonymously. There is no credential or proxy input.\n\n**Why did I get a notice row instead of games?**\nA notice explains the empty result: no games on that date, no odds published yet, an off-season schedule, or a mode ESPN does not support for that league. The notice `code` and `hint` tell you what to change.\n\n**How many news articles can I get per league?**\nESPN's league news endpoint returns at most 50 articles. Use `newsScope: \"global\"` to page the wider feed; the actor filters those pages client-side to the selected league.\n\n**Why are some odds fields missing?**\nESPN publishes a primary line for many upcoming games but not every game, and moneyline/spread components vary by sport and provider. Empty odds fields are omitted rather than guessed. The actor ships the first published line only; it does not promise open-line history or every sportsbook.\n\n**Can I scrape tennis, golf, MMA or F1 game summaries?**\nTheir scoreboards are fully supported with matches, leaderboards, fight cards and driver classifications. ESPN does not expose the same team-style summary for these sports, so `gameDetail` returns a notice for them.\n\n**Why is a team venue missing?**\nESPN only includes venue details for some teams (for example, many NBA/NFL clubs). Soccer and F1 team endpoints commonly omit a home venue. The field is omitted when the source has no value.\n\n**Can I fetch historical seasons and dates?**\nYes. Scoreboard and odds accept a custom date range of up to 366 days. Standings, schedules, players and rankings accept a `season` year. Coverage depends on what ESPN keeps for each league.\n\n**Does the actor return duplicate rows?**\nNo. Rows are de-duplicated by their natural key (league + event, article, team, athlete or ranking), even when several leagues or player sources overlap.\n\n**Is this affiliated with ESPN?**\nNo. This is an independent actor that reads publicly accessible ESPN data and is not endorsed by or affiliated with ESPN, Inc.\n", "input": { "title": "ESPN Scraper Input", "description": "Pull ESPN scores, game details, standings, teams, players, news, schedules, rankings and odds for 36 leagues — no key, cookie or proxy.", "type": "object", "schemaVersion": 1, "properties": { "mode": { "title": "Mode", "type": "string", "description": "What to fetch from ESPN.", "editor": "select", "enum": [ "scoreboard", "gameDetail", "standings", "teams", "teamDetail", "news", "players", "schedule", "rankings", "odds" ], "enumTitles": [ "Scoreboard — games, matches, leaderboards and fight cards", "Game Detail — box score, player lines, odds and win probability", "Standings — league tables plus F1 drivers and constructors", "Teams — every team in a league", "Team Detail — record, venue and next event for selected teams", "News — league headlines or the global ESPN feed", "Players — rosters, athlete search, profiles, stats and game logs", "Schedule — a team's season schedule with results", "Rankings — ATP, WTA, UFC and college polls", "Odds — primary sportsbook line per game" ], "default": "news", "prefill": "news" }, "league": { "title": "League", "type": "string", "description": "League slug. The sport is derived automatically.", "editor": "select", "enum": [ "nfl", "college-football", "ufl", "nba", "wnba", "mens-college-basketball", "womens-college-basketball", "mlb", "college-baseball", "nhl", "usa.1", "eng.1", "esp.1", "ger.1", "ita.1", "fra.1", "ned.1", "por.1", "mex.1", "bra.1", "arg.1", "uefa.champions", "uefa.europa", "uefa.europa.conf", "eng.fa", "eng.league_cup", "fifa.world", "fifa.cwc", "concacaf.champions", "atp", "wta", "pga", "lpga", "ufc", "pfl", "f1" ], "enumTitles": [ "NFL", "College Football", "UFL", "NBA", "WNBA", "Men's College Basketball", "Women's College Basketball", "MLB", "College Baseball", "NHL", "MLS", "English Premier League", "Spanish La Liga", "German Bundesliga", "Italian Serie A", "French Ligue 1", "Dutch Eredivisie", "Portuguese Primeira Liga", "Mexican Liga MX", "Brazilian Serie A", "Argentine Liga Profesional", "UEFA Champions League", "UEFA Europa League", "UEFA Conference League", "English FA Cup", "English Carabao Cup", "FIFA World Cup", "FIFA Club World Cup", "Concacaf Champions Cup", "ATP Tennis", "WTA Tennis", "PGA Tour Golf", "LPGA Golf", "UFC", "PFL", "Formula 1" ], "default": "nba", "prefill": "nba" }, "leagues": { "title": "Extra leagues", "type": "array", "description": "Optional multi-league override for modes that iterate leagues (scoreboard, odds, standings, teams, teamDetail, news, players, schedule, rankings), e.g. [\"nba\",\"nfl\"].", "editor": "stringList", "items": { "type": "string" } }, "datePreset": { "title": "Date preset", "type": "string", "description": "Date window for scoreboard and odds. ESPN accepts one date per request, so ranges are fetched one day at a time.", "editor": "select", "enum": [ "today", "tomorrow", "yesterday", "last7Days", "next7Days", "custom" ], "enumTitles": [ "Today", "Tomorrow", "Yesterday", "Last 7 days", "Next 7 days", "Custom range" ], "default": "today", "prefill": "today" }, "startDate": { "title": "Start date (custom)", "type": "string", "description": "First date for datePreset=custom, in YYYYMMDD or YYYY-MM-DD.", "editor": "textfield" }, "endDate": { "title": "End date (custom)", "type": "string", "description": "Last date for datePreset=custom (inclusive), in YYYYMMDD or YYYY-MM-DD. Maximum 366 days.", "editor": "textfield" }, "season": { "title": "Season year", "type": "integer", "description": "ESPN season year for standings, schedule, players and rankings (e.g. 2025). Leave blank for the current season.", "minimum": 1900, "maximum": 2100 }, "seasonType": { "title": "Season type (mode=schedule)", "type": "string", "description": "Filter a team schedule by season phase (ignored for soccer schedules, which ESPN reports as one league season).", "editor": "select", "enum": [ "preseason", "regular", "postseason" ], "enumTitles": [ "Preseason", "Regular season", "Postseason" ] }, "teamIds": { "title": "Team IDs or abbreviations", "type": "array", "description": "Teams for teams/teamDetail/schedule/players. Accepts 2, BOS or nba/BOS. Get IDs from mode=teams.", "editor": "stringList", "items": { "type": "string" } }, "eventIds": { "title": "Event IDs", "type": "array", "description": "Games for gameDetail/odds. Accepts 401909904 or nba/401909904. Get IDs from mode=scoreboard.", "editor": "stringList", "items": { "type": "string" } }, "athleteQueries": { "title": "Athlete searches (mode=players)", "type": "array", "description": "Player names to search, e.g. [\"LeBron James\", \"Jannik Sinner\"].", "editor": "stringList", "items": { "type": "string" } }, "athleteIds": { "title": "Athlete IDs (mode=players)", "type": "array", "description": "ESPN athlete IDs for direct profiles, e.g. [\"1966\"].", "editor": "stringList", "items": { "type": "string" } }, "rankingType": { "title": "Ranking (mode=rankings)", "type": "string", "description": "Which poll to return. 'all' includes every poll ESPN publishes for the league.", "editor": "select", "enum": [ "all", "ap", "coaches", "cfp", "pound-for-pound" ], "enumTitles": [ "All rankings", "AP Top 25", "Coaches Poll", "College Football Playoff", "Pound-for-pound" ], "default": "all", "prefill": "all" }, "statusFilter": { "title": "Game status", "type": "string", "description": "Filter scoreboard, odds or schedule rows by game state.", "editor": "select", "enum": [ "all", "pre", "in", "post" ], "enumTitles": [ "All games", "Upcoming", "Live", "Completed" ], "default": "all", "prefill": "all" }, "liveOnly": { "title": "Live only", "type": "boolean", "description": "Keep only in-progress games (scoreboard and odds).", "default": false, "prefill": false }, "newsScope": { "title": "News scope (mode=news)", "type": "string", "description": "League news is capped at 50 articles by ESPN. Global pages the ESPN now feed and filters to the selected league.", "editor": "select", "enum": [ "league", "global" ], "enumTitles": [ "Selected league", "Global ESPN feed (paginated)" ], "default": "league", "prefill": "league" }, "includeTeamDetails": { "title": "Include team details (mode=teams)", "type": "boolean", "description": "Fetch each team's record, venue and next event. Adds one request per team.", "default": true, "prefill": false }, "includeGameDetails": { "title": "Include game details (mode=scoreboard)", "type": "boolean", "description": "Attach the full game summary to every team-sport game. Adds one request per game.", "default": false, "prefill": false }, "includePlayerStats": { "title": "Include player stats", "type": "boolean", "description": "Attach latest season stats to player rows and the player box score to gameDetail. Adds requests per player.", "default": false, "prefill": false }, "includeGameLog": { "title": "Include game log (mode=players)", "type": "boolean", "description": "Attach the current-season game log to each player. Adds one request per athlete.", "default": false, "prefill": false }, "includePlayByPlay": { "title": "Include every play", "type": "boolean", "description": "Include the full play-by-play list in gameDetail (scoring plays are always included).", "default": false, "prefill": false }, "maxItems": { "title": "Max items", "type": "integer", "description": "Hard cap on data records. Notice rows explain unsupported or empty requests.", "minimum": 1, "maximum": 5000, "default": 50, "prefill": 1 } }, "required": [ "mode" ] }, "output": { "actorOutputSchemaVersion": 1, "title": "ESPN Scores, Teams, Players, News & Odds Output", "description": "ESPN records for games, standings, teams, players, news, schedules, rankings and odds, with a recordType on every row.", "properties": { "espnData": { "type": "string", "title": "ESPN sports data", "description": "Dataset containing the requested ESPN records plus notice rows for empty or unsupported combinations.", "template": "{{links.apiDefaultDatasetUrl}}/items" } } }, "defaultRunOptions": { "build": "latest", "timeoutSecs": 300, "memoryMbytes": 1024 }, "storages": { "dataset": { "actorSpecification": 1, "views": { "overview": { "title": "ESPN Results", "transformation": { "fields": [ "recordType", "mode", "sport", "league", "name", "status", "homeTeam", "awayTeam", "homeScore", "awayScore", "date" ] }, "display": { "component": "table", "properties": {} } } } } }, "environmentVariables": {} }, "buildNumber": "1.0.2", "imageDigest": "f60eeeb31467bf5cbc6c5b6dc02320f769b4813065e0d9bd8ecf2fb4e1ea48d5", "actVersion": { "sourceType": "SOURCE_FILES", "buildTag": "latest", "versionNumber": "1.0" }, "usage": { "ACTOR_COMPUTE_UNITS": 0.0042833333333333334 } } }