Skip to main content

Men's college basketball — ESPN site API (v2)

sportsdataverse.mbb — 25 endpoints.

espn_mbb_scoreboard​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/scoreboard

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/scoreboard?dates=20240115&groups=50&limit=500

API ParameterPythonPatternRequiredNullableDescription
datesdatesYOne day (YYYYMMDD) or one calendar year (YYYY). A range (YYYYMMDD-YYYYMMDD) is rejected with HTTP 400; request each day, or use the Core v2 events wrapper.
weekweekYWeek number within the season.
seasontypeseason_typeYSeason phase: 1=preseason, 2=regular season, 3=postseason.
groupsgroupsYConference or group id filter (e.g. an ESPN conference id).
limitlimitYMaximum number of items to return.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
game_idInt64ESPN event id.
uidStringESPN UID string.
dateStringMatch start timestamp (ISO 8601, UTC).
nameStringFull event name (e.g. 'Team A at Team B').
short_nameStringAbbreviated event name (e.g. 'TA @ TB').
season_yearInt64Integer season year ESPN assigns the event (e.g. 2025 for the 2025-26 season).
season_typeInt64ESPN season-type id of the event's season: 1 preseason, 2 regular season, 3 postseason, 4 offseason for the US leagues; soccer competitions carry their own competition-specific ids (e.g. 13481).
season_slugStringESPN slug of the event's season type (e.g. 'regular-season', 'post-season'; soccer competitions use their own, such as 'final' or 'torneo-apertura').
status_type_idInt64Unique identifier for status type.
status_type_nameStringStatus type name.
status_type_stateStringStatus type state.
status_type_completedBooleanStatus type completed.
status_type_descriptionStringStatus type description.
status_type_detailStringStatus type detail.
status_type_short_detailStringStatus type short detail.
status_clockFloat64Game clock in seconds as ESPN reports it: time remaining in the period for clock sports, elapsed seconds for soccer (e.g. 5400.0 at full time); 0.0 once a game has ended.
status_display_clockStringStatus display clock.
status_periodInt64Current or final period number (quarter, half, inning or period, depending on the sport).
neutral_siteBooleanWhether the match is played at a neutral venue.
conference_competitionBooleanConference competition.
attendanceInt64Reported attendance.
venue_idInt64Unique venue identifier.
venue_full_nameStringVenue full name.
venue_cityStringVenue city.
venue_stateStringVenue state / region.
venue_indoorBooleanTRUE if the venue is indoors.
broadcastStringEvery network name of the competition in feed order, deduped and ", "-joined (an entry with no names gives its market); "" when the game lists no broadcast.
noteStringEvent note text from the competition (e.g. a series or game label such as 'World Series - Game 1', or a shootout result); an empty string when there is none.
home_idInt64Unique identifier for home.
home_nameStringHome name.
home_abbreviationStringHome team's abbreviation.
home_display_nameStringHome display name.
home_locationStringHome team's location.
home_colorStringColor code (hex) for home.
home_alternate_colorStringColor code (hex) for home alternate.
home_logoStringHome team logo URL.
home_scoreStringHome team's score. For cricket, the innings string (e.g. '161/5 (18/20 ov, target 156)').
home_winnerBooleanHome team's winner.
home_rankInt64
away_idInt64Unique identifier for away.
away_nameStringAway name.
away_abbreviationStringAway team's abbreviation.
away_display_nameStringAway display name.
away_locationStringAway team's location.
away_colorStringColor code (hex) for away.
away_alternate_colorStringColor code (hex) for away alternate.
away_logoStringAway team logo URL.
away_scoreStringAway team's score. For cricket, the innings string.
away_winnerBooleanAway team's winner.
away_rankInt64

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_scoreboard(dates='20240115')

espn_mbb_summary​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/summary

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/summary

API ParameterPythonPatternRequiredNullableDescription
eventevent_idYevent query parameter.

Returns​

