ESPN API: Get team schedule
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.
Unofficial. Not affiliated with or endorsed by ESPN.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Team, required
team Team name, such as Dallas Cowboys or Real Madrid.
Dallas Cowboys
- League optional
league League to distinguish teams with similar names, such as NFL or Spanish LALIGA.
(default)
- Season optional
season Starting year of the season, such as 2025 for 2025–26. Defaults to the current ESPN season.
2025
Whole number.
- Time Zone optional
time_zone Time zone for game start times, such as US/Eastern or Europe/Madrid.
US/Eastern (default)
Input as JSON
{ "team": "Dallas Cowboys", "season": 2025}Output
{ "team": "Dallas Cowboys", "games": [ { "score": "20-24", "venue": "Lincoln Financial Field", "result": "loss", "event_id": "401772510", "opponent": "Philadelphia Eagles", "date_time": "2025-09-04T20:20:00-04:00", "game_link": "https://www.espn.com/nfl/game/_/gameId/401772510/cowboys-eagles" , "home_away": "away", "tv_network": "NBC, Peacock" }, { "score": "40-37", "venue": "AT&T Stadium", "result": "win", "event_id": "401772834", "opponent": "New York Giants", "date_time": "2025-09-14T13:00:00-04:00", "game_link": "https://www.espn.com/nfl/game/_/gameId/401772834/giants-cowboys" , "home_away": "home", "tv_network": "Fox" }, { "score": "14-31", "venue": "Soldier Field", "result": "loss", "event_id": "401772844", "opponent": "Chicago Bears", "date_time": "2025-09-21T16:25:00-04:00", "game_link": "https://www.espn.com/nfl/game/_/gameId/401772844/cowboys-bears" , "home_away": "away", "tv_network": "Fox" } ], "league": "NFL", "season": 2025, "team_id": "6", "team_link": "https://www.espn.com/nfl/team/_/name/dal/dallas-cowboys" }Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"espn.com/get_team_schedule","input":{"team":"Dallas Cowboys","season":2025}}' # 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_team_schedule" , "input": { "team": "Dallas Cowboys", "season": 2025 }})# 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_team_schedule" , "input": { "team": "Dallas Cowboys", "season": 2025 } }), 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_team_schedule# with {"team":"Dallas Cowboys","season":2025}"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": [ "team" ], "properties": { "team": { "type": "string", "description": "Team name, such as Dallas Cowboys or Real Madrid." }, "league": { "type": "string", "default": "", "description": "League to distinguish teams with similar names, such as NFL or Spanish LALIGA." }, "season": { "type": "integer", "description": "Starting year of the season, such as 2025 for 2025–26. Defaults to the current ESPN season." }, "time_zone": { "type": "string", "default": "US/Eastern" , "description": "Time zone for game start times, such as US/Eastern or Europe/Madrid." } }, "additionalProperties": false}Output schema
{ "type": "object", "required": [ "team", "league", "season", "team_link", "team_id", "games" ], "properties": { "team": { "type": "string" }, "games": { "type": "array", "items": { "type": "object", "required": [ "date_time", "opponent", "home_away", "result", "score", "tv_network", "venue", "game_link", "event_id" ], "properties": { "score": { "type": [ "string", "null" ], "description": "Team score followed by opponent score, or null before the result is final." }, "venue": { "type": [ "string", "null" ] }, "result": { "enum": [ "win", "loss", "tie", null ], "type": [ "string", "null" ] }, "event_id": { "type": "string" }, "opponent": { "type": "string" }, "date_time": { "type": [ "string", "null" ], "description": "Local start time in ISO 8601 with offset, or null if not set." }, "game_link": { "type": [ "string", "null" ] }, "home_away": { "enum": [ "home", "away" ], "type": "string" }, "tv_network": { "type": [ "string", "null" ] } }, "additionalProperties": false } }, "league": { "type": "string" }, "season": { "type": "integer" }, "team_id": { "type": "string" }, "team_link": { "type": "string" } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
espn.com/get_team_schedule- Returns
- team, league, season, team link, and games with date_time, opponent, home_away, result, score, tv_network, venue, game_link, event_id
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_team_schedule with the inputs above.
Ask your agent
- What's the Real Madrid schedule for the 2025–26 season, with kickoff times in Europe/Madrid time?
- Show me every Dallas Cowboys game this season with opponents, scores, and TV networks.
- Can you pull the Boston Bruins results and upcoming games for 2024 on ESPN in US/Pacific time?
- I need the Liverpool fixtures across all competitions for the 2025 season, including venues and broadcast channels.
- List the Golden State Warriors past results and future games for the 2023 season, with local start times in US/Central.
See more
All ESPN methodsGets 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.
espn.com/get_scoresFinds 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_summaryFinds 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 Premier League fixtures and results in a date range, with kickoff times in your chosen time zone. Returns up to 380 matches.
premierleague.com/get_fixtures_and_resultsLists 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_scoresGets NFL scores and scheduled games for the week that contains a date. You can keep only one team's games. Kickoff times are in US Eastern time unless you choose another time zone.
nfl.com/get_scores