ESPN hidden API Docs

espn-api-docs.md

ESPN's hidden API endpoints

Football

College Football

Latest News: http://site.api.espn.com/apis/site/v2/sports/football/college-football/news

Latest Scores: http://site.api.espn.com/apis/site/v2/sports/football/college-football/scoreboard

• query params:

  • calendar: 'blacklist'
  • dates: any date in YYYYMMDD

Game Information: http://site.api.espn.com/apis/site/v2/sports/football/college-football/summary?event=:gameId

• params:

  • gameId: identifier of some game (EX: 400934572 for 2017 Army vs Navy)

Team Information: http://site.api.espn.com/apis/site/v2/sports/football/college-football/teams/:team

• params:

  • team: some team abbreviation (EX: 'all' for Allegheny, 'gt' for Georgia Tech, 'wisconsin' for Wisconsin)

Rankings: http://site.api.espn.com/apis/site/v2/sports/football/college-football/rankings

NFL

Scores: http://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard

News: http://site.api.espn.com/apis/site/v2/sports/football/nfl/news

All Teams: http://site.api.espn.com/apis/site/v2/sports/football/nfl/teams

Specific Team: http://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/:team

Baseball

MLB

Scores: http://site.api.espn.com/apis/site/v2/sports/baseball/mlb/scoreboard

News: http://site.api.espn.com/apis/site/v2/sports/baseball/mlb/news

All Teams: http://site.api.espn.com/apis/site/v2/sports/baseball/mlb/teams

Specific Team: http://site.api.espn.com/apis/site/v2/sports/baseball/mlb/teams/:team

College Baseball

Scores: https://site.api.espn.com/apis/site/v2/sports/baseball/college-baseball/scoreboard

Hockey

Scores: http://site.api.espn.com/apis/site/v2/sports/hockey/nhl/scoreboard

News: http://site.api.espn.com/apis/site/v2/sports/hockey/nhl/news

All Teams: http://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams

Specific Team: http://site.api.espn.com/apis/site/v2/sports/hockey/nhl/teams/:team

Basketball

NBA

Scores: http://site.api.espn.com/apis/site/v2/sports/basketball/nba/scoreboard

News: http://site.api.espn.com/apis/site/v2/sports/basketball/nba/news

All Teams: http://site.api.espn.com/apis/site/v2/sports/basketball/nba/teams

Specific Team: http://site.api.espn.com/apis/site/v2/sports/basketball/nba/teams/:team

WNBA

Scores: http://site.api.espn.com/apis/site/v2/sports/basketball/wnba/scoreboard

News: http://site.api.espn.com/apis/site/v2/sports/basketball/wnba/news

All Teams: http://site.api.espn.com/apis/site/v2/sports/basketball/wnba/teams

Specific Team: http://site.api.espn.com/apis/site/v2/sports/basketball/wnba/teams/:team

Women's College Basketball

Scores: http://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/scoreboard

News: http://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/news

All Teams: http://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams

Specific Team: http://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams/:team

Men's College Basketball

Scores: http://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/scoreboard

News: http://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/news

All Teams: http://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams

Specific Team: http://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/:team

Soccer

Scores: http://site.api.espn.com/apis/site/v2/sports/soccer/:league/scoreboard

• params:

  • league: some league abbreviation (EX: 'eng.1' for EPL, 'usa.1' for MLS)

Latest News: http://site.api.espn.com/apis/site/v2/sports/soccer/:league/news

List of Team Information: http://site.api.espn.com/apis/site/v2/sports/soccer/:league/teams

Will update with more information as I find more...

Does anybody have the college softball endpoint?

Does anybody have the college softball endpoint?

@mrioslecaros baseball/college-softball

https://site.web.api.espn.com/apis/site/v2/sports/baseball/college-softball/scoreboard

Has anyone else noticed the in-game updates for MLB now seem to be updated at the end of each at-bat rather than after each pitch. As a result, the count isn't updated. Just checking to see if anyone is seeing balls and strikes come through this year.

