Docs menu

ESPN API endpoint

ESPN standings API

Returns league standings grouped by conference/division. 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), and `3` (postseason).

GETapiKey1 credit/requestESPNespn.standingsResponseDoc/espn/standings

Endpoint facts

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

ESPN API Try ESPN standings 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.
season: optional integer. Four-digit season year, e.g. 2024. Defaults to the current season.
seasontype: optional enum. Allowed values: 1 (preseason), 2 (regular season), 3 (postseason).

Notable response behavior:

Standings are flattened from ESPN's nested tree into groups, each with entries; each entry carries a flat stats map (e.g. wins, losses, winPercent).
A response with no entries is treated as an upstream error (parser drift or block).
Invalid sport/league/season/seasontype values return an invalid-parameter error before upstream IO.

Live monitoring

Monitored request: GET /espn/standings?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/standings?league=nfl&sport=football
Items in groups: 2
Fields filled in every checked item: 3

Field	Filled in, of 2 checked	Values in the sample
name	2	“American Football Conference” and 1 other value
abbreviation	2	“AFC” and 1 other value
entries	2	median 16 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
season	integer	No	the current season	Four-digit season year; defaults to the current season	2024
seasontype	integer	No		Season type Allowed values: 1, 2, 3.	2
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/espn/standings?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": 2024
    },
    "source_url": "https://site.api.espn.com/apis/v2/sports/football/nfl/standings?season=2024",
    "fetched_at": "2026-07-06T00:00:00Z",
    "groups": [
      {
        "name": "American Football Conference",
        "abbreviation": "AFC",
        "entries": [
          {
            "team": {
              "id": "12",
              "display_name": "Kansas City Chiefs"
            },
            "stats": {
              "wins": "15",
              "losses": "2"
            }
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/espn.standingsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	espn.StandingsResponse	No
data.fetched_at	string	No
data.groups	array	No
data.groups[].abbreviation	string	No
data.groups[].entries	array	No
data.groups[].entries[].note	string	No
data.groups[].entries[].stats	object	No
data.groups[].entries[].team	espn.TeamRef	No		TeamRef record, 10 fields: abbreviation, alternate_color, color, display_name, id, location, logo, name, short_display_name, uid. Described under ESPN team list API.
data.groups[].name	string	No
data.league	string	No
data.league_name	string	No
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
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/standings?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 scoreboard API documentation ESPN team roster API documentation

Open in Playground Back to group

Docs menu

ESPN API endpoint

ESPN standings API

GETapiKey1 credit/requestESPNespn.standingsResponseDoc/espn/standings

Endpoint facts

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

ESPN API Try ESPN standings 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.
season: optional integer. Four-digit season year, e.g. 2024. Defaults to the current season.
seasontype: optional enum. Allowed values: 1 (preseason), 2 (regular season), 3 (postseason).

Notable response behavior:

Standings are flattened from ESPN's nested tree into groups, each with entries; each entry carries a flat stats map (e.g. wins, losses, winPercent).
A response with no entries is treated as an upstream error (parser drift or block).
Invalid sport/league/season/seasontype values return an invalid-parameter error before upstream IO.

Live monitoring

Monitored request: GET /espn/standings?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/standings?league=nfl&sport=football
Items in groups: 2
Fields filled in every checked item: 3

Field	Filled in, of 2 checked	Values in the sample
name	2	“American Football Conference” and 1 other value
abbreviation	2	“AFC” and 1 other value
entries	2	median 16 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
season	integer	No	the current season	Four-digit season year; defaults to the current season	2024
seasontype	integer	No		Season type Allowed values: 1, 2, 3.	2
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/espn/standings?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": 2024
    },
    "source_url": "https://site.api.espn.com/apis/v2/sports/football/nfl/standings?season=2024",
    "fetched_at": "2026-07-06T00:00:00Z",
    "groups": [
      {
        "name": "American Football Conference",
        "abbreviation": "AFC",
        "entries": [
          {
            "team": {
              "id": "12",
              "display_name": "Kansas City Chiefs"
            },
            "stats": {
              "wins": "15",
              "losses": "2"
            }
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/espn.standingsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	espn.StandingsResponse	No
data.fetched_at	string	No
data.groups	array	No
data.groups[].abbreviation	string	No
data.groups[].entries	array	No
data.groups[].entries[].note	string	No
data.groups[].entries[].stats	object	No
data.groups[].entries[].team	espn.TeamRef	No		TeamRef record, 10 fields: abbreviation, alternate_color, color, display_name, id, location, logo, name, short_display_name, uid. Described under ESPN team list API.
data.groups[].name	string	No
data.league	string	No
data.league_name	string	No
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
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/standings?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 standings 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 standings 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