# ESPN API: Get game summary

> 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.

Unofficial. Not affiliated with or endorsed by ESPN.

- Page: https://fous.com/methods/espn.com/get-game-summary
- Method: `espn.com/get_game_summary`, version 1
- Website: espn.com
- Returns: league, date/time, status, venue, attendance, score, period scoring, top performers, team stats, player box score, 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 |  | Game date, for example 2026-02-22. If omitted, find the most recent game. |
| `league` | string | no |  | League if team names are ambiguous, for example NBA (NBA, WNBA, NFL, MLB, NHL, NCAAF, NCAAM, NCAAW, MLS, EPL). |
| `team_1` | string | yes | `"Lakers"` | First team name, such as Lakers. |
| `team_2` | string | yes | `"Celtics"` | Second team name, such as Celtics. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "team_1": "Lakers",
  "team_2": "Celtics"
}
```

Its output:

```json
{
  "score": {
    "team_1": "Los Angeles Lakers",
    "team_2": "Boston Celtics",
    "team_1_score": 89,
    "team_2_score": 111
  },
  "venue": "crypto.com Arena",
  "league": "National Basketball Association",
  "status": "Final",
  "event_id": "401810678",
  "date_time": "2026-02-22T23:30:00+00:00",
  "game_link": "https://www.espn.com/nba/boxscore/_/gameId/401810678",
  "attendance": 18997,
  "team_stats": [
    {
      "stat": "Field Goals Made/Attempted",
      "team_1_value": "34-87",
      "team_2_value": "40-83"
    },
    {
      "stat": "Field Goal Percentage",
      "team_1_value": "39",
      "team_2_value": "48"
    },
    {
      "stat": "Three-Point Field Goals Made/Attempted",
      "team_1_value": "9-30",
      "team_2_value": "14-36"
    }
  ],
  "top_performers": [
    {
      "team": "Los Angeles Lakers",
      "player": "Luka Doncic",
      "stat_line": "25 Points"
    },
    {
      "team": "Los Angeles Lakers",
      "player": "LeBron James",
      "stat_line": "5 Assists"
    },
    {
      "team": "Los Angeles Lakers",
      "player": "Austin Reaves",
      "stat_line": "7 Rebounds"
    }
  ],
  "player_box_score": [
    {
      "team": "Boston Celtics",
      "stats": {
        "Blocks": "0",
        "Points": "7",
        "Steals": "0",
        "Assists": "2",
        "Minutes": "29",
        "Rebounds": "6",
        "Turnovers": "0",
        "Personal Fouls": "1",
        "Defensive Rebounds": "6",
        "Offensive Rebounds": "0",
        "Field Goals Made/Attempted": "2-6",
        "Free Throws Made/Attempted": "1-1",
        "3-Point Field Goals Made/Attempted": "2-6",
        "Teams net points while player is on the court.": "+5"
      },
      "player": "Sam Hauser",
      "category": null,
      "position": "Forward"
    },
    {
      "team": "Boston Celtics",
      "stats": {
        "Blocks": "3",
        "Points": "10",
        "Steals": "0",
        "Assists": "1",
        "Minutes": "26",
        "Rebounds": "12",
        "Turnovers": "2",
        "Personal Fouls": "1",
        "Defensive Rebounds": "8",
        "Offensive Rebounds": "4",
        "Field Goals Made/Attempted": "4-5",
        "Free Throws Made/Attempted": "2-2",
        "3-Point Field Goals Made/Attempted": "0-0",
        "Teams net points while player is on the court.": "+5"
      },
      "player": "Neemias Queta",
      "category": null,
      "position": "Center"
    },
    {
      "team": "Boston Celtics",
      "stats": {
        "Blocks": "1",
        "Points": "12",
        "Steals": "1",
        "Assists": "8",
        "Minutes": "35",
        "Rebounds": "5",
        "Turnovers": "1",
        "Personal Fouls": "1",
        "Defensive Rebounds": "4",
        "Offensive Rebounds": "1",
        "Field Goals Made/Attempted": "5-13",
        "Free Throws Made/Attempted": "0-0",
        "3-Point Field Goals Made/Attempted": "2-6",
        "Teams net points while player is on the court.": "+18"
      },
      "player": "Derrick White",
      "category": null,
      "position": "Guard"
    }
  ],
  "scoring_by_period": [
    {
      "period": "Quarter 1",
      "team_1_points": 28,
      "team_2_points": 28
    },
    {
      "period": "Quarter 2",
      "team_1_points": 22,
      "team_2_points": 32
    },
    {
      "period": "Quarter 3",
      "team_1_points": 21,
      "team_2_points": 24
    }
  ]
}
```

## 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_game_summary","input":{"team_1":"Lakers","team_2":"Celtics"}}'
```

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 was the final score of the Lakers vs Celtics game last night?
- Give me the box score and top scorers from the Knicks game on 2026-01-14
- Did Arsenal play Chelsea in the EPL on 2026-02-08? Show me the scoring by period and team stats.
- Find the most recent Dodgers game and tell me the attendance and venue.
- I want the player stats and period breakdown for the Bruins vs Maple Leafs NHL game on 2026-03-02, from espn.com.