Does anyone have soccer, tennis and basketball endpoint

Does anyone have soccer, tennis and basketball endpoint

Endpoints to what exactly? Soccer and Basketball are documented.

Does anyone have soccer, tennis and basketball endpoint

Endpoints to what exactly? Soccer and Basketball are documented.

Soccer/Basketball fixtures & match update, team info & lineups

Also i'm looking into getting match video stream source link

Does anybody have the college softball endpoint?

@mrioslecaros baseball/college-softball

https://site.web.api.espn.com/apis/site/v2/sports/baseball/college-softball/scoreboard

Thank you so much!

I am planning on building a sports analysis excel sheet for my Capstone project. I was wondering if anyone have endpoints on getting historical / current data on the teams of NFL, NBA, NHL and WNBA.

If you happen to already have the script please mention me or post it below..

Thank you for the help .

Does anyone have soccer, tennis and basketball endpoint

Endpoints to what exactly? Soccer and Basketball are documented.

Soccer/Basketball fixtures & match update, team info & lineups

Also i'm looking into getting match video stream source link

@propsdaily do you have this one

Does anyone have soccer, tennis and basketball endpoint

Endpoints to what exactly? Soccer and Basketball are documented.

Soccer/Basketball fixtures & match update, team info & lineups

Also i'm looking into getting match video stream source link

How can i get players in a team -
team endpoint - https://site.api.espn.com/apis/site/v2/sports/soccer/eng.1/teams/349 ??

does anyone know if there's an endpoint for seeing the standings of a soccer league?

should look something like this

http://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/seasons/2024/types/1/standings

ive been working on a python client for the espn api

I am planning on building a sports analysis excel sheet for my Capstone project. I was wondering if anyone have endpoints on getting historical / current data on the teams of NFL, NBA, NHL and WNBA.

If you happen to already have the script please mention me or post it below..

Thank you for the help .

i have been working on a python client for this. i have a function you can use to pull a seasons stats by team (i have not tested how far it goes back though)

https://github.com/EnderLocke/pyespn

Does anyone have soccer, tennis and basketball endpoint

Endpoints to what exactly? Soccer and Basketball are documented.

Soccer/Basketball fixtures & match update, team info & lineups
Also i'm looking into getting match video stream source link

How can i get players in a team - team endpoint - https://site.api.espn.com/apis/site/v2/sports/soccer/eng.1/teams/349 ??

You can do something like this:
https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/seasons/2024/teams/349/athletes?active=true

OR:
https://site.api.espn.com/apis/site/v2/sports/soccer/eng.1/teams/349/roster

@ryanbuckner , do you know if there's a way to put a date range into the ncaa api url? I'd like to be able to pull all of this weekend's games. https://data.ncaa.com/casablanca/scoreboard/basketball-men/d1/2025/03/20/scoreboard.json

you can access specific dates or date ranges of events within the espn api. it looks something like this

http://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/events?dates=20250313-20250410

my python package pulls a lot of this by just creating the client and running a function though 😊

Does anyone have soccer, tennis and basketball endpoint

Endpoints to what exactly? Soccer and Basketball are documented.

Soccer/Basketball fixtures & match update, team info & lineups
Also i'm looking into getting match video stream source link

How can i get players in a team - team endpoint - https://site.api.espn.com/apis/site/v2/sports/soccer/eng.1/teams/349 ??

You can do something like this: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/seasons/2024/teams/349/athletes?active=true

OR: https://site.api.espn.com/apis/site/v2/sports/soccer/eng.1/teams/349/roster

Okay, thanks

http://site.api.espn.com/apis/site/v2/sports/golf/pga/scoreboard

wanted to share golf into this mix shall anyone be looking for it.

Does anyone have the minor league baseball endpoint?

Out of curiosity, does anyone know if the api for the schedules has changed?

In the past I have been using the following to pull an entire schedule for a specific team.

https://site.api.espn.com/apis/site/v2/sports/football/college-football/teams/2306/schedule?season=2025

But right now the events array just comes back empty.

