--- type: "firecrawl-provider" description: "ESPN public sports data from the anonymous site and core JSON APIs: sport/league discovery, scoreboards by date or week (schedules, live and final scores with explicit status), event summaries, teams, team records and schedules, rosters, standings, player bios with career statistics, and site search. US and international coverage as ESPN exposes it (NFL, NBA, MLB, NHL, college sports, Premier League and ~219 soccer competitions incl. UEFA and FIFA tournaments)." use_when: "ESPN public sports data from the anonymous site and core JSON APIs: sport/league discovery, scoreboards by date or week (schedules, live and final scores with explicit status), event summaries, teams, team records and schedules, rosters, standings, player bios with career statistics, and site search. US and international coverage as ESPN exposes it (NFL, NBA, MLB, NHL, college sports, Premier League and ~219 soccer competitions incl. UEFA and FIFA tournaments)." categories: "Sports" capabilities: 10 credits_per_call: 5 --- # ESPN on Firecrawl Alexandria ESPN public sports data from the anonymous site and core JSON APIs: sport/league discovery, scoreboards by date or week (schedules, live and final scores with explicit status), event summaries, teams, team records and schedules, rosters, standings, player bios with career statistics, and site search. US and international coverage as ESPN exposes it (NFL, NBA, MLB, NHL, college sports, Premier League and ~219 soccer competitions incl. UEFA and FIFA tournaments). - Categories: Sports - Category index: [Sports category](https://firecrawl.dev/alexandria/agents/categories/sports) - Provider key: `espn-com` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/espn-com) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/espn-com/openapi.json) ## Capabilities - [Event](https://firecrawl.dev/alexandria/agents/providers/espn-com/sports-data/event): One event's summary from `site.api.espn.com/apis/site/v2/sports/{sport}/{league}/summary?event=`: header (status, start time, competitors, scores, records), venue, attendance, officials, team box-score statistics as ESPN labels them, scoring/key plays (NFL `scoringPlays`; soccer match details flagged scoringPlay) and the recap headline. ESPN does not validate the league path, so an event that belongs to another league is `not_found` rather than mislabeled. An unknown event_id is `not_found`. - [Leagues](https://firecrawl.dev/alexandria/agents/providers/espn-com/sports-data/leagues): List the sports ESPN's core API exposes (no `sport`) or every league/competition slug within one sport (`sport`), from `sports.core.api.espn.com/v2/sports[/{sport}/leagues]`. Slugs are the stable identifiers every other function takes as `sport`/`league`. Soccer lists ~219 competitions (eng.1, esp.1, ger.1, ita.1, fra.1, usa.1, mex.1, uefa.champions, uefa.europa, fifa.world, ...). One request; ESPN pages at 1000 so the list is complete for every sport observed. An unknown sport is `not_found`. - [Player](https://firecrawl.dev/alexandria/agents/providers/espn-com/sports-data/player): One athlete's public profile from `site.web.api.espn.com/apis/common/v3/sports/{sport}/{league}/athletes/{athlete_id}` (identity, position, current team, status, age, birth date/place, height, weight, experience, draft, college, headshot) and, unless `include_statistics` is false, career statistics by season from `.../athletes/{athlete_id}/stats`: ESPN's categories with labels, stat names, display names, per-season rows (team, position, values as ESPN prints them) and career totals. Stat names and units are sport-specific and kept verbatim; a player without a statistics page keeps `statistics: null` with a warning. An unknown athlete_id is `not_found`. - [Roster](https://firecrawl.dev/alexandria/agents/providers/espn-com/sports-data/roster): A team's current roster from `site.api.espn.com/apis/site/v2/sports/{sport}/{league}/teams/{team_id}/roster`, flattened to one player list (NFL unit groups such as offense/defense/practiceSquad become `group`) in a bounded window (`offset`/`limit`, default 100) with `next_offset`: athlete_id, names, jersey, position, age, date of birth, height/weight (raw inches/pounds and display), birthplace, citizenship (soccer), college and experience (NFL), status, injuries, headshot, player URL; plus coaches and season. An unknown team_id is `not_found`. - [Scoreboard](https://firecrawl.dev/alexandria/agents/providers/espn-com/sports-data/scoreboard): Events for one league on one date (`date`, YYYYMMDD, ESPN's US-Eastern day) or, for week-based leagues such as the NFL and college football, one week (`season` + `seasontype` + `week`), from `site.api.espn.com/apis/site/v2/sports/{sport}/{league}/scoreboard`. Each event carries ESPN's event_id, UTC start time, the status type (STATUS_SCHEDULED / STATUS_IN_PROGRESS / STATUS_FINAL / STATUS_FULL_TIME / STATUS_POSTPONED / ...) with a derived `category`, venue, broadcasts and both competitors with score (null before kickoff), winner flag and records. Without `date` ESPN returns its current day/week. `groups` bounds college football (80 = FBS) and `limit` caps the count (partial coverage when hit). An empty list is a legitimate day without events. An unknown league is `not_found`. - [Search](https://firecrawl.dev/alexandria/agents/providers/espn-com/sports-data/search): ESPN site search from `site.web.api.espn.com/apis/search/v2`: results grouped by type (player, team, league, article, clips, ...) with ESPN's totals, each item with display name, subtitle, sport, default league slug, web URL and the ids decoded from ESPN's uid (`s:600~t:359` = sport 600, team 359; `s:20~l:28~a:3139477` = NFL athlete). Restrict with `type` (player, team, league, article). A query with no matches returns empty groups. - [Standings](https://firecrawl.dev/alexandria/agents/providers/espn-com/sports-data/standings): League standings from `site.api.espn.com/apis/v2/sports/{sport}/{league}/standings[?season=&level=]`, flattened to tables: one per group that carries entries (a soccer league table; NFL conferences, or divisions with `level=3`), each entry with team identity, ESPN's rank note (qualification/relegation) and every standings column as ESPN names it (wins, losses, ties, points, gamesPlayed, pointDifferential, winPercent, streak, playoffSeed, ...). Includes the seasons ESPN offers. `stats` narrows the columns to the named ones. Without `season` ESPN returns the current season; a requested season ESPN answers with another year is `not_found`. An unknown league is `not_found`. - [Team](https://firecrawl.dev/alexandria/agents/providers/espn-com/sports-data/team): One team from `site.api.espn.com/apis/site/v2/sports/{sport}/{league}/teams/{team_id}`: identity, current record items with ESPN's stat names, standing summary (e.g. "1st in AFC East"), group/division ids, home venue and the next scheduled event(s). An unknown team_id is `not_found`. - [Team schedule](https://firecrawl.dev/alexandria/agents/providers/espn-com/sports-data/team_schedule): A team's season schedule from `site.api.espn.com/apis/site/v2/sports/{sport}/{league}/teams/{team_id}/schedule[?season=]`, as a bounded window (`offset`/`limit`, default 50) over the full list with `next_offset` continuation: every event with UTC start, status (including STATUS_POSTPONED), venue, competitors and final scores. Without `season` ESPN returns the current season; a season ESPN does not have falls back upstream and is reported as `not_found`. For soccer ESPN splits the season into completed results and upcoming fixtures (`fixture=true`); the program fetches both and returns one chronological list, so a competition whose season has not started yet lists its fixtures instead of nothing. A soccer `league` is one competition; `league: "all"` (ESPN's All Competitions view) spans every competition the club or national team plays, with each event's competition in its `season.name`. An unknown team_id is `not_found`. - [Teams](https://firecrawl.dev/alexandria/agents/providers/espn-com/sports-data/teams): All teams in a league from `site.api.espn.com/apis/site/v2/sports/{sport}/{league}/teams` (one request, `limit=1000`): ESPN team_id, uid, slug, names, abbreviation, colors, logo and clubhouse URL. An unknown league is `not_found`. ## 1. Choose this provider when ESPN public sports data from the anonymous site and core JSON APIs: sport/league discovery, scoreboards by date or week (schedules, live and final scores with explicit status), event summaries, teams, team records and schedules, rosters, standings, player bios with career statistics, and site search. US and international coverage as ESPN exposes it (NFL, NBA, MLB, NHL, college sports, Premier League and ~219 soccer competitions incl. UEFA and FIFA tournaments). ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "espn-com", "capability": "sports-data/event", "options": { "event_id": "401872932", "league": "nfl", "sport": "football" } } ``` ## 3. Add provider options Use only the options needed for the task: - `event_id` (string, required): ESPN event id (from scoreboard / team_schedule / search). Pattern: ^[0-9]+$. Example: `` - `league` (string, required): ESPN league slug within the sport, e.g. nfl, college-football, eng.1, uefa.champions, fifa.world, nba, mlb, nhl (from `leagues`). Pattern: ^[a-z0-9][a-z0-9._-]*$. Example: `` - `sport` (string, required): ESPN sport slug, e.g. football, soccer, basketball, baseball, hockey (from `leagues` without `sport`). Pattern: ^[a-z][a-z0-9-]*$. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "espn-com", capability: "sports-data/event", options: { event_id: "401872932", league: "nfl", sport: "football", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "espn-com", "capability": "sports-data/event", "options": { "event_id": "401872932", "league": "nfl", "sport": "football" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "espn-com", "capability": "sports-data/event", "options": { "event_id": "401872932", "league": "nfl", "sport": "football" } } }' ``` ### CLI ```sh firecrawl scrape 'espn-com/sports-data/event' \ --options '{"event_id":"401872932","league":"nfl","sport":"football"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "espn-com", "capability": "sports-data/event", "options": { "event_id": "401872932", "league": "nfl", "sport": "football" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "espn-com", "capability": "sports-data/event", "options": { "event_id": "401872932", "league": "nfl", "sport": "football" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "attendance": 60644, "event": { "attendance": null, "broadcasts": [ "Prime Video" ], "competitors": [ { "abbreviation": "BUF", "display_name": "Buffalo Bills", "form": null, "home_away": "home", "location": "Buffalo", "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/buf.png", "order": 0, "rank": null, "records": [ { "name": null, "summary": "2-0", "type": "total" }, { "name": null, "summary": "1-0", "type": "home" } ], "score": "41", "score_value": 41, "short_display_name": null, "team_id": "2", "uid": "s:20~l:28~t:2", "url": "https://www.espn.com/nfl/team/_/name/buf/buffalo-bills", "winner": true }, { "abbreviation": "DET", "display_name": "Detroit Lions", "form": null, "home_away": "away", "location": "Detroit", "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/det.png", "order": 1, "rank": null, "records": [ { "name": null, "summary": "1-1", "type": "total" }, { "name": null, "summary": "0-1", "type": "road" } ], "score": "31", "score_value": 31, "short_display_name": null, "team_id": "8", "uid": "s:20~l:28~t:8", "url": "https://www.espn.com/nfl/team/_/name/det/detroit-lions", "winner": false } ], "event_id": "401872932", "name": null, "neutral_site": false, "season": { "name": null, "type": 2, "year": 2026 }, "short_name": null, "start_time": "2026-09-18T00:15Z", "status": { "category": "final", "clock": null, "completed": true, "description": "Final", "detail": "Final", "display_clock": null, "id": "3", "name": "STATUS_FINAL", "period": null, "short_detail": "Final", "state": "post" }, "time_valid": true, "uid": "s:20~l:28~e:401872932", "url": "https://www.espn.com/nfl/game/_/gameId/401872932/lions-bills", "venue": null, "week": 2 }, "key_plays": [ { "athletes": [], "away_score": 0, "clock": "9:09", "home_score": 7, "id": "401872932317", "period": 1, "score_value": null, "scoring_play": true, "team_id": "2", "text": "Josh Allen 1 Yd Rush (Tyler Bass Kick)", "type": "Rushing Touchdown", "type_id": "68", "wallclock": null }, { "athletes": [], "away_score": 0, "clock": "3:42", "home_score": 14, "id": "401872932640", "period": 1, "score_value": null, "scoring_play": true, "team_id": "2", "text": "Joshua Palmer 43 Yd pass from Josh Allen (Tyler Bass Kick)", "type": "Passing Touchdown", "type_id": "67", "wallclock": null }, { "athletes": [], "away_score": 0, "clock": "11:48", "home_score": 21, "id": "4018729321146", "period": 2, "score_value": null, "scoring_play": true, "team_id": "2", "text": "Dawson Knox 1 Yd pass from Josh Allen (Tyler Bass Kick)", "type": "Passing Touchdown", "type_id": "67", "wallclock": null }, { "athletes": [], "away_score": 7, "clock": "5:03", "home_score": 21, "id": "4018729321523", "period": 2, "score_value": null, "scoring_play": true, "team_id": "8", "text": "Jahmyr Gibbs 11 Yd pass from Jared Goff (Jake Bates Kick)", "type": "Passing Touchdown", "type_id": "67", "wallclock": null }, { "athletes": [], "away_score": 7, "clock": "2:52", "home_score": 27, "id": "4018729321712", "period": 2, "score_value": null, "scoring_play": true, "team_id": "2", "text": "Dalton Kincaid 16 Yd pass from Josh Allen (Tyler Bass PAT Failed)", "type": "Passing Touchdown", "type_id": "67", "wallclock": null }, { "athletes": [], "away_score": 10, "clock": "0:00", "home_score": 27, "id": "4018729322363", "period": 2, "score_value": null, "scoring_play": true, "team_id": "8", "text": "Jake Bates 31 Yd Field Goal", "type": "Field Goal Good", "type_id": "59", "wallclock": null }, { "athletes": [], "away_score": 17, "clock": "9:29", "home_score": 27, "id": "4018729322706", "period": 3, "score_value": null, "scoring_play": true, "team_id": "8", "text": "Amon-Ra St. Brown 2 Yd pass from Jared Goff (Jake Bates Kick)", "type": "Passing Touchdown", "type_id": "67", "wallclock": null }, { "athletes": [], "away_score": 17, "clock": "1:07", "home_score": 34, "id": "4018729323135", "period": 3, "score_value": null, "scoring_play": true, "team_id": "2", "text": "Josh Allen 2 Yd Rush (Tyler Bass Kick)", "type": "Rushing Touchdown", "type_id": "68", "wallclock": null }, { "athletes": [], "away_score": 24, "clock": "10:53", "home_score": 34, "id": "4018729323573", "period": 4, "score_value": null, "scoring_play": true, "team_id": "8", "text": "Sam LaPorta 1 Yd pass from Jared Goff (Jake Bates Kick)", "type": "Passing Touchdown", "type_id": "67", "wallclock": null }, { "athletes": [], "away_score": 24, "clock": "2:50", "home_score": 41, "id": "4018729324101", "period": 4, "score_value": null, "scoring_play": true, "team_id": "2", "text": "James Cook III 1 Yd Rush (Tyler Bass Kick)", "type": "Rushing Touchdown", "type_id": "68", "wallclock": null }, { "athletes": [], "away_score": 31, "clock": "1:42", "home_score": 41, "id": "4018729324330", "period": 4, "score_value": null, "scoring_play": true, "team_id": "8", "text": "Amon-Ra St. Brown 27 Yd pass from Jared Goff (Jake Bates Kick)", "type": "Passing Touchdown", "type_id": "67", "wallclock": null } ], "last_updated": "2026-09-18T03:28:45Z", "league": { "abbreviation": "NFL", "id": "28", "name": "National Football League", "season": null, "slug": "nfl", "uid": "s:20~l:28" }, "observed_at_ms": 1790018154618, "officials": [ { "name": "Derick Bowers", "position": "Down Judge" }, { "name": "Ronald Torbert", "position": "Referee" }, { "name": "Keith Washington", "position": "Side Judge" }, { "name": "Roy Ellison", "position": "Umpire" }, { "name": "Ryan Dickson", "position": "Field Judge" }, { "name": "Thomas Eaton", "position": "Line Judge" }, { "name": "Courtney Brown", "position": "Back Judge" } ], "recap": { "description": "— Forget the official name of the Buffalo Bills' new stadium. It’s Josh Allen’s house.", "headline": "Josh Allen opens the Bills' new stadium with a 5-TD outing in a 41-31 win over the Lions", "published": "2026-09-18T03:39:36Z" }, "sport": "football", "team_statistics": [ { "abbreviation": "DET", "display_name": "Detroit Lions", "home_away": "away", "statistics": [ { "abbreviation": null, "display_value": "24", "label": "1st Downs", "name": "firstDowns", "value": 24 }, { "abbreviation": null, "display_value": "19", "label": "Passing 1st downs", "name": "firstDownsPassing", "value": 19 }, { "abbreviation": null, "display_value": "2", "label": "Rushing 1st downs", "name": "firstDownsRushing", "value": 2 }, { "abbreviation": null, "display_value": "3", "label": "1st downs from penalties", "name": "firstDownsPenalty", "value": 3 }, { "abbreviation": null, "display_value": "4-11", "label": "3rd down efficiency", "name": "thirdDownEff", "value": 0.3636363636 }, { "abbreviation": null, "display_value": "2-2", "label": "4th down efficiency", "name": "fourthDownEff", "value": 1 }, { "abbreviation": null, "display_value": "62", "label": "Total Plays", "name": "totalOffensivePlays", "value": 62 }, { "abbreviation": null, "display_value": "355", "label": "Total Yards", "name": "totalYards", "value": null }, { "abbreviation": null, "display_value": "5.7", "label": "Yards per Play", "name": "yardsPerPlay", "value": 5.7258064516 }, { "abbreviation": null, "display_value": "9", "label": "Total Drives", "name": "totalDrives", "value": 9 }, { "abbreviation": null, "display_value": "289", "label": "Passing", "name": "netPassingYards", "value": 289 }, { "abbreviation": null, "display_value": "26/38", "label": "Comp/Att", "name": "completionAttempts", "value": null }, { "abbreviation": null, "display_value": "6.9", "label": "Yards per pass", "name": "yardsPerPass", "value": 6.880952380952381 }, { "abbreviation": null, "display_value": "0", "label": "Interceptions thrown", "name": "interceptions", "value": 0 }, { "abbreviation": null, "display_value": "4-38", "label": "Sacks-Yards Lost", "name": "sacksYardsLost", "value": null }, { "abbreviation": null, "display_value": "66", "label": "Rushing", "name": "rushingYards", "value": 66 }, { "abbreviation": null, "display_value": "20", "label": "Rushing Attempts", "name": "rushingAttempts", "value": 20 }, { "abbreviation": null, "display_value": "3.3", "label": "Yards per rush", "name": "yardsPerRushAttempt", "value": 3.3 }, { "abbreviation": null, "display_value": "3-4", "label": "Red Zone (Made-Att)", "name": "redZoneAttempts", "value": 0.75 }, { "abbreviation": null, "display_value": "10-58", "label": "Penalties", "name": "totalPenaltiesYards", "value": null }, { "abbreviation": null, "display_value": "0", "label": "Turnovers", "name": "turnovers", "value": null }, { "abbreviation": null, "display_value": "0", "label": "Fumbles lost", "name": "fumblesLost", "value": 0 }, { "abbreviation": null, "display_value": "0", "label": "Interceptions thrown", "name": "interceptions", "value": 0 }, { "abbreviation": null, "display_value": "0", "label": "Defensive / Special Teams TDs", "name": "defensiveTouchdowns", "value": 0 }, { "abbreviation": null, "display_value": "26:15", "label": "Possession", "name": "possessionTime", "value": 1575 } ], "team_id": "8" }, { "abbreviation": "BUF", "display_name": "Buffalo Bills", "home_away": "home", "statistics": [ { "abbreviation": null, "display_value": "34", "label": "1st Downs", "name": "firstDowns", "value": 34 }, { "abbreviation": null, "display_value": "14", "label": "Passing 1st downs", "name": "firstDownsPassing", "value": 14 }, { "abbreviation": null, "display_value": "15", "label": "Rushing 1st downs", "name": "firstDownsRushing", "value": 15 }, { "abbreviation": null, "display_value": "5", "label": "1st downs from penalties", "name": "firstDownsPenalty", "value": 5 }, { "abbreviation": null, "display_value": "9-12", "label": "3rd down efficiency", "name": "thirdDownEff", "value": 0.75 }, { "abbreviation": null, "display_value": "0-0", "label": "4th down efficiency", "name": "fourthDownEff", "value": null }, { "abbreviation": null, "display_value": "69", "label": "Total Plays", "name": "totalOffensivePlays", "value": 69 }, { "abbreviation": null, "display_value": "446", "label": "Total Yards", "name": "totalYards", "value": null }, { "abbreviation": null, "display_value": "6.5", "label": "Yards per Play", "name": "yardsPerPlay", "value": 6.4637681159 }, { "abbreviation": null, "display_value": "9", "label": "Total Drives", "name": "totalDrives", "value": 9 }, { "abbreviation": null, "display_value": "243", "label": "Passing", "name": "netPassingYards", "value": 243 }, { "abbreviation": null, "display_value": "20/31", "label": "Comp/Att", "name": "completionAttempts", "value": null }, { "abbreviation": null, "display_value": "7.4", "label": "Yards per pass", "name": "yardsPerPass", "value": 7.363636363636363 }, { "abbreviation": null, "display_value": "0", "label": "Interceptions thrown", "name": "interceptions", "value": 0 }, { "abbreviation": null, "display_value": "2-5", "label": "Sacks-Yards Lost", "name": "sacksYardsLost", "value": null }, { "abbreviation": null, "display_value": "203", "label": "Rushing", "name": "rushingYards", "value": 203 }, { "abbreviation": null, "display_value": "36", "label": "Rushing Attempts", "name": "rushingAttempts", "value": 36 }, { "abbreviation": null, "display_value": "5.6", "label": "Yards per rush", "name": "yardsPerRushAttempt", "value": 5.639 }, { "abbreviation": null, "display_value": "5-5", "label": "Red Zone (Made-Att)", "name": "redZoneAttempts", "value": 1 }, { "abbreviation": null, "display_value": "5-46", "label": "Penalties", "name": "totalPenaltiesYards", "value": null }, { "abbreviation": null, "display_value": "0", "label": "Turnovers", "name": "turnovers", "value": null }, { "abbreviation": null, "display_value": "0", "label": "Fumbles lost", "name": "fumblesLost", "value": 0 }, { "abbreviation": null, "display_value": "0", "label": "Interceptions thrown", "name": "interceptions", "value": 0 }, { "abbreviation": null, "display_value": "0", "label": "Defensive / Special Teams TDs", "name": "defensiveTouchdowns", "value": 0 }, { "abbreviation": null, "display_value": "33:45", "label": "Possession", "name": "possessionTime", "value": 2025 } ], "team_id": "2" } ], "venue": { "city": "Orchard Park", "country": "USA", "id": "11938", "indoor": null, "name": "Highmark Stadium", "state": "NY" } } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Event - Capability: `sports-data/event` - Description: One event's summary from `site.api.espn.com/apis/site/v2/sports/{sport}/{league}/summary?event=`: header (status, start time, competitors, scores, records), venue, attendance, officials, team box-score statistics as ESPN labels them, scoring/key plays (NFL `scoringPlays`; soccer match details flagged scoringPlay) and the recap headline. ESPN does not validate the league path, so an event that belongs to another league is `not_found` rather than mislabeled. An unknown event_id is `not_found`. - Instructions: Read a specific game/match after finding its event_id in scoreboard or team_schedule. - Cost: 5 credits per call - Capability file: [Event](https://firecrawl.dev/alexandria/agents/providers/espn-com/sports-data/event) Accepted options: - `event_id` (string, required): ESPN event id (from scoreboard / team_schedule / search). Pattern: ^[0-9]+$. Example: `` - `league` (string, required): ESPN league slug within the sport, e.g. nfl, college-football, eng.1, uefa.champions, fifa.world, nba, mlb, nhl (from `leagues`). Pattern: ^[a-z0-9][a-z0-9._-]*$. Example: `` - `sport` (string, required): ESPN sport slug, e.g. football, soccer, basketball, baseball, hockey (from `leagues` without `sport`). Pattern: ^[a-z][a-z0-9-]*$. Example: `` Response schema example: ```json { "attendance": 60644, "event": { "attendance": null, "broadcasts": [ "Prime Video" ], "competitors": [ { "abbreviation": "BUF", "display_name": "Buffalo Bills", "form": null, "home_away": "home", "location": "Buffalo", "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/buf.png", "order": 0, "rank": null, "records": [ { "name": null, "summary": "2-0", "type": "total" }, { "name": null, "summary": "1-0", "type": "home" } ], "score": "41", "score_value": 41, "short_display_name": null, "team_id": "2", "uid": "s:20~l:28~t:2", "url": "https://www.espn.com/nfl/team/_/name/buf/buffalo-bills", "winner": true }, { "abbreviation": "DET", "display_name": "Detroit Lions", "form": null, "home_away": "away", "location": "Detroit", "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/det.png", "order": 1, "rank": null, "records": [ { "name": null, "summary": "1-1", "type": "total" }, { "name": null, "summary": "0-1", "type": "road" } ], "score": "31", "score_value": 31, "short_display_name": null, "team_id": "8", "uid": "s:20~l:28~t:8", "url": "https://www.espn.com/nfl/team/_/name/det/detroit-lions", "winner": false } ], "event_id": "401872932", "name": null, "neutral_site": false, "season": { "name": null, "type": 2, "year": 2026 }, "short_name": null, "start_time": "2026-09-18T00:15Z", "status": { "category": "final", "clock": null, "completed": true, "description": "Final", "detail": "Final", "display_clock": null, "id": "3", "name": "STATUS_FINAL", "period": null, "short_detail": "Final", "state": "post" }, "time_valid": true, "uid": "s:20~l:28~e:401872932", "url": "https://www.espn.com/nfl/game/_/gameId/401872932/lions-bills", "venue": null, "week": 2 }, "key_plays": [ { "athletes": [], "away_score": 0, "clock": "9:09", "home_score": 7, "id": "401872932317", "period": 1, "score_value": null, "scoring_play": true, "team_id": "2", "text": "Josh Allen 1 Yd Rush (Tyler Bass Kick)", "type": "Rushing Touchdown", "type_id": "68", "wallclock": null }, { "athletes": [], "away_score": 0, "clock": "3:42", "home_score": 14, "id": "401872932640", "period": 1, "score_value": null, "scoring_play": true, "team_id": "2", "text": "Joshua Palmer 43 Yd pass from Josh Allen (Tyler Bass Kick)", "type": "Passing Touchdown", "type_id": "67", "wallclock": null }, { "athletes": [], "away_score": 0, "clock": "11:48", "home_score": 21, "id": "4018729321146", "period": 2, "score_value": null, "scoring_play": true, "team_id": "2", "text": "Dawson Knox 1 Yd pass from Josh Allen (Tyler Bass Kick)", "type": "Passing Touchdown", "type_id": "67", "wallclock": null }, { "athletes": [], "away_score": 7, "clock": "5:03", "home_score": 21, "id": "4018729321523", "period": 2, "score_value": null, "scoring_play": true, "team_id": "8", "text": "Jahmyr Gibbs 11 Yd pass from Jared Goff (Jake Bates Kick)", "type": "Passing Touchdown", "type_id": "67", "wallclock": null }, { "athletes": [], "away_score": 7, "clock": "2:52", "home_score": 27, "id": "4018729321712", "period": 2, "score_value": null, "scoring_play": true, "team_id": "2", "text": "Dalton Kincaid 16 Yd pass from Josh Allen (Tyler Bass PAT Failed)", "type": "Passing Touchdown", "type_id": "67", "wallclock": null }, { "athletes": [], "away_score": 10, "clock": "0:00", "home_score": 27, "id": "4018729322363", "period": 2, "score_value": null, "scoring_play": true, "team_id": "8", "text": "Jake Bates 31 Yd Field Goal", "type": "Field Goal Good", "type_id": "59", "wallclock": null }, { "athletes": [], "away_score": 17, "clock": "9:29", "home_score": 27, "id": "4018729322706", "period": 3, "score_value": null, "scoring_play": true, "team_id": "8", "text": "Amon-Ra St. Brown 2 Yd pass from Jared Goff (Jake Bates Kick)", "type": "Passing Touchdown", "type_id": "67", "wallclock": null }, { "athletes": [], "away_score": 17, "clock": "1:07", "home_score": 34, "id": "4018729323135", "period": 3, "score_value": null, "scoring_play": true, "team_id": "2", "text": "Josh Allen 2 Yd Rush (Tyler Bass Kick)", "type": "Rushing Touchdown", "type_id": "68", "wallclock": null }, { "athletes": [], "away_score": 24, "clock": "10:53", "home_score": 34, "id": "4018729323573", "period": 4, "score_value": null, "scoring_play": true, "team_id": "8", "text": "Sam LaPorta 1 Yd pass from Jared Goff (Jake Bates Kick)", "type": "Passing Touchdown", "type_id": "67", "wallclock": null }, { "athletes": [], "away_score": 24, "clock": "2:50", "home_score": 41, "id": "4018729324101", "period": 4, "score_value": null, "scoring_play": true, "team_id": "2", "text": "James Cook III 1 Yd Rush (Tyler Bass Kick)", "type": "Rushing Touchdown", "type_id": "68", "wallclock": null }, { "athletes": [], "away_score": 31, "clock": "1:42", "home_score": 41, "id": "4018729324330", "period": 4, "score_value": null, "scoring_play": true, "team_id": "8", "text": "Amon-Ra St. Brown 27 Yd pass from Jared Goff (Jake Bates Kick)", "type": "Passing Touchdown", "type_id": "67", "wallclock": null } ], "last_updated": "2026-09-18T03:28:45Z", "league": { "abbreviation": "NFL", "id": "28", "name": "National Football League", "season": null, "slug": "nfl", "uid": "s:20~l:28" }, "observed_at_ms": 1790018154618, "officials": [ { "name": "Derick Bowers", "position": "Down Judge" }, { "name": "Ronald Torbert", "position": "Referee" }, { "name": "Keith Washington", "position": "Side Judge" }, { "name": "Roy Ellison", "position": "Umpire" }, { "name": "Ryan Dickson", "position": "Field Judge" }, { "name": "Thomas Eaton", "position": "Line Judge" }, { "name": "Courtney Brown", "position": "Back Judge" } ], "recap": { "description": "— Forget the official name of the Buffalo Bills' new stadium. It’s Josh Allen’s house.", "headline": "Josh Allen opens the Bills' new stadium with a 5-TD outing in a 41-31 win over the Lions", "published": "2026-09-18T03:39:36Z" }, "sport": "football", "team_statistics": [ { "abbreviation": "DET", "display_name": "Detroit Lions", "home_away": "away", "statistics": [ { "abbreviation": null, "display_value": "24", "label": "1st Downs", "name": "firstDowns", "value": 24 }, { "abbreviation": null, "display_value": "19", "label": "Passing 1st downs", "name": "firstDownsPassing", "value": 19 }, { "abbreviation": null, "display_value": "2", "label": "Rushing 1st downs", "name": "firstDownsRushing", "value": 2 }, { "abbreviation": null, "display_value": "3", "label": "1st downs from penalties", "name": "firstDownsPenalty", "value": 3 }, { "abbreviation": null, "display_value": "4-11", "label": "3rd down efficiency", "name": "thirdDownEff", "value": 0.3636363636 }, { "abbreviation": null, "display_value": "2-2", "label": "4th down efficiency", "name": "fourthDownEff", "value": 1 }, { "abbreviation": null, "display_value": "62", "label": "Total Plays", "name": "totalOffensivePlays", "value": 62 }, { "abbreviation": null, "display_value": "355", "label": "Total Yards", "name": "totalYards", "value": null }, { "abbreviation": null, "display_value": "5.7", "label": "Yards per Play", "name": "yardsPerPlay", "value": 5.7258064516 }, { "abbreviation": null, "display_value": "9", "label": "Total Drives", "name": "totalDrives", "value": 9 }, { "abbreviation": null, "display_value": "289", "label": "Passing", "name": "netPassingYards", "value": 289 }, { "abbreviation": null, "display_value": "26/38", "label": "Comp/Att", "name": "completionAttempts", "value": null }, { "abbreviation": null, "display_value": "6.9", "label": "Yards per pass", "name": "yardsPerPass", "value": 6.880952380952381 }, { "abbreviation": null, "display_value": "0", "label": "Interceptions thrown", "name": "interceptions", "value": 0 }, { "abbreviation": null, "display_value": "4-38", "label": "Sacks-Yards Lost", "name": "sacksYardsLost", "value": null }, { "abbreviation": null, "display_value": "66", "label": "Rushing", "name": "rushingYards", "value": 66 }, { "abbreviation": null, "display_value": "20", "label": "Rushing Attempts", "name": "rushingAttempts", "value": 20 }, { "abbreviation": null, "display_value": "3.3", "label": "Yards per rush", "name": "yardsPerRushAttempt", "value": 3.3 }, { "abbreviation": null, "display_value": "3-4", "label": "Red Zone (Made-Att)", "name": "redZoneAttempts", "value": 0.75 }, { "abbreviation": null, "display_value": "10-58", "label": "Penalties", "name": "totalPenaltiesYards", "value": null }, { "abbreviation": null, "display_value": "0", "label": "Turnovers", "name": "turnovers", "value": null }, { "abbreviation": null, "display_value": "0", "label": "Fumbles lost", "name": "fumblesLost", "value": 0 }, { "abbreviation": null, "display_value": "0", "label": "Interceptions thrown", "name": "interceptions", "value": 0 }, { "abbreviation": null, "display_value": "0", "label": "Defensive / Special Teams TDs", "name": "defensiveTouchdowns", "value": 0 }, { "abbreviation": null, "display_value": "26:15", "label": "Possession", "name": "possessionTime", "value": 1575 } ], "team_id": "8" }, { "abbreviation": "BUF", "display_name": "Buffalo Bills", "home_away": "home", "statistics": [ { "abbreviation": null, "display_value": "34", "label": "1st Downs", "name": "firstDowns", "value": 34 }, { "abbreviation": null, "display_value": "14", "label": "Passing 1st downs", "name": "firstDownsPassing", "value": 14 }, { "abbreviation": null, "display_value": "15", "label": "Rushing 1st downs", "name": "firstDownsRushing", "value": 15 }, { "abbreviation": null, "display_value": "5", "label": "1st downs from penalties", "name": "firstDownsPenalty", "value": 5 }, { "abbreviation": null, "display_value": "9-12", "label": "3rd down efficiency", "name": "thirdDownEff", "value": 0.75 }, { "abbreviation": null, "display_value": "0-0", "label": "4th down efficiency", "name": "fourthDownEff", "value": null }, { "abbreviation": null, "display_value": "69", "label": "Total Plays", "name": "totalOffensivePlays", "value": 69 }, { "abbreviation": null, "display_value": "446", "label": "Total Yards", "name": "totalYards", "value": null }, { "abbreviation": null, "display_value": "6.5", "label": "Yards per Play", "name": "yardsPerPlay", "value": 6.4637681159 }, { "abbreviation": null, "display_value": "9", "label": "Total Drives", "name": "totalDrives", "value": 9 }, { "abbreviation": null, "display_value": "243", "label": "Passing", "name": "netPassingYards", "value": 243 }, { "abbreviation": null, "display_value": "20/31", "label": "Comp/Att", "name": "completionAttempts", "value": null }, { "abbreviation": null, "display_value": "7.4", "label": "Yards per pass", "name": "yardsPerPass", "value": 7.363636363636363 }, { "abbreviation": null, "display_value": "0", "label": "Interceptions thrown", "name": "interceptions", "value": 0 }, { "abbreviation": null, "display_value": "2-5", "label": "Sacks-Yards Lost", "name": "sacksYardsLost", "value": null }, { "abbreviation": null, "display_value": "203", "label": "Rushing", "name": "rushingYards", "value": 203 }, { "abbreviation": null, "display_value": "36", "label": "Rushing Attempts", "name": "rushingAttempts", "value": 36 }, { "abbreviation": null, "display_value": "5.6", "label": "Yards per rush", "name": "yardsPerRushAttempt", "value": 5.639 }, { "abbreviation": null, "display_value": "5-5", "label": "Red Zone (Made-Att)", "name": "redZoneAttempts", "value": 1 }, { "abbreviation": null, "display_value": "5-46", "label": "Penalties", "name": "totalPenaltiesYards", "value": null }, { "abbreviation": null, "display_value": "0", "label": "Turnovers", "name": "turnovers", "value": null }, { "abbreviation": null, "display_value": "0", "label": "Fumbles lost", "name": "fumblesLost", "value": 0 }, { "abbreviation": null, "display_value": "0", "label": "Interceptions thrown", "name": "interceptions", "value": 0 }, { "abbreviation": null, "display_value": "0", "label": "Defensive / Special Teams TDs", "name": "defensiveTouchdowns", "value": 0 }, { "abbreviation": null, "display_value": "33:45", "label": "Possession", "name": "possessionTime", "value": 2025 } ], "team_id": "2" } ], "venue": { "city": "Orchard Park", "country": "USA", "id": "11938", "indoor": null, "name": "Highmark Stadium", "state": "NY" } } ``` ### Leagues - Capability: `sports-data/leagues` - Description: List the sports ESPN's core API exposes (no `sport`) or every league/competition slug within one sport (`sport`), from `sports.core.api.espn.com/v2/sports[/{sport}/leagues]`. Slugs are the stable identifiers every other function takes as `sport`/`league`. Soccer lists ~219 competitions (eng.1, esp.1, ger.1, ita.1, fra.1, usa.1, mex.1, uefa.champions, uefa.europa, fifa.world, ...). One request; ESPN pages at 1000 so the list is complete for every sport observed. An unknown sport is `not_found`. - Instructions: Start here to discover `sport` and `league` slugs before calling scoreboard, teams, standings or search. - Cost: 5 credits per call - Capability file: [Leagues](https://firecrawl.dev/alexandria/agents/providers/espn-com/sports-data/leagues) Accepted options: - `sport` (string): ESPN sport slug, e.g. football, soccer, basketball, baseball, hockey (from `leagues` without `sport`). Pattern: ^[a-z][a-z0-9-]*$. Example: `` Response schema example: ```json { "count": 17, "items": [ { "api_url": "https://sports.core.api.espn.com/v2/sports/australian-football?lang=en®ion=us", "kind": "sport", "slug": "australian-football", "sport": "australian-football" }, { "api_url": "https://sports.core.api.espn.com/v2/sports/baseball?lang=en®ion=us", "kind": "sport", "slug": "baseball", "sport": "baseball" }, { "api_url": "https://sports.core.api.espn.com/v2/sports/basketball?lang=en®ion=us", "kind": "sport", "slug": "basketball", "sport": "basketball" }, { "api_url": "https://sports.core.api.espn.com/v2/sports/cricket?lang=en®ion=us", "kind": "sport", "slug": "cricket", "sport": "cricket" }, { "api_url": "https://sports.core.api.espn.com/v2/sports/field-hockey?lang=en®ion=us", "kind": "sport", "slug": "field-hockey", "sport": "field-hockey" }, { "api_url": "https://sports.core.api.espn.com/v2/sports/football?lang=en®ion=us", "kind": "sport", "slug": "football", "sport": "football" }, { "api_url": "https://sports.core.api.espn.com/v2/sports/golf?lang=en®ion=us", "kind": "sport", "slug": "golf", "sport": "golf" }, { "api_url": "https://sports.core.api.espn.com/v2/sports/hockey?lang=en®ion=us", "kind": "sport", "slug": "hockey", "sport": "hockey" }, { "api_url": "https://sports.core.api.espn.com/v2/sports/lacrosse?lang=en®ion=us", "kind": "sport", "slug": "lacrosse", "sport": "lacrosse" }, { "api_url": "https://sports.core.api.espn.com/v2/sports/mma?lang=en®ion=us", "kind": "sport", "slug": "mma", "sport": "mma" }, { "api_url": "https://sports.core.api.espn.com/v2/sports/racing?lang=en®ion=us", "kind": "sport", "slug": "racing", "sport": "racing" }, { "api_url": "https://sports.core.api.espn.com/v2/sports/rugby?lang=en®ion=us", "kind": "sport", "slug": "rugby", "sport": "rugby" }, { "api_url": "https://sports.core.api.espn.com/v2/sports/rugby-league?lang=en®ion=us", "kind": "sport", "slug": "rugby-league", "sport": "rugby-league" }, { "api_url": "https://sports.core.api.espn.com/v2/sports/soccer?lang=en®ion=us", "kind": "sport", "slug": "soccer", "sport": "soccer" }, { "api_url": "https://sports.core.api.espn.com/v2/sports/tennis?lang=en®ion=us", "kind": "sport", "slug": "tennis", "sport": "tennis" }, { "api_url": "https://sports.core.api.espn.com/v2/sports/volleyball?lang=en®ion=us", "kind": "sport", "slug": "volleyball", "sport": "volleyball" }, { "api_url": "https://sports.core.api.espn.com/v2/sports/water-polo?lang=en®ion=us", "kind": "sport", "slug": "water-polo", "sport": "water-polo" } ], "observed_at_ms": 1790018125435, "page": 1, "page_count": 1, "sport": null, "total": 17 } ``` ### Player - Capability: `sports-data/player` - Description: One athlete's public profile from `site.web.api.espn.com/apis/common/v3/sports/{sport}/{league}/athletes/{athlete_id}` (identity, position, current team, status, age, birth date/place, height, weight, experience, draft, college, headshot) and, unless `include_statistics` is false, career statistics by season from `.../athletes/{athlete_id}/stats`: ESPN's categories with labels, stat names, display names, per-season rows (team, position, values as ESPN prints them) and career totals. Stat names and units are sport-specific and kept verbatim; a player without a statistics page keeps `statistics: null` with a warning. An unknown athlete_id is `not_found`. - Instructions: Read a player's bio and season-by-season statistics after finding the athlete_id in roster or search. - Cost: 5 credits per call - Capability file: [Player](https://firecrawl.dev/alexandria/agents/providers/espn-com/sports-data/player) Accepted options: - `athlete_id` (string, required): ESPN athlete id (from roster / search / event key plays). Pattern: ^[0-9]+$. Example: `` - `include_statistics` (boolean): include_statistics Example: `false` - `league` (string, required): ESPN league slug within the sport, e.g. nfl, college-football, eng.1, uefa.champions, fifa.world, nba, mlb, nhl (from `leagues`). Pattern: ^[a-z0-9][a-z0-9._-]*$. Example: `` - `sport` (string, required): ESPN sport slug, e.g. football, soccer, basketball, baseball, hockey (from `leagues` without `sport`). Pattern: ^[a-z][a-z0-9-]*$. Example: `` Response schema example: ```json { "athlete": { "active": true, "age": 31, "athlete_id": "3139477", "birth_place": "Whitehouse, TX", "citizenship": null, "college": "Texas Tech", "date_of_birth": "9/17/1995", "debut_year": 2017, "display_name": "Patrick Mahomes", "draft": "2017: Rd 1, Pk 10 (KC)", "experience": "10th Season", "first_name": "Patrick", "full_name": "Patrick Mahomes", "guid": "37d87523-280a-9d4a-0adb-22cfc6d3619c", "headshot": "https://a.espncdn.com/i/headshots/nfl/players/full/3139477.png", "height": "6' 2\"", "jersey": "15", "last_name": "Mahomes", "position": { "abbreviation": "QB", "display_name": "Quarterback", "id": "8", "name": "Quarterback" }, "status": "Active", "team": { "abbreviation": "KC", "display_name": "Kansas City Chiefs", "location": "Kansas City", "slug": "kansas-city-chiefs", "team_id": "12", "uid": "s:20~l:28~t:12", "url": "https://www.espn.com/nfl/team/_/name/kc/kansas-city-chiefs" }, "uid": "s:20~l:28~a:3139477", "url": "https://www.espn.com/nfl/player/_/id/3139477/patrick-mahomes", "weight": "225 lbs" }, "league": { "id": "28", "name": "National Football League", "slug": "nfl" }, "observed_at_ms": 1790018267623, "season": { "name": "Regular Season", "type": 2, "year": 2026 }, "sport": "football", "statistics": { "categories": [ { "descriptions": [ "Games Played", "The times a player completes a pass to another player who is eligible to catch a pass.", "The number of times a pass is attempted.", "The percentage of completed passes.", "The total passing yards.", "The average number yards per pass attempt.", "The total number of passing touchdowns.", "The number of passes thrown that were intercepted by the opposing team.", "The longest pass play completed in terms of yards.", "The total number of sacks.", "Passer Rating", "Adjusted Quarterback Rating." ], "display_name": "Passing", "display_names": [ "Games Played", "Completions", "Passing Attempts", "Completion Percentage", "Passing Yards", "Yards Per Pass Attempt", "Passing Touchdowns", "Interceptions", "Longest Pass", "Total Sacks", "Passer Rating", "Adjusted QBR" ], "labels": [ "GP", "CMP", "ATT", "CMP%", "YDS", "AVG", "TD", "INT", "LNG", "SACK", "RTG", "QBR" ], "name": "passing", "names": [ "gamesPlayed", "completions", "passingAttempts", "completionPct", "passingYards", "yardsPerPassAttempt", "passingTouchdowns", "interceptions", "longPassing", "sacks", "QBRating", "adjQBR" ], "seasons": [ { "position": "QB", "season_name": "2017", "season_year": 2017, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "1", "22", "35", "62.9", "284", "8.1", "0", "1", "51", "2", "76.4", "66.8" ] }, { "position": "QB", "season_name": "2018", "season_year": 2018, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "16", "383", "580", "66.0", "5,097", "8.8", "50", "12", "89", "26", "113.8", "80.3" ] }, { "position": "QB", "season_name": "2019", "season_year": 2019, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "14", "319", "484", "65.9", "4,031", "8.3", "26", "5", "83", "17", "105.3", "77.7" ] }, { "position": "QB", "season_name": "2020", "season_year": 2020, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "15", "390", "588", "66.3", "4,740", "8.1", "38", "6", "75", "22", "108.2", "78.1" ] }, { "position": "QB", "season_name": "2021", "season_year": 2021, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "17", "436", "658", "66.3", "4,839", "7.4", "37", "13", "75", "28", "98.5", "67.7" ] }, { "position": "QB", "season_name": "2022", "season_year": 2022, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "17", "435", "648", "67.1", "5,250", "8.1", "41", "12", "67", "26", "105.2", "79.0" ] }, { "position": "QB", "season_name": "2023", "season_year": 2023, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "16", "401", "597", "67.2", "4,183", "7.0", "27", "14", "67", "27", "92.6", "63.9" ] }, { "position": "QB", "season_name": "2024", "season_year": 2024, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "16", "392", "581", "67.5", "3,928", "6.8", "26", "11", "54", "36", "93.5", "64.6" ] }, { "position": "QB", "season_name": "2025", "season_year": 2025, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "14", "315", "502", "62.7", "3,587", "7.1", "22", "11", "61", "34", "89.6", "68.5" ] }, { "position": "QB", "season_name": "2026", "season_year": 2026, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "2", "47", "74", "63.5", "566", "7.6", "5", "1", "59", "4", "103.8", "70.4" ] } ], "totals": [ "128", "3140", "4747", "66.1", "36,505", "7.7", "272", "86", "89", "222", "100.8", "-" ] }, { "descriptions": [ "Games Played", "The total number of attempted rushes.", "The total rushing yards.", "The average number of yards per rush attempt.", "The total number of rushing touchdowns.", "The amount of yards for the longest run.", "The number of times a first down is picked up by a run.", "The number of times there is a run and then the ball is fumbled.", "The number of times there is a run and then the ball is fumbled." ], "display_name": "Rushing", "display_names": [ "Games Played", "Rushing Attempts", "Rushing Yards", "Yards Per Rush Attempt", "Rushing Touchdowns", "Long Rushing", "Rushing 1st downs", "Rushing Fumbles", "Rushing Fumbles Lost" ], "labels": [ "GP", "CAR", "YDS", "AVG", "TD", "LNG", "FD", "FUM", "LST" ], "name": "rushing", "names": [ "gamesPlayed", "rushingAttempts", "rushingYards", "yardsPerRushAttempt", "rushingTouchdowns", "longRushing", "rushingFirstDowns", "rushingFumbles", "rushingFumblesLost" ], "seasons": [ { "position": "QB", "season_name": "2017", "season_year": 2017, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "1", "7", "10", "1.4", "0", "5", "0", "0", "0" ] }, { "position": "QB", "season_name": "2018", "season_year": 2018, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "16", "60", "272", "4.5", "2", "28", "18", "2", "0" ] }, { "position": "QB", "season_name": "2019", "season_year": 2019, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "14", "43", "218", "5.1", "2", "25", "15", "1", "0" ] }, { "position": "QB", "season_name": "2020", "season_year": 2020, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "15", "62", "308", "5.0", "2", "24", "21", "2", "0" ] }, { "position": "QB", "season_name": "2021", "season_year": 2021, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "17", "66", "381", "5.8", "2", "32", "25", "4", "2" ] }, { "position": "QB", "season_name": "2022", "season_year": 2022, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "17", "61", "358", "5.9", "4", "20", "25", "5", "0" ] }, { "position": "QB", "season_name": "2023", "season_year": 2023, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "16", "75", "389", "5.2", "0", "25", "27", "1", "0" ] }, { "position": "QB", "season_name": "2024", "season_year": 2024, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "16", "58", "307", "5.3", "2", "33", "22", "1", "0" ] }, { "position": "QB", "season_name": "2025", "season_year": 2025, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "14", "64", "422", "6.6", "5", "22", "27", "0", "0" ] }, { "position": "QB", "season_name": "2026", "season_year": 2026, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "2", "9", "40", "4.4", "1", "15", "3", "0", "0" ] } ], "totals": [ "128", "505", "2,705", "5.4", "20", "33", "183", "16", "2" ] }, { "descriptions": [ "Games Played", "The total number of receptions.", "The number of times a receiver is thrown to.", "The total receiving yards.", "The average number of yards per reception.", "The total number of receiving touchdowns.", "The amount of yards for the longest reception.", "The number of times a first down is picked up by a reception.", "The number of times a reception is made and then the ball is fumbled.", "The number of times a reception is made and the balled is fumbled and recovered by the opposing team." ], "display_name": "Receiving", "display_names": [ "Games Played", "Receptions", "Receiving Targets", "Receiving Yards", "Yards Per Reception", "Receiving Touchdowns", "Long Reception", "Receiving First Downs", "Receiving Fumbles", "Receiving Fumbles Lost" ], "labels": [ "GP", "REC", "TGTS", "YDS", "AVG", "TD", "LNG", "FD", "FUM", "LST" ], "name": "receiving", "names": [ "gamesPlayed", "receptions", "receivingTargets", "receivingYards", "yardsPerReception", "receivingTouchdowns", "longReception", "receivingFirstDowns", "receivingFumbles", "receivingFumblesLost" ], "seasons": [ { "position": "QB", "season_name": "2020", "season_year": 2020, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "15", "0", "2", "0", "0.0", "0", "0", "0", "0", "0" ] }, { "position": "QB", "season_name": "2022", "season_year": 2022, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "17", "1", "1", "6", "6.0", "0", "6", "0", "0", "0" ] }, { "position": "QB", "season_name": "2024", "season_year": 2024, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "16", "1", "1", "2", "2.0", "0", "2", "0", "0", "0" ] }, { "position": "QB", "season_name": "2025", "season_year": 2025, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "14", "1", "1", "-10", "-10.0", "0", "-10", "0", "0", "0" ] }, { "position": "QB", "season_name": "2026", "season_year": 2026, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "2", "0", "1", "0", "0.0", "0", "0", "0", "0", "0" ] } ], "totals": [ "128", "3", "6", "-2", "-0.7", "0", "6", "0", "0", "0" ] }, { "descriptions": [ "Games Played", "The total number of tackles.", "The number of times a tackle was made unassisted.", "The number of assists on tackles.", "The total number of sacks.", "The total number of forced fumbles.", "The number of fumbles recovered.", "The number of yards gained after a fumble is recovered.", "The total number of interceptions.", "The number of yards gained after an interception.", "The average number of return yards per interception.", "The number of times an interception is returned for a touchdown.", "The amount of yards of the longest interception return.", "The total number of passes defended.", "The number of times that a runner is stuffed at or behind the line of scrimmage.", "The number of yards lost from stuffs.", "The number of times a kick was blocked." ], "display_name": "Defense", "display_names": [ "Games Played", "Total Tackles", "Solo Tackles", "Assist Tackles", "Sacks", "Forced Fumbles", "Fumbles Recovered", "Fumbles Recovered Yards", "Interceptions", "Interception Yards", "Average Interception Yards", "Interception Touchdowns", "Long Interception", "Passes Defended", "Stuffs", "Stuff Yards", "Kicks Blocked" ], "labels": [ "GP", "TOT", "SOLO", "AST", "SACK", "FF", "FR", "YDS", "INT", "YDS", "AVG", "TD", "LNG", "PD", "STF", "STFYDS", "KB" ], "name": "defensive", "names": [ "gamesPlayed", "totalTackles", "soloTackles", "assistTackles", "sacks", "fumblesForced", "fumblesRecovered", "fumblesRecoveredYards", "interceptions", "interceptionYards", "avgInterceptionYards", "interceptionTouchdowns", "longInterception", "passesDefended", "stuffs", "stuffYards", "kicksBlocked" ], "seasons": [ { "position": "QB", "season_name": "2020", "season_year": 2020, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "15", "3", "2", "1", "0", "0", "0", "0", "0", "0", "0.0", "0", "0", "0", "0", "0", "0" ] }, { "position": "QB", "season_name": "2021", "season_year": 2021, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "17", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0.0", "0", "0", "0", "0", "0", "0" ] }, { "position": "QB", "season_name": "2022", "season_year": 2022, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "17", "2", "1", "1", "0", "0", "0", "0", "0", "0", "0.0", "0", "0", "0", "0", "0", "0" ] }, { "position": "QB", "season_name": "2023", "season_year": 2023, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "16", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0.0", "0", "0", "0", "0", "0", "0" ] }, { "position": "QB", "season_name": "2025", "season_year": 2025, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "14", "1", "1", "0", "0", "0", "0", "0", "0", "0", "0.0", "0", "0", "0", "0", "0", "0" ] }, { "position": "QB", "season_name": "2026", "season_year": 2026, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "2", "0", "0", "0", "0", "0", "2", "0", "0", "0", "0.0", "0", "0", "0", "0", "0", "0" ] } ], "totals": [ "128", "8", "6", "2", "0", "0", "2", "0", "0", "0", "0.0", "0", "0", "0", "0", "0", "0" ] }, { "descriptions": [ "Games Played", "The total number of passing touchdowns.", "The total number of rushing touchdowns.", "The total number of receiving touchdowns.", "The total number of return touchdowns.", "The number of touchdowns scored in total.", "The number of times a 2-point conversion is successful.", "The number of extra points made.", "The number of field goals made.", "The number of total points scored." ], "display_name": "Scoring", "display_names": [ "Games Played", "Passing Touchdowns", "Rushing Touchdowns", "Receiving Touchdowns", "Return Touchdowns", "Total Touchdowns", "Total Two Point Conversions", "Kick Extra Points", "Field Goals", "Total Points" ], "labels": [ "GP", "PASS", "RUSH", "REC", "RET", "TD", "2PT", "PAT", "FG", "PTS" ], "name": "scoring", "names": [ "gamesPlayed", "passingTouchdowns", "rushingTouchdowns", "receivingTouchdowns", "returnTouchdowns", "totalTouchdowns", "totalTwoPointConvs", "kickExtraPoints", "fieldGoals", "totalPoints" ], "seasons": [ { "position": "QB", "season_name": "2018", "season_year": 2018, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "16", "50", "2", "0", "0", "2", "1", "0", "0", "14" ] }, { "position": "QB", "season_name": "2019", "season_year": 2019, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "14", "26", "2", "0", "0", "2", "0", "0", "0", "12" ] }, { "position": "QB", "season_name": "2020", "season_year": 2020, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "15", "39", "2", "0", "0", "2", "0", "0", "0", "12" ] }, { "position": "QB", "season_name": "2021", "season_year": 2021, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "17", "37", "2", "0", "0", "2", "1", "0", "0", "14" ] }, { "position": "QB", "season_name": "2022", "season_year": 2022, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "17", "41", "4", "0", "0", "4", "1", "0", "0", "26" ] }, { "position": "QB", "season_name": "2023", "season_year": 2023, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "16", "27", "0", "0", "0", "0", "0", "0", "0", "0" ] }, { "position": "QB", "season_name": "2024", "season_year": 2024, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "16", "26", "2", "0", "0", "2", "0", "0", "0", "12" ] }, { "position": "QB", "season_name": "2025", "season_year": 2025, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "14", "22", "5", "0", "0", "5", "0", "0", "0", "30" ] }, { "position": "QB", "season_name": "2026", "season_year": 2026, "team_id": "12", "team_slug": "kansas-city-chiefs", "values": [ "2", "5", "1", "0", "0", "1", "0", "0", "0", "6" ] } ], "totals": [ "128", "273", "20", "0", "0", "20", "3", "0", "0", "126" ] } ], "glossary": [ { "abbreviation": "1-19\t", "displayName": "FGM 1-19 yards" }, { "abbreviation": "20-29\t", "displayName": "FGM 20-29 yards" }, { "abbreviation": "2PT", "displayName": "Total Two Point Conversions" }, { "abbreviation": "30-39", "displayName": "FGM 30-39 yards" }, { "abbreviation": "40-49\t", "displayName": "FGM 40-49 yards" }, { "abbreviation": "50+", "displayName": "FGM 50+ yards" }, { "abbreviation": "AST", "displayName": "Assist Tackles" }, { "abbreviation": "ATT", "displayName": "Passing Attempts" }, { "abbreviation": "AVG", "displayName": "Yards Per Pass Attempt" }, { "abbreviation": "CAR", "displayName": "Rushing Attempts" }, { "abbreviation": "CMP", "displayName": "Completions" }, { "abbreviation": "CMP%", "displayName": "Completion Percentage" }, { "abbreviation": "FC", "displayName": "Punt Return Fair Catches" }, { "abbreviation": "FD", "displayName": "Rushing 1st downs" }, { "abbreviation": "FF", "displayName": "Forced Fumbles" }, { "abbreviation": "FG", "displayName": "Field Goals" }, { "abbreviation": "FG%", "displayName": "Field Goal Percentage" }, { "abbreviation": "FR", "displayName": "Fumbles Recovered" }, { "abbreviation": "FUM", "displayName": "Rushing Fumbles" }, { "abbreviation": "GP", "displayName": "Games Played" }, { "abbreviation": "IN20", "displayName": "Punts Inside 20" }, { "abbreviation": "IN20%", "displayName": "Punts Inside 20 Percentage" }, { "abbreviation": "INT", "displayName": "Interceptions" }, { "abbreviation": "KB", "displayName": "Kicks Blocked" }, { "abbreviation": "KRFC", "displayName": "Kick Return Fair Catches" }, { "abbreviation": "LNG", "displayName": "Longest Pass" }, { "abbreviation": "LST", "displayName": "Rushing Fumbles Lost" }, { "abbreviation": "NET", "displayName": "Net Average Punt Yards" }, { "abbreviation": "PASS", "displayName": "Passing Touchdowns" }, { "abbreviation": "PAT", "displayName": "Kick Extra Points" }, { "abbreviation": "PD", "displayName": "Passes Defended" }, { "abbreviation": "PTS", "displayName": "Total Points" }, { "abbreviation": "PUNTS", "displayName": "Punts" }, { "abbreviation": "QBR", "displayName": "Adjusted QBR" }, { "abbreviation": "REC", "displayName": "Receptions" }, { "abbreviation": "RET", "displayName": "Return Touchdowns" }, { "abbreviation": "RTG", "displayName": "Passer Rating" }, { "abbreviation": "RUSH", "displayName": "Rushing Touchdowns" }, { "abbreviation": "SACK", "displayName": "Total Sacks" }, { "abbreviation": "SOLO", "displayName": "Solo Tackles" }, { "abbreviation": "STF", "displayName": "Stuffs" }, { "abbreviation": "STFYDS", "displayName": "Stuff Yards" }, { "abbreviation": "TB", "displayName": "Touchbacks" }, { "abbreviation": "TB%", "displayName": "Touchback Percentage" }, { "abbreviation": "TD", "displayName": "Passing Touchdowns" }, { "abbreviation": "TGTS", "displayName": "Receiving Targets" }, { "abbreviation": "TOT", "displayName": "Total Tackles" }, { "abbreviation": "XPA", "displayName": "Extra Point Attempts" }, { "abbreviation": "XPM", "displayName": "Extra Points Made" }, { "abbreviation": "YDS", "displayName": "Passing Yards" } ], "season_type": "2" } } ``` ### Roster - Capability: `sports-data/roster` - Description: A team's current roster from `site.api.espn.com/apis/site/v2/sports/{sport}/{league}/teams/{team_id}/roster`, flattened to one player list (NFL unit groups such as offense/defense/practiceSquad become `group`) in a bounded window (`offset`/`limit`, default 100) with `next_offset`: athlete_id, names, jersey, position, age, date of birth, height/weight (raw inches/pounds and display), birthplace, citizenship (soccer), college and experience (NFL), status, injuries, headshot, player URL; plus coaches and season. An unknown team_id is `not_found`. - Instructions: Get athlete_id values and roster details for a team; feed athlete_id to `player`. - Cost: 5 credits per call - Capability file: [Roster](https://firecrawl.dev/alexandria/agents/providers/espn-com/sports-data/roster) Accepted options: - `league` (string, required): ESPN league slug within the sport, e.g. nfl, college-football, eng.1, uefa.champions, fifa.world, nba, mlb, nhl (from `leagues`). Pattern: ^[a-z0-9][a-z0-9._-]*$. Example: `` - `limit` (number): Page size (default 100, max 200). Example: `100` - `offset` (number): Zero-based offset into the full upstream list. Example: `0` - `sport` (string, required): ESPN sport slug, e.g. football, soccer, basketball, baseball, hockey (from `leagues` without `sport`). Pattern: ^[a-z][a-z0-9-]*$. Example: `` - `team_id` (string, required): ESPN team id. Pattern: ^[0-9]+$. Example: `` Response schema example: ```json { "coaches": [ { "experience": null, "first_name": "Arsene", "id": "5", "last_name": "Wenger" } ], "count": 5, "groups": [], "league": "eng.1", "limit": 5, "next_offset": 5, "observed_at_ms": 1790018251888, "offset": 0, "players": [ { "age": 31, "athlete_id": "169532", "birth_place": null, "citizenship": "Spain", "college": null, "date_of_birth": "1994-10-03T07:00Z", "debut_year": null, "display_name": "Kepa Arrizabalaga", "experience_years": null, "first_name": "Kepa", "full_name": "Kepa Arrizabalaga", "group": null, "headshot": null, "height": "6' 2\"", "height_in": 74, "injuries": [], "jersey": "13", "last_name": "Arrizabalaga", "position": { "abbreviation": "G", "display_name": "Goalkeeper", "id": "1", "name": "Goalkeeper" }, "short_name": "K. Arrizabalaga", "status": "Active", "uid": "s:600~a:169532", "url": "https://www.espn.com/soccer/player/_/id/169532/kepa-arrizabalaga", "weight": "183 lbs", "weight_lb": 183 }, { "age": 31, "athlete_id": "196176", "birth_place": null, "citizenship": "Spain", "college": null, "date_of_birth": "1995-09-15T07:00Z", "debut_year": null, "display_name": "David Raya", "experience_years": null, "first_name": "David", "full_name": "David Raya", "group": null, "headshot": null, "height": "6' 0\"", "height_in": 72, "injuries": [], "jersey": "1", "last_name": "Raya", "position": { "abbreviation": "G", "display_name": "Goalkeeper", "id": "1", "name": "Goalkeeper" }, "short_name": "D. Raya", "status": "Active", "uid": "s:600~a:196176", "url": "https://www.espn.com/soccer/player/_/id/196176/david-raya", "weight": "174 lbs", "weight_lb": 174 }, { "age": 26, "athlete_id": "265921", "birth_place": null, "citizenship": "France", "college": null, "date_of_birth": "2000-03-02T08:00Z", "debut_year": null, "display_name": "Illan Meslier", "experience_years": null, "first_name": "Illan", "full_name": "Illan Meslier", "group": null, "headshot": null, "height": "6' 6\"", "height_in": 78, "injuries": [], "jersey": "30", "last_name": "Meslier", "position": { "abbreviation": "G", "display_name": "Goalkeeper", "id": "1", "name": "Goalkeeper" }, "short_name": "I. Meslier", "status": "Active", "uid": "s:600~a:265921", "url": "https://www.espn.com/soccer/player/_/id/265921/illan-meslier", "weight": "161 lbs", "weight_lb": 161 }, { "age": 28, "athlete_id": "231859", "birth_place": null, "citizenship": "England", "college": null, "date_of_birth": "1997-10-23T07:00Z", "debut_year": null, "display_name": "Ezri Konsa", "experience_years": null, "first_name": "Ezri", "full_name": "Ezri Konsa", "group": null, "headshot": null, "height": "6' 0\"", "height_in": 72, "injuries": [], "jersey": "15", "last_name": "Konsa", "position": { "abbreviation": "D", "display_name": "Defender", "id": "2", "name": "Defender" }, "short_name": "E. Konsa", "status": "Active", "uid": "s:600~a:231859", "url": "https://www.espn.com/soccer/player/_/id/231859/ezri-konsa", "weight": "168 lbs", "weight_lb": 168 }, { "age": 28, "athlete_id": "236322", "birth_place": null, "citizenship": "Brazil", "college": null, "date_of_birth": "1997-12-19T08:00Z", "debut_year": null, "display_name": "Gabriel Magalhães", "experience_years": null, "first_name": "Gabriel", "full_name": "Gabriel Magalhães", "group": null, "headshot": null, "height": "6' 3\"", "height_in": 75, "injuries": [], "jersey": "6", "last_name": "Magalhães", "position": { "abbreviation": "D", "display_name": "Defender", "id": "2", "name": "Defender" }, "short_name": "G. Magalhães", "status": "Active", "uid": "s:600~a:236322", "url": "https://www.espn.com/soccer/player/_/id/236322/gabriel-magalhaes", "weight": "203 lbs", "weight_lb": 203 } ], "season": { "name": "2026-27 English Premier League", "type": 14308, "year": 2026 }, "sport": "soccer", "team": { "abbreviation": "ARS", "display_name": "Arsenal", "location": "Arsenal", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/359.png", "name": "Arsenal", "record_summary": "4-0-1", "season_summary": "2026-27", "standing_summary": "2nd in English Premier League", "team_id": "359", "url": "https://www.espn.com/soccer/club/_/id/359/arsenal" }, "total": 27 } ``` ### Scoreboard - Capability: `sports-data/scoreboard` - Description: Events for one league on one date (`date`, YYYYMMDD, ESPN's US-Eastern day) or, for week-based leagues such as the NFL and college football, one week (`season` + `seasontype` + `week`), from `site.api.espn.com/apis/site/v2/sports/{sport}/{league}/scoreboard`. Each event carries ESPN's event_id, UTC start time, the status type (STATUS_SCHEDULED / STATUS_IN_PROGRESS / STATUS_FINAL / STATUS_FULL_TIME / STATUS_POSTPONED / ...) with a derived `category`, venue, broadcasts and both competitors with score (null before kickoff), winner flag and records. Without `date` ESPN returns its current day/week. `groups` bounds college football (80 = FBS) and `limit` caps the count (partial coverage when hit). An empty list is a legitimate day without events. An unknown league is `not_found`. - Instructions: Find schedules, live and completed scores for a league and day, and the event_id for `event`. - Cost: 5 credits per call - Capability file: [Scoreboard](https://firecrawl.dev/alexandria/agents/providers/espn-com/sports-data/scoreboard) Accepted options: - `date` (string): Day as YYYYMMDD. Mutually exclusive with `season`. Pattern: ^[0-9]{8}$. Example: `` - `groups` (string): ESPN group id filter (college football: 80 FBS, 81 FCS; conference ids). Pattern: ^[0-9]+$. Example: `` - `league` (string, required): ESPN league slug within the sport, e.g. nfl, college-football, eng.1, uefa.champions, fifa.world, nba, mlb, nhl (from `leagues`). Pattern: ^[a-z0-9][a-z0-9._-]*$. Example: `` - `limit` (number): limit Example: `10` - `season` (number): Season start year, for week-based lookups together with `seasontype` and `week`. Example: `1900` - `seasontype` (number): 1 preseason, 2 regular season, 3 postseason (NFL / college football). Example: `9` - `sport` (string, required): ESPN sport slug, e.g. football, soccer, basketball, baseball, hockey (from `leagues` without `sport`). Pattern: ^[a-z][a-z0-9-]*$. Example: `` - `week` (number): week Example: `10` Response schema example: ```json { "count": 2, "count_by_status": { "final": 2 }, "date": "20260913", "day": null, "events": [ { "attendance": 31492, "broadcasts": [ "USA Net" ], "competitors": [ { "abbreviation": "COV", "display_name": "Coventry City", "form": "WLLLL", "home_away": "home", "location": "Coventry City", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/388.png", "order": 0, "rank": null, "records": [ { "name": "All Splits", "summary": "0-0-4", "type": "total" } ], "score": "0", "score_value": 0, "short_display_name": "Coventry", "team_id": "388", "uid": "s:600~t:388", "url": "https://www.espn.com/soccer/club/_/id/388/coventry-city", "winner": false }, { "abbreviation": "BHA", "display_name": "Brighton & Hove Albion", "form": "WWWDL", "home_away": "away", "location": "Brighton & Hove Albion", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/331.png", "order": 1, "rank": null, "records": [ { "name": "All Splits", "summary": "2-1-1", "type": "total" } ], "score": "5", "score_value": 5, "short_display_name": "Brighton", "team_id": "331", "uid": "s:600~t:331", "url": "https://www.espn.com/soccer/club/_/id/331/brighton-hove-albion", "winner": true } ], "event_id": "401879282", "name": "Brighton & Hove Albion at Coventry City", "neutral_site": null, "season": { "name": "2026-27-english-premier-league", "type": 14308, "year": 2026 }, "short_name": "BHA @ COV", "start_time": "2026-09-13T13:00Z", "status": { "category": "final", "clock": 5400, "completed": true, "description": "Full Time", "detail": "FT", "display_clock": "90'+6'", "id": "28", "name": "STATUS_FULL_TIME", "period": 2, "short_detail": "FT", "state": "post" }, "time_valid": true, "uid": "s:600~l:700~e:401879282", "url": "https://www.espn.com/soccer/match/_/gameId/401879282/brighton-hove-albion-coventry-city", "venue": { "city": "Coventry", "country": "England", "id": "1680", "indoor": null, "name": "Coventry Building Society Arena", "state": null }, "week": null }, { "attendance": 74161, "broadcasts": [ "NBCSN", "Peacock", "Tele" ], "competitors": [ { "abbreviation": "MAN", "display_name": "Manchester United", "form": "DLLWD", "home_away": "home", "location": "Manchester United", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/360.png", "order": 0, "rank": null, "records": [ { "name": "All Splits", "summary": "1-1-2", "type": "total" } ], "score": "0", "score_value": 0, "short_display_name": "Man United", "team_id": "360", "uid": "s:600~t:360", "url": "https://www.espn.com/soccer/club/_/id/360/manchester-united", "winner": false }, { "abbreviation": "MNC", "display_name": "Manchester City", "form": "WWWWW", "home_away": "away", "location": "Manchester City", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/382.png", "order": 1, "rank": null, "records": [ { "name": "All Splits", "summary": "4-0-0", "type": "total" } ], "score": "1", "score_value": 1, "short_display_name": "Man City", "team_id": "382", "uid": "s:600~t:382", "url": "https://www.espn.com/soccer/club/_/id/382/manchester-city", "winner": true } ], "event_id": "401879278", "name": "Manchester City at Manchester United", "neutral_site": null, "season": { "name": "2026-27-english-premier-league", "type": 14308, "year": 2026 }, "short_name": "MNC @ MAN", "start_time": "2026-09-13T15:30Z", "status": { "category": "final", "clock": 5400, "completed": true, "description": "Full Time", "detail": "FT", "display_clock": "90'+6'", "id": "28", "name": "STATUS_FULL_TIME", "period": 2, "short_detail": "FT", "state": "post" }, "time_valid": true, "uid": "s:600~l:700~e:401879278", "url": "https://www.espn.com/soccer/match/_/gameId/401879278/manchester-city-manchester-united", "venue": { "city": "Manchester", "country": "England", "id": "250", "indoor": null, "name": "Old Trafford", "state": null }, "week": null } ], "league": { "abbreviation": "Premier League", "id": "700", "name": "English Premier League", "season": { "end_date": "2027-06-01T03:59Z", "name": "2026-27 English Premier League", "start_date": "2026-06-01T04:00Z", "type": 14308, "type_id": "1", "year": 2026 }, "slug": "eng.1", "uid": "s:600~l:700" }, "observed_at_ms": 1790018146971, "sport": "soccer", "week": null } ``` ### Search - Capability: `sports-data/search` - Description: ESPN site search from `site.web.api.espn.com/apis/search/v2`: results grouped by type (player, team, league, article, clips, ...) with ESPN's totals, each item with display name, subtitle, sport, default league slug, web URL and the ids decoded from ESPN's uid (`s:600~t:359` = sport 600, team 359; `s:20~l:28~a:3139477` = NFL athlete). Restrict with `type` (player, team, league, article). A query with no matches returns empty groups. - Instructions: Resolve a team or player name to ESPN ids and the league slug to use with team, roster, player. - Cost: 5 credits per call - Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/espn-com/sports-data/search) Accepted options: - `limit` (number): limit Example: `10` - `query` (string, required): query Example: `` - `type` (string): Restrict to one result type. Example: `player` Response schema example: ```json { "groups": [ { "count": 4, "display_name": "Teams", "limit": 5, "page": 1, "results": [ { "athlete_id": null, "date": null, "default_league_slug": "eng.1", "description": null, "display_name": "Arsenal", "id": "feb44e87-58fa-9597-2691-b3c32768ebe4", "image": "https://a.espncdn.com/i/teamlogos/soccer/500/359.png", "league_id": null, "sport": "soccer", "sport_id": "600", "subtitle": "Premier League", "team_id": "359", "type": "team", "uid": "s:600~t:359", "web_url": "https://www.espn.com/soccer/club/_/id/359/arsenal" }, { "athlete_id": null, "date": null, "default_league_slug": "eng.w.1", "description": null, "display_name": "Arsenal", "id": "b01601fc-ede7-63f6-b94b-f08b2f98b476", "image": "https://a.espncdn.com/i/teamlogos/soccer/500/19973.png", "league_id": null, "sport": "soccer", "sport_id": "600", "subtitle": "Women's Super League", "team_id": "19973", "type": "team", "uid": "s:600~t:19973", "web_url": "https://www.espn.com/soccer/club/_/id/19973/arsenal" }, { "athlete_id": null, "date": null, "default_league_slug": "eng.trophy", "description": null, "display_name": "Arsenal U21", "id": "b02bfad3-434e-594c-c433-88a8e6393197", "image": "https://a.espncdn.com/i/teamlogos/soccer/500/19299.png", "league_id": null, "sport": "soccer", "sport_id": "600", "subtitle": "EFL Trophy", "team_id": "19299", "type": "team", "uid": "s:600~t:19299", "web_url": "https://www.espn.com/soccer/club/_/id/19299/arsenal-u21" }, { "athlete_id": null, "date": null, "default_league_slug": "arg.3", "description": null, "display_name": "Arsenal Sarandi", "id": "ba4802f5-dd64-fbd3-e1e5-10bb4090244e", "image": "https://a.espncdn.com/i/teamlogos/soccer/500/2635.png", "league_id": null, "sport": "soccer", "sport_id": "600", "subtitle": "Argentine Primera B", "team_id": "2635", "type": "team", "uid": "s:600~t:2635", "web_url": "https://www.espn.com/soccer/club/_/id/2635/arsenal-sarandi" } ], "total_found": 5, "type": "team" } ], "observed_at_ms": 1790018275336, "query": "arsenal", "result_types": [ { "display_name": "Teams", "total_found": 16, "type": "team" }, { "display_name": "Articles", "total_found": 51802, "type": "article" }, { "display_name": "Upcoming", "total_found": 1, "type": "upcoming" }, { "display_name": "Clips", "total_found": 691, "type": "clips" } ], "total_found": 1, "type": "team" } ``` ### Standings - Capability: `sports-data/standings` - Description: League standings from `site.api.espn.com/apis/v2/sports/{sport}/{league}/standings[?season=&level=]`, flattened to tables: one per group that carries entries (a soccer league table; NFL conferences, or divisions with `level=3`), each entry with team identity, ESPN's rank note (qualification/relegation) and every standings column as ESPN names it (wins, losses, ties, points, gamesPlayed, pointDifferential, winPercent, streak, playoffSeed, ...). Includes the seasons ESPN offers. `stats` narrows the columns to the named ones. Without `season` ESPN returns the current season; a requested season ESPN answers with another year is `not_found`. An unknown league is `not_found`. - Instructions: Read a league table or conference/division standings for a season. - Cost: 5 credits per call - Capability file: [Standings](https://firecrawl.dev/alexandria/agents/providers/espn-com/sports-data/standings) Accepted options: - `league` (string, required): ESPN league slug within the sport, e.g. nfl, college-football, eng.1, uefa.champions, fifa.world, nba, mlb, nhl (from `leagues`). Pattern: ^[a-z0-9][a-z0-9._-]*$. Example: `` - `level` (number): Group depth (NFL: 3 returns divisions instead of conferences). Example: `5` - `season` (number): Season start year. Example: `1900` - `sport` (string, required): ESPN sport slug, e.g. football, soccer, basketball, baseball, hockey (from `leagues` without `sport`). Pattern: ^[a-z][a-z0-9-]*$. Example: `` - `stats` (string[]): Keep only these standings columns, by ESPN stat name (e.g. wins, losses, ties, points, gamesPlayed, pointDifferential, winPercent, streak, playoffSeed). Default: every column ESPN sends; a full NFL table is ~90 KB, so filter when you only need a few. Example: `[]` Response schema example: ```json { "available_seasons": [ { "end_date": "2027-06-01T03:59Z", "name": "2026-27 English Premier League", "start_date": "2026-06-01T04:00Z", "year": 2026 }, { "end_date": "2026-06-01T03:59Z", "name": "2025-26 English Premier League", "start_date": "2025-06-01T04:00Z", "year": 2025 }, { "end_date": "2025-06-01T03:59Z", "name": "2024-25 English Premier League", "start_date": "2024-06-01T04:00Z", "year": 2024 }, { "end_date": "2024-06-01T03:59Z", "name": "2023-24 English Premier League", "start_date": "2023-06-01T04:00Z", "year": 2023 }, { "end_date": "2023-06-01T03:59Z", "name": "2022-23 English Premier League", "start_date": "2022-06-01T04:00Z", "year": 2022 }, { "end_date": "2022-06-01T03:59Z", "name": "2021-22 English Premier League", "start_date": "2021-06-01T04:00Z", "year": 2021 }, { "end_date": "2021-06-01T03:59Z", "name": "2020-21 English Premier League", "start_date": "2020-08-01T04:00Z", "year": 2020 }, { "end_date": "2020-08-01T03:59Z", "name": "2019-20 English Premier League", "start_date": "2019-06-01T04:00Z", "year": 2019 }, { "end_date": "2019-06-01T03:59Z", "name": "2018-19 English Premier League", "start_date": "2018-06-01T04:00Z", "year": 2018 }, { "end_date": "2018-06-01T03:59Z", "name": "2017-18 English Premier League", "start_date": "2017-06-01T04:00Z", "year": 2017 }, { "end_date": "2017-06-01T03:59Z", "name": "2016-17 English Premier League", "start_date": "2016-06-01T04:00Z", "year": 2016 }, { "end_date": "2016-06-01T03:59Z", "name": "2015-16 Barclays Premier League", "start_date": "2015-06-17T04:00Z", "year": 2015 }, { "end_date": "2015-06-17T03:59Z", "name": "2014-15 Barclays Premier League", "start_date": "2014-06-01T04:00Z", "year": 2014 }, { "end_date": "2014-05-31T03:59Z", "name": "2013-14 Barclays Premier League", "start_date": "2013-06-01T04:00Z", "year": 2013 }, { "end_date": "2013-05-31T03:59Z", "name": "2012-13 Barclays Premier League", "start_date": "2012-07-01T04:00Z", "year": 2012 }, { "end_date": "2012-06-01T03:59Z", "name": "2011-12 Barclays Premier League", "start_date": "2011-06-01T04:00Z", "year": 2011 }, { "end_date": "2011-06-01T03:59Z", "name": "2010-11 Barclays Premier League", "start_date": "2010-06-01T04:00Z", "year": 2010 }, { "end_date": "2010-05-10T03:59Z", "name": "2009-10 Barclays Premier League", "start_date": "2009-08-15T04:00Z", "year": 2009 }, { "end_date": "2009-06-01T03:59Z", "name": "2008-09 Barclays Premier League", "start_date": "2008-06-01T04:00Z", "year": 2008 }, { "end_date": "2008-06-01T03:59Z", "name": "2007-08 Barclays Premier League", "start_date": "2007-08-01T04:00Z", "year": 2007 }, { "end_date": "2007-08-01T03:59Z", "name": "2006-07 Barclays Premier League", "start_date": "2006-08-01T04:00Z", "year": 2006 }, { "end_date": "2006-08-01T03:59Z", "name": "2005-06 Barclays Premier League", "start_date": "2005-08-01T04:00Z", "year": 2005 }, { "end_date": "2005-08-01T03:59Z", "name": "2004-05 Barclays Premier League", "start_date": "2004-08-01T04:00Z", "year": 2004 }, { "end_date": "2004-08-01T03:59Z", "name": "2003-04 Barclays Premier League", "start_date": "2003-08-01T04:00Z", "year": 2003 }, { "end_date": "2003-08-01T03:59Z", "name": "2002-03 Barclays Premier League", "start_date": "2002-08-01T04:00Z", "year": 2002 } ], "league": { "abbreviation": "Premier League", "id": "23", "name": "English Premier League", "slug": "eng.1", "uid": "s:600~l:700" }, "observed_at_ms": 1790018259563, "season": { "end_date": "2026-06-01T03:59Z", "name": "2025-26 English Premier League", "start_date": "2025-06-01T04:00Z", "year": 2025 }, "sport": "soccer", "stats_filter": [ "rank", "gamesPlayed", "wins", "ties", "losses", "pointDifferential", "points" ], "table_count": 1, "tables": [ { "abbreviation": "2025-2026", "count": 20, "display_name": "Standings", "entries": [ { "abbreviation": "ARS", "display_name": "Arsenal", "location": "Arsenal", "note": "Champions League", "rank": 1, "stats": [ { "abbreviation": "GP", "display_value": "38", "name": "gamesPlayed", "summary": null, "type": "gamesplayed", "value": 38 }, { "abbreviation": "L", "display_value": "5", "name": "losses", "summary": null, "type": "losses", "value": 5 }, { "abbreviation": "GD", "display_value": "+44", "name": "pointDifferential", "summary": null, "type": "pointdifferential", "value": 44 }, { "abbreviation": "P", "display_value": "85", "name": "points", "summary": null, "type": "points", "value": 85 }, { "abbreviation": "D", "display_value": "7", "name": "ties", "summary": null, "type": "ties", "value": 7 }, { "abbreviation": "W", "display_value": "26", "name": "wins", "summary": null, "type": "wins", "value": 26 }, { "abbreviation": "R", "display_value": "1", "name": "rank", "summary": null, "type": "rank", "value": 1 } ], "team_id": "359", "uid": "s:600~t:359", "url": "https://www.espn.com/soccer/club/_/id/359/arsenal" }, { "abbreviation": "MNC", "display_name": "Manchester City", "location": "Manchester City", "note": "Champions League", "rank": 2, "stats": [ { "abbreviation": "GP", "display_value": "38", "name": "gamesPlayed", "summary": null, "type": "gamesplayed", "value": 38 }, { "abbreviation": "L", "display_value": "6", "name": "losses", "summary": null, "type": "losses", "value": 6 }, { "abbreviation": "GD", "display_value": "+42", "name": "pointDifferential", "summary": null, "type": "pointdifferential", "value": 42 }, { "abbreviation": "P", "display_value": "78", "name": "points", "summary": null, "type": "points", "value": 78 }, { "abbreviation": "D", "display_value": "9", "name": "ties", "summary": null, "type": "ties", "value": 9 }, { "abbreviation": "W", "display_value": "23", "name": "wins", "summary": null, "type": "wins", "value": 23 }, { "abbreviation": "R", "display_value": "2", "name": "rank", "summary": null, "type": "rank", "value": 2 } ], "team_id": "382", "uid": "s:600~t:382", "url": "https://www.espn.com/soccer/club/_/id/382/manchester-city" }, { "abbreviation": "MAN", "display_name": "Manchester United", "location": "Manchester United", "note": "Champions League", "rank": 3, "stats": [ { "abbreviation": "GP", "display_value": "38", "name": "gamesPlayed", "summary": null, "type": "gamesplayed", "value": 38 }, { "abbreviation": "L", "display_value": "7", "name": "losses", "summary": null, "type": "losses", "value": 7 }, { "abbreviation": "GD", "display_value": "+19", "name": "pointDifferential", "summary": null, "type": "pointdifferential", "value": 19 }, { "abbreviation": "P", "display_value": "71", "name": "points", "summary": null, "type": "points", "value": 71 }, { "abbreviation": "D", "display_value": "11", "name": "ties", "summary": null, "type": "ties", "value": 11 }, { "abbreviation": "W", "display_value": "20", "name": "wins", "summary": null, "type": "wins", "value": 20 }, { "abbreviation": "R", "display_value": "3", "name": "rank", "summary": null, "type": "rank", "value": 3 } ], "team_id": "360", "uid": "s:600~t:360", "url": "https://www.espn.com/soccer/club/_/id/360/manchester-united" }, { "abbreviation": "AVL", "display_name": "Aston Villa", "location": "Aston Villa", "note": "Champions League", "rank": 4, "stats": [ { "abbreviation": "GP", "display_value": "38", "name": "gamesPlayed", "summary": null, "type": "gamesplayed", "value": 38 }, { "abbreviation": "L", "display_value": "11", "name": "losses", "summary": null, "type": "losses", "value": 11 }, { "abbreviation": "GD", "display_value": "+7", "name": "pointDifferential", "summary": null, "type": "pointdifferential", "value": 7 }, { "abbreviation": "P", "display_value": "65", "name": "points", "summary": null, "type": "points", "value": 65 }, { "abbreviation": "D", "display_value": "8", "name": "ties", "summary": null, "type": "ties", "value": 8 }, { "abbreviation": "W", "display_value": "19", "name": "wins", "summary": null, "type": "wins", "value": 19 }, { "abbreviation": "R", "display_value": "4", "name": "rank", "summary": null, "type": "rank", "value": 4 } ], "team_id": "362", "uid": "s:600~t:362", "url": "https://www.espn.com/soccer/club/_/id/362/aston-villa" }, { "abbreviation": "LIV", "display_name": "Liverpool", "location": "Liverpool", "note": "Champions League", "rank": 5, "stats": [ { "abbreviation": "GP", "display_value": "38", "name": "gamesPlayed", "summary": null, "type": "gamesplayed", "value": 38 }, { "abbreviation": "L", "display_value": "12", "name": "losses", "summary": null, "type": "losses", "value": 12 }, { "abbreviation": "GD", "display_value": "+10", "name": "pointDifferential", "summary": null, "type": "pointdifferential", "value": 10 }, { "abbreviation": "P", "display_value": "60", "name": "points", "summary": null, "type": "points", "value": 60 }, { "abbreviation": "D", "display_value": "9", "name": "ties", "summary": null, "type": "ties", "value": 9 }, { "abbreviation": "W", "display_value": "17", "name": "wins", "summary": null, "type": "wins", "value": 17 }, { "abbreviation": "R", "display_value": "5", "name": "rank", "summary": null, "type": "rank", "value": 5 } ], "team_id": "364", "uid": "s:600~t:364", "url": "https://www.espn.com/soccer/club/_/id/364/liverpool" }, { "abbreviation": "BOU", "display_name": "AFC Bournemouth", "location": "AFC Bournemouth", "note": "Europa League", "rank": 6, "stats": [ { "abbreviation": "GP", "display_value": "38", "name": "gamesPlayed", "summary": null, "type": "gamesplayed", "value": 38 }, { "abbreviation": "L", "display_value": "7", "name": "losses", "summary": null, "type": "losses", "value": 7 }, { "abbreviation": "GD", "display_value": "+4", "name": "pointDifferential", "summary": null, "type": "pointdifferential", "value": 4 }, { "abbreviation": "P", "display_value": "57", "name": "points", "summary": null, "type": "points", "value": 57 }, { "abbreviation": "D", "display_value": "18", "name": "ties", "summary": null, "type": "ties", "value": 18 }, { "abbreviation": "W", "display_value": "13", "name": "wins", "summary": null, "type": "wins", "value": 13 }, { "abbreviation": "R", "display_value": "6", "name": "rank", "summary": null, "type": "rank", "value": 6 } ], "team_id": "349", "uid": "s:600~t:349", "url": "https://www.espn.com/soccer/club/_/id/349/afc-bournemouth" }, { "abbreviation": "SUN", "display_name": "Sunderland", "location": "Sunderland", "note": "Europa League", "rank": 7, "stats": [ { "abbreviation": "GP", "display_value": "38", "name": "gamesPlayed", "summary": null, "type": "gamesplayed", "value": 38 }, { "abbreviation": "L", "display_value": "12", "name": "losses", "summary": null, "type": "losses", "value": 12 }, { "abbreviation": "GD", "display_value": "-6", "name": "pointDifferential", "summary": null, "type": "pointdifferential", "value": -6 }, { "abbreviation": "P", "display_value": "54", "name": "points", "summary": null, "type": "points", "value": 54 }, { "abbreviation": "D", "display_value": "12", "name": "ties", "summary": null, "type": "ties", "value": 12 }, { "abbreviation": "W", "display_value": "14", "name": "wins", "summary": null, "type": "wins", "value": 14 }, { "abbreviation": "R", "display_value": "7", "name": "rank", "summary": null, "type": "rank", "value": 7 } ], "team_id": "366", "uid": "s:600~t:366", "url": "https://www.espn.com/soccer/club/_/id/366/sunderland" }, { "abbreviation": "BHA", "display_name": "Brighton & Hove Albion", "location": "Brighton & Hove Albion", "note": "Conference League Playoff Round", "rank": 8, "stats": [ { "abbreviation": "GP", "display_value": "38", "name": "gamesPlayed", "summary": null, "type": "gamesplayed", "value": 38 }, { "abbreviation": "L", "display_value": "13", "name": "losses", "summary": null, "type": "losses", "value": 13 }, { "abbreviation": "GD", "display_value": "+6", "name": "pointDifferential", "summary": null, "type": "pointdifferential", "value": 6 }, { "abbreviation": "P", "display_value": "53", "name": "points", "summary": null, "type": "points", "value": 53 }, { "abbreviation": "D", "display_value": "11", "name": "ties", "summary": null, "type": "ties", "value": 11 }, { "abbreviation": "W", "display_value": "14", "name": "wins", "summary": null, "type": "wins", "value": 14 }, { "abbreviation": "R", "display_value": "8", "name": "rank", "summary": null, "type": "rank", "value": 8 } ], "team_id": "331", "uid": "s:600~t:331", "url": "https://www.espn.com/soccer/club/_/id/331/brighton-hove-albion" }, { "abbreviation": "BRE", "display_name": "Brentford", "location": "Brentford", "note": null, "rank": null, "stats": [ { "abbreviation": "GP", "display_value": "38", "name": "gamesPlayed", "summary": null, "type": "gamesplayed", "value": 38 }, { "abbreviation": "L", "display_value": "13", "name": "losses", "summary": null, "type": "losses", "value": 13 }, { "abbreviation": "GD", "display_value": "+3", "name": "pointDifferential", "summary": null, "type": "pointdifferential", "value": 3 }, { "abbreviation": "P", "display_value": "53", "name": "points", "summary": null, "type": "points", "value": 53 }, { "abbreviation": "D", "display_value": "11", "name": "ties", "summary": null, "type": "ties", "value": 11 }, { "abbreviation": "W", "display_value": "14", "name": "wins", "summary": null, "type": "wins", "value": 14 }, { "abbreviation": "R", "display_value": "9", "name": "rank", "summary": null, "type": "rank", "value": 9 } ], "team_id": "337", "uid": "s:600~t:337", "url": "https://www.espn.com/soccer/club/_/id/337/brentford" }, { "abbreviation": "CHE", "display_name": "Chelsea", "location": "Chelsea", "note": null, "rank": null, "stats": [ { "abbreviation": "GP", "display_value": "38", "name": "gamesPlayed", "summary": null, "type": "gamesplayed", "value": 38 }, { "abbreviation": "L", "display_value": "14", "name": "losses", "summary": null, "type": "losses", "value": 14 }, { "abbreviation": "GD", "display_value": "+6", "name": "pointDifferential", "summary": null, "type": "pointdifferential", "value": 6 }, { "abbreviation": "P", "display_value": "52", "name": "points", "summary": null, "type": "points", "value": 52 }, { "abbreviation": "D", "display_value": "10", "name": "ties", "summary": null, "type": "ties", "value": 10 }, { "abbreviation": "W", "display_value": "14", "name": "wins", "summary": null, "type": "wins", "value": 14 }, { "abbreviation": "R", "display_value": "10", "name": "rank", "summary": null, "type": "rank", "value": 10 } ], "team_id": "363", "uid": "s:600~t:363", "url": "https://www.espn.com/soccer/club/_/id/363/chelsea" }, { "abbreviation": "FUL", "display_name": "Fulham", "location": "Fulham", "note": null, "rank": null, "stats": [ { "abbreviation": "GP", "display_value": "38", "name": "gamesPlayed", "summary": null, "type": "gamesplayed", "value": 38 }, { "abbreviation": "L", "display_value": "16", "name": "losses", "summary": null, "type": "losses", "value": 16 }, { "abbreviation": "GD", "display_value": "-4", "name": "pointDifferential", "summary": null, "type": "pointdifferential", "value": -4 }, { "abbreviation": "P", "display_value": "52", "name": "points", "summary": null, "type": "points", "value": 52 }, { "abbreviation": "D", "display_value": "7", "name": "ties", "summary": null, "type": "ties", "value": 7 }, { "abbreviation": "W", "display_value": "15", "name": "wins", "summary": null, "type": "wins", "value": 15 }, { "abbreviation": "R", "display_value": "11", "name": "rank", "summary": null, "type": "rank", "value": 11 } ], "team_id": "370", "uid": "s:600~t:370", "url": "https://www.espn.com/soccer/club/_/id/370/fulham" }, { "abbreviation": "NEW", "display_name": "Newcastle United", "location": "Newcastle United", "note": null, "rank": null, "stats": [ { "abbreviation": "GP", "display_value": "38", "name": "gamesPlayed", "summary": null, "type": "gamesplayed", "value": 38 }, { "abbreviation": "L", "display_value": "17", "name": "losses", "summary": null, "type": "losses", "value": 17 }, { "abbreviation": "GD", "display_value": "-2", "name": "pointDifferential", "summary": null, "type": "pointdifferential", "value": -2 }, { "abbreviation": "P", "display_value": "49", "name": "points", "summary": null, "type": "points", "value": 49 }, { "abbreviation": "D", "display_value": "7", "name": "ties", "summary": null, "type": "ties", "value": 7 }, { "abbreviation": "W", "display_value": "14", "name": "wins", "summary": null, "type": "wins", "value": 14 }, { "abbreviation": "R", "display_value": "12", "name": "rank", "summary": null, "type": "rank", "value": 12 } ], "team_id": "361", "uid": "s:600~t:361", "url": "https://www.espn.com/soccer/club/_/id/361/newcastle-united" }, { "abbreviation": "EVE", "display_name": "Everton", "location": "Everton", "note": null, "rank": null, "stats": [ { "abbreviation": "GP", "display_value": "38", "name": "gamesPlayed", "summary": null, "type": "gamesplayed", "value": 38 }, { "abbreviation": "L", "display_value": "15", "name": "losses", "summary": null, "type": "losses", "value": 15 }, { "abbreviation": "GD", "display_value": "-3", "name": "pointDifferential", "summary": null, "type": "pointdifferential", "value": -3 }, { "abbreviation": "P", "display_value": "49", "name": "points", "summary": null, "type": "points", "value": 49 }, { "abbreviation": "D", "display_value": "10", "name": "ties", "summary": null, "type": "ties", "value": 10 }, { "abbreviation": "W", "display_value": "13", "name": "wins", "summary": null, "type": "wins", "value": 13 }, { "abbreviation": "R", "display_value": "13", "name": "rank", "summary": null, "type": "rank", "value": 13 } ], "team_id": "368", "uid": "s:600~t:368", "url": "https://www.espn.com/soccer/club/_/id/368/everton" }, { "abbreviation": "LEE", "display_name": "Leeds United", "location": "Leeds United", "note": null, "rank": null, "stats": [ { "abbreviation": "GP", "display_value": "38", "name": "gamesPlayed", "summary": null, "type": "gamesplayed", "value": 38 }, { "abbreviation": "L", "display_value": "13", "name": "losses", "summary": null, "type": "losses", "value": 13 }, { "abbreviation": "GD", "display_value": "-7", "name": "pointDifferential", "summary": null, "type": "pointdifferential", "value": -7 }, { "abbreviation": "P", "display_value": "47", "name": "points", "summary": null, "type": "points", "value": 47 }, { "abbreviation": "D", "display_value": "14", "name": "ties", "summary": null, "type": "ties", "value": 14 }, { "abbreviation": "W", "display_value": "11", "name": "wins", "summary": null, "type": "wins", "value": 11 }, { "abbreviation": "R", "display_value": "14", "name": "rank", "summary": null, "type": "rank", "value": 14 } ], "team_id": "357", "uid": "s:600~t:357", "url": "https://www.espn.com/soccer/club/_/id/357/leeds-united" }, { "abbreviation": "CRY", "display_name": "Crystal Palace", "location": "Crystal Palace", "note": "Europa League", "rank": 15, "stats": [ { "abbreviation": "GP", "display_value": "38", "name": "gamesPlayed", "summary": null, "type": "gamesplayed", "value": 38 }, { "abbreviation": "L", "display_value": "15", "name": "losses", "summary": null, "type": "losses", "value": 15 }, { "abbreviation": "GD", "display_value": "-10", "name": "pointDifferential", "summary": null, "type": "pointdifferential", "value": -10 }, { "abbreviation": "P", "display_value": "45", "name": "points", "summary": null, "type": "points", "value": 45 }, { "abbreviation": "D", "display_value": "12", "name": "ties", "summary": null, "type": "ties", "value": 12 }, { "abbreviation": "W", "display_value": "11", "name": "wins", "summary": null, "type": "wins", "value": 11 }, { "abbreviation": "R", "display_value": "15", "name": "rank", "summary": null, "type": "rank", "value": 15 } ], "team_id": "384", "uid": "s:600~t:384", "url": "https://www.espn.com/soccer/club/_/id/384/crystal-palace" }, { "abbreviation": "NFO", "display_name": "Nottingham Forest", "location": "Nottingham Forest", "note": null, "rank": null, "stats": [ { "abbreviation": "GP", "display_value": "38", "name": "gamesPlayed", "summary": null, "type": "gamesplayed", "value": 38 }, { "abbreviation": "L", "display_value": "16", "name": "losses", "summary": null, "type": "losses", "value": 16 }, { "abbreviation": "GD", "display_value": "-3", "name": "pointDifferential", "summary": null, "type": "pointdifferential", "value": -3 }, { "abbreviation": "P", "display_value": "44", "name": "points", "summary": null, "type": "points", "value": 44 }, { "abbreviation": "D", "display_value": "11", "name": "ties", "summary": null, "type": "ties", "value": 11 }, { "abbreviation": "W", "display_value": "11", "name": "wins", "summary": null, "type": "wins", "value": 11 }, { "abbreviation": "R", "display_value": "16", "name": "rank", "summary": null, "type": "rank", "value": 16 } ], "team_id": "393", "uid": "s:600~t:393", "url": "https://www.espn.com/soccer/club/_/id/393/nottingham-forest" }, { "abbreviation": "TOT", "display_name": "Tottenham Hotspur", "location": "Tottenham Hotspur", "note": null, "rank": null, "stats": [ { "abbreviation": "GP", "display_value": "38", "name": "gamesPlayed", "summary": null, "type": "gamesplayed", "value": 38 }, { "abbreviation": "L", "display_value": "17", "name": "losses", "summary": null, "type": "losses", "value": 17 }, { "abbreviation": "GD", "display_value": "-9", "name": "pointDifferential", "summary": null, "type": "pointdifferential", "value": -9 }, { "abbreviation": "P", "display_value": "41", "name": "points", "summary": null, "type": "points", "value": 41 }, { "abbreviation": "D", "display_value": "11", "name": "ties", "summary": null, "type": "ties", "value": 11 }, { "abbreviation": "W", "display_value": "10", "name": "wins", "summary": null, "type": "wins", "value": 10 }, { "abbreviation": "R", "display_value": "17", "name": "rank", "summary": null, "type": "rank", "value": 17 } ], "team_id": "367", "uid": "s:600~t:367", "url": "https://www.espn.com/soccer/club/_/id/367/tottenham-hotspur" }, { "abbreviation": "WHU", "display_name": "West Ham United", "location": "West Ham United", "note": "Relegation", "rank": 18, "stats": [ { "abbreviation": "GP", "display_value": "38", "name": "gamesPlayed", "summary": null, "type": "gamesplayed", "value": 38 }, { "abbreviation": "L", "display_value": "19", "name": "losses", "summary": null, "type": "losses", "value": 19 }, { "abbreviation": "GD", "display_value": "-19", "name": "pointDifferential", "summary": null, "type": "pointdifferential", "value": -19 }, { "abbreviation": "P", "display_value": "39", "name": "points", "summary": null, "type": "points", "value": 39 }, { "abbreviation": "D", "display_value": "9", "name": "ties", "summary": null, "type": "ties", "value": 9 }, { "abbreviation": "W", "display_value": "10", "name": "wins", "summary": null, "type": "wins", "value": 10 }, { "abbreviation": "R", "display_value": "18", "name": "rank", "summary": null, "type": "rank", "value": 18 } ], "team_id": "371", "uid": "s:600~t:371", "url": "https://www.espn.com/soccer/club/_/id/371/west-ham-united" }, { "abbreviation": "BUR", "display_name": "Burnley", "location": "Burnley", "note": "Relegation", "rank": 19, "stats": [ { "abbreviation": "GP", "display_value": "38", "name": "gamesPlayed", "summary": null, "type": "gamesplayed", "value": 38 }, { "abbreviation": "L", "display_value": "24", "name": "losses", "summary": null, "type": "losses", "value": 24 }, { "abbreviation": "GD", "display_value": "-37", "name": "pointDifferential", "summary": null, "type": "pointdifferential", "value": -37 }, { "abbreviation": "P", "display_value": "22", "name": "points", "summary": null, "type": "points", "value": 22 }, { "abbreviation": "D", "display_value": "10", "name": "ties", "summary": null, "type": "ties", "value": 10 }, { "abbreviation": "W", "display_value": "4", "name": "wins", "summary": null, "type": "wins", "value": 4 }, { "abbreviation": "R", "display_value": "19", "name": "rank", "summary": null, "type": "rank", "value": 19 } ], "team_id": "379", "uid": "s:600~t:379", "url": "https://www.espn.com/soccer/club/_/id/379/burnley" }, { "abbreviation": "WOL", "display_name": "Wolverhampton Wanderers", "location": "Wolverhampton Wanderers", "note": "Relegation", "rank": 20, "stats": [ { "abbreviation": "GP", "display_value": "38", "name": "gamesPlayed", "summary": null, "type": "gamesplayed", "value": 38 }, { "abbreviation": "L", "display_value": "24", "name": "losses", "summary": null, "type": "losses", "value": 24 }, { "abbreviation": "GD", "display_value": "-41", "name": "pointDifferential", "summary": null, "type": "pointdifferential", "value": -41 }, { "abbreviation": "P", "display_value": "20", "name": "points", "summary": null, "type": "points", "value": 20 }, { "abbreviation": "D", "display_value": "11", "name": "ties", "summary": null, "type": "ties", "value": 11 }, { "abbreviation": "W", "display_value": "3", "name": "wins", "summary": null, "type": "wins", "value": 3 }, { "abbreviation": "R", "display_value": "20", "name": "rank", "summary": null, "type": "rank", "value": 20 } ], "team_id": "380", "uid": "s:600~t:380", "url": "https://www.espn.com/soccer/club/_/id/380/wolverhampton-wanderers" } ], "group_id": "1", "group_uid": "s:600~l:700~g:1", "is_conference": null, "name": "English Premier League 2025-2026", "path": [ "English Premier League", "English Premier League 2025-2026" ], "season_name": "2025-26 English Premier League", "season_type": 1, "season_year": 2025, "url": "https://www.espn.com/soccer/table/_/league/eng.1" } ] } ``` ### Team - Capability: `sports-data/team` - Description: One team from `site.api.espn.com/apis/site/v2/sports/{sport}/{league}/teams/{team_id}`: identity, current record items with ESPN's stat names, standing summary (e.g. "1st in AFC East"), group/division ids, home venue and the next scheduled event(s). An unknown team_id is `not_found`. - Instructions: Read a team's record, standing and next fixture by team_id. - Cost: 5 credits per call - Capability file: [Team](https://firecrawl.dev/alexandria/agents/providers/espn-com/sports-data/team) Accepted options: - `league` (string, required): ESPN league slug within the sport, e.g. nfl, college-football, eng.1, uefa.champions, fifa.world, nba, mlb, nhl (from `leagues`). Pattern: ^[a-z0-9][a-z0-9._-]*$. Example: `` - `sport` (string, required): ESPN sport slug, e.g. football, soccer, basketball, baseball, hockey (from `leagues` without `sport`). Pattern: ^[a-z][a-z0-9-]*$. Example: `` - `team_id` (string, required): ESPN team id (from teams / scoreboard competitors / search). Pattern: ^[0-9]+$. Example: `` Response schema example: ```json { "group": { "id": "4", "is_conference": false, "parent_id": "8" }, "league": "nfl", "next_events": [ { "attendance": 60644, "broadcasts": [ "Prime Video" ], "competitors": [ { "abbreviation": "BUF", "display_name": "Buffalo Bills", "form": null, "home_away": "home", "location": "Buffalo", "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/buf.png", "order": 0, "rank": null, "records": [ { "name": null, "summary": "2-0", "type": "total" }, { "name": null, "summary": "1-0", "type": "home" }, { "name": null, "summary": "1-0", "type": "road" } ], "score": "41", "score_value": 41, "short_display_name": "Bills", "team_id": "2", "uid": null, "url": "https://www.espn.com/nfl/team/_/name/buf/buffalo-bills", "winner": true }, { "abbreviation": "DET", "display_name": "Detroit Lions", "form": null, "home_away": "away", "location": "Detroit", "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/det.png", "order": 1, "rank": null, "records": [ { "name": null, "summary": "1-1", "type": "total" }, { "name": null, "summary": "1-0", "type": "home" }, { "name": null, "summary": "0-1", "type": "road" } ], "score": "31", "score_value": 31, "short_display_name": "Lions", "team_id": "8", "uid": null, "url": "https://www.espn.com/nfl/team/_/name/det/detroit-lions", "winner": false } ], "event_id": "401872932", "name": "Detroit Lions at Buffalo Bills", "neutral_site": false, "season": { "name": "2026", "type": 2, "year": 2026 }, "short_name": "DET @ BUF", "start_time": "2026-09-18T00:15Z", "status": { "category": "final", "clock": 0, "completed": true, "description": "Final", "detail": "Final", "display_clock": "0:00", "id": "3", "name": "STATUS_FINAL", "period": 4, "short_detail": "Final", "state": "post" }, "time_valid": true, "uid": null, "url": "https://www.espn.com/nfl/game/_/gameId/401872932/lions-bills", "venue": { "city": "Orchard Park", "country": "USA", "id": null, "indoor": null, "name": "Highmark Stadium", "state": "NY" }, "week": 2 } ], "observed_at_ms": 1790018169804, "record": [ { "description": null, "stats": [ { "name": "OTLosses", "value": 0 }, { "name": "OTWins", "value": 0 }, { "name": "avgPointsAgainst", "value": 31 }, { "name": "avgPointsFor", "value": 38.5 }, { "name": "differential", "value": 15 }, { "name": "divisionWinPercent", "value": 0 }, { "name": "gamesBehind", "value": 0 }, { "name": "gamesPlayed", "value": 2 }, { "name": "leagueWinPercent", "value": 1 }, { "name": "losses", "value": 0 }, { "name": "playoffSeed", "value": 2 }, { "name": "pointDifferential", "value": 15 }, { "name": "points", "value": 1 }, { "name": "pointsAgainst", "value": 62 }, { "name": "pointsFor", "value": 77 }, { "name": "streak", "value": 2 }, { "name": "ties", "value": 0 }, { "name": "winPercent", "value": 1 }, { "name": "wins", "value": 2 }, { "name": "divisionLosses", "value": 0 }, { "name": "divisionRecord", "value": 0 }, { "name": "divisionTies", "value": 0 }, { "name": "divisionWins", "value": 0 }, { "name": "lockedDivRank", "value": 0 } ], "summary": "2-0", "type": "total" }, { "description": "Home Record", "stats": [ { "name": "wins", "value": 1 }, { "name": "losses", "value": 0 }, { "name": "ties", "value": 0 }, { "name": "winPercent", "value": 1 }, { "name": "OTLosses", "value": 0 } ], "summary": "1-0", "type": "home" }, { "description": "Away Record", "stats": [ { "name": "wins", "value": 1 }, { "name": "losses", "value": 0 }, { "name": "ties", "value": 0 }, { "name": "winPercent", "value": 1 }, { "name": "OTLosses", "value": 0 } ], "summary": "1-0", "type": "road" } ], "sport": "football", "standing_summary": "1st in AFC East", "team": { "abbreviation": "BUF", "color": "00338d", "display_name": "Buffalo Bills", "is_active": true, "location": "Buffalo", "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/buf.png", "name": "Bills", "nickname": "Bills", "short_display_name": "Bills", "slug": "buffalo-bills", "team_id": "2", "uid": "s:20~l:28~t:2", "url": "https://www.espn.com/nfl/team/_/name/buf/buffalo-bills" }, "venue": { "city": "Orchard Park", "country": "USA", "id": "11938", "indoor": false, "name": "Highmark Stadium", "state": "NY" } } ``` ### Team schedule - Capability: `sports-data/team_schedule` - Description: A team's season schedule from `site.api.espn.com/apis/site/v2/sports/{sport}/{league}/teams/{team_id}/schedule[?season=]`, as a bounded window (`offset`/`limit`, default 50) over the full list with `next_offset` continuation: every event with UTC start, status (including STATUS_POSTPONED), venue, competitors and final scores. Without `season` ESPN returns the current season; a season ESPN does not have falls back upstream and is reported as `not_found`. For soccer ESPN splits the season into completed results and upcoming fixtures (`fixture=true`); the program fetches both and returns one chronological list, so a competition whose season has not started yet lists its fixtures instead of nothing. A soccer `league` is one competition; `league: "all"` (ESPN's All Competitions view) spans every competition the club or national team plays, with each event's competition in its `season.name`. An unknown team_id is `not_found`. - Instructions: List a team's fixtures and results with event_ids for `event`. - Cost: 5 credits per call - Capability file: [Team schedule](https://firecrawl.dev/alexandria/agents/providers/espn-com/sports-data/team_schedule) Accepted options: - `league` (string, required): ESPN league slug within the sport, e.g. nfl, college-football, eng.1, uefa.champions, fifa.world, nba, mlb, nhl (from `leagues`). Pattern: ^[a-z0-9][a-z0-9._-]*$. Example: `` - `limit` (number): Page size (default 50, max 200). Example: `50` - `offset` (number): Zero-based offset into the full upstream list. Example: `0` - `season` (number): Season start year (e.g. 2025 for the 2025-26 Premier League). Example: `1900` - `sport` (string, required): ESPN sport slug, e.g. football, soccer, basketball, baseball, hockey (from `leagues` without `sport`). Pattern: ^[a-z][a-z0-9-]*$. Example: `` - `team_id` (string, required): ESPN team id. Pattern: ^[0-9]+$. Example: `` Response schema example: ```json { "bye_week": null, "count": 3, "events": [ { "attendance": 60098, "broadcasts": [ "USA Net", "Universo" ], "competitors": [ { "abbreviation": "ARS", "display_name": "Arsenal", "form": null, "home_away": "home", "location": "Arsenal", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/359.png", "order": 0, "rank": null, "records": [ { "name": null, "summary": "1-0-0", "type": "total" } ], "score": "3", "score_value": 3, "short_display_name": "Arsenal", "team_id": "359", "uid": null, "url": "https://www.espn.com/soccer/club/_/id/359/arsenal", "winner": true }, { "abbreviation": "COV", "display_name": "Coventry City", "form": null, "home_away": "away", "location": "Coventry City", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/388.png", "order": 1, "rank": null, "records": [ { "name": null, "summary": "0-0-1", "type": "total" } ], "score": "0", "score_value": 0, "short_display_name": "Coventry", "team_id": "388", "uid": null, "url": "https://www.espn.com/soccer/club/_/id/388/coventry-city", "winner": false } ], "event_id": "401879301", "name": "Coventry City at Arsenal", "neutral_site": false, "season": { "name": "2026-27 English Premier League", "type": 14308, "year": 2026 }, "short_name": "COV @ ARS", "start_time": "2026-08-21T19:00Z", "status": { "category": "final", "clock": 5400, "completed": true, "description": "Full Time", "detail": "FT", "display_clock": "90'+5'", "id": "28", "name": "STATUS_FULL_TIME", "period": 2, "short_detail": "FT", "state": "post" }, "time_valid": true, "uid": null, "url": "https://www.espn.com/soccer/match/_/gameId/401879301/coventry-city-arsenal", "venue": { "city": "London", "country": "England", "id": null, "indoor": null, "name": "Emirates Stadium", "state": null }, "week": null }, { "attendance": 36804, "broadcasts": [ "USA Net", "Universo" ], "competitors": [ { "abbreviation": "AVL", "display_name": "Aston Villa", "form": null, "home_away": "home", "location": "Aston Villa", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/362.png", "order": 0, "rank": null, "records": [ { "name": null, "summary": "0-0-2", "type": "total" } ], "score": "0", "score_value": 0, "short_display_name": "Aston Villa", "team_id": "362", "uid": null, "url": "https://www.espn.com/soccer/club/_/id/362/aston-villa", "winner": false }, { "abbreviation": "ARS", "display_name": "Arsenal", "form": null, "home_away": "away", "location": "Arsenal", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/359.png", "order": 1, "rank": null, "records": [ { "name": null, "summary": "2-0-0", "type": "total" } ], "score": "1", "score_value": 1, "short_display_name": "Arsenal", "team_id": "359", "uid": null, "url": "https://www.espn.com/soccer/club/_/id/359/arsenal", "winner": true } ], "event_id": "401879295", "name": "Arsenal at Aston Villa", "neutral_site": false, "season": { "name": "2026-27 English Premier League", "type": 14308, "year": 2026 }, "short_name": "ARS @ AVL", "start_time": "2026-08-31T19:00Z", "status": { "category": "final", "clock": 5400, "completed": true, "description": "Full Time", "detail": "FT", "display_clock": "90'+10'", "id": "28", "name": "STATUS_FULL_TIME", "period": 2, "short_detail": "FT", "state": "post" }, "time_valid": true, "uid": null, "url": "https://www.espn.com/soccer/match/_/gameId/401879295/arsenal-aston-villa", "venue": { "city": "Birmingham", "country": "England", "id": null, "indoor": null, "name": "Villa Park", "state": null }, "week": null }, { "attendance": 60240, "broadcasts": [ "USA Net", "Tele" ], "competitors": [ { "abbreviation": "ARS", "display_name": "Arsenal", "form": null, "home_away": "home", "location": "Arsenal", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/359.png", "order": 0, "rank": null, "records": [ { "name": null, "summary": "4-0-0", "type": "total" } ], "score": "2", "score_value": 2, "short_display_name": "Arsenal", "team_id": "359", "uid": null, "url": "https://www.espn.com/soccer/club/_/id/359/arsenal", "winner": true }, { "abbreviation": "CHE", "display_name": "Chelsea", "form": null, "home_away": "away", "location": "Chelsea", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/363.png", "order": 1, "rank": null, "records": [ { "name": null, "summary": "2-1-1", "type": "total" } ], "score": "1", "score_value": 1, "short_display_name": "Chelsea", "team_id": "363", "uid": null, "url": "https://www.espn.com/soccer/club/_/id/363/chelsea", "winner": false } ], "event_id": "401879292", "name": "Chelsea at Arsenal", "neutral_site": false, "season": { "name": "2026-27 English Premier League", "type": 14308, "year": 2026 }, "short_name": "CHE @ ARS", "start_time": "2026-09-06T15:30Z", "status": { "category": "final", "clock": 5400, "completed": true, "description": "Full Time", "detail": "FT", "display_clock": "90'+5'", "id": "28", "name": "STATUS_FULL_TIME", "period": 2, "short_detail": "FT", "state": "post" }, "time_valid": true, "uid": null, "url": "https://www.espn.com/soccer/match/_/gameId/401879292/chelsea-arsenal", "venue": { "city": "London", "country": "England", "id": null, "indoor": null, "name": "Emirates Stadium", "state": null }, "week": null } ], "league": "eng.1", "limit": 3, "next_offset": 3, "observed_at_ms": 1790237125264, "offset": 0, "requested_season": { "name": "2026-27 English Premier League", "type": 14308, "year": 2026 }, "season": { "name": "2026-27 English Premier League", "type": 14308, "year": 2026 }, "sport": "soccer", "team": { "abbreviation": "ARS", "display_name": "Arsenal", "location": "Arsenal", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/359.png", "name": "Arsenal", "record_summary": "4-0-1", "season_summary": "2026-27", "standing_summary": "2nd in English Premier League", "team_id": "359", "url": "https://www.espn.com/soccer/club/_/id/359/arsenal" }, "total": 38 } ``` ### Teams - Capability: `sports-data/teams` - Description: All teams in a league from `site.api.espn.com/apis/site/v2/sports/{sport}/{league}/teams` (one request, `limit=1000`): ESPN team_id, uid, slug, names, abbreviation, colors, logo and clubhouse URL. An unknown league is `not_found`. - Instructions: Get team_id values for team, team_schedule, roster. - Cost: 5 credits per call - Capability file: [Teams](https://firecrawl.dev/alexandria/agents/providers/espn-com/sports-data/teams) Accepted options: - `league` (string, required): ESPN league slug within the sport, e.g. nfl, college-football, eng.1, uefa.champions, fifa.world, nba, mlb, nhl (from `leagues`). Pattern: ^[a-z0-9][a-z0-9._-]*$. Example: `` - `sport` (string, required): ESPN sport slug, e.g. football, soccer, basketball, baseball, hockey (from `leagues` without `sport`). Pattern: ^[a-z][a-z0-9-]*$. Example: `` Response schema example: ```json { "count": 20, "league": { "abbreviation": "Premier League", "id": "700", "name": "English Premier League", "season": { "end_date": null, "name": "2026", "start_date": null, "type": null, "type_id": null, "year": 2026 }, "slug": "eng.1", "uid": "s:600~l:700" }, "observed_at_ms": 1790018162337, "season_year": 2026, "sport": "soccer", "teams": [ { "abbreviation": "BOU", "color": "f42727", "display_name": "AFC Bournemouth", "is_active": true, "location": "AFC Bournemouth", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/349.png", "name": "AFC Bournemouth", "nickname": "Bournemouth", "short_display_name": "Bournemouth", "slug": "eng.bournemouth", "team_id": "349", "uid": "s:600~t:349", "url": "https://www.espn.com/soccer/club/_/id/349/afc-bournemouth" }, { "abbreviation": "ARS", "color": "e20520", "display_name": "Arsenal", "is_active": true, "location": "Arsenal", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/359.png", "name": "Arsenal", "nickname": "Gunners", "short_display_name": "Arsenal", "slug": "eng.arsenal", "team_id": "359", "uid": "s:600~t:359", "url": "https://www.espn.com/soccer/club/_/id/359/arsenal" }, { "abbreviation": "AVL", "color": "660e36", "display_name": "Aston Villa", "is_active": true, "location": "Aston Villa", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/362.png", "name": "Aston Villa", "nickname": "Aston Villa", "short_display_name": "Aston Villa", "slug": "eng.aston_villa", "team_id": "362", "uid": "s:600~t:362", "url": "https://www.espn.com/soccer/club/_/id/362/aston-villa" }, { "abbreviation": "BRE", "color": "f42727", "display_name": "Brentford", "is_active": true, "location": "Brentford", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/337.png", "name": "Brentford", "nickname": "Brentford", "short_display_name": "Brentford", "slug": "eng.brentford", "team_id": "337", "uid": "s:600~t:337", "url": "https://www.espn.com/soccer/club/_/id/337/brentford" }, { "abbreviation": "BHA", "color": "0606fa", "display_name": "Brighton & Hove Albion", "is_active": true, "location": "Brighton & Hove Albion", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/331.png", "name": "Brighton & Hove Albion", "nickname": "Seagulls", "short_display_name": "Brighton", "slug": "eng.brighton", "team_id": "331", "uid": "s:600~t:331", "url": "https://www.espn.com/soccer/club/_/id/331/brighton-hove-albion" }, { "abbreviation": "CHE", "color": "144992", "display_name": "Chelsea", "is_active": true, "location": "Chelsea", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/363.png", "name": "Chelsea", "nickname": "Blues", "short_display_name": "Chelsea", "slug": "eng.chelsea", "team_id": "363", "uid": "s:600~t:363", "url": "https://www.espn.com/soccer/club/_/id/363/chelsea" }, { "abbreviation": "COV", "color": "87cced", "display_name": "Coventry City", "is_active": true, "location": "Coventry City", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/388.png", "name": "Coventry City", "nickname": "Sky Blues", "short_display_name": "Coventry", "slug": "eng.coventry", "team_id": "388", "uid": "s:600~t:388", "url": "https://www.espn.com/soccer/club/_/id/388/coventry-city" }, { "abbreviation": "CRY", "color": "0202fb", "display_name": "Crystal Palace", "is_active": true, "location": "Crystal Palace", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/384.png", "name": "Crystal Palace", "nickname": "Eagles", "short_display_name": "C Palace", "slug": "eng.crystal_palace", "team_id": "384", "uid": "s:600~t:384", "url": "https://www.espn.com/soccer/club/_/id/384/crystal-palace" }, { "abbreviation": "EVE", "color": "0606fa", "display_name": "Everton", "is_active": true, "location": "Everton", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/368.png", "name": "Everton", "nickname": "Toffees", "short_display_name": "Everton", "slug": "eng.everton", "team_id": "368", "uid": "s:600~t:368", "url": "https://www.espn.com/soccer/club/_/id/368/everton" }, { "abbreviation": "FUL", "color": "ffffff", "display_name": "Fulham", "is_active": true, "location": "Fulham", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/370.png", "name": "Fulham", "nickname": "Fulham", "short_display_name": "Fulham", "slug": "eng.fulham", "team_id": "370", "uid": "s:600~t:370", "url": "https://www.espn.com/soccer/club/_/id/370/fulham" }, { "abbreviation": "HUL", "color": "f28800", "display_name": "Hull City", "is_active": true, "location": "Hull City", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/306.png", "name": "Hull City", "nickname": "Tigers", "short_display_name": "Hull", "slug": "eng.hull", "team_id": "306", "uid": "s:600~t:306", "url": "https://www.espn.com/soccer/club/_/id/306/hull-city" }, { "abbreviation": "IPS", "color": "0000fa", "display_name": "Ipswich Town", "is_active": true, "location": "Ipswich Town", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/373.png", "name": "Ipswich Town", "nickname": "Tractor Boys", "short_display_name": "Ipswich", "slug": "eng.ipswich", "team_id": "373", "uid": "s:600~t:373", "url": "https://www.espn.com/soccer/club/_/id/373/ipswich-town" }, { "abbreviation": "LEE", "color": "ffffff", "display_name": "Leeds United", "is_active": true, "location": "Leeds United", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/357.png", "name": "Leeds United", "nickname": "Leeds", "short_display_name": "Leeds", "slug": "eng.leeds", "team_id": "357", "uid": "s:600~t:357", "url": "https://www.espn.com/soccer/club/_/id/357/leeds-united" }, { "abbreviation": "LIV", "color": "d11317", "display_name": "Liverpool", "is_active": true, "location": "Liverpool", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/364.png", "name": "Liverpool", "nickname": "Reds", "short_display_name": "Liverpool", "slug": "eng.liverpool", "team_id": "364", "uid": "s:600~t:364", "url": "https://www.espn.com/soccer/club/_/id/364/liverpool" }, { "abbreviation": "MNC", "color": "99c5ea", "display_name": "Manchester City", "is_active": true, "location": "Manchester City", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/382.png", "name": "Manchester City", "nickname": "Sky Blues", "short_display_name": "Man City", "slug": "eng.man_city", "team_id": "382", "uid": "s:600~t:382", "url": "https://www.espn.com/soccer/club/_/id/382/manchester-city" }, { "abbreviation": "MAN", "color": "da020e", "display_name": "Manchester United", "is_active": true, "location": "Manchester United", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/360.png", "name": "Manchester United", "nickname": "Red Devils", "short_display_name": "Man United", "slug": "eng.man_utd", "team_id": "360", "uid": "s:600~t:360", "url": "https://www.espn.com/soccer/club/_/id/360/manchester-united" }, { "abbreviation": "NEW", "color": "000000", "display_name": "Newcastle United", "is_active": true, "location": "Newcastle United", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/361.png", "name": "Newcastle United", "nickname": "Magpies/Toon", "short_display_name": "Newcastle", "slug": "eng.newcastle", "team_id": "361", "uid": "s:600~t:361", "url": "https://www.espn.com/soccer/club/_/id/361/newcastle-united" }, { "abbreviation": "NFO", "color": "c8102e", "display_name": "Nottingham Forest", "is_active": true, "location": "Nottingham Forest", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/393.png", "name": "Nottingham Forest", "nickname": "Nottingham F.", "short_display_name": "Nottm Forest", "slug": "eng.nottm_forest", "team_id": "393", "uid": "s:600~t:393", "url": "https://www.espn.com/soccer/club/_/id/393/nottingham-forest" }, { "abbreviation": "SUN", "color": "EB172B", "display_name": "Sunderland", "is_active": true, "location": "Sunderland", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/366.png", "name": "Sunderland", "nickname": "Black Cats/Wearsiders", "short_display_name": "Sunderland", "slug": "eng.sunderland", "team_id": "366", "uid": "s:600~t:366", "url": "https://www.espn.com/soccer/club/_/id/366/sunderland" }, { "abbreviation": "TOT", "color": "ffffff", "display_name": "Tottenham Hotspur", "is_active": true, "location": "Tottenham Hotspur", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/367.png", "name": "Tottenham Hotspur", "nickname": "Spurs", "short_display_name": "Spurs", "slug": "eng.tottenham", "team_id": "367", "uid": "s:600~t:367", "url": "https://www.espn.com/soccer/club/_/id/367/tottenham-hotspur" } ] } ```