--- title: "ESPN game summary" method: GET path: "/espn/game-summary" tags: ["ESPN"] --- # ESPN game summary `GET /espn/game-summary` ## Request - Base URL: `https://api.crawlora.net/api/v1` - URL: `https://api.crawlora.net/api/v1/espn/game-summary` - Auth: API key in header `x-api-key` 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. ## Query parameters - `sport` 'football' | 'basketball' | 'baseball' | 'hockey' | 'soccer', required - `league` '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', required - `event` string, required ## Headers - `x-api-key` string, required ## Response `200` OK - EspnGameSummaryResponseDoc - `code` integer - `data` EspnGameSummaryResponse - `boxscore_teams` EspnBoxscoreTeam[]: Team stat totals for the game, one entry per team. Omitted when none are available. - `home_away` string: Whether the team is the `home` or `away` side. - `stats` object: Team stat totals keyed by stat label, with each value as ESPN displays it. - `team` EspnTeamRef - `abbreviation` string: Short team code, for example `KC`. - `alternate_color` string: Team's secondary colour code, as ESPN gives it. - `color` string: Team's primary colour code, as ESPN gives it. - `display_name` string: Full team name, for example `Kansas City Chiefs`. - `id` string: ESPN team id, for example `12`. Use it as the `team` parameter of the team and roster endpoints. - `location` string: Team's city or region, for example `Kansas City`. - `logo` string: URL of the team logo image. - `name` string: Team nickname without the location, for example `Chiefs`. - `short_display_name` string: Shortened team name, for example `Chiefs`. - `uid` string: ESPN's unique identifier string for the team. - `event` string: ESPN event id that was requested. - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339). - `game` EspnGame - `competitors` EspnCompetitor[]: Both sides of the game, each with team, home or away role and score. - `home_away` string: Whether the team is the `home` or `away` side. - `record` string: Team's win-loss record, for example `10-2`. - `score` string: Team's score in the game, as a string. - `team` EspnTeamRef - `abbreviation` string: Short team code, for example `KC`. - `alternate_color` string: Team's secondary colour code, as ESPN gives it. - `color` string: Team's primary colour code, as ESPN gives it. - `display_name` string: Full team name, for example `Kansas City Chiefs`. - `id` string: ESPN team id, for example `12`. Use it as the `team` parameter of the team and roster endpoints. - `location` string: Team's city or region, for example `Kansas City`. - `logo` string: URL of the team logo image. - `name` string: Team nickname without the location, for example `Chiefs`. - `short_display_name` string: Shortened team name, for example `Chiefs`. - `uid` string: ESPN's unique identifier string for the team. - `winner` boolean: Whether this team won the game. - `date` string: Scheduled start time of the game in ISO 8601, for example `2026-09-10T20:00Z`. - `id` string: ESPN event id of the game, for example `401816033`. Use it with the game summary endpoint. - `name` string: Full matchup title of the game, as ESPN shows it. - `odds` EspnGameOdds[]: Betting lines for the game, one entry per odds provider. - `details` string: Betting line summary text as the provider shows it, for example `ATL -1.5`. - `over_under` number: Total points line for the game, as the provider lists it. - `provider` string: Name of the odds provider that published the line. - `spread` number: Point spread for the game, as the provider lists it. - `short_name` string: Short matchup title of the game, as ESPN shows it. - `status` EspnGameStatus - `clock` string: Game clock text as ESPN displays it. Omitted when ESPN gives none. - `completed` boolean: Whether the game has finished. - `detail` string: Full status text ESPN shows for the game, for example `Final`. - `period` integer: Current period of the game, such as the quarter, inning or half. Omitted when ESPN gives none. - `short_detail` string: Short status text ESPN shows for the game, for example `Final`. - `state` string: Game state code as ESPN gives it, for example `pre` before the game or `post` after it. - `venue` string: Name of the stadium or arena where the game is played. - `league` string: League key that was requested, for example `nfl`. - `odds` EspnGameOdds[]: Betting lines for the game, one entry per odds provider. Omitted when none are available. - `details` string: Betting line summary text as the provider shows it, for example `ATL -1.5`. - `over_under` number: Total points line for the game, as the provider lists it. - `provider` string: Name of the odds provider that published the line. - `spread` number: Point spread for the game, as the provider lists it. - `source_url` string: URL the data was read from. - `sport` string: Sport key that was requested, for example `football`. - `msg` string ## Other responses - `400`: Bad Request - `404`: Not Found - `429`: Too Many Requests - `503`: Service Unavailable --- [API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)