Any ideas or suggestions?

TIA

Women's college soccer:

• https://site.api.espn.com/apis/site/v2/sports/soccer/usa.ncaa.w.1/news
• https://site.api.espn.com/apis/site/v2/sports/soccer/usa.ncaa.w.1/scoreboard
• https://site.api.espn.com/apis/site/v2/sports/soccer/usa.ncaa.w.1/rankings

Women's college volleyball

• https://site.api.espn.com/apis/site/v2/sports/volleyball/womens-college-volleyball/rankings
• https://site.api.espn.com/apis/site/v2/sports/volleyball/womens-college-volleyball/scoreboard

Out of curiosity, does anyone know if the api for the schedules has changed?

In the past I have been using the following to pull an entire schedule for a specific team.

https://site.api.espn.com/apis/site/v2/sports/football/college-football/teams/2306/schedule?season=2025

But right now the events array just comes back empty.

Any ideas or suggestions?

TIA

@BStenfors9119 Try passing in a season type:
https://site.api.espn.com/apis/site/v2/sports/football/college-football/teams/2306/schedule?season=2025&seasontype=2

Out of curiosity, does anyone know if the api for the schedules has changed?
In the past I have been using the following to pull an entire schedule for a specific team.
https://site.api.espn.com/apis/site/v2/sports/football/college-football/teams/2306/schedule?season=2025
But right now the events array just comes back empty.
Any ideas or suggestions?
TIA

@BStenfors9119 Try passing in a season type: https://site.api.espn.com/apis/site/v2/sports/football/college-football/teams/2306/schedule?season=2025&seasontype=2

Thank you so much @propsdaily !! This is huge!! 🔥❤️

In the scoreboard endpoints for each individual sport (ex: https://site.api.espn.com/apis/site/v2/sports/baseball/mlb/scoreboard) does anyone know all the possible values for event status name (see below)?

The values I am aware of:

• STATUS_SCHEDULED
• STATUS_IN_PROGRESS
• STATUS_FINAL

The reason I am asking is I would like to filter out any events that are postponed, cancelled, etc., but have not noticed if those are the only possible values or not. Thanks!

Has anyone else noticed the in-game updates for MLB now seem to be updated at the end of each at-bat rather than after each pitch. As a result, the count isn't updated. Just checking to see if anyone is seeing balls and strikes come through this year.

I have balls and strikes etc -- Might be a change of something there you want to check.

In the scoreboard endpoints for each individual sport (ex: https://site.api.espn.com/apis/site/v2/sports/baseball/mlb/scoreboard) does anyone know all the possible values for event status name (see below)?

The values I am aware of:

• STATUS_SCHEDULED
• STATUS_IN_PROGRESS
• STATUS_FINAL

The reason I am asking is I would like to filter out any events that are postponed, cancelled, etc., but have not noticed if those are the only possible values or not. Thanks!

STATUS_POSTPONED = rail delayed etc just confirmed.

I'm looking for suggestions gathering games for all weeks of NFL season upcoming

https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard

this is the baseline url, now i was trying to get games for week 2, 3 etc. I have tried adding season type but havent found success. Any help, many thanks

I'm looking for suggestions gathering games for all weeks of NFL season upcoming

https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard

this is the baseline url, now i was trying to get games for week 2, 3 etc. I have tried adding season type but havent found success. Any help, many thanks

https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?seasontype=2&week=1&dates=2025

Change seasontype to 1 if you want preseason.

Many thanks for this so quickly -

If anyone's interested: I've gotten pretty far with creating an OpenAPI spec for ~200 endpoints that I've found: https://github.com/aaronweldy/espn-openapi
Fully typed-out definitions for all of the endpoints listed here.

Does anyone know the league parameter name for NBA summer league?

If anyone's interested: I've gotten pretty far with creating an OpenAPI spec for ~200 endpoints that I've found: https://github.com/aaronweldy/espn-openapi Fully typed-out definitions for all of the endpoints listed here.

Fire! Very cool.

Also wondering if anyone has a param for NBA summer league