## Input schema

```json
{
  "type": "object",
  "required": [
    "team_1",
    "team_2"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Game date, for example 2026-02-22. If omitted, find the most recent game."
    },
    "league": {
      "type": "string",
      "description": "League if team names are ambiguous, for example NBA (NBA, WNBA, NFL, MLB, NHL, NCAAF, NCAAM, NCAAW, MLS, EPL)."
    },
    "team_1": {
      "type": "string",
      "description": "First team name, such as Lakers."
    },
    "team_2": {
      "type": "string",
      "description": "Second team name, such as Celtics."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "league",
    "date_time",
    "status",
    "venue",
    "attendance",
    "score",
    "scoring_by_period",
    "top_performers",
    "team_stats",
    "player_box_score",
    "game_link",
    "event_id"
  ],
  "properties": {
    "score": {
      "type": "object",
      "properties": {
        "team_1": {
          "type": "string"
        },
        "team_2": {
          "type": "string"
        },
        "team_1_score": {
          "type": [
            "integer",
            "null"
          ]
        },
        "team_2_score": {
          "type": [
            "integer",
            "null"
          ]
        }
      }
    },
    "venue": {
      "type": [
        "string",
        "null"
      ]
    },
    "league": {
      "type": "string"
    },
    "status": {
      "type": [
        "string",
        "null"
      ]
    },
    "event_id": {
      "type": "string"
    },
    "date_time": {
      "type": "string"
    },
    "game_link": {
      "type": "string"
    },
    "attendance": {
      "type": [
        "integer",
        "null"
      ]
    },
    "team_stats": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "stat": {
            "type": "string"
          },
          "team_1_value": {
            "type": [
              "string",
              "null"
            ]
          },
          "team_2_value": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "top_performers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "team": {
            "type": "string"
          },
          "player": {
            "type": "string"
          },
          "stat_line": {
            "type": "string"
          }
        }
      }
    },
    "player_box_score": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "team": {
            "type": "string"
          },
          "stats": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "player": {
            "type": "string"
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "position": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "scoring_by_period": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "period": {
            "type": "string"
          },
          "team_1_points": {
            "type": [
              "integer",
              "null"
            ]
          },
          "team_2_points": {
            "type": [
              "integer",
              "null"
            ]
          }
        }
      }
    }
  }
}
```

## See more

- [ESPN API: Get scores](https://fous.com/methods/espn.com/get-scores.md): 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.
- [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.
- [NBA API: Get box score](https://fous.com/methods/nba.com/get-box-score.md): Returns the NBA box score for a game between two teams on a date; without a date, their most recent matchup, including Summer League and games in progress.
- [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.
- [All ESPN methods](https://fous.com/methods/espn.com.md)