return_parsed=True (default) — a dict of polars.DataFrames keyed by summary section (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

boxscore_player

col_nametypedescription
team_idInt64Team id.
team_abbreviationStringTeam abbreviation.
team_display_nameStringTeam display name.
team_locationStringTeam location.
athlete_idInt64Athlete id.
athlete_display_nameStringAthlete display name.
athlete_short_nameStringAthlete short name.
athlete_jerseyStringAthlete jersey.
athlete_positionStringAthlete position.
starterBooleanStarter.
activeStringActive.
did_not_playBooleanDid not play.
ejectedBooleanEjected.
reasonStringReason.
minutesStringMinutes.
pointsStringPoints.
field_goals_made_field_goals_attemptedStringField goals made field goals attempted.
three_point_field_goals_made_three_point_field_goals_attemptedStringThree point field goals made three point field goals attempted.
free_throws_made_free_throws_attemptedStringFree throws made free throws attempted.
reboundsStringRebounds.
assistsStringAssists.
turnoversStringTurnovers.
stealsStringSteals.
blocksStringBlocks.
offensive_reboundsStringOffensive rebounds.
defensive_reboundsStringDefensive rebounds.
foulsStringFouls.

boxscore_team

col_nametypedescription
team_idInt64Team id.
team_abbreviationStringTeam abbreviation.
team_display_nameStringTeam display name.
home_awayStringHome away.
display_orderInt64Display order.
stat_nameStringStat name.
stat_labelStringStat label.
stat_display_valueStringStat display value.
stat_valueStringStat value.

plays

col_nametypedescription
idInt64Id.
sequence_numberStringSequence number.
textStringText.
away_scoreInt64Away score.
home_scoreInt64Home score.
scoring_playBooleanScoring play.
score_valueInt64Score value.
wallclockStringWallclock.
shooting_playBooleanShooting play.
points_attemptedInt64Points attempted.
short_descriptionStringShort description.
type_idInt64Type id.
type_textStringType text.
period_numberInt64Period number.
period_display_valueStringPeriod display value.
clock_display_valueStringClock display value.
team_idInt64Team id.
coordinate_xInt64Coordinate x.
coordinate_yInt64Coordinate y.
participantsStringParticipants.

winprobability

col_nametypedescription
home_win_percentageFloat64Home win percentage.
tie_percentageFloat64Tie percentage.
play_idInt64Play id.

leaders

col_nametypedescription
team_idInt64Team id.
team_abbreviationStringTeam abbreviation.
category_nameStringCategory name.
category_display_nameStringCategory display name.
athlete_idInt64Athlete id.
athlete_display_nameStringAthlete display name.
athlete_positionStringAthlete position.
valueFloat64Value.
display_valueStringDisplay value.
main_statStringMain stat.
summaryStringSummary.

game_info

col_nametypedescription
attendanceInt64Attendance.
venue_idInt64Venue id.
venue_guidStringVenue guid.
venue_full_nameStringVenue full name.
venue_address_cityStringVenue address city.
venue_address_stateStringVenue address state.
venue_address_zip_codeStringPostal zip code of the venue where the game was played.
venue_grassBooleanVenue grass.

officials

col_nametypedescription
full_nameStringFull name.
display_nameStringDisplay name.
orderInt64Order.
position_nameStringPosition name.
position_display_nameStringPosition display name.
position_idInt64Position id.

header

col_nametypedescription
idInt64Id.
uidStringUid.
time_validBooleanTime valid.
competitionsStringCompetitions.
linksStringLinks.
weekInt64Week number.
game_noteStringOptional editorial note or context annotation attached to the game in the header.
season_yearInt64Season year.
season_currentBooleanSeason current.
season_typeInt64Season type.
league_idInt64League id.
league_uidStringLeague uid.
league_nameStringLeague name.
league_abbreviationStringLeague abbreviation.
league_midsize_nameStringMedium-length display name for the league or competition as shown in the game header.
league_slugStringLeague slug.
league_is_tournamentBooleanLeague is tournament.
league_linksStringLeague links.
league_logosStringLeague logos.

standings

col_nametypedescription
group_headerStringGroup header.
conference_headerStringConference header.
division_headerStringDivision header.
team_idInt64Team id.
team_uidStringTeam uid.
team_locationStringTeam location.
overallStringOverall pick number.
games_behindStringGames behind.
vs. conf.StringTeam's record against conference opponents, shown as part of the standings snapshot in the box score.

format

col_nametypedescription
regulation_periodsInt64Regulation periods.
regulation_display_nameStringRegulation display name.
regulation_slugStringRegulation slug.
regulation_clockFloat64Regulation clock.
overtime_display_nameStringOvertime display name.
overtime_slugStringOvertime slug.
overtime_clockFloat64Overtime clock.

article

col_nametypedescription
idInt64Id.
now_idStringNow id.
content_keyStringContent key.
data_source_identifierStringData source identifier.
publishedkeyStringPublishedkey.
typeStringType.
game_idInt64Game id.
headlineStringHeadline.
descriptionStringDescription.
link_textStringLink text.
categorizedStringCategorized.
originally_postedStringOriginally posted.
last_modifiedStringLast modified.
publishedStringPublished.
sectionStringSection.
sourceStringSource.
imagesStringImages.
videoStringVideo.
categoriesStringCategories.
keywordsStringKeywords.
storyStringStory.
premiumBooleanPremium.
is_live_blogBooleanIs live blog.
allow_commentsBooleanAllow comments.
allow_searchBooleanAllow search.
allow_content_reactionsBooleanAllow content reactions.
links_web_hrefStringLinks web href.
links_mobile_hrefStringLinks mobile href.
links_api_self_hrefStringLinks api self href.
links_app_sportscenter_hrefStringLinks app sportscenter href.

news

col_nametypedescription
idInt64Id.
now_idStringNow id.
content_keyStringContent key.
data_source_identifierStringData source identifier.
typeStringType.
headlineStringHeadline.
descriptionStringDescription.
last_modifiedStringLast modified.
publishedStringPublished.
imagesStringImages.
categoriesStringCategories.
premiumBooleanPremium.
links_web_hrefStringLinks web href.
links_mobile_hrefStringLinks mobile href.
links_api_self_hrefStringLinks api self href.
links_app_sportscenter_hrefStringLinks app sportscenter href.
bylineStringByline.
links_web_self_hrefStringURL for the canonical web page of the associated article or editorial content.
links_web_self_dsi_hrefStringData-source-identified URL for the web page of the associated article content.
links_api_artwork_hrefStringAPI endpoint URL for artwork or imagery associated with the article.
links_sportscenter_hrefStringURL for the article's page on ESPN's SportsCenter platform.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_summary()

espn_mbb_calendar_site​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/calendar

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/calendar

API ParameterPythonPatternRequiredNullableDescription

Returns​

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: 404 in nba, nfl, mlb, nhl, wnba, cfb, mbb, wbb with the documented example arguments (2026-10-07).

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_calendar_site()

espn_mbb_news​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/news

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/news?limit=50

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of items to return.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idInt64ESPN numeric identifier for the article.
now_idStringESPN 'now' feed id.
content_keyStringInternal content key.
data_source_identifierStringSource-system identifier.
typeStringArticle type (Story, Media, HeadlineNews, etc.).
headlineStringArticle headline.
descriptionStringArticle summary/description.
last_modifiedStringLast-modified timestamp (ISO 8601).
publishedStringPublish timestamp (ISO 8601).
imagesStringArticle images (list, stringified).
categoriesStringArticle categories (list, stringified).
premiumBooleanWhether the article is premium/paywalled.
links_web_hrefStringWeb article URL.
links_mobile_hrefStringMobile article URL.
links_api_self_hrefStringESPN API canonical self-link for the article resource.
links_app_sportscenter_hrefStringSportsCenter app deep link.
bylineStringAuthor byline string as published by ESPN.
links_web_self_hrefStringPrimary canonical web URL for this news article on ESPN.com.
links_web_self_dsi_hrefStringAlternate canonical web URL for this news article using ESPN's DSI routing.
links_api_artwork_hrefStringESPN API URL for the artwork image associated with this news article.
links_sportscenter_hrefStringDeep-link URL to this news article within the ESPN SportsCenter app or web experience.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_news()

espn_mbb_injuries​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/injuries

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/injuries

API ParameterPythonPatternRequiredNullableDescription

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idInt64ESPN numeric identifier for the athlete.
display_nameStringAthlete's full display name as shown on ESPN.
injuriesStringInjury entries for the athlete (list of dicts, stringified): status, type, details, dates.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_injuries()

espn_mbb_transactions​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/transactions

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/transactions?limit=500

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of items to return.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
dateStringDate in YYYY-MM-DD format.
descriptionStringLong-form description text.
team_abbreviationStringShort team abbreviation (e.g. 'LAS').
team_alternate_colorStringTeam alternate color (hex without leading '#').
team_colorStringTeam primary color (hex without leading '#').
team_display_nameStringFull team display name.
team_idInt64Unique team identifier.
team_linksString
team_locationStringTeam city or location string.
team_logosString
team_nameStringFull team display name (e.g. 'Las Vegas Aces').

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_transactions()

espn_mbb_conferences​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/groups

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/groups

API ParameterPythonPatternRequiredNullableDescription

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
group_idInt64ESPN group id.
nameStringDisplay name.
abbreviationStringShort abbreviation.
short_nameStringShort display name.
is_conferenceBooleanWhether this group is a conference.
parent_group_idInt64Unique identifier for parent group.
depthInt64
children_countInt64

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_conferences()

espn_mbb_statistics_league​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/statistics

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/statistics

API ParameterPythonPatternRequiredNullableDescription

Returns​

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: parser: parse_items returns no columns on the live payload (nba, nfl, mlb, nhl, wnba, cfb, mbb, wbb, 2026-10-07); its rows sit under keys it does not read (top level: league, season, status, timestamp).

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_statistics_league()

espn_mbb_draft​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/draft

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/draft

API ParameterPythonPatternRequiredNullableDescription

Returns​

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: parser: parse_items returns no columns on the live payload (nba, nfl, nhl, wnba, 2026-10-07); its rows sit under keys it does not read (top level: breakingNews, broadcasts, displayName, picks, positions, rounds, shortDisplayName, status).

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_draft()

espn_mbb_teams_site​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams?limit=1000

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of items to return.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
team_abbreviationStringShort team abbreviation (e.g. "BOS").
team_alternate_colorStringSecondary team color as a hex string (no leading '#').
team_colorStringPrimary team color as a hex string (no leading '#').
team_display_nameStringFull team display name (location + nickname).
team_idInt64ESPN team id (stable join key across ESPN endpoints).
team_is_activeBooleanWhether the team is currently active.
team_is_all_starBooleanWhether the entry is an all-star squad rather than a franchise.
team_locationStringTeam location / city (e.g. "Boston").
team_logosStringPipe-delimited logo image URLs.
team_nameStringTeam nickname/mascot (e.g. "Celtics").
team_nicknameStringTeam nickname as ESPN labels it (often equals team_name).
team_short_display_nameStringAbbreviated display name for compact UIs.
team_slugStringURL slug used in ESPN web paths.
team_uidStringESPN global UID (encodes sport/league/team).

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_teams_site()

espn_mbb_team​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/{team_id}

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/4

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
team_abbreviationStringShort team abbreviation (e.g. 'LAS').
team_alternate_colorStringTeam alternate color (hex without leading '#').
team_colorStringTeam primary color (hex without leading '#').
team_display_nameStringFull team display name.
team_franchise_$refString
team_franchise_abbreviationString
team_franchise_colorString
team_franchise_display_nameString
team_franchise_idInt64
team_franchise_is_activeBoolean
team_franchise_locationString
team_franchise_nameString
team_franchise_short_display_nameString
team_franchise_slugString
team_franchise_team_$refString
team_franchise_uidString
team_franchise_venue_$refString
team_franchise_venue_address_cityString
team_franchise_venue_address_stateString
team_franchise_venue_full_nameString
team_franchise_venue_grassBoolean
team_franchise_venue_guidString
team_franchise_venue_idInt64
team_franchise_venue_imagesString
team_franchise_venue_indoorBoolean
team_franchise_venue_short_nameString
team_groups_idInt64
team_groups_is_conferenceBoolean
team_groups_parent_idInt64
team_idInt64Unique team identifier.
team_is_activeBooleanTRUE if the team is currently active.
team_linksString
team_locationStringTeam city or location string.
team_logosString
team_nameStringFull team display name (e.g. 'Las Vegas Aces').
team_next_eventString
team_record_itemsString
team_short_display_nameStringShort team display name (e.g. 'Aces').
team_slugStringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_standing_summaryString
team_uidStringESPN universal team identifier (UID format 's:40~l:...~t:...').

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_team(team_id='4')

espn_mbb_team_roster​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/{team_id}/roster

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/4/roster?limit=500

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.
limitlimitYMaximum number of items to return.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idInt64Id.
uidStringUid.
guidStringGuid.
first_nameStringFirst name.
last_nameStringLast name.
full_nameStringFull name.
display_nameStringDisplay name.
short_nameStringShort name.
weightFloat64Weight.
display_weightStringDisplay weight.
heightFloat64Height.
display_heightStringDisplay height.
linksStringLinks.
slugStringSlug.
jerseyStringJersey.
injuriesStringInjuries.
teamsStringTeams.
alternate_ids_sdrStringAlternate ids sdr.
birth_place_cityStringBirth place city.
birth_place_stateStringBirth place state.
birth_place_countryStringBirth place country.
birth_place_display_textString
birth_country_alternate_idInt64Alternate identifier for the athlete's country of birth used in ESPN's country-flag reference system.
birth_country_abbreviationString
headshot_hrefStringHeadshot href.
headshot_altStringHeadshot alt.
flag_hrefStringURL of the SVG or PNG flag image representing the athlete's country of birth.
flag_altStringAlt-text string for the athlete's country-of-birth flag image, typically the full country name.
flag_relStringRelationship descriptor for the athlete's country-of-birth flag link (e.g., "flag").
position_idInt64Position id.
position_nameStringPosition name.
position_display_nameStringPosition display name.
position_abbreviationStringPosition abbreviation.
position_leafBooleanPosition leaf.
experience_yearsInt64Experience years.
experience_display_valueStringExperience display value.
experience_abbreviationStringExperience abbreviation.
status_idInt64Status id.
status_nameStringStatus name.
status_typeStringStatus type.
status_abbreviationStringStatus abbreviation.
hand_typeStringHand type.
hand_abbreviationStringHand abbreviation.
hand_display_valueStringHand display value.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_team_roster(team_id='4')

espn_mbb_team_schedule​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/{team_id}/schedule

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/4/schedule

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.
seasonseasonYSeason year (e.g. 2024).

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idInt64ESPN numeric event identifier.
dateStringEvent timestamp (ISO 8601, UTC).
nameStringFull event name (e.g. 'Team A at Team B').
short_nameStringAbbreviated event name (e.g. 'TA @ TB').
time_validBooleanWhether the event time is confirmed.
competitionsStringCompetition detail (list of dicts, stringified): competitors, venue, status.
linksStringRelated links (list, stringified).
season_yearInt64Four-digit season year.
season_display_nameStringHuman-readable season label (e.g. '2024-25').
season_type_idInt64ESPN numeric identifier for the season type.
season_type_typeInt64Season type numeric code.
season_type_nameStringSeason type name (e.g. Regular Season).
season_type_abbreviationStringSeason type abbreviation.
week_numberInt64Week number.
week_textStringHuman-readable label for the week or scheduling block in which the event falls (e.g., 'Week 3', 'Bowl Week'), as returned by the ESPN schedule API.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_team_schedule(team_id='4')

espn_mbb_team_record​

Deprecated: ESPN answers this team route with an empty object.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/{team_id}/record

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/4/record

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.

Returns​

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: ESPN answers an empty object in nba, nfl, mlb, nhl, wnba, cfb, mbb, wbb with the documented example arguments (2026-10-07).

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_team_record(team_id='4')

espn_mbb_team_depthcharts​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/{team_id}/depthcharts

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/4/depthcharts

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.

Returns​

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: parser: parse_items returns no columns on the live payload (nba, nfl, mlb, nhl, wnba, cfb, mbb, wbb, 2026-10-07); its rows sit under keys it does not read (top level: depthchart, season, status, team, timestamp).

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_team_depthcharts(team_id='4')

espn_mbb_team_injuries​

Deprecated: ESPN answers this team route with an empty object.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/{team_id}/injuries

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/4/injuries

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idInt64ESPN numeric identifier for the athlete.
display_nameStringAthlete's full display name as shown on ESPN.
injuriesStringInjury entries for the athlete (list of dicts, stringified): status, type, details, dates.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_team_injuries(team_id='4')

espn_mbb_team_transactions​

Deprecated: ESPN answers this team route with an empty object.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/{team_id}/transactions

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/4/transactions

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.

Returns​

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: ESPN answers an empty object in nba, nfl, mlb, nhl, wnba, cfb, mbb, wbb with the documented example arguments (2026-10-07).

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_team_transactions(team_id='4')

espn_mbb_team_history​

Deprecated: ESPN answers this team route with an empty object.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/{team_id}/history

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/4/history

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.

Returns​

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: ESPN answers an empty object in nba, nfl, mlb, nhl, wnba, mbb, wbb; 400 in cfb with the documented example arguments (2026-10-07).

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_team_history(team_id='4')

espn_mbb_team_news​

Deprecated: ESPN answers this team route with an empty object.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/{team_id}/news

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/4/news?limit=50

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.
limitlimitYMaximum number of items to return.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idInt64ESPN numeric identifier for the article.
now_idStringESPN 'now' feed id.
content_keyStringInternal content key.
data_source_identifierStringSource-system identifier.
typeStringArticle type (Story, Media, HeadlineNews, etc.).
headlineStringArticle headline.
descriptionStringArticle summary/description.
last_modifiedStringLast-modified timestamp (ISO 8601).
publishedStringPublish timestamp (ISO 8601).
imagesStringArticle images (list, stringified).
categoriesStringArticle categories (list, stringified).
premiumBooleanWhether the article is premium/paywalled.
links_web_hrefStringWeb article URL.
links_mobile_hrefStringMobile article URL.
links_api_self_hrefStringESPN API canonical self-link for the article resource.
links_app_sportscenter_hrefStringSportsCenter app deep link.
bylineStringAuthor byline string as published by ESPN.
links_web_self_hrefStringPrimary canonical web URL for this news article on ESPN.com.
links_web_self_dsi_hrefStringAlternate canonical web URL for this news article using ESPN's DSI routing.
links_api_artwork_hrefStringESPN API URL for the artwork image associated with this news article.
links_sportscenter_hrefStringDeep-link URL to this news article within the ESPN SportsCenter app or web experience.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_team_news(team_id='4')

espn_mbb_team_leaders​

Deprecated: ESPN answers this team route with an empty object.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/{team_id}/leaders

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/teams/4/leaders

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.

Returns​

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: ESPN answers an empty object in nba, nfl, mlb, nhl, wnba, cfb, mbb, wbb with the documented example arguments (2026-10-07).

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_team_leaders(team_id='4')

espn_mbb_player_info​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/athletes/{athlete_id}

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/athletes/4239

API ParameterPythonPatternRequiredNullableDescription
athlete_idathlete_idYathlete_id path parameter.

Returns​

return_parsed=True (default) — the output of parse_single_entity; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: 404 in nba, nfl, mlb, nhl, wnba, cfb, mbb, wbb with the documented example arguments (2026-10-07).

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_player_info(athlete_id='4239')

espn_mbb_player_bio​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/athletes/{athlete_id}/bio

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/athletes/4239/bio

API ParameterPythonPatternRequiredNullableDescription
athlete_idathlete_idYathlete_id path parameter.

Returns​

return_parsed=True (default) — the output of parse_single_entity; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: 404 in nba, nfl, mlb, nhl, wnba, cfb, mbb, wbb with the documented example arguments (2026-10-07).

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_player_bio(athlete_id='4239')

espn_mbb_player_news​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/athletes/{athlete_id}/news

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/athletes/4239/news

API ParameterPythonPatternRequiredNullableDescription
athlete_idathlete_idYathlete_id path parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idInt64ESPN numeric identifier for the article.
now_idStringESPN 'now' feed id.
content_keyStringInternal content key.
data_source_identifierStringSource-system identifier.
typeStringArticle type (Story, Media, HeadlineNews, etc.).
headlineStringArticle headline.
descriptionStringArticle summary/description.
last_modifiedStringLast-modified timestamp (ISO 8601).
publishedStringPublish timestamp (ISO 8601).
imagesStringArticle images (list, stringified).
categoriesStringArticle categories (list, stringified).
premiumBooleanWhether the article is premium/paywalled.
links_web_hrefStringWeb article URL.
links_mobile_hrefStringMobile article URL.
links_api_self_hrefStringESPN API canonical self-link for the article resource.
links_app_sportscenter_hrefStringSportsCenter app deep link.
bylineStringAuthor byline string as published by ESPN.
links_web_self_hrefStringPrimary canonical web URL for this news article on ESPN.com.
links_web_self_dsi_hrefStringAlternate canonical web URL for this news article using ESPN's DSI routing.
links_api_artwork_hrefStringESPN API URL for the artwork image associated with this news article.
links_sportscenter_hrefStringDeep-link URL to this news article within the ESPN SportsCenter app or web experience.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_player_news(athlete_id='4239')

espn_mbb_standings​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason year (e.g. 2024).
groupgroupYConference or group id filter (e.g. an ESPN conference id).
typestandings_typeYStandings variant (e.g. 'by-division' or 'by-conference').

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
group_nameStringGroup name.
group_abbreviationStringGroup abbreviation.
team_idInt64Team id.
team_nameStringTeam name.
team_abbreviationStringTeam abbreviation.
team_display_nameStringTeam display name.
team_locationStringTeam location.
team_logoStringTeam logo.
avg_points_againstFloat64Avg points against.
avg_points_forFloat64Avg points for.
games_behindFloat64Games behind.
league_win_percentFloat64League win percent.
lossesFloat64Losses.
playoff_seedFloat64Playoff seed.
point_differentialFloat64Point differential.
points_againstFloat64Points against.
points_forFloat64Points for.
streakFloat64Streak.
win_percentFloat64Win percent.
winsFloat64Wins.
games_aheadFloat64Games ahead.
overallStringOverall.
homeStringHome.
roadStringRoad.
vs ap top 25StringThe team's win-loss record against opponents ranked in the AP Top 25 poll.
vs usa ranked teamsStringThe team's win-loss record against opponents ranked in the USA Today Coaches Poll.
vs. conf.StringVs. conf..

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_standings()

espn_mbb_rankings​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
poll_idInt64ESPN poll id, e.g. 1 = AP Top 25, 2 = Coaches Poll, 20 = FCS Coaches Poll, 10624 = USCHO Men's Poll.
poll_nameStringFull poll name, e.g. 'AP Top 25', 'AFCA Coaches Poll', "USCHO Women's Poll".
poll_short_nameStringShort poll label, e.g. 'AP Poll'.
poll_typeStringESPN poll type code, e.g. 'ap', 'usa' (coaches), 'fcs', 'USCHOMENSPOLL'.
seasonInt64Season year of the poll (ESPN's ending year for a season that spans two calendar years, e.g. 2026 for 2025-26).
season_typeInt64Season phase of the poll: 1 = preseason, 2 = regular season, 3 = postseason.
weekInt64Poll week within season_type (the week ESPN's Core v2 rankings URL uses).
week_displayStringPoll week as ESPN labels it, e.g. 'Week 6'.
poll_dateStringDate the poll was released (ISO 8601, UTC).
rankedBooleanTRUE for the poll's ranked teams; FALSE for teams that only received votes.
team_idInt64ESPN team id (Int64, like scoreboard home_id / away_id).
rankInt64Position in the poll (1 = top). Null on vote-receiving rows.
previous_rankInt64Position in the previous poll; 0 when the team was unranked then.
pointsFloat64Poll points received (0 for polls ESPN ships without points, such as USCHO).
first_place_votesInt64First-place votes received. Null when the poll does not report them.
trendStringMovement since the previous poll as ESPN prints it, e.g. '+3', '-2', or '-' for no change.
record_summaryStringTeam's win-loss record at the poll date, e.g. '5-0'.
team_uidStringESPN universal team id, e.g. 's:20l:23t:251'.
team_locationStringTeam location (school name), e.g. 'Texas'.
team_nameStringTeam mascot name, e.g. 'Longhorns'.
team_nicknameStringShort team name ESPN displays, e.g. 'Texas'.
team_abbreviationStringShort team code ESPN displays, e.g. 'TEX'.
team_colorStringTeam primary color as a hex string without '#'. Null for teams ESPN ships without one.
team_logoStringURL of the team logo on ESPN's CDN.
last_updatedStringWhen ESPN last updated this poll entry (ISO 8601, UTC).

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_mbb_rankings()