Docs menu

ESPN API endpoint

ESPN game summary API

Returns one game's matchup, betting odds, and boxscore stat totals. The `sport` enum accepts `football`, `basketball`, `baseball`, `hockey`, and `soccer`. The `league` enum accepts `nfl`, `college-football`, `nba`, `wnba`, `mens-college-basketball`, `womens-college-basketball`, `mlb`, `nhl`, `eng.1`, `esp.1`, `ita.1`, `ger.1`, `fra.1`, `usa.1`, and `uefa.champions`; it must be valid for the chosen sport. Get an `event` id from the scoreboard endpoint.

GETapiKey2 credits/requestESPNespn.gameSummaryResponseDoc/espn/game-summary

Endpoint facts

Method: GET
API path: /espn/game-summary
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: ESPN
Response schema: #/definitions/espn.gameSummaryResponseDoc

ESPN API Try ESPN game summary API in Playground ESPN API documentation

How this endpoint behaves

Query parameters:

sport: required enum. Allowed values: football, basketball, baseball, hockey, soccer.
league: required enum, must be valid for the chosen sport. Allowed values: nfl, college-football, nba, wnba, mens-college-basketball, womens-college-basketball, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, usa.1, uefa.champions.
event: required. Numeric ESPN event (game) id, e.g. 401816033. Obtain one from the scoreboard endpoint.

Notable response behavior:

game normalizes the matchup (competitors, scores, status); odds lists provider lines; boxscore_teams carries each team's stat totals as a flat stats map.
odds and boxscore_teams may be empty for games/leagues that do not provide them.
A response missing game data is treated as an upstream error.
Invalid sport/league/event values return an invalid-parameter error before upstream IO.

Live monitoring

Monitored request: GET /espn/game-summary?event=401816033&league=mlb&sport=baseball
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.08 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /espn/game-summary?event=401816033&league=mlb&sport=baseball
Items in game.competitors: 2
Fields filled in every checked item: 3
Fields empty in some or all items: 1

Field	Filled in, of 2 checked	Values in the sample
team	2
home_away	2	“home” and 1 other value
score	2	9 to 10, median 9
winner	1	true in 1 of 1

Request parameters

