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

Seeding will show up under rank for home and away.

Obviously all depends on what you ultimately want to do with it. Here’s a couple of screen shots on how I make it work. I load tomorrow’s games on one sheet (attached). The far right column has check boxes. I manually select the ncaa tourney games and or games I want. I then run a script to lock those games and odds to a second sheet (attached). The teams and odds are stagnant. Then I pull the live data ie score clock etc with a vlookup.

How can i get api for live streaming sports video matches ??

Thanks for this!

Does anyone know if ESPN's API supports a query parameter like fields= to reduce response size?

I'm only interested in basic game info over a date range, like team names, kick-off time, scores. The /scoreboard request otherwise returns a lot of heft and is quite a big payload as a result.

@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

I see a tournamentId. Maybe that can be helpful. Id = 22 in some of these TBD games. If the seed shows up and the round we can use it. I see a ["notes"] key where they have "Men's Basketball Championship - 1st Round"
…
On Thu, Mar 13, 2025 at 12:39 PM jb082005 @.> wrote: @.* commented on this gist. ------------------------------ I wasn't able to find a tournament indicator in the ESPN endpoint. Let me know if you find one. … <#m_-3902739222069110977_> On Thu, Mar 13, 2025 at 12:02 PM cmwillett @.*> wrote: @.** commented on this gist. ------------------------------ If you query with a date range, you can get the scheduled games. This does include all college basketball games, but it does have the tournament games. For example: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/scoreboard?dates=20250320-20250323&groups=50&limit=500 Got ya. That makes sense as well. I'm sure there's an element stating it's a tourney game in there. — I believe you can use groups=100 for NCAA tournament games — Reply to this email directly, view it on GitHub https://gist.github.com/akeaswaran/b48b02f1c94f873c6655e7129910fc3b#gistcomment-5490654 or unsubscribe https://github.com/notifications/unsubscribe-auth/AANTBKNNZIKLTTG4XLI6BJD2UGYDHBFKMF2HI4TJMJ2XIZLTSKBKK5TBNR2WLJDUOJ2WLJDOMFWWLO3UNBZGKYLEL5YGC4TUNFRWS4DBNZ2F6YLDORUXM2LUPGBKK5TBNR2WLJDHNFZXJJDOMFWWLK3UNBZGKYLEL52HS4DFVRZXKYTKMVRXIX3UPFYGLK2HNFZXIQ3PNVWWK3TUUZ2G64DJMNZZDAVEOR4XAZNEM5UXG5FFOZQWY5LFVA4DGOBXGIZTEMVHORZGSZ3HMVZKMY3SMVQXIZI . You are receiving this email because you commented on the thread. Triage notifications on the go with GitHub Mobile for iOS https://apps.apple.com/app/apple-store/id1477376905?ct=notification-email&mt=8&pt=524675 or Android https://play.google.com/store/apps/details?id=com.github.android&referrer=utm_campaign%3Dnotification-email%26utm_medium%3Demail%26utm_source%3Dgithub .

This may help

http://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/events/401746030/competitions/401746030?lang=en&region=us

Thanks for this!

Does anyone know if ESPN's API supports a query parameter like fields= to reduce response size?

I'm only interested in basic game info over a date range, like team names, kick-off time, scores. The /scoreboard request otherwise returns a lot of heft and is quite a big payload as a result.

I've only come across that type of functionality when working with the MLB api. Is your main concern the time to complete or just the hassle of dealing with a heavily nested json?

Just wondering if anyone knew of anyway to get specific player stats for college basketball?

Kindly refer to the screenshot which reflects a play/Action in Basketball Game. Here you can see under co-ordinates (x, y) are given helpful in determining the position of the action made.

Similarly in football how can we figure out the position of the action made on the field. Are there some params that may assist in doing so ?

Also there is no information about the participants id who were involved in that play/action

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

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

I don't recall being able to coax just a league standings from my experiments but I wasn't focusing on that. Take a look at what I posted a couple months back. Between that and some of the other comments here about accessing the soccer data, you might be able to find a way to get just standings.

https://gist.github.com/akeaswaran/b48b02f1c94f873c6655e7129910fc3b?permalink_comment_id=5451438#gistcomment-5451438

are fantasy sports APIs documented anywhere?

I saw that this question was asked in 2021, but it never got a response. Hoping someone can help me out this time around. Any idea on how to get the tournament result summary information for a specific golfer in a similar way it is displayed here:

https://www.espn.com/golf/player/results/_/id/3702/rickie-fowler

Obviously you could query each tournament and get it that way, but that would be extremely inefficient for what I am trying to build. Any help would be greatly appreciated!

I saw that this question was asked in 2021, but it never got a response. Hoping someone can help me out this time around. Any idea on how to get the tournament result summary information for a specific golfer in a similar way it is displayed here:

https://www.espn.com/golf/player/results/_/id/3702/rickie-fowler

Obviously you could query each tournament and get it that way, but that would be extremely inefficient for what I am trying to build. Any help would be greatly appreciated!

I think there's a different endpoint that you'd prefer but I can't look for it until tonight

https://sports.core.api.espn.com/v2/sports/golf/leagues/pga/seasons/2024/athletes/3702/eventlog?lang=en&region=us

@zwheatley502 I was able to find this https://site.web.api.espn.com/apis/common/v3/sports/golf/athletes/3702/stats?season=2025

@zwheatley502 I was able to find this https://site.web.api.espn.com/apis/common/v3/sports/golf/athletes/3702/stats?season=2025

This is exactly what I was looking for! Thank you!

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