Docs menu

ESPN API endpoint

ESPN scoreboard API

Returns games (scores, schedule, status, and odds when available) for a sport and league. 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. The `seasontype` enum accepts `1` (preseason), `2` (regular season), `3` (postseason), and `4` (offseason).

GETapiKey1 credit/requestESPNespn.scoreboardResponseDoc/espn/scoreboard

Endpoint facts

Method: GET
API path: /espn/scoreboard
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: ESPN
Response schema: #/definitions/espn.scoreboardResponseDoc

ESPN API Try ESPN scoreboard 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.
dates: optional. A date or range as YYYYMMDD, YYYYMMDD-YYYYMMDD, or YYYY. Defaults to the current scoreboard.
week: optional integer. Week number (football leagues).
seasontype: optional enum. Allowed values: 1 (preseason), 2 (regular season), 3 (postseason), 4 (offseason).

Notable response behavior:

A valid date with no games returns an empty games array (not an error).
Each game includes competitors with team, home_away, score, and winner, plus odds when the league provides them.
Invalid sport/league/dates/seasontype values return an invalid-parameter error before upstream IO.

Live monitoring

Monitored request: GET /espn/scoreboard?league=nfl&sport=football
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.96 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /espn/scoreboard?league=nfl&sport=football
Items in games: 15
Fields filled in every checked item: 7

