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

Hi everyone,
I’m trying to use the following ESPN API to fetch game summaries for college football: https://site.api.espn.com/apis/site/v2/sports/football/college-football/summary?event=ed11cbf3b02850670bf213622cf4517b
But it’s not working / returning errors for me.
Does anyone have an alternate solution or a reliable way to get college football game summaries / stats through ESPN or another free API?

@hamzashiwani That doesn't look like a valid eventID... example: https://site.api.espn.com/apis/site/v2/sports/football/college-football/summary?event=401777353

Cool thanks!

How do you get the current days NCAA men's college basketball schedule?

How do you get the current days NCAA men's college basketball schedule?

You should be able to hit the scoreboard endpoint to get any specific day's schedule.
https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/scoreboard?dates=20260120

Note to get every single game, you need to include the groups query param. It must be a higher number than the total games for the day.
https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/scoreboard?dates=20260120&groups=100

I also think if you just wanted today's at any point you can just drop the date query param.

How do you get the current days NCAA men's college basketball schedule?

You should be able to hit the scoreboard endpoint to get any specific day's schedule. https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/scoreboard?dates=20260120

Note to get every single game, you need to include the groups query param. It must be a higher number than the total games for the day. https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/scoreboard?dates=20260120&groups=100

I also think if you just wanted today's at any point you can just drop the date query param.

Add groups=50 to get games for all Division I and then limit=365 to ensure you actually get every game.

Is there any way to get the depth charts of nba teams? https://www.espn.com/nba/depth/_/type/full or https://www.espn.com/nba/team/depth/_/name/gsw

Is there any way to get the depth charts of nba teams? https://www.espn.com/nba/depth/_/type/full or https://www.espn.com/nba/team/depth/_/name/gsw

@Anibal00 You should be able to do something like this:
https://site.api.espn.com/apis/site/v2/sports/basketball/nba/teams/25/depthcharts where 25 is the team ID.

Is there any way to get the depth charts of nba teams? https://www.espn.com/nba/depth/_/type/full or https://www.espn.com/nba/team/depth/_/name/gsw

@Anibal00 You should be able to do something like this: https://site.api.espn.com/apis/site/v2/sports/basketball/nba/teams/25/depthcharts where 25 is the team ID.

thank you

Do we have cricket api?

All series:
https://site.api.espn.com/apis/personalized/v2/scoreboard/header?sport=cricket&region=in&tz=Asia/Calcutta

Per event:
https://site.web.api.espn.com/apis/site/v2/sports/cricket/23694/summary?contentorigin=espn&event=1490237&lang=en&region=in

Is there any way to get the scoreboards of nba games from the previous day? These NBA endpoints are still working?_

Is there any way to get the scoreboards of nba games from the previous day? These NBA endpoints are still working?_

Have you tried just appending yesterday's date like this: https://site.api.espn.com/apis/site/v2/sports/basketball/nba/scoreboard?dates=20250204 or use a range

Hello, I am currently using the following URL format to retrieve player avatar images by player ID:

https://a.espncdn.com/i/headshots/soccer/players/full/258909.png

However, I noticed that this URL does not return images for all player IDs. Could you please provide the correct URL format or the recommended way to reliably retrieve the avatar image for each player?

Just curious if anyone has been able to pull stats by period in the boxscores? Like 1Q Points in NBA for example. Or does ESPN only have full game stats?

Just curious if anyone has been able to pull stats by period in the boxscores? Like 1Q Points in NBA for example. Or does ESPN only have full game stats?

Sure live and completed in the scoreboard api. here is NBA https://site.api.espn.com/apis/site/v2/sports/basketball/nba/scoreboard drill down into linescores for each team.

If you use Home Assistant you can see how we use the api data for different sports that may help as well:
https://community.home-assistant.io/t/sports-standings-and-scores/547094/928

Here is one for the Superbowl that updates live until the end of the game and goes final.

Just curious if anyone has been able to pull stats by period in the boxscores? Like 1Q Points in NBA for example. Or does ESPN only have full game stats?

Sure live and completed in the scoreboard api. here is NBA https://site.api.espn.com/apis/site/v2/sports/basketball/nba/scoreboard drill down into linescores for each team.

If you use Home Assistant you can see how we use the api data for different sports that may help as well: https://community.home-assistant.io/t/sports-standings-and-scores/547094/928

Here is one for the Superbowl that updates live until the end of the game and goes final.

Thanks for the reply! I should've been more specific, looking for player individual stats by period

Hey, just wanted to share something I built using the endpoints in this thread: https://www.diamondcollegebaseball.com/

