Skip to main content
Version: 0.0.54

NFL — ESPN site API (v2)

sportsdataverse.nfl — 28 endpoints.

espn_nfl_scoreboard

ESPN endpoint.

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

Valid URL: https://site.api.espn.com/apis/site/v2/sports/football/nfl/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_rankcharacter
away_idcharacter
away_namecharacter
away_abbreviationcharacter
away_display_namecharacter
away_locationcharacter
away_colorcharacter
away_alternate_colorcharacter
away_logocharacter
away_scorecharacter
away_winnerlogical
away_rankcharacter

Example

espn_nfl_scoreboard(dates='20240115')

Last validated n/a.

espn_nfl_summary

ESPN endpoint.

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

Valid URL: https://site.api.espn.com/apis/site/v2/sports/football/nfl/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
sacks_sack_yards_lostcharacter
adj_qbrcharacter
qb_ratingcharacter
rushing_attemptscharacter
rushing_yardscharacter
yards_per_rush_attemptcharacter
rushing_touchdownscharacter
long_rushingcharacter
receptionscharacter
receiving_yardscharacter
yards_per_receptioncharacter
receiving_touchdownscharacter
long_receptioncharacter
receiving_targetscharacter
fumblescharacter
fumbles_lostcharacter
fumbles_recoveredcharacter
total_tacklescharacter
solo_tacklescharacter
sackscharacter
tackles_for_losscharacter
passes_defendedcharacter
qb_hitscharacter
defensive_touchdownscharacter
interception_yardscharacter
interception_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
puntscharacter
punt_yardscharacter
gross_avg_punt_yardscharacter
touchbackscharacter
punts_inside20character
long_puntcharacter
field_goals_made/field_goal_attemptscharacter
field_goal_pctcharacter
long_field_goal_madecharacter
extra_points_made/extra_point_attemptscharacter
total_kicking_pointscharacter

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.

officials

col_nametypedescription
full_namecharacterFull name.
display_namecharacterDisplay name.
orderintegerOrder.
position_namecharacterPosition name.
position_display_namecharacterPosition display name.
position_idcharacterPosition id.

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_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.
lossescharacterLosses.
points_againstcharacter
points_forcharacter
tiescharacter
win_percentcharacterWin percent.
winscharacterWins.
overallcharacter

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.
overtime_clockdoubleOvertime clock.
sudden_death_periodsinteger
sudden_death_clockdouble

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.

injuries

col_nametypedescription
injuriescharacterInjuries.
team_idcharacterTeam id.
team_uidcharacterTeam uid.
team_display_namecharacterTeam display name.
team_abbreviationcharacterTeam abbreviation.
team_linkscharacterTeam links.
team_logocharacterTeam logo.
team_logoscharacterTeam logos.

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.
bylinecharacterByline.
links_web_hrefcharacterLinks web href.
links_mobile_hrefcharacterLinks mobile href.
links_api_self_hrefcharacterLinks api self 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

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_nfl_summary()

Last validated n/a.

espn_nfl_calendar

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_calendar()

Last validated n/a.

espn_nfl_calendar_offseason

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_calendar_offseason()

Last validated n/a.

espn_nfl_calendar_regular_season

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_calendar_regular_season()

Last validated n/a.

espn_nfl_calendar_postseason

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_calendar_postseason()

Last validated n/a.

espn_nfl_calendar_ondays

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_calendar_ondays()

Last validated n/a.

espn_nfl_news

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
limitlimitY

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_news()

Last validated n/a.

espn_nfl_injuries

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_injuries()

Last validated n/a.

espn_nfl_transactions

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_transactions()

Last validated n/a.

espn_nfl_conferences

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_conferences()

Last validated n/a.

espn_nfl_statistics_league

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_statistics_league()

Last validated n/a.

espn_nfl_draft

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_draft()

Last validated n/a.

espn_nfl_teams_site

ESPN endpoint.

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

Valid URL: https://site.api.espn.com/apis/site/v2/sports/football/nfl/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_nfl_teams_site()

Last validated n/a.

espn_nfl_team

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
team_idteam_idY

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_team(team_id='4')

Last validated n/a.

espn_nfl_team_roster

ESPN endpoint.

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

Valid URL: https://site.api.espn.com/apis/site/v2/sports/football/nfl/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.
contractscharacterContracts.
alternate_ids_sdrcharacterAlternate ids sdr.
birth_place_citycharacterBirth place city.
birth_place_statecharacterBirth place state.
birth_place_countrycharacterBirth place country.
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.
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.
status_idcharacterStatus id.
status_namecharacterStatus name.
status_typecharacterStatus type.
status_abbreviationcharacterStatus abbreviation.
agedoubleAge.
date_of_birthcharacterDate of birth.
debut_yeardoubleDebut year.
hand_typecharacterHand type.
hand_abbreviationcharacterHand abbreviation.
hand_display_valuecharacterHand display value.

Example

espn_nfl_team_roster(team_id='4')

Last validated n/a.

espn_nfl_team_schedule

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
team_idteam_idY
seasonseasonY

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_team_schedule(team_id='4')

Last validated n/a.

espn_nfl_team_record

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
team_idteam_idY

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_team_record(team_id='4')

Last validated n/a.

espn_nfl_team_depthcharts

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
team_idteam_idY

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_team_depthcharts(team_id='4')

Last validated n/a.

espn_nfl_team_injuries

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
team_idteam_idY

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_team_injuries(team_id='4')

Last validated n/a.

espn_nfl_team_transactions

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
team_idteam_idY

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_team_transactions(team_id='4')

Last validated n/a.

espn_nfl_team_history

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
team_idteam_idY

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_team_history(team_id='4')

Last validated n/a.

espn_nfl_team_news

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
team_idteam_idY
limitlimitY

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_team_news(team_id='4')

Last validated n/a.

espn_nfl_team_leaders

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
team_idteam_idY

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_team_leaders(team_id='4')

Last validated n/a.

espn_nfl_player_info

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
athlete_idathlete_idY

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_player_info(athlete_id='4239')

Last validated n/a.

espn_nfl_player_bio

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
athlete_idathlete_idY

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_player_bio(athlete_id='4239')

Last validated n/a.

espn_nfl_player_news

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullable
athlete_idathlete_idY

Returns

Raw JSON Dict (no parser registered).

Example

espn_nfl_player_news(athlete_id='4239')

Last validated n/a.

espn_nfl_standings

ESPN endpoint.

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

Valid URL: https://site.api.espn.com/apis/v2/sports/football/nfl/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.
clincherdoubleClincher.
differentialdoubleDifferential.
games_behinddoubleGames behind.
lossesdoubleLosses.
playoff_seeddoublePlayoff seed.
point_differentialdoublePoint differential.
points_againstdoublePoints against.
points_fordoublePoints for.
streakdoubleStreak.
tiesdouble
win_percentdoubleWin percent.
winsdoubleWins.
division_lossesdouble
division_recorddouble
division_tiesdouble
division_winsdouble
overallcharacterOverall.
homecharacterHome.
roadcharacterRoad.
vs. div.characterVs. div..
vs. conf.characterVs. conf..

Example

espn_nfl_standings()

Last validated n/a.