Skip to main content
Version: 0.0.54

CFB — ESPN site API (v2)

sportsdataverse.cfb — 29 endpoints.

espn_cfb_scoreboard

ESPN endpoint.

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

Valid URL: https://site.api.espn.com/apis/site/v2/sports/football/college-football/scoreboard?dates=20240115

API ParameterPythonPatternRequiredNullable
datesdatesY
weekweekY
seasontypeseason_typeY
groupsgroupsY
limitlimitY

Returns

col_nametypedescription
game_idcharacterESPN event id.
uidcharacter
datecharacter
namecharacter
short_namecharacter
season_yearinteger
season_typeinteger
season_slugcharacter
status_type_idcharacter
status_type_namecharacter
status_type_statecharacter
status_type_completedlogical
status_type_descriptioncharacter
status_type_detailcharacter
status_type_short_detailcharacter
status_clockdouble
status_display_clockcharacter
status_periodinteger
neutral_sitelogical
conference_competitionlogical
attendanceinteger
venue_idcharacter
venue_full_namecharacter
venue_citycharacter
venue_statecharacter
venue_indoorlogical
broadcastcharacter
notecharacter
home_idcharacter
home_namecharacter
home_abbreviationcharacter
home_display_namecharacter
home_locationcharacter
home_colorcharacter
home_alternate_colorcharacter
home_logocharacter
home_scorecharacter
home_winnerlogical
home_rankinteger
away_idcharacter
away_namecharacter
away_abbreviationcharacter
away_display_namecharacter
away_locationcharacter
away_colorcharacter
away_alternate_colorcharacter
away_logocharacter
away_scorecharacter
away_winnerlogical
away_rankinteger

Example

espn_cfb_scoreboard(dates='20240115')

Last validated n/a.

espn_cfb_summary

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
eventevent_idY

Returns

boxscore_player

col_nametypedescription
team_idcharacterTeam id.
team_abbreviationcharacterTeam abbreviation.
team_display_namecharacterTeam display name.
team_locationcharacterTeam location.
athlete_idcharacterAthlete id.
athlete_display_namecharacterAthlete display name.
athlete_short_namecharacterAthlete short name.
athlete_jerseycharacterAthlete jersey.
athlete_positioncharacterAthlete position.
startercharacterStarter.
activecharacterActive.
did_not_playcharacterDid not play.
ejectedcharacterEjected.
reasoncharacterReason.
completions/passing_attemptscharacter
passing_yardscharacter
yards_per_pass_attemptcharacter
passing_touchdownscharacter
interceptionscharacter
adj_qbrcharacter
rushing_attemptscharacter
rushing_yardscharacter
yards_per_rush_attemptcharacter
rushing_touchdownscharacter
long_rushingcharacter
receptionscharacter
receiving_yardscharacter
yards_per_receptioncharacter
receiving_touchdownscharacter
long_receptioncharacter
fumblescharacter
fumbles_lostcharacter
fumbles_recoveredcharacter
total_tacklescharacter
solo_tacklescharacter
sackscharacter
tackles_for_losscharacter
passes_defendedcharacter
hurriescharacter
defensive_touchdownscharacter
kick_returnscharacter
kick_return_yardscharacter
yards_per_kick_returncharacter
long_kick_returncharacter
kick_return_touchdownscharacter
punt_returnscharacter
punt_return_yardscharacter
yards_per_punt_returncharacter
long_punt_returncharacter
punt_return_touchdownscharacter
field_goals_made/field_goal_attemptscharacter
field_goal_pctcharacter
long_field_goal_madecharacter
extra_points_made/extra_point_attemptscharacter
total_kicking_pointscharacter
puntscharacter
punt_yardscharacter
gross_avg_punt_yardscharacter
touchbackscharacter
punts_inside20character
long_puntcharacter

boxscore_team

col_nametypedescription
team_idcharacterTeam id.
team_abbreviationcharacterTeam abbreviation.
team_display_namecharacterTeam display name.
home_awaycharacterHome away.
display_orderintegerDisplay order.
stat_namecharacterStat name.
stat_labelcharacterStat label.
stat_display_valuecharacterStat display value.
stat_valuecharacterStat value.

winprobability

col_nametypedescription
home_win_percentagedoubleHome win percentage.
tie_percentagedoubleTie percentage.
play_idcharacterPlay id.

leaders

col_nametypedescription
team_idcharacterTeam id.
team_abbreviationcharacterTeam abbreviation.
category_namecharacterCategory name.
category_display_namecharacterCategory display name.
athlete_idcharacterAthlete id.
athlete_display_namecharacterAthlete display name.
athlete_positioncharacterAthlete position.
valuedoubleValue.
display_valuecharacterDisplay value.
main_statcharacterMain stat.
summarycharacterSummary.