I'm not a developer by trade but I wanted a single place to follow all D1 college baseball scores without jumping between ESPN pages — so I used this gist (and a healthy dose of help from AI) to figure out how to pull the data. Shows live scores for every D1 game, box scores with individual batting and pitching lines (where available), ball/strike count, base runners (where available), outs, the whole thing. It also has a uniqe stats leader ticker that I haven't seen anywhere else. Covers all conferences including a filter for HBCU programs which I couldn't find anywhere else.

Took a while to figure out but it actually seems to work pretty well.

Hey, just wanted to share something I built using the endpoints in this thread: https://www.diamondcollegebaseball.com/

I'm not a developer by trade but I wanted a single place to follow all D1 college baseball scores without jumping between ESPN pages — so I used this gist (and a healthy dose of help from AI) to figure out how to pull the data. Shows live scores for every D1 game, box scores with individual batting and pitching lines (where available), ball/strike count, base runners (where available), outs, the whole thing. It also has a uniqe stats leader ticker that I haven't seen anywhere else. Covers all conferences including a filter for HBCU programs which I couldn't find anywhere else.

Took a while to figure out but it actually seems to work pretty well.

This is awesome! Thanks for Sharing -- I think it would look great if you had the school logo, adding a lookup to the /teams page by ID and capturing the logo!

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

That format does allow for viewing today's games (e.g. https://data.ncaa.com/casablanca/scoreboard/basketball-men/d1/2024/03/21/scoreboard.json), but I don't see how it could be used to retrieve the bracket ahead of time before the NCAA tournament begins. Any insight?

I haven't actually done this yet because I've been wrapped up in playbyplay data but my plan is to just recreate it based on what's in the json. All you need is ["bracketRegion"], ["bracketRound"], ["away"]["seed"], ["home"]["seed"]

we need the return of Jesus Shuttlesworth. Join the discord if you don’t mind saying hello https://discord.gg/6zZtPfU94

Claude and I built a website inspired by the box score pages newspapers used to print. Check out https://agatetypes.com. We're going through the motorsports data now to add that to the site. A fun site that reminds me of the Detroit Free Press sports pages I devoured as a kid.

Claude and I built a website inspired by the box score pages newspapers used to print. Check out https://agatetypes.com. We're going through the motorsports data now to add that to the site. A fun site that reminds me of the Detroit Free Press sports pages I devoured as a kid.

This is fun. A toggle of sports would make this better than the ESPN page

Claude and I built a website inspired by the box score pages newspapers used to print. Check out https://agatetypes.com. We're going through the motorsports data now to add that to the site. A fun site that reminds me of the Detroit Free Press sports pages I devoured as a kid.

This is super cool because it is so simple and clean! Love it!

Can I also plug my implementation, please? (Not as cool as the above but I tried my best)

Claude and I built a website inspired by the box score pages newspapers used to print. Check out https://agatetypes.com. We're going through the motorsports data now to add that to the site. A fun site that reminds me of the Detroit Free Press sports pages I devoured as a kid.

This is fun. A toggle of sports would make this better than the ESPN page

Yeah, it's on the list. The current way to each sport was to click on "Full box scores."

...5 minutes...

Done. It's not a toggle but the homepage now lets you click into each sport from the sports nav row at the top. I struggled with what to display on the homepage. Box scores for every sport with events that day would be REALLY long. I landed on using the home page as a quick way to see what's coming, scores for events that have ended, etc. but didn't initially have the sports nav as well. The added sport navigation should now make it easier to quickly get to a particular sport. F1, Nascar, and IndyCar added today. Working on formatting so when someone prints a page out, everything still formats alright.

Claude and I built a website inspired by the box score pages newspapers used to print. Check out https://agatetypes.com. We're going through the motorsports data now to add that to the site. A fun site that reminds me of the Detroit Free Press sports pages I devoured as a kid.

This is super cool because it is so simple and clean! Love it!

Can I also plug my implementation, please? (Not as cool as the above but I tried my best)

The more the merrier! Let's see what you built.

Claude and I built a website inspired by the box score pages newspapers used to print. Check out https://agatetypes.com. We're going through the motorsports data now to add that to the site. A fun site that reminds me of the Detroit Free Press sports pages I devoured as a kid.

This is super cool because it is so simple and clean! Love it!
Can I also plug my implementation, please? (Not as cool as the above but I tried my best)

The more the merrier! Let's see what you built.

