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.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Date optional
date Local calendar date (YYYY-MM-DD), for example 2026-09-27. Defaults to today in the selected time zone.
2026-09-27
- Team optional
team Keep games for this team, for example Boston Celtics.
Not set
- League, required
league League name, such as NBA, NFL, Premier League or college football.
NFL
- Time Zone optional
time_zone City or time zone for dates and start times, for example London or America/New_York. Defaults to US Eastern.
US Eastern
Default
US Eastern.
Input as JSON
{ "date": "2026-09-27", "league": "NFL", "time_zone": "US Eastern"}Output
{ "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" } ] } ]}Code
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"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "espn.com/get_scores" , "input": { "date": "2026-09-27", "league": "NFL", "time_zone": "US Eastern" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "espn.com/get_scores" , "input": { "date": "2026-09-27", "league": "NFL", "time_zone": "US Eastern" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run espn.com/get_scores# with {"date":"2026-09-27","league":"NFL","time_zone":"US Eastern"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "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
{ "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" } } } } } } } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
espn.com/get_scores- Returns
- teams, scores, status, period, clock, start time, TV, venue, top performers, game link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method espn.com/get_scores with the inputs above.
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.
See more
All ESPN methodsFinds 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.com/get_game_summaryReturns 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.com/get_team_scheduleFinds an ESPN league or team by name and lists the latest headlines ESPN publishes for it, newest first.
espn.com/list_newsLooks 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.
espn.com/get_player_statsGets 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.
sports.yahoo.com/get_scoresGets 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.
nba.com/get_scoresLists NHL games for a date, optionally limited to one team, with start times in the chosen time zone, scores, status, and TV networks.
nhl.com/get_scoresLists 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.
mlb.com/get_scores