game_info

col_nametypedescription
attendanceintegerAttendance.
venue_idcharacterVenue id.
venue_guidcharacterVenue guid.
venue_full_namecharacterVenue full name.
venue_address_citycharacterVenue address city.
venue_address_statecharacterVenue address state.
venue_address_zip_codecharacter
venue_address_countrycharacter
venue_grasslogicalVenue grass.

header

col_nametypedescription
idcharacterId.
uidcharacterUid.
time_validlogicalTime valid.
competitionscharacterCompetitions.
linkscharacterLinks.
weekinteger
game_notecharacter
season_yearintegerSeason year.
season_currentlogicalSeason current.
season_typeintegerSeason type.
league_idcharacterLeague id.
league_uidcharacterLeague uid.
league_namecharacterLeague name.
league_abbreviationcharacterLeague abbreviation.
league_midsize_namecharacter
league_slugcharacterLeague slug.
league_is_tournamentlogicalLeague is tournament.
league_linkscharacterLeague links.
league_logoscharacterLeague logos.

standings

col_nametypedescription
group_headercharacterGroup header.
conference_headercharacterConference header.
division_headercharacterDivision header.
team_idcharacterTeam id.
team_uidcharacterTeam uid.
team_locationcharacterTeam location.
overallcharacter
vs. conf.character

broadcasts

col_nametypedescription
stationcharacter
station_keycharacter
langcharacter
regioncharacter
is_nationallogical
type_idcharacterType id.
type_short_namecharacter
type_long_namecharacter
type_slugcharacter
market_idcharacter
market_typecharacter
media_call_letterscharacter
media_namecharacter
media_short_namecharacter

format

col_nametypedescription
regulation_periodsintegerRegulation periods.
regulation_display_namecharacterRegulation display name.
regulation_slugcharacterRegulation slug.
regulation_clockdoubleRegulation clock.
overtime_display_namecharacterOvertime display name.
overtime_slugcharacterOvertime slug.
sudden_death_periodsinteger

article

col_nametypedescription
idintegerId.
now_idcharacterNow id.
content_keycharacterContent key.
data_source_identifiercharacterData source identifier.
publishedkeycharacterPublishedkey.
typecharacterType.
game_idcharacterGame id.
headlinecharacterHeadline.
descriptioncharacterDescription.
link_textcharacterLink text.
categorizedcharacterCategorized.
originally_postedcharacterOriginally posted.
last_modifiedcharacterLast modified.
publishedcharacterPublished.
sectioncharacterSection.
sourcecharacterSource.
imagescharacterImages.
videocharacterVideo.
categoriescharacterCategories.
keywordscharacterKeywords.
storycharacterStory.
premiumlogicalPremium.
is_live_bloglogicalIs live blog.
allow_commentslogicalAllow comments.
allow_searchlogicalAllow search.
allow_content_reactionslogicalAllow content reactions.
links_web_hrefcharacterLinks web href.
links_mobile_hrefcharacterLinks mobile href.
links_api_self_hrefcharacterLinks api self href.
links_app_sportscenter_hrefcharacterLinks app sportscenter href.

news

col_nametypedescription
idintegerId.
now_idcharacterNow id.
content_keycharacterContent key.
data_source_identifiercharacterData source identifier.
typecharacterType.
headlinecharacterHeadline.
descriptioncharacterDescription.
last_modifiedcharacterLast modified.
publishedcharacterPublished.
imagescharacterImages.
categoriescharacterCategories.
premiumlogicalPremium.
links_web_hrefcharacterLinks web href.
links_web_self_hrefcharacter
links_web_self_dsi_hrefcharacter
links_api_self_hrefcharacterLinks api self href.
links_api_artwork_hrefcharacter
links_sportscenter_hrefcharacter
bylinecharacterByline.
links_mobile_hrefcharacterLinks mobile href.
links_app_sportscenter_hrefcharacterLinks app sportscenter href.

drives

col_nametypedescription
idcharacterId.
descriptioncharacterDescription.
yardsinteger
is_scorelogical
offensive_playsinteger
resultcharacter
short_display_resultcharacter
display_resultcharacter
playscharacter
team_idcharacterTeam id.
team_namecharacter
team_abbreviationcharacterTeam abbreviation.
team_display_namecharacterTeam display name.
team_short_display_namecharacter
team_logoscharacterTeam logos.
start_period_typecharacter
start_period_numberinteger
start_clock_display_valuecharacter
start_yard_lineinteger
start_textcharacter
end_period_typecharacter
end_period_numberinteger
end_clock_display_valuecharacter
end_yard_lineinteger
end_textcharacter
time_elapsed_display_valuecharacter

