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

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

2026 FIFA World Cup endpoint

https://site.api.espn.com/apis/site/v2/sports/soccer/fifa.world/scoreboard?limit=200&dates=20260611-20260719

After seeing Agate Types, Every Baseball Score, & Diamond College Baseball, I hate to post about my little, but long-time project (I first posted here back on page 2). (By the way, I'm glad someone got something out of the college baseball API; I found that Big 10 scores often ran a day late & just supplied a lousy RHE score.)

I have added a World Cup Python script to my set of on-demand command-line-oriented API scripts at https://github.com/ITIRadio/ESPN-API . Given the smaller number of games, use two parameters (earlier date first) for a date range, YYYYMMDD YYYYMMDD, one date for one day's games, or no parm for just today's games. For future games, the schedule is given from the scoreboard API. For games in progress, a brief summary with some stats & events is shown. For completed games (sometimes it takes overnight for box scores to be finalized), a full box score is given, with full team statistics, full player statistics, the game recap, and ESPN web site's text commentary log...so just about everything. And no AI-slop code...just sloppy code ;) . And by the way, @cheese-industries, no one has cared about my project ;) .

Anyway, I hope to reuse the new soccer code for a daily European club run down script this fall. I also need to get around to adding fumble recoveries & multi-SQLite database file support to my NFL box score & database / reporting system.

In the meantime, enjoy the soccer.

Hey @dtokarz1 super helpful thanks! Do you know of a way to get the specific hole breakdowns for a player? So what the scored on what hole by what round?

I know it's 6 years later but .. found it!

https://site.web.api.espn.com/apis/site/v2/sports/golf/pga/leaderboard/401811952/playersummary?season=2026&player=4690755