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

for this?

https://www.espn.com/soccer/scoreboard

no, for MMA/UFC. Nevertheless, please show how it looks for soccer

Does anyone know how to get "only" the College Bowl games!?

I've pulled a ton of data using this API for NFL, MLB, and NHL into PowerBI. Organizes the data and I have some visuals ready to go. I'd be willing to share the .pbix file if anyone can suggest a good way of doing so and/or if that would help someone?

Wow, thanks for sharing.

does anyone know how to use log in api and generate the required Cookie to use other apis? For example changing the leage setting requires sending the Cookie from header and I guess it uses it for authentication purpose.

is anyone else getting errors with the NFL gamelog endpoint for previous years? this just started happening to me today: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/8439/gamelog?season=2022

{"code":3001,"detail":"timeout error: timeout occurred waiting for core endpoint"}

is anyone else getting errors with the NFL gamelog endpoint for previous years? this just started happening to me today: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/8439/gamelog?season=2022

{"code":3001,"detail":"timeout error: timeout occurred waiting for core endpoint"}

Getting this error on some current gamelogs as well: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/4362249/gamelog?season=2024

**EDIT: All looks to be working now, so appears to be an across the board outage yesterday

I know yesterday when I was doing a show if you went to a player profile at ESPN.com and looked at their game log there was no data but that seems to be fixed now. I wonder if perhaps they moved the source of the data?

Anyone able to get play-by-play data of MMA? Basically I am looking for the "timeline" of a fight.

if it doesn't exist on the website you probably won't find it in the api. The best I could find is something like this for UFC308:
https://site.web.api.espn.com/apis/common/v3/sports/mma/ufc/fightcenter/600044733

Looks like a good starting endpoint (that's a weird phrase) for UFC fights would be:
https://site.api.espn.com/apis/personalized/v2/scoreboard/header?sport=mma&league=ufc

and for MMA would be:
https://site.api.espn.com/apis/personalized/v2/scoreboard/header?sport=mma

the thing that sucks about this is that I want news just for the knicks, however I can't get that. I only get links to the news vs api links to the news. I want to add that to my site I am making somethign for fun but I can't get this to work in my favor, is there an endpoint that allows me actual news besides the 6 articles that change hourly

Anyone able to get play-by-play data of MMA? Basically I am looking for the "timeline" of a fight.

if it doesn't exist on the website you probably won't find it in the api. The best I could find is something like this for UFC308: https://site.web.api.espn.com/apis/common/v3/sports/mma/ufc/fightcenter/600044733

Looks like a good starting endpoint (that's a weird phrase) for UFC fights would be: https://site.api.espn.com/apis/personalized/v2/scoreboard/header?sport=mma&league=ufc

and for MMA would be: https://site.api.espn.com/apis/personalized/v2/scoreboard/header?sport=mma

I have not tried never cared about doing this but maybe I will try to help tomorrow or monday evening :)

never mind I figured out the team news thing with this link thanks a lot ;)
https://site.api.espn.com/apis/site/v2/sports/basketball/nba/news?team=ny

can I use this to get specific teams stats such as turnovers, offensive efficiency, defensive efficiency, rushing defense, etc etc

I think you can you have to learn how to like for news with NBA I had to add ?team=ny

Anyone know how to get statistics for a certain season for a NBA player i.e. Luka Doncic 2024-2025 stats?

https://site.api.espn.com/apis/site/v2/sports/basketball/nba/teams/ny/roster you might be able to do something like this with that team it is getting me team roster you have to fiddle with it @jdgilhuly

Is it possible to get injury data for soccer from this somehow?