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

Does anyone know how to get CFB standings for FCS and Divison II/III?

endpoints para ver as seleºões femininas, por exemplo a liga portuguesa feminina.

I'm looking to pull all NFL scores for the current week, but I don't know when the API updates to the next week's matchups. I know it happens pretty quick, but I need my script to fire before it updates. Does anyone know when the week changes?

It changes every minute.  You can see my google sheets for implementation Ryan ***@***.*** Aug 28, 2023, at 10:25 PM, jshef16 ***@***.***> wrote:Re: ***@***.*** commented on this gist.I'm looking to pull all NFL scores for the current week, but I don't know when the API updates to the next week's matchups. I know it happens pretty quick, but I need my script to fire before it updates. Does anyone know when the week changes?—Reply to this email directly, view it on GitHub or unsubscribe.You are receiving this email because you commented on the thread.Triage notifications on the go with GitHub Mobile for iOS or Android.                                                           

Why doesn't it show all the college football games? Both https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events and https://site.api.espn.com/apis/site/v2/sports/football/college-football/scoreboard only show 23 games but you can clearly see for week 2 there is much more: https://www.espn.com/college-football/schedule/_/week/2

Why doesn't it show all the college football games? Both https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events and https://site.api.espn.com/apis/site/v2/sports/football/college-football/scoreboard only show 23 games but you can clearly see for week 2 there is much more: https://www.espn.com/college-football/schedule/_/week/2

See this link from last year. You gotta pass in a “group” param to get all FBS. By default it just returns top 25 games.

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

Why doesn't it show all the college football games? Both https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events and https://site.api.espn.com/apis/site/v2/sports/football/college-football/scoreboard only show 23 games but you can clearly see for week 2 there is much more: https://www.espn.com/college-football/schedule/_/week/2

See this link from last year. You gotta pass in a “group” param to get all FBS. By default it just returns top 25 games.

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

