# ESPN API: Get scores > Gets ESPN scores and the schedule for a league on a local day. You can filter by team, and start times are shown in your time zone. Unofficial. Not affiliated with or endorsed by ESPN. - Page: https://fous.com/methods/espn.com/get-scores - Method: `espn.com/get_scores`, version 1 - Website: espn.com - Returns: teams, scores, status, period, clock, start time, TV, venue, top performers, game link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `date` | string | no | `"2026-09-27"` | Local calendar date (YYYY-MM-DD), for example 2026-09-27. Defaults to today in the selected time zone. | | `team` | string | no | | Keep games for this team, for example Boston Celtics. | | `league` | string | yes | `"NFL"` | League name, such as NBA, NFL, Premier League or college football. | | `time_zone` | string | no | `"US Eastern"` | City or time zone for dates and start times, for example London or America/New_York. Defaults to US Eastern. Default "US Eastern". | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "date": "2026-09-27", "league": "NFL", "time_zone": "US Eastern" } ``` Its output: ```json { "games": [ { "clock": null, "venue": "Huntington Bank Field", "period": null, "status": "final", "away_team": "Carolina Panthers", "game_link": "https://www.espn.com/nfl/game/_/gameId/401872949/panthers-browns", "home_team": "Cleveland Browns", "away_score": 18, "home_score": 21, "start_time": "2026-09-27T13:00:00-04:00", "tv_network": "Fox", "espn_event_id": "401872949", "top_performers": [ { "team": "Carolina Panthers", "player": "Bryce Young", "stat_line": "26/48, 291 YDS, 1 TD, 1 INT Passing Leader" }, { "team": "Carolina Panthers", "player": "Chuba Hubbard", "stat_line": "19 CAR, 82 YDS Rushing Leader" }, { "team": "Carolina Panthers", "player": "Brycen Tremayne", "stat_line": "4 REC, 83 YDS Receiving Leader" } ] }, { "clock": null, "venue": "Acrisure Stadium", "period": null, "status": "final", "away_team": "Cincinnati Bengals", "game_link": "https://www.espn.com/nfl/game/_/gameId/401872950/bengals-steelers", "home_team": "Pittsburgh Steelers", "away_score": 27, "home_score": 30, "start_time": "2026-09-27T13:00:00-04:00", "tv_network": "CBS", "espn_event_id": "401872950", "top_performers": [ { "team": "Pittsburgh Steelers", "player": "Aaron Rodgers", "stat_line": "19/34, 292 YDS, 3 TD, 1 INT Passing Leader" }, { "team": "Pittsburgh Steelers", "player": "Jaylen Warren", "stat_line": "17 CAR, 127 YDS Rushing Leader" }, { "team": "Cincinnati Bengals", "player": "Ja'Marr Chase", "stat_line": "9 REC, 98 YDS, 1 TD Receiving Leader" } ] }, { "clock": null, "venue": "Lucas Oil Stadium", "period": null, "status": "final", "away_team": "Houston Texans", "game_link": "https://www.espn.com/nfl/game/_/gameId/401872951/texans-colts", "home_team": "Indianapolis Colts", "away_score": 17, "home_score": 19, "start_time": "2026-09-27T13:00:00-04:00", "tv_network": "CBS", "espn_event_id": "401872951", "top_performers": [ { "team": "Indianapolis Colts", "player": "Daniel Jones", "stat_line": "24/36, 235 YDS, 1 TD, 1 INT Passing Leader" }, { "team": "Indianapolis Colts", "player": "Jonathan Taylor", "stat_line": "23 CAR, 68 YDS Rushing Leader" }, { "team": "Indianapolis Colts", "player": "Josh Downs", "stat_line": "5 REC, 77 YDS Receiving Leader" } ] } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"espn.com/get_scores","input":{"date":"2026-09-27","league":"NFL","time_zone":"US Eastern"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What were the NBA scores last night, and when did the Celtics play? - Show me today's college football games in London time with start times and TV channels. - Any Premier League matches on 2026-09-27? I'm in Chicago, so local times please. - Did the Lakers win their game on the 14th of March? Include the final score and top scorers. - List every NFL game this Sunday for the Cowboys with the venue and game link on ESPN. ## Input schema ```json { "type": "object", "required": [ "league" ], "properties": { "date": { "type": "string", "description": "Local calendar date (YYYY-MM-DD), for example 2026-09-27. Defaults to today in the selected time zone." }, "team": { "type": "string", "description": "Keep games for this team, for example Boston Celtics." }, "league": { "type": "string", "description": "League name, such as NBA, NFL, Premier League or college football." }, "time_zone": { "type": "string", "default": "US Eastern", "description": "City or time zone for dates and start times, for example London or America/New_York. Defaults to US Eastern." } } } ``` ## Output schema ```json { "type": "object", "required": [ "games" ], "properties": { "games": { "type": "array", "items": { "type": "object", "properties": { "clock": { "type": [ "string", "null" ] }, "venue": { "type": [ "string", "null" ] }, "period": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "away_team": { "type": "string" }, "game_link": { "type": "string" }, "home_team": { "type": "string" }, "away_score": { "type": [ "integer", "null" ] }, "home_score": { "type": [ "integer", "null" ] }, "start_time": { "type": "string" }, "tv_network": { "type": [ "string", "null" ] }, "espn_event_id": { "type": "string" }, "top_performers": { "type": "array", "items": { "type": "object", "properties": { "team": { "type": "string" }, "player": { "type": "string" }, "stat_line": { "type": "string" } } } } } } } } } ``` ## See more - [ESPN API: Get game summary](https://fous.com/methods/espn.com/get-game-summary.md): Finds the latest game between two teams, or their game on a given date, in major US leagues, MLS or the EPL. Returns the score, scoring by period, leading players, team stats and player box scores. - [ESPN API: Get team schedule](https://fous.com/methods/espn.com/get-team-schedule.md): Returns a team's past results and upcoming games for a season on ESPN, with opponents, local start times, scores, broadcasts and venues. Soccer fixtures include all competitions shown for the team. - [ESPN API: List news for a league or team](https://fous.com/methods/espn.com/list-news.md): Finds an ESPN league or team by name and lists the latest headlines ESPN publishes for it, newest first. - [ESPN API: Get player stats](https://fous.com/methods/espn.com/get-player-stats.md): Looks up an ESPN player by name and returns season and career statistics. Use a league to tell apart players with the same name, and a season year or label to pick a past season. - [Yahoo API: Get scores](https://fous.com/methods/sports.yahoo.com/get-scores.md): Gets scores and schedules for a league on a date, or for the football week that contains the date. Results can be limited to one team. Venue names come from each game page, for up to 22 games. - [NBA API: Get scores](https://fous.com/methods/nba.com/get-scores.md): Gets NBA games for a date or up to seven days, using the NBA games calendar in US Eastern time. Each game has its score, status, start time, TV channels and venue. - [NHL API: Get scores](https://fous.com/methods/nhl.com/get-scores.md): Lists NHL games for a date, optionally limited to one team, with start times in the chosen time zone, scores, status, and TV networks. - [MLB API: Get scores and schedule](https://fous.com/methods/mlb.com/get-scores.md): Lists MLB games and scores for a date or up to seven days, optionally for one team. Start times are shown in the requested time zone. - [All ESPN methods](https://fous.com/methods/espn.com.md)