Parameter	Type	Required	Description	Example
sport	string	Yes	Sport key Allowed values: football, basketball, baseball, hockey, soccer.	baseball
league	string	Yes	League key (must be valid for the sport) Allowed values: nfl, college-football, nba, wnba, mens-college-basketball, womens-college-basketball, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, usa.1, uefa.champions.	mlb
event	string	Yes	Numeric ESPN event (game) id	401816033
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/espn/game-summary?sport=baseball&league=mlb&event=401816033" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "sport": "baseball",
    "league": "mlb",
    "event": "401816033",
    "source_url": "https://site.api.espn.com/apis/site/v2/sports/baseball/mlb/summary?event=401816033",
    "fetched_at": "2026-07-06T00:00:00Z",
    "game": {
      "id": "401816033",
      "status": {
        "state": "post",
        "detail": "Final",
        "completed": true
      },
      "competitors": [
        {
          "team": {
            "id": "15",
            "display_name": "Braves"
          },
          "home_away": "home",
          "score": "9",
          "winner": true
        },
        {
          "team": {
            "id": "22",
            "display_name": "Marlins"
          },
          "home_away": "away",
          "score": "3"
        }
      ]
    },
    "odds": [
      {
        "provider": "ESPN BET",
        "details": "ATL -1.5",
        "over_under": 8.5,
        "spread": -1.5
      }
    ],
    "boxscore_teams": [
      {
        "team": {
          "id": "15",
          "display_name": "Braves"
        },
        "home_away": "home",
        "stats": {}
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/espn.gameSummaryResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	espn.GameSummaryResponse	No
data.boxscore_teams	array	No		Team stat totals for the game, one entry per team. Omitted when none are available.
data.boxscore_teams[].home_away	string	No		Whether the team is the `home` or `away` side.
data.boxscore_teams[].stats	object	No		Team stat totals keyed by stat label, with each value as ESPN displays it.
data.boxscore_teams[].team	object	No		Team these stat totals belong to.
data.boxscore_teams[].team.abbreviation	string	No	KC	Short team code, for example `KC`.
data.boxscore_teams[].team.alternate_color	string	No		Team's secondary colour code, as ESPN gives it.
data.boxscore_teams[].team.color	string	No		Team's primary colour code, as ESPN gives it.
data.boxscore_teams[].team.display_name	string	No	Kansas City Chiefs	Full team name, for example `Kansas City Chiefs`.
data.boxscore_teams[].team.id	string	No	12	ESPN team id, for example `12`. Use it as the `team` parameter of the team and roster endpoints.
data.boxscore_teams[].team.location	string	No	Kansas City	Team's city or region, for example `Kansas City`.
data.boxscore_teams[].team.logo	string	No		URL of the team logo image.
data.boxscore_teams[].team.name	string	No	Chiefs	Team nickname without the location, for example `Chiefs`.
data.boxscore_teams[].team.short_display_name	string	No	Chiefs	Shortened team name, for example `Chiefs`.
data.boxscore_teams[].team.uid	string	No		ESPN's unique identifier string for the team.
data.event	string	No		ESPN event id that was requested.
data.fetched_at	string	No		Time the data was fetched, in UTC (RFC 3339).
data.game	object	No		Matchup details for the game: teams, scores and status.
data.game.competitors	array	No		Both sides of the game, each with team, home or away role and score.
data.game.competitors[].home_away	string	No	home	Whether the team is the `home` or `away` side.
data.game.competitors[].record	string	No	10-2	Team's win-loss record, for example `10-2`.
data.game.competitors[].score	string	No	27	Team's score in the game, as a string.
data.game.competitors[].team	object	No		Team playing in this game.
data.game.competitors[].team.abbreviation	string	No	KC	Short team code, for example `KC`.
data.game.competitors[].team.alternate_color	string	No		Team's secondary colour code, as ESPN gives it.
data.game.competitors[].team.color	string	No		Team's primary colour code, as ESPN gives it.
data.game.competitors[].team.display_name	string	No	Kansas City Chiefs	Full team name, for example `Kansas City Chiefs`.
data.game.competitors[].team.id	string	No	12	ESPN team id, for example `12`. Use it as the `team` parameter of the team and roster endpoints.
data.game.competitors[].team.location	string	No	Kansas City	Team's city or region, for example `Kansas City`.
data.game.competitors[].team.logo	string	No		URL of the team logo image.
data.game.competitors[].team.name	string	No	Chiefs	Team nickname without the location, for example `Chiefs`.
data.game.competitors[].team.short_display_name	string	No	Chiefs	Shortened team name, for example `Chiefs`.
data.game.competitors[].team.uid	string	No		ESPN's unique identifier string for the team.
data.game.competitors[].winner	boolean	No		Whether this team won the game.
data.game.date	string	No		Scheduled start time of the game in ISO 8601, for example `2026-09-10T20:00Z`.
data.game.id	string	No	401816033	ESPN event id of the game, for example `401816033`. Use it with the game summary endpoint.
data.game.name	string	No		Full matchup title of the game, as ESPN shows it.
data.game.odds	array	No		Betting lines for the game, one entry per odds provider.
data.game.odds[].details	string	No		Betting line summary text as the provider shows it, for example `ATL -1.5`.
data.game.odds[].over_under	number	No		Total points line for the game, as the provider lists it.
data.game.odds[].provider	string	No		Name of the odds provider that published the line.
data.game.odds[].spread	number	No		Point spread for the game, as the provider lists it.
data.game.short_name	string	No		Short matchup title of the game, as ESPN shows it.
data.game.status	object	No		Current state of the game, such as scheduled, in progress or final.
data.game.status.clock	string	No		Game clock text as ESPN displays it. Omitted when ESPN gives none.
data.game.status.completed	boolean	No	true	Whether the game has finished.
data.game.status.detail	string	No	Final	Full status text ESPN shows for the game, for example `Final`.
data.game.status.period	integer	No		Current period of the game, such as the quarter, inning or half. Omitted when ESPN gives none.
data.game.status.short_detail	string	No	Final	Short status text ESPN shows for the game, for example `Final`.
data.game.status.state	string	No	post	Game state code as ESPN gives it, for example `pre` before the game or `post` after it.
data.game.venue	string	No		Name of the stadium or arena where the game is played.
data.league	string	No		League key that was requested, for example `nfl`.
data.odds	array	No		Betting lines for the game, one entry per odds provider. Omitted when none are available.
data.odds[].details	string	No		Betting line summary text as the provider shows it, for example `ATL -1.5`.
data.odds[].over_under	number	No		Total points line for the game, as the provider lists it.
data.odds[].provider	string	No		Name of the odds provider that published the line.
data.odds[].spread	number	No		Point spread for the game, as the provider lists it.
data.source_url	string	No		URL the data was read from.
data.sport	string	No		Sport key that was requested, for example `football`.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/espn/game-summary?sport=baseball&league=mlb&event=401816033" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More ESPN endpoint docs ESPN API ESPN athlete API documentation ESPN league news API documentation ESPN poll rankings API documentation ESPN scoreboard API documentation ESPN standings API documentation ESPN team roster API documentation

Open in Playground Back to group

Docs menu

ESPN API endpoint

ESPN game summary API

GETapiKey2 credits/requestESPNespn.gameSummaryResponseDoc/espn/game-summary

Endpoint facts

Method: GET
API path: /espn/game-summary
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: ESPN
Response schema: #/definitions/espn.gameSummaryResponseDoc

ESPN API Try ESPN game summary API in Playground ESPN API documentation

How this endpoint behaves

Query parameters:

sport: required enum. Allowed values: football, basketball, baseball, hockey, soccer.
league: required enum, must be valid for the chosen sport. Allowed values: nfl, college-football, nba, wnba, mens-college-basketball, womens-college-basketball, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, usa.1, uefa.champions.
event: required. Numeric ESPN event (game) id, e.g. 401816033. Obtain one from the scoreboard endpoint.

Notable response behavior:

game normalizes the matchup (competitors, scores, status); odds lists provider lines; boxscore_teams carries each team's stat totals as a flat stats map.
odds and boxscore_teams may be empty for games/leagues that do not provide them.
A response missing game data is treated as an upstream error.
Invalid sport/league/event values return an invalid-parameter error before upstream IO.

Live monitoring

Monitored request: GET /espn/game-summary?event=401816033&league=mlb&sport=baseball
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.08 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /espn/game-summary?event=401816033&league=mlb&sport=baseball
Items in game.competitors: 2
Fields filled in every checked item: 3
Fields empty in some or all items: 1

Field	Filled in, of 2 checked	Values in the sample
team	2
home_away	2	“home” and 1 other value
score	2	9 to 10, median 9
winner	1	true in 1 of 1

Request parameters

Parameter	Type	Required	Description	Example
sport	string	Yes	Sport key Allowed values: football, basketball, baseball, hockey, soccer.	baseball
league	string	Yes	League key (must be valid for the sport) Allowed values: nfl, college-football, nba, wnba, mens-college-basketball, womens-college-basketball, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, usa.1, uefa.champions.	mlb
event	string	Yes	Numeric ESPN event (game) id	401816033
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/espn/game-summary?sport=baseball&league=mlb&event=401816033" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "sport": "baseball",
    "league": "mlb",
    "event": "401816033",
    "source_url": "https://site.api.espn.com/apis/site/v2/sports/baseball/mlb/summary?event=401816033",
    "fetched_at": "2026-07-06T00:00:00Z",
    "game": {
      "id": "401816033",
      "status": {
        "state": "post",
        "detail": "Final",
        "completed": true
      },
      "competitors": [
        {
          "team": {
            "id": "15",
            "display_name": "Braves"
          },
          "home_away": "home",
          "score": "9",
          "winner": true
        },
        {
          "team": {
            "id": "22",
            "display_name": "Marlins"
          },
          "home_away": "away",
          "score": "3"
        }
      ]
    },
    "odds": [
      {
        "provider": "ESPN BET",
        "details": "ATL -1.5",
        "over_under": 8.5,
        "spread": -1.5
      }
    ],
    "boxscore_teams": [
      {
        "team": {
          "id": "15",
          "display_name": "Braves"
        },
        "home_away": "home",
        "stats": {}
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/espn.gameSummaryResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	espn.GameSummaryResponse	No
data.boxscore_teams	array	No		Team stat totals for the game, one entry per team. Omitted when none are available.
data.boxscore_teams[].home_away	string	No		Whether the team is the `home` or `away` side.
data.boxscore_teams[].stats	object	No		Team stat totals keyed by stat label, with each value as ESPN displays it.
data.boxscore_teams[].team	object	No		Team these stat totals belong to.
data.boxscore_teams[].team.abbreviation	string	No	KC	Short team code, for example `KC`.
data.boxscore_teams[].team.alternate_color	string	No		Team's secondary colour code, as ESPN gives it.
data.boxscore_teams[].team.color	string	No		Team's primary colour code, as ESPN gives it.
data.boxscore_teams[].team.display_name	string	No	Kansas City Chiefs	Full team name, for example `Kansas City Chiefs`.
data.boxscore_teams[].team.id	string	No	12	ESPN team id, for example `12`. Use it as the `team` parameter of the team and roster endpoints.
data.boxscore_teams[].team.location	string	No	Kansas City	Team's city or region, for example `Kansas City`.
data.boxscore_teams[].team.logo	string	No		URL of the team logo image.
data.boxscore_teams[].team.name	string	No	Chiefs	Team nickname without the location, for example `Chiefs`.
data.boxscore_teams[].team.short_display_name	string	No	Chiefs	Shortened team name, for example `Chiefs`.
data.boxscore_teams[].team.uid	string	No		ESPN's unique identifier string for the team.
data.event	string	No		ESPN event id that was requested.
data.fetched_at	string	No		Time the data was fetched, in UTC (RFC 3339).
data.game	object	No		Matchup details for the game: teams, scores and status.
data.game.competitors	array	No		Both sides of the game, each with team, home or away role and score.
data.game.competitors[].home_away	string	No	home	Whether the team is the `home` or `away` side.
data.game.competitors[].record	string	No	10-2	Team's win-loss record, for example `10-2`.
data.game.competitors[].score	string	No	27	Team's score in the game, as a string.
data.game.competitors[].team	object	No		Team playing in this game.
data.game.competitors[].team.abbreviation	string	No	KC	Short team code, for example `KC`.
data.game.competitors[].team.alternate_color	string	No		Team's secondary colour code, as ESPN gives it.
data.game.competitors[].team.color	string	No		Team's primary colour code, as ESPN gives it.
data.game.competitors[].team.display_name	string	No	Kansas City Chiefs	Full team name, for example `Kansas City Chiefs`.
data.game.competitors[].team.id	string	No	12	ESPN team id, for example `12`. Use it as the `team` parameter of the team and roster endpoints.
data.game.competitors[].team.location	string	No	Kansas City	Team's city or region, for example `Kansas City`.
data.game.competitors[].team.logo	string	No		URL of the team logo image.
data.game.competitors[].team.name	string	No	Chiefs	Team nickname without the location, for example `Chiefs`.
data.game.competitors[].team.short_display_name	string	No	Chiefs	Shortened team name, for example `Chiefs`.
data.game.competitors[].team.uid	string	No		ESPN's unique identifier string for the team.
data.game.competitors[].winner	boolean	No		Whether this team won the game.
data.game.date	string	No		Scheduled start time of the game in ISO 8601, for example `2026-09-10T20:00Z`.
data.game.id	string	No	401816033	ESPN event id of the game, for example `401816033`. Use it with the game summary endpoint.
data.game.name	string	No		Full matchup title of the game, as ESPN shows it.
data.game.odds	array	No		Betting lines for the game, one entry per odds provider.
data.game.odds[].details	string	No		Betting line summary text as the provider shows it, for example `ATL -1.5`.
data.game.odds[].over_under	number	No		Total points line for the game, as the provider lists it.
data.game.odds[].provider	string	No		Name of the odds provider that published the line.
data.game.odds[].spread	number	No		Point spread for the game, as the provider lists it.
data.game.short_name	string	No		Short matchup title of the game, as ESPN shows it.
data.game.status	object	No		Current state of the game, such as scheduled, in progress or final.
data.game.status.clock	string	No		Game clock text as ESPN displays it. Omitted when ESPN gives none.
data.game.status.completed	boolean	No	true	Whether the game has finished.
data.game.status.detail	string	No	Final	Full status text ESPN shows for the game, for example `Final`.
data.game.status.period	integer	No		Current period of the game, such as the quarter, inning or half. Omitted when ESPN gives none.
data.game.status.short_detail	string	No	Final	Short status text ESPN shows for the game, for example `Final`.
data.game.status.state	string	No	post	Game state code as ESPN gives it, for example `pre` before the game or `post` after it.
data.game.venue	string	No		Name of the stadium or arena where the game is played.
data.league	string	No		League key that was requested, for example `nfl`.
data.odds	array	No		Betting lines for the game, one entry per odds provider. Omitted when none are available.
data.odds[].details	string	No		Betting line summary text as the provider shows it, for example `ATL -1.5`.
data.odds[].over_under	number	No		Total points line for the game, as the provider lists it.
data.odds[].provider	string	No		Name of the odds provider that published the line.
data.odds[].spread	number	No		Point spread for the game, as the provider lists it.
data.source_url	string	No		URL the data was read from.
data.sport	string	No		Sport key that was requested, for example `football`.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/espn/game-summary?sport=baseball&league=mlb&event=401816033" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

ESPN game summary API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

ESPN game summary API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related