Interesting - you would think the page count would be more than one without specifying the group {"$meta":{"parameters":{"week":["2"],"groups":[""],"season":["2023"],"seasontypes":["2"]}},"count":23,"pageIndex":1,"pageSize":25,"pageCount":1,"items":[

Why doesn't it show all the college football games? Both https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events and https://site.api.espn.com/apis/site/v2/sports/football/college-football/scoreboard only show 23 games but you can clearly see for week 2 there is much more: https://www.espn.com/college-football/schedule/_/week/2

See this link from last year. You gotta pass in a “group” param to get all FBS. By default it just returns top 25 games.
https://gist.github.com/akeaswaran/b48b02f1c94f873c6655e7129910fc3b?permalink_comment_id=4284742#gistcomment-4284742

Interesting - you would think the page count would be more than one without specifying the group {"$meta":{"parameters":{"week":["2"],"groups":[""],"season":["2023"],"seasontypes":["2"]}},"count":23,"pageIndex":1,"pageSize":25,"pageCount":1,"items":[

You can also pass in a “limit” param to get more in your results. Like ‘&limit=200’

Anyone know if there is a way to view the endpoint json schemas? For example, would like to view the json schema for College Football Team (http://site.api.espn.com/apis/site/v2/sports/football/college-football/teams/:team). Reasoning for this I am using Paste Special > JSON to create models for a C# application. Depending on team I noticed not all JSON objects and keys maybe be present at time of loading the JSON result. Ideally they would have a schema that models full JSON result.

Anyone know if there is a way to view the endpoint json schemas? For example, would like to view the json schema for College Football Team (http://site.api.espn.com/apis/site/v2/sports/football/college-football/teams/:team). Reasoning for this I am using Paste Special > JSON to create models for a C# application. Depending on team I noticed not all JSON objects and keys maybe be present at time of loading the JSON result. Ideally they would have a schema that models full JSON result.

https://site.api.espn.com/apis/site/v2/sports/football/nfl/seasons/2023/teams/29?lang=en&region=us

@BataBoom Thanks, for informing about the seasons endpoint, but was not what I was looking for. For those wondering @BataBoom added that can hit:

https://site.api.espn.com/apis/site/v2/sports/football/college-football/seasons/2023/teams/2305?lang=en&region=us

Instead of:

https://site.api.espn.com/apis/site/v2/sports/football/college-football/teams/2305

The first endpoint provides extended next event information (full season).

What I am trying to find out is if it is possible to load the JSON schemas directly which normally gives the model results. This is normally outlined in the following header:

But if you try loading https://site.api.espn.com/teamSummary.json get a 403 Forbidden. Either I am trying to load incorrect URL or they just have it blocked...

Hey there folks,

I've been working with these endpoints quite a bit recently and built a couple of APIs that build upon/work well with these ESPN endpoints. I know plenty of people are asking around for additional endpoints so I just thought I'd drop this here and hopefully help a few of y'all out. If you need featured news, additional league news, live scores, box scores, upcoming events, expanded leagues, teams, etc., come check them out at: https://rapidapi.com/makenoise-media-makenoise-media-default/api/score-room

I'm always adding new features and endpoints and I'm around to help with any questions if you have them!

Cheers!
:)

It's football time again so I'm putting up some links to some of the ESPN/NFL stuff I've built. It's part of my online football pool updated to not use any of my stored data.
https://bigearthweb.com/football-espn/
Not a lot to it really. A few PHP files & classes that get data from ESPN, some jquery to fire navigation & loaders and CSS. It uses these end points:

http://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard
https://site.web.api.espn.com/apis/v2/sports/football/nfl/standings?season=[year]&level=[level]
http://site.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=[event_id]

This version just reads and formats data. The online version writes some of the current data to SQL and JSON. I've also included some tiny little logos because if a team no longer exists, ESPN doesn't have a logo for it (Or I can't find it). What it does is get whatever data it can for game stats (Team stats, Leader stats and Drives), standings and post season results from as far back as 1999 to the present. Here are the files if you're interested:
https://bigearthweb.com/football-espn/espn-football.7z

Anyone got an API that I could get football highlights from?

Anyone got an API that I could get football highlights from?

@RexStev Not sure exactly what you're looking for, but this may help. All types of stats, news, game/player info, etc. https://rapidapi.com/makenoise-media-makenoise-media-default/api/score-room.

Is there a way to get the NHL scores endpoint to return a range of dates rather than 1 day per call?

currently using: "http://site.api.espn.com/apis/site/v2/sports/hockey/nhl/scoreboard?limit=500&dates=" + day

It sounds like one site is in ZULU and the other is not.

…

On Tue, Sep 26, 2023 at 3:36 AM Hamza Nasir ***@***.***> wrote: ***@***.**** commented on this gist. ------------------------------ An interesting observation I have regarding the endpoint by @seanrco <https://github.com/seanrco>: https://site.api.espn.com/apis/site/v2/sports/football/college-football/seasons/2023/teams/2440?lang=en&region=us . The above is for Nevada Wolf Pack, and looking at their schedule and comparing it to ESPN's official website, the Zulu conversion seems to be off (or I'm just doing it wrong), where all the time's gotten from nextEvent objects need to add +5 hours to get the same time for upcoming games in ESPN's official website. Feel free to correct me if I'm wrong though! — Reply to this email directly, view it on GitHub <https://gist.github.com/akeaswaran/b48b02f1c94f873c6655e7129910fc3b#gistcomment-4704372> or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAHGUPE3L5OZ6NB6NKE3CALX4KHYPBFKMF2HI4TJMJ2XIZLTSKBKK5TBNR2WLJDHNFZXJJDOMFWWLK3UNBZGKYLEL52HS4DFQKSXMYLMOVS2I5DSOVS2I3TBNVS3W5DIOJSWCZC7OBQXE5DJMNUXAYLOORPWCY3UNF3GS5DZVRZXKYTKMVRXIX3UPFYGLK2HNFZXIQ3PNVWWK3TUUZ2G64DJMNZZDAVEOR4XAZNEM5UXG5FFOZQWY5LFVA4DGOBXGIZTEMVHORZGSZ3HMVZKMY3SMVQXIZI> . 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> .

-- * David Pilkinton* *VP of Development* Business Technology, INC. <http://www.bti.tv> 301 Mallory Station Rd. Franklin, TN. 37067 *T. 615-591-1900* *F. 615-591-1909*

------------------------------ *Disclaimer: This electronic message may contain information that is Proprietary, Confidential, or legally privileged or protected. It is intended only for the use of the individual(s) and entity named in the message. If you are not an intended recipient of this message, please notify the sender immediately and delete the material from your computer. Do not deliver, distribute or copy this message and do not disclose its contents or take any action in reliance on the information it contains.* ------------------------------

-- _Disclaimer: This electronic message may contain information that is Proprietary, Confidential, or legally privileged or protected. It is intended only for the use of the individual(s) and entity named in the message. If you are not an intended recipient of this message, please notify the sender immediately and delete the material from your computer. Do not deliver, distribute or copy this message and do not disclose its contents or take any action in reliance on the information it contains._

This is awesome! Has anyone found anything regarding rugby scores? For example - the National Rugby League? I have yet to find anything.

NRL: https://site.api.espn.com/apis/site/v2/sports/rugby-league/3/scoreboard
RWC: https://site.api.espn.com/apis/site/v2/sports/rugby/164205/scoreboard

Hi all,
I want to make a dashboard about the our own Pigskin'em group.
Is there any API to use the Pick'em picks or group data?

Many thanks in advance for any thoughts.

Current drive for college football?
I am trying to have a site get live data for a few different sports and one is college football. However when I use the following endpoint:
http://site.api.espn.com/apis/site/v2/sports/football/college-football/summary?event=401524023
And I am getting a really old current drive:

This is a drive from COLO from the start of the 3rd quarter but it is currently the strart of the 4th now:

Other data like possession, score, and stats are being updated but not the drives, both current and previous. Anyone else run into this?

Current drive for college football? I am trying to have a site get live data for a few different sports and one is college football. However when I use the following endpoint: http://site.api.espn.com/apis/site/v2/sports/football/college-football/summary?event=401524023 And I am getting a really old current drive:

This is a drive from COLO from the start of the 3rd quarter but it is currently the strart of the 4th now:

Other data like possession, score, and stats are being updated but not the drives, both current and previous. Anyone else run into this?

@isaiahscheel
I had to build my own API and endpoints because ESPN's old ones simply weren't cutting it. I actually saw your comment and decided to add the play-by-play endpoint to my API for folks to use. Hopefully, this helps :)

https://rapidapi.com/makenoise-media-makenoise-media-default/api/score-room (fetchPlayByPlay endpoint)

Let me know if it doesn't have what you're looking for and I'll see if I can include what you are!

Is there a way to get the NHL scores endpoint to return a range of dates rather than 1 day per call?

currently using: "http://site.api.espn.com/apis/site/v2/sports/hockey/nhl/scoreboard?limit=500&dates=" + day

Don't know if you still need help with this, but you can pass several options to dates:
yyyy to return the events for the year
yyyyMM to return the events for a year and month
yyyyMMdd to return the events for a specific year, month, and day
yyyyMMdd-yyyyMMdd to return the events in a range

For athletes can use something like:
http://sports.core.api.espn.com/v2/sports/football/leagues/college-football/athletes/4689970

Wow. This is really useful. Thanks so much! Off to rewrite my code...

…

On Mon, Oct 23, 2023 at 4:49 PM KvyatkovskyAleksey ***@***.***> wrote: ***@***.**** commented on this gist. ------------------------------ For athletes can use something like: http://sports.core.api.espn.com/v2/sports/football/leagues/college-football/athletes/4689970 — Reply to this email directly, view it on GitHub <https://gist.github.com/akeaswaran/b48b02f1c94f873c6655e7129910fc3b#gistcomment-4736206> or unsubscribe <https://github.com/notifications/unsubscribe-auth/AANTBKKGWMKST5U53KYM4QDYA3J7LBFKMF2HI4TJMJ2XIZLTSKBKK5TBNR2WLJDHNFZXJJDOMFWWLK3UNBZGKYLEL52HS4DFQKSXMYLMOVS2I5DSOVS2I3TBNVS3W5DIOJSWCZC7OBQXE5DJMNUXAYLOORPWCY3UNF3GS5DZVRZXKYTKMVRXIX3UPFYGLK2HNFZXIQ3PNVWWK3TUUZ2G64DJMNZZDAVEOR4XAZNEM5UXG5FFOZQWY5LFVA4DGOBXGIZTEMVHORZGSZ3HMVZKMY3SMVQXIZI> . 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> .

Is there anyway to get addition article information with the data source identifier?

Many of the previously listed URL's for endpoints are now dead. Having worked with the API for a couple of years (and this year's football API's for a couple of months), here is a summary of links that are still working, using the NFL as an example (fill in other sports & league names as mentioned above as necessary).

List of Teams
https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams

Full Roster, the team_id is a 1 or 2-digit number found at the previous endpoint. (In the returned roster JSON, under athletes, the roster is divided up into offense, defense, and special teams, but no season statistics are supplied.) Don't include the brackets.
https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/[team_id]/roster

Team Schedule, scores only
https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/[team_id]/schedule

Team Total Statistics (other URL's either don't work, only provide circular links, give links back to espn.com, or return data with all 0's). Also note that the previously mentioned standings endpoints don't provide much either; the event calls still work (mentioned below).
https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/[team_id]/statistics

From a team's roster, get a player's 7-digit id (player_id), then receive this season's (2023) statistics for that player (change the year for different season totals). (League-wide rosters don't seem to be working, at least at the endpoints I tried.)
http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2023/types/2/athletes/[player_id]/statistics/

Player's career totals
http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/[player_id]/statistics

---

I have concentrated on box scores, previews, and in-game scores for my projects (https://github.com/ITIRadio/ESPN-API/), rather than player & team total season statistics. However, to address some of the questions above, the API in general is not very fast to update, and is subject to slowing down significantly when receiving a lot of requests from an IP. As such, I try to get just one day's worth of box scores via the event calls at one time. I also generally only use the scoreboard call for games in-progress, or I don't make a lot of requests. I have never been able to even get close to the previously mentioned 2,500 calls in a day before receiving errors.

Other issues such as updating the timeouts remaining were only fixed this past week for NFL games in-progress (college games still don't work). I wouldn't expect drives in event calls to be fully updated for a couple of hours after the game.

The scoreboard call itself switches from yesterday's scores to today's schedule usually between 9 and 11 AM Eastern US time, for daily sports. For football, expect the week's scoreboard to switch at around the same time on Tuesdays for the NFL and Sundays for college. As such, I usually depend on supplying dates to my projects.

Current Scoreboard (for the given week for football)
http://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard

Current Scoreboard for all College Division I games (group=80 is all conferences, maximum 200 games)
https://site.api.espn.com/apis/site/v2/sports/football/college-football/scoreboard?groups=80&limit=200

Scoreboard for all NFL games on a given date, in YYYYMMDD format (suggested to use 1 day at a time due to throttling issues, but use a range of dates, earlier date first, at your discretion)
http://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=20231029-20231029

From a scoreboard call, use ['events'][game_number]['id'] to retrieve an event_id for a particular game. Then to receive full box score data either post-game or in-progress, or preview data before the game begins (also note that updated standings as usually provided in this call post-game):
http://site.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=[event_id]

Does anyone know how to return more than 100 college basketball games? http://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/scoreboard?groups=50&limit=200 only returns the first 100 even including the group=50 (all div 1) and setting the limit higher than 100.

For example Idaho v Washington State (https://www.espn.com/mens-college-basketball/boxscore/_/gameId/401580926) is missing from the return.

@aoddspotato I always get all of the games for the day if I set the date parameter explicitly (YYYYMMDD format), along with the limit parameter and groups=50

@aoddspotato I always get all of the games for the day if I set the date parameter explicitly (YYYYMMDD format), along with the limit parameter and groups=50

@ischmidt20 Can you provide an example for an explicit date? Im trying with dates and getting very short results or only games currently on scoreboard.

@aoddspotato http://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/scoreboard?dates=20231125&groups=50&limit=357

Anyone know how to get spreads/totals from the API? Seems like they might have been removed with ESPN Bet? Used to be in pickcenter object under the summary endpoint.

Anyone find an endpoint to get stats by period, for example, NBA player points in 1-4 quarters or by half?

does anyone know if espn uses webhook to send updates ?

@RexStev if you are still looking for highlights API its worth checking https://highlightly.net/

anyone got recently working api for soccer?

@juniortotep i am. I recently implemented it in my project & its giving me some delayed status . How is it going for you so far

Is there an endpoint for college softball?

Im not sure,

Anyone implemented any of these in wordpress website? Any suggestions how to do it?

anyone know if it's possible to get team's results for all tournaments?
or at least get list of tournaments that team participates in

for example, this returns Serie A results for AC Milan
https://site.api.espn.com/apis/site/v2/sports/soccer/ita.1/teams/103/schedule

but I would like to get results like these:
https://www.espn.com/soccer/team/results/_/id/103/ita.ac_milan

with Coppa and Europa league

Can someone tell me how I can get Australian football from the ESPN api. Just need to find the sport id name and league id etc. If someone could help would be amazing.

Can someone tell me how I can get Australian football from the ESPN api. Just need to find the sport id name and league id etc. If someone could help would be amazing.

@acerbzzz
Here is a start https://sports.core.api.espn.com/v2/sports/australian-football/leagues/afl. At least you have the league and sport name. Using the rest of the params I'm sure you'll get it. GL

has anyone had success with api endpoints for ncaa basketball tournament brackets? I have found the format:

http://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/tournaments/22/seasons/${season}/bracketology?

to work for years up until 2021, but 2022 and 2023 return empty

I found the endpoint for nfl drafts

Athlete: https://site.web.api.espn.com/apis/site/v2/sports/football/nfl/draft/athlete/106643?season=2023&region=us&lang=en
Entire Draft: https://site.web.api.espn.com/apis/site/v2/sports/football/nfl/draft?season=2023&region=us&lang=en

Is it possible to get realtime football scores ?

Is it possible to get realtime football scores ?

I've only seen the scores in the schedule update when refreshing the endpoint. But I'd also love a realtime live scores endpoint as well.

I've always felt that forces should be combined and have a service deployed that would perform the polling required to get the data, then publish that information via events (AWS SNS/SQS, Azure Service Bus, etc), so we don't overload their system - and they decide to simply take it offline due to costs.

To respond to some questions above, first, I have found nothing for statistics by period, and I've looked.

As far as combining forces to avoid overuse, I'm not sure how much the general public uses this. They are so aggressive with their throttling, that I anyone who tries to access the API more than a couple of hundred times a day would not have much luck. For example, while you can get individual player stats, for the NFL for example, you wouldn't be able to update the stats of every skill player weekly before getting errors. You'd be better off running an event API call for each game & updating player stats on your own database.

Also, as I posted a couple of years back, ESPN.com is essentially a web app running in your browser (why it's soooo slow) that accesses the API to load the data onto a requested page, the list of current or past scores, a box score, a player's stats, etc. So, literally everyone who uses the site is using this API. The site just thinks I'm a fast clicker, in fact, the speed of the site is the most effective throttler for the general public. Otherwise, I don't have the money lying around to pay for some AWS BS.

As far as real time scores are concerned, the scoreboard calls are pretty current, such as for the NFL, http://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard , which works nicely. If you have Python installed and are OK with using the command line, I have 6 sports now included in my project at https://github.com/ITIRadio/ESPN-API . In-progress scores are included. If you scroll back a little bit in these comments, another poster uses these scoreboard endpoints to copy over updated scores to a site at https://bigearthweb.net/sports/ .

anyone know if it's possible to get team's results for all tournaments? or at least get list of tournaments that team participates in

for example, this returns Serie A results for AC Milan https://site.api.espn.com/apis/site/v2/sports/soccer/ita.1/teams/103/schedule

but I would like to get results like these: https://www.espn.com/soccer/team/results/_/id/103/ita.ac_milan

with Coppa and Europa league

You can use this format:
https://site.api.espn.com/apis/site/v2/sports/soccer/UEFA.EUROPA/teams/103/schedule
https://site.api.espn.com/apis/site/v2/sports/soccer/{competition}/teams/{teamId}/schedule

The competition codes come from selecting in dropdown on https://www.espn.com/soccer/team/results/_/id/103/ita.ac_milan

has anyone had success with api endpoints for ncaa basketball tournament brackets? I have found the format:

http://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/tournaments/22/seasons/${season}/bracketology?

to work for years up until 2021, but 2022 and 2023 return empty

I found the following endpoint when looking at the requests made for this page: https://www.espn.com/mens-college-basketball/bracket

Endpoint: https://fcast.espncdn.com/FastcastService/pubsub/profiles/12000/topic/bracket-basketball-mens-college-basketball-22-en/message/24624/checkpoint

https://data.ncaa.com/casablanca/scoreboard/basketball-men/d1" + dates[day] + "scoreboard.json" ;

…

On Thu, Mar 21, 2024 at 1:08 PM Winston Cooke ***@***.***> wrote: ***@***.**** commented on this gist. ------------------------------ has anyone had success with api endpoints for ncaa basketball tournament brackets? I have found the format: http://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/tournaments/22/seasons/${season}/bracketology ? to work for years up until 2021, but 2022 and 2023 return empty I found the following endpoint when looking at the requests made for this page: https://www.espn.com/mens-college-basketball/bracket Endpoint: https://fcast.espncdn.com/FastcastService/pubsub/profiles/12000/topic/bracket-basketball-mens-college-basketball-22-en/message/24624/checkpoint — Reply to this email directly, view it on GitHub <https://gist.github.com/akeaswaran/b48b02f1c94f873c6655e7129910fc3b#gistcomment-4996517> or unsubscribe <https://github.com/notifications/unsubscribe-auth/AANTBKLWL2Q2WQXOTSR7RW3YZMH2VBFKMF2HI4TJMJ2XIZLTSKBKK5TBNR2WLJDUOJ2WLJDOMFWWLO3UNBZGKYLEL5YGC4TUNFRWS4DBNZ2F6YLDORUXM2LUPGBKK5TBNR2WLJDHNFZXJJDOMFWWLK3UNBZGKYLEL52HS4DFVRZXKYTKMVRXIX3UPFYGLK2HNFZXIQ3PNVWWK3TUUZ2G64DJMNZZDAVEOR4XAZNEM5UXG5FFOZQWY5LFVA4DGOBXGIZTEMVHORZGSZ3HMVZKMY3SMVQXIZI> . 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> .

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?

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"]

I am fetching data from - http://site.api.espn.com/apis/site/v2/sports/soccer/eng.1/standings
the outcome is empty object, what can be a cause ?!

I am fetching data from - http://site.api.espn.com/apis/site/v2/sports/soccer/eng.1/standings the outcome is empty object, what can be a cause ?!

You want to use https://site.api.espn.com/apis/site/v2/sports/soccer/eng.1/scoreboard instead. I'm not sure what your looking for in terms of data but this endpoint does work.

While the college basketball tournament is going on, any team in the tournament will only return postseason results when you call https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/{team}/schedule to get their schedule. To get their regular season schedule, append season and seasontype params (i.e. https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/{team}/schedule?season=2024&seasontype=2) to get a different set of games. Seasontype 2 is regular season, 3 is postseason.

Rankings: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/rankings

Standings: https://site.api.espn.com/apis/v2/sports/basketball/mens-college-basketball/standings

I am fetching data from - http://site.api.espn.com/apis/site/v2/sports/soccer/eng.1/standings the outcome is empty object, what can be a cause ?!

You want to use https://site.api.espn.com/apis/site/v2/sports/soccer/eng.1/scoreboard instead. I'm not sure what your looking for in terms of data but this endpoint does work.

I want to get possition of each time on table, like Liverpool - which position it is in premier league, how many points got and etc.

I am fetching data from - http://site.api.espn.com/apis/site/v2/sports/soccer/eng.1/standings the outcome is empty object, what can be a cause ?!

You want to use https://site.api.espn.com/apis/site/v2/sports/soccer/eng.1/scoreboard instead. I'm not sure what your looking for in terms of data but this endpoint does work.

I want to get possition of each time on table, like Liverpool - which position it is in premier league, how many points got and etc.

You have to add ?season=xxxx. https://site.web.api.espn.com/apis/v2/sports/soccer/eng.1/standings?season=2023

Could anyone help me out with the possible values of game states? Is there a list somewhere I'm missing?

I've never seen an exhaustive list, but I have found the following:

• STATUS_SCHEDULED
• STATUS_IN_PROGRESS
• STATUS_END_PERIOD
• STATUS_HALFTIME
• STATUS_POSTPONED
• STATUS_FINAL

I've never seen an exhaustive list, but I have found the following:

• STATUS_SCHEDULED
• STATUS_IN_PROGRESS
• STATUS_END_PERIOD
• STATUS_HALFTIME
• STATUS_POSTPONED
• STATUS_FINAL

Thank you! I believe STATUS_CANCELLED is also one of them. Do you know the id for each status? End period and halftime in particular.

I don't know the ids but you should be able to find them. There's an id key alongside name in competitions->status->type.

Thank you! I believe STATUS_CANCELLED is also one of them. Do you know the id for each status? End period and halftime in particular.

I found this comment from earlier. Hopefully this helps? @D00pN00dle Link - https://gist.github.com/akeaswaran/b48b02f1c94f873c6655e7129910fc3b?permalink_comment_id=4458293#gistcomment-4458293

Thank you! I believe STATUS_CANCELLED is also one of them. Do you know the id for each status? End period and halftime in particular.

I found this comment from earlier. Hopefully this helps? @D00pN00dle Link - https://gist.github.com/akeaswaran/b48b02f1c94f873c6655e7129910fc3b?permalink_comment_id=4458293#gistcomment-4458293

Oh man Idk why but I didn't even think to look through the comments section for answers! Thank you so much! I'll have to keep in mind the comments are kind of like an extension of the documentation. Thanks again @carterjpilling