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...

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

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

@apelt001 @BataBoom It looks like they separate leagues out by region, for reference you can check all leagues here:
https://sports.core.api.espn.com/v2/sports/basketball/leagues

I am trying to load college basketball player data (GP, MIN, PTS, etc) from prior years (the same thing that you can see on the team stats pages for prior years, https://www.espn.com/womens-college-basketball/team/stats/_/id/2294/season/2023). In the API team data I see only this season, and not really all of the player data I'm looking for and if I add a query for prior season it doesn't seem to chagne the data. Any idea how I can get prior year stats for players?

I know this is a little late but better late then ever. So i did something similar for mens colleage and created a loop to get whatever matups to a certain point

' current_year = date.today().year
year = current_year -1
matchup_data = []

while year >= 2024:  #You can do it to whatever year you would like here
    # Define season start and end dates for the given year
    start_date = date(year, 11, 4)  # Typically around early November
    end_date = date(year + 1, 3, 9)  # Typically around early March

    # Generate each day in the season date range
    current_date = start_date
    while current_date <= end_date:
        date_str = current_date.strftime("%Y%m%d")  # Format date as YYYYMMD

        url = f"https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/scoreboard?dates={date_str}"
       #change to your url for women 
        try:
            response = requests.get(url)
            response.raise_for_status()
            data = response.json()
        except requests.exceptions.RequestException as e:
            print(f"Error fetching scoreboard data for {date_str}: {e}")
            current_date += timedelta(days=1)
            continue`

This worked for me as I was building my algo out for men so hopefully this helps you with your analytics.

Can someone tell me all the available leagues, this api doesn't seem to cover all of them: https://site.api.espn.com/apis/site/v2/scoreboard/activeSports?v=1&editionKey=espn-en&lang=en&region=us

Can someone tell me all the available leagues, this api doesn't seem to cover all of them: https://site.api.espn.com/apis/site/v2/scoreboard/activeSports?v=1&editionKey=espn-en&lang=en&region=us

@daniyalmaster693 You can view all sports on this endpoint:
https://sports.core.api.espn.com/v2/sports

And then if you go a bit deeper, for each sport you can view leagues
https://sports.core.api.espn.com/v2/sports/basketball/leagues

Develop your website in a manner that it just consumes an object using the API data as middleware. Then when/if the ESPN API changes or fails, you just have to find a new source and your website continues. This is what I had to do with mine. NFL changed their API, or rather closed it down.

Hi @KevinDuganJr can you go into some detail on what you did. Sorry if this is a stupid question, I'm still very much a programming beginner.
Thanks

Develop your website in a manner that it just consumes an object using the API data as middleware. Then when/if the ESPN API changes or fails, you just have to find a new source and your website continues. This is what I had to do with mine. NFL changed their API, or rather closed it down.

Hi @KevinDuganJr can you go into some detail on what you did. Sorry if this is a stupid question, I'm still very much a programming beginner. Thanks

You create classes that your application will use. Let's say you're doing Schedule so you would have at least a Schedule class and Team class. Then you use the API to populate the properties of those classes. If you have an ongoing project, I could try to help guide you. I'm afraid I'm not good at wiring everything up in a chat window though haha.