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

Yes, I can confirm neither https://site.web.api.espn.com/apis/site/v2/sports/football/college-football/scoreboard?seasontype=2&limit=120&dates=20260918-20260920, nor https://site.api.espn.com/apis/site/v2/sports/football/college-football/scoreboard?seasontype=2&limit=120&dates=20260918-20260920 work. (Putting "web" in the URL stub makes no difference.)

Date range queries have been blocked, probably permanently, as of yesterday. All of my apps at https://github.com/ITIRadio/ESPN-API have been broken at once, although most of the Python scripts had code to accept one day at a time on the command line anyway. I just used a range because it worked for years, and in case I wanted to allow for a range in the future. But, I was definitely wanting to call the API 1-2 times per day per game maximum, and save output locally. Unfortunately, the block is "dumb", "?dates=20260915-20260915", returning one date anyway, doesn't work either.

However, https://site.api.espn.com/apis/site/v2/sports/football/college-football/scoreboard?seasontype=2&limit=120&dates=20260918, with just one date, and not a range is still working, for now. The "web" in the URL stub is still optional.

I would agree with @robster2001, their site doesn't need it. Their site does have schedules, so there is probably another, unknown hidden endpoint, but I have no insights to help with that.

I've always felt like I'm on borrowed time with this thing, but the AI slop-masters are going to ruin it for everybody. At least I know how to code.

The best alternative is probably using the date parameter to get the schedule for the entire month. Then write a function to just organize the array of games based on the date parameters you need

In a change in the last 24 hours, the dates=(year) parameter is working again, but it's literal, and you get all events for the calendar year,

So you may end up having to use dates=2026 and dates=2027 on separate passes because dates=2026-2027 and dates=2026-27 both fail.

If they want me to pull more data and manually filter it, I'm fine with that. I guess there's too much of a cost to them to filter on their side... :)

Agreed, it sounds like a query compute issue, though without knowledge of their back end (the whole thing is quite the black box), who knows. All of the slop apps hitting their API are forcing them to reduce & simplify compute wherever possible. Having the year parm available allows their site & app to build a schedule for display without building another endpoint, and transferring the compute to the client side (as though loading their front end web site isn't obese enough). Reddit was sure that adding .web after "site" in the endpoint URL was the issue, so thanks to @pbrFresh & @robster2001 for the correct solution (& thanks for testing the year parm)!

In addition to the YYYY value for a full year, you can use YYYYMM to get the events for that specific month.

&week=# also works, at least for /nfl and /college-football , It's actually easier for me than the date ranges.

In addition to the YYYY value for a full year, you can use YYYYMM to get the events for that specific month.

Not the whole month, but rather the first 100th events of the month (for example, nba last event date for october is 2026-10-25).

I think the default is 100 events for NBA, try adding limit=300 and you can see all 155 events.

Oh nice, thank you.