drive_plays

col_nametypedescription
drive_idcharacter
drive_sequenceinteger
idcharacterId.
sequence_numbercharacterSequence number.
textcharacterText.
away_scoreintegerAway score.
home_scoreintegerHome score.
scoring_playlogicalScoring play.
prioritylogical
modifiedcharacter
wallclockcharacterWallclock.
team_participantscharacter
is_penaltylogical
stat_yardageinteger
is_turnoverlogical
type_idcharacterType id.
type_textcharacterType text.
type_abbreviationcharacter
period_numberintegerPeriod number.
clock_display_valuecharacterClock display value.
start_downinteger
start_distanceinteger
start_yard_lineinteger
start_yards_to_endzoneinteger
start_team_idcharacter
end_downinteger
end_distanceinteger
end_yard_lineinteger
end_yards_to_endzoneinteger
end_down_distance_textcharacter
end_short_down_distance_textcharacter
end_possession_textcharacter
end_team_idcharacter
start_down_distance_textcharacter
start_short_down_distance_textcharacter
start_possession_textcharacter
scoring_type_namecharacter
scoring_type_display_namecharacter
scoring_type_abbreviationcharacter
point_after_attempt_iddouble
point_after_attempt_textcharacter
point_after_attempt_abbreviationcharacter
point_after_attempt_valuedouble
media_idcharacter

scoring_plays

col_nametypedescription
idcharacterId.
textcharacterText.
away_scoreintegerAway score.
home_scoreintegerHome score.
type_idcharacterType id.
type_textcharacterType text.
type_abbreviationcharacter
period_numberintegerPeriod number.
clock_valuedouble
clock_display_valuecharacterClock display value.
team_idcharacterTeam id.
team_uidcharacterTeam uid.
team_display_namecharacterTeam display name.
team_abbreviationcharacterTeam abbreviation.
team_linkscharacterTeam links.
team_logocharacterTeam logo.
team_logoscharacterTeam logos.
scoring_type_namecharacter
scoring_type_display_namecharacter
scoring_type_abbreviationcharacter

Example

espn_cfb_summary()

Last validated n/a.

espn_cfb_calendar

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_calendar()

Last validated n/a.

espn_cfb_calendar_offseason

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_calendar_offseason()

Last validated n/a.

espn_cfb_calendar_regular_season

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/football/college-football/calendar/regular-season

Valid URL: https://site.api.espn.com/apis/site/v2/sports/football/college-football/calendar/regular-season

API ParameterPythonPatternRequiredNullable

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_calendar_regular_season()

Last validated n/a.

espn_cfb_calendar_postseason

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_calendar_postseason()

Last validated n/a.

espn_cfb_calendar_ondays

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_calendar_ondays()

Last validated n/a.

espn_cfb_news

ESPN endpoint.

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

Valid URL: https://site.api.espn.com/apis/site/v2/sports/football/college-football/news

API ParameterPythonPatternRequiredNullable
limitlimitY

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_news()

Last validated n/a.

espn_cfb_injuries

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_injuries()

Last validated n/a.

espn_cfb_transactions

ESPN endpoint.

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

Valid URL: https://site.api.espn.com/apis/site/v2/sports/football/college-football/transactions

API ParameterPythonPatternRequiredNullable

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_transactions()

Last validated n/a.

espn_cfb_conferences

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_conferences()

Last validated n/a.

espn_cfb_statistics_league

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_statistics_league()

Last validated n/a.

espn_cfb_draft

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_draft()

Last validated n/a.

espn_cfb_teams_site

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
limitlimitY

Returns

col_nametypedescription
team_abbreviationcharacterShort team abbreviation (e.g. "BOS").
team_alternate_colorcharacterSecondary team color as a hex string (no leading '#').
team_colorcharacterPrimary team color as a hex string (no leading '#').
team_display_namecharacterFull team display name (location + nickname).
team_idcharacterESPN team id (stable join key across ESPN endpoints).
team_is_activelogicalWhether the team is currently active.
team_is_all_starlogicalWhether the entry is an all-star squad rather than a franchise.
team_locationcharacterTeam location / city (e.g. "Boston").
team_logoscharacterPipe-delimited logo image URLs.
team_namecharacterTeam nickname/mascot (e.g. "Celtics").
team_nicknamecharacterTeam nickname as ESPN labels it (often equals team_name).
team_short_display_namecharacterAbbreviated display name for compact UIs.
team_slugcharacterURL slug used in ESPN web paths.
team_uidcharacterESPN global UID (encodes sport/league/team).

Example

espn_cfb_teams_site()

Last validated n/a.

espn_cfb_team

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
team_idteam_idY

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_team(team_id='4')