Field	Filled in, of 15 checked	Values in the sample
id	15
date	15	2026-10-09 to 2026-10-13
name	15	“Tampa Bay Buccaneers at Dallas Cowboys” and 14 other values
short_name	15	“TB @ DAL” and 14 other values
status	15
venue	15	“AT&T Stadium” and 13 other values
competitors	15	median 2 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
sport	string	Yes		Sport key Allowed values: football, basketball, baseball, hockey, soccer.	football
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.	nfl
dates	string	No	the current scoreboard	Date or range as YYYYMMDD, YYYYMMDD-YYYYMMDD, or YYYY; defaults to the current scoreboard	20260910
week	integer	No		Week number (football leagues)	1
seasontype	integer	No		Season type Allowed values: 1, 2, 3, 4.	2
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/espn/scoreboard?sport=football&league=nfl&seasontype=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "sport": "football",
    "league": "nfl",
    "league_name": "National Football League",
    "season": {
      "year": 2026,
      "type": 2,
      "name": "Regular Season"
    },
    "count": 1,
    "source_url": "https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard",
    "fetched_at": "2026-09-10T20:05:00Z",
    "games": [
      {
        "id": "401700000",
        "date": "2026-09-10T20:00Z",
        "short_name": "KC @ BUF",
        "status": {
          "state": "pre",
          "detail": "Scheduled",
          "completed": false
        },
        "venue": "Highmark Stadium",
        "competitors": [
          {
            "team": {
              "id": "2",
              "abbreviation": "BUF",
              "display_name": "Buffalo Bills"
            },
            "home_away": "home",
            "score": "0"
          },
          {
            "team": {
              "id": "12",
              "abbreviation": "KC",
              "display_name": "Kansas City Chiefs"
            },
            "home_away": "away",
            "score": "0"
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/espn.scoreboardResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	espn.ScoreboardResponse	No
data.count	integer	No	14
data.day	string	No
data.fetched_at	string	No
data.games	array	No
data.games[].competitors	array	No		Both sides of the game, each with team, home or away role and score. Competitor record, 15 fields: home_away, record, score, team, winner. Described under ESPN game summary API.
data.games[].date	string	No		Scheduled start time of the game in ISO 8601, for example `2026-09-10T20:00Z`.
data.games[].id	string	No	401816033	ESPN event id of the game, for example `401816033`. Use it with the game summary endpoint.
data.games[].name	string	No		Full matchup title of the game, as ESPN shows it.
data.games[].odds	array	No		Betting lines for the game, one entry per odds provider. GameOdds record, 4 fields: details, over_under, provider, spread. Described under ESPN game summary API.
data.games[].short_name	string	No		Short matchup title of the game, as ESPN shows it.
data.games[].status	object	No		Current state of the game, such as scheduled, in progress or final.
data.games[].status.clock	string	No		Game clock text as ESPN displays it. Omitted when ESPN gives none.
data.games[].status.completed	boolean	No	true	Whether the game has finished.
data.games[].status.detail	string	No	Final	Full status text ESPN shows for the game, for example `Final`.
data.games[].status.period	integer	No		Current period of the game, such as the quarter, inning or half. Omitted when ESPN gives none.
data.games[].status.short_detail	string	No	Final	Short status text ESPN shows for the game, for example `Final`.
data.games[].status.state	string	No	post	Game state code as ESPN gives it, for example `pre` before the game or `post` after it.
data.games[].venue	string	No		Name of the stadium or arena where the game is played.
data.league	string	No	nfl
data.league_name	string	No	National Football League
data.season	espn.Season	No
data.season.name	string	No		Season type name as ESPN shows it.
data.season.type	integer	No	2	Season type code: 1 preseason, 2 regular season, 3 postseason, 4 offseason.
data.season.year	integer	No	2024	Season year, for example `2024`.
data.source_url	string	No
data.sport	string	No	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/scoreboard?sport=football&league=nfl&seasontype=1" \
  -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 game summary API documentation ESPN league news API documentation ESPN poll rankings API documentation ESPN standings API documentation ESPN team roster API documentation

Open in Playground Back to group

Docs menu

ESPN API endpoint

ESPN scoreboard API

GETapiKey1 credit/requestESPNespn.scoreboardResponseDoc/espn/scoreboard

Endpoint facts

Method: GET
API path: /espn/scoreboard
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: ESPN
Response schema: #/definitions/espn.scoreboardResponseDoc

ESPN API Try ESPN scoreboard 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.
dates: optional. A date or range as YYYYMMDD, YYYYMMDD-YYYYMMDD, or YYYY. Defaults to the current scoreboard.
week: optional integer. Week number (football leagues).
seasontype: optional enum. Allowed values: 1 (preseason), 2 (regular season), 3 (postseason), 4 (offseason).

Notable response behavior:

A valid date with no games returns an empty games array (not an error).
Each game includes competitors with team, home_away, score, and winner, plus odds when the league provides them.
Invalid sport/league/dates/seasontype values return an invalid-parameter error before upstream IO.

Live monitoring

Monitored request: GET /espn/scoreboard?league=nfl&sport=football
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.96 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /espn/scoreboard?league=nfl&sport=football
Items in games: 15
Fields filled in every checked item: 7

Field	Filled in, of 15 checked	Values in the sample
id	15
date	15	2026-10-09 to 2026-10-13
name	15	“Tampa Bay Buccaneers at Dallas Cowboys” and 14 other values
short_name	15	“TB @ DAL” and 14 other values
status	15
venue	15	“AT&T Stadium” and 13 other values
competitors	15	median 2 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
sport	string	Yes		Sport key Allowed values: football, basketball, baseball, hockey, soccer.	football
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.	nfl
dates	string	No	the current scoreboard	Date or range as YYYYMMDD, YYYYMMDD-YYYYMMDD, or YYYY; defaults to the current scoreboard	20260910
week	integer	No		Week number (football leagues)	1
seasontype	integer	No		Season type Allowed values: 1, 2, 3, 4.	2
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/espn/scoreboard?sport=football&league=nfl&seasontype=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "sport": "football",
    "league": "nfl",
    "league_name": "National Football League",
    "season": {
      "year": 2026,
      "type": 2,
      "name": "Regular Season"
    },
    "count": 1,
    "source_url": "https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard",
    "fetched_at": "2026-09-10T20:05:00Z",
    "games": [
      {
        "id": "401700000",
        "date": "2026-09-10T20:00Z",
        "short_name": "KC @ BUF",
        "status": {
          "state": "pre",
          "detail": "Scheduled",
          "completed": false
        },
        "venue": "Highmark Stadium",
        "competitors": [
          {
            "team": {
              "id": "2",
              "abbreviation": "BUF",
              "display_name": "Buffalo Bills"
            },
            "home_away": "home",
            "score": "0"
          },
          {
            "team": {
              "id": "12",
              "abbreviation": "KC",
              "display_name": "Kansas City Chiefs"
            },
            "home_away": "away",
            "score": "0"
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/espn.scoreboardResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	espn.ScoreboardResponse	No
data.count	integer	No	14
data.day	string	No
data.fetched_at	string	No
data.games	array	No
data.games[].competitors	array	No		Both sides of the game, each with team, home or away role and score. Competitor record, 15 fields: home_away, record, score, team, winner. Described under ESPN game summary API.
data.games[].date	string	No		Scheduled start time of the game in ISO 8601, for example `2026-09-10T20:00Z`.
data.games[].id	string	No	401816033	ESPN event id of the game, for example `401816033`. Use it with the game summary endpoint.
data.games[].name	string	No		Full matchup title of the game, as ESPN shows it.
data.games[].odds	array	No		Betting lines for the game, one entry per odds provider. GameOdds record, 4 fields: details, over_under, provider, spread. Described under ESPN game summary API.
data.games[].short_name	string	No		Short matchup title of the game, as ESPN shows it.
data.games[].status	object	No		Current state of the game, such as scheduled, in progress or final.
data.games[].status.clock	string	No		Game clock text as ESPN displays it. Omitted when ESPN gives none.
data.games[].status.completed	boolean	No	true	Whether the game has finished.
data.games[].status.detail	string	No	Final	Full status text ESPN shows for the game, for example `Final`.
data.games[].status.period	integer	No		Current period of the game, such as the quarter, inning or half. Omitted when ESPN gives none.
data.games[].status.short_detail	string	No	Final	Short status text ESPN shows for the game, for example `Final`.
data.games[].status.state	string	No	post	Game state code as ESPN gives it, for example `pre` before the game or `post` after it.
data.games[].venue	string	No		Name of the stadium or arena where the game is played.
data.league	string	No	nfl
data.league_name	string	No	National Football League
data.season	espn.Season	No
data.season.name	string	No		Season type name as ESPN shows it.
data.season.type	integer	No	2	Season type code: 1 preseason, 2 regular season, 3 postseason, 4 offseason.
data.season.year	integer	No	2024	Season year, for example `2024`.
data.source_url	string	No
data.sport	string	No	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/scoreboard?sport=football&league=nfl&seasontype=1" \
  -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 scoreboard 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 scoreboard 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