https://t.me/espnfbot on Telegram. It took about 2 months to get it done with the features I had in mind even with the help of ChatGPT but I am kinda proud of it. I personally use it on a daily basis to follow MLB, Cricket and Football/Soccer. It also supports Tennis, NHL, NFL, NBA, Formula1 and college sports as well. Alerts and Favorites can be set up too. I tried not to dump all the data available from ESPN into the match details while giving the most important information to the user.
Finally, a dashboard for a quick glance at all the recent, live and upcoming matches of your favorites.

Right now it has about 850+ total users, which I'm happy with. I guess less users the better, because you never know when the ESPN API free ride will end!

Hey, just wanted to share something I built using the endpoints in this thread: https://www.diamondcollegebaseball.com/

I'm not a developer by trade but I wanted a single place to follow all D1 college baseball scores without jumping between ESPN pages — so I used this gist (and a healthy dose of help from AI) to figure out how to pull the data. Shows live scores for every D1 game, box scores with individual batting and pitching lines (where available), ball/strike count, base runners (where available), outs, the whole thing. It also has a uniqe stats leader ticker that I haven't seen anywhere else. Covers all conferences including a filter for HBCU programs which I couldn't find anywhere else.

Took a while to figure out but it actually seems to work pretty well.

That ticker is really eye-catching! I love the full inning snapshot too.

Some notes and opinions:

1. I think the ticker is a tad bit slow. I think it can be quicker by about 2-3x the current speed. Something like 1 match/stat leader can be in the view per 3 seconds.
2. Is it possible to add MLB? I follow Dodgers and Yankees and would love to use this sleek UI to follow their matches. If College Baseball is your only vision then I totally understand.
3. I feel the filters (All, Upcoming, Live, Stat leaders etc) are a bit crowded. Maybe some of them can be in the hamburger menu? I'm not sure.

Thank you for this site. It is a perfect combination of retro static pages and a modern look.

I’ve used the ESPN endpoints for a lot of projects, but I built https://everybaseballscore.com <https://everybaseballscore.com/> using the MLB.com <http://mlb.com/> API. (There are NBA/NHL/NCAA versions as well if you go to the hamburger menu up top. Those use the ESPN endpoints.) I try not to toot my own horn because that’s not really who I am, but EveryBaseballScore has gotten my foot in the door to get hired for a couple of full-time dev roles despite no formal education in computer science. I’m pretty proud of it. I love the other projects people in this thread have mentioned. Keep up the great work, everyone!

…

On May 18, 2026, at 6:44 PM, Suhasa ***@***.***> wrote: @suhasa010 commented on this gist. Hey, just wanted to share something I built using the endpoints in this thread: https://www.diamondcollegebaseball.com/ I'm not a developer by trade but I wanted a single place to follow all D1 college baseball scores without jumping between ESPN pages — so I used this gist (and a healthy dose of help from AI) to figure out how to pull the data. Shows live scores for every D1 game, box scores with individual batting and pitching lines (where available), ball/strike count, base runners (where available), outs, the whole thing. It also has a uniqe stats leader ticker that I haven't seen anywhere else. Covers all conferences including a filter for HBCU programs which I couldn't find anywhere else. Took a while to figure out but it actually seems to work pretty well. That ticker is really eye-catching! I love the full inning snapshot too. Some notes and opinions: I think the ticker is a tad bit slow. I think it can be quicker by about 2-3x the current speed. Something like 1 match/stat leader can be in the view per 3 seconds. Is it possible to add MLB? I follow Dodgers and Yankees and would love to use this sleek UI to follow their matches. If College Baseball is your only vision then I totally understand. I feel the filters (All, Upcoming, Live, Stat leaders etc) are a bit crowded. Maybe some of them can be in the hamburger menu? I'm not sure. Thank you for this site. It is a perfect combination of retro static pages and a modern look. — Reply to this email directly, view it on GitHub <https://gist.github.com/akeaswaran/b48b02f1c94f873c6655e7129910fc3b#gistcomment-6155933> or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAPDKPI4QWZ4JAYVB2IHC6D43OG5FBFHORZGSZ3HMVZKMY3SMVQXIZNMON2WE2TFMN2F65DZOBS2WR3JON2EG33NNVSW45FGORXXA2LDOOIYFJDUPFYGLJDHNFZXJJLWMFWHKZNIHAZTQNZSGMZDFKTBOR2HE2LCOV2GK44TQKSXMYLMOVS2QMJRG42TMOJSGKSG4YLNMWUGCY3UN5ZF62LEQKSXMYLMOVS2I5DSOVS2I3TBNVS3W5DIOJSWCZC7OBQXE5DJMNUXAYLOORPWCY3UNF3GS5DZQKSXMYLMOVS2IZ3JON2KI3TBNVS2W5DIOJSWCZC7OR4XAZI>. 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>.