Last validated n/a.

espn_cfb_team_roster

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
team_idteam_idY

Returns

col_nametypedescription
position_groupcharacter
idcharacterId.
uidcharacterUid.
guidcharacterGuid.
first_namecharacterFirst name.
last_namecharacterLast name.
full_namecharacterFull name.
display_namecharacterDisplay name.
short_namecharacterShort name.
weightdoubleWeight.
display_weightcharacterDisplay weight.
heightdoubleHeight.
display_heightcharacterDisplay height.
linkscharacterLinks.
slugcharacterSlug.
jerseycharacterJersey.
injuriescharacterInjuries.
alternate_ids_sdrcharacterAlternate ids sdr.
birth_place_citycharacterBirth place city.
birth_place_statecharacterBirth place state.
birth_place_countrycharacterBirth place country.
birth_place_display_textcharacter
birth_country_alternate_idcharacter
birth_country_abbreviationcharacter
college_idcharacterCollege id.
college_guidcharacterCollege guid.
college_mascotcharacterCollege mascot.
college_namecharacterCollege name.
college_short_namecharacterCollege short name.
college_abbrevcharacterCollege abbrev.
college_logoscharacterCollege logos.
headshot_hrefcharacterHeadshot href.
headshot_altcharacterHeadshot alt.
flag_hrefcharacter
flag_altcharacter
flag_relcharacter
position_idcharacterPosition id.
position_namecharacterPosition name.
position_display_namecharacterPosition display name.
position_abbreviationcharacterPosition abbreviation.
position_leaflogicalPosition leaf.
position_parent_idcharacter
position_parent_namecharacter
position_parent_display_namecharacter
position_parent_abbreviationcharacter
position_parent_leaflogical
experience_yearsintegerExperience years.
experience_display_valuecharacter
experience_abbreviationcharacter
status_idcharacterStatus id.
status_namecharacterStatus name.
status_typecharacterStatus type.
status_abbreviationcharacterStatus abbreviation.
hand_typecharacterHand type.
hand_abbreviationcharacterHand abbreviation.
hand_display_valuecharacterHand display value.

Example

espn_cfb_team_roster(team_id='4')

Last validated n/a.

espn_cfb_team_schedule

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
team_idteam_idY
seasonseasonY

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_team_schedule(team_id='4')

Last validated n/a.

espn_cfb_team_record

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
team_idteam_idY

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_team_record(team_id='4')

Last validated n/a.

espn_cfb_team_depthcharts

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
team_idteam_idY

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_team_depthcharts(team_id='4')

Last validated n/a.

espn_cfb_team_injuries

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
team_idteam_idY

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_team_injuries(team_id='4')

Last validated n/a.

espn_cfb_team_transactions

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
team_idteam_idY

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_team_transactions(team_id='4')

Last validated n/a.

espn_cfb_team_history

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
team_idteam_idY

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_team_history(team_id='4')

Last validated n/a.

espn_cfb_team_news

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
team_idteam_idY
limitlimitY

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_team_news(team_id='4')

Last validated n/a.

espn_cfb_team_leaders

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
team_idteam_idY

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_team_leaders(team_id='4')

Last validated n/a.

espn_cfb_player_info

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
athlete_idathlete_idY

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_player_info(athlete_id='4239')

Last validated n/a.

espn_cfb_player_bio

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
athlete_idathlete_idY

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_player_bio(athlete_id='4239')

Last validated n/a.

espn_cfb_player_news

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
athlete_idathlete_idY

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_player_news(athlete_id='4239')

Last validated n/a.

espn_cfb_standings

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
seasonseasonY
groupgroupY
typestandings_typeY

Returns

col_nametypedescription
group_namecharacterGroup name.
group_abbreviationcharacterGroup abbreviation.
team_idcharacterTeam id.
team_namecharacterTeam name.
team_abbreviationcharacterTeam abbreviation.
team_display_namecharacterTeam display name.
team_locationcharacterTeam location.
team_logocharacterTeam logo.
games_behinddoubleGames behind.
league_win_percentdoubleLeague win percent.
playoff_seeddoublePlayoff seed.
point_differentialdoublePoint differential.
points_againstdoublePoints against.
points_fordoublePoints for.
streakdoubleStreak.
winsdoubleWins.
division_lossesdouble
division_tiesdouble
division_winsdouble
overallcharacterOverall.
homecharacterHome.
awaycharacter
vs. conf.characterVs. conf..
vs ap top 25character
vs usa ranked teamscharacter
vs divisiondouble

Example

espn_cfb_standings()

Last validated n/a.

espn_cfb_rankings

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable

Returns

Raw JSON Dict (no parser registered).

Example

espn_cfb_rankings()

Last validated n/a.