Skip to content

Instantly share code, notes, and snippets.

@akeaswaran

akeaswaran/espn-api-docs.md

Last active January 22, 2026 15:22
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save akeaswaran/b48b02f1c94f873c6655e7129910fc3b to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save akeaswaran/b48b02f1c94f873c6655e7129910fc3b to your computer and use it in GitHub Desktop.
Download ZIP
ESPN hidden API Docs
Raw
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...

@propsdaily
Copy link

propsdaily commented Dec 9, 2025

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

@hamzashiwani
Copy link

hamzashiwani commented Dec 9, 2025

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!

@RhettTitus
Copy link

RhettTitus commented Dec 10, 2025 •
edited
Loading

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

@downing034
Copy link

downing034 commented Jan 21, 2026 •
edited
Loading

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.

@ischmidt20
Copy link

ischmidt20 commented Jan 21, 2026

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment