Skip to main content

cfb — ESPN reference

  • sport slug: football
  • league slug: college-football
  • scopes: universal, ncaa, football
  • wrappers: 115

Every endpoint is called as sdv.cfb.espnCfb<Endpoint>(params). Each method is also available under its snake_case name (espn_cfb_<endpoint>) for parity with the Python / R packages. Parameters accept snake_case or camelCase. Required path params are marked *.

import sdv from 'sportsdataverse';

await sdv.cfb.espnCfbScoreboard({});

Universal endpoints

MethodHTTPPath paramsQuery params
espnCfbAthleteAwardscore_v2 /football/leagues/college-football/athletes/{athlete_id}/awardsathlete_id*
espnCfbAthleteBiosite_v2 /football/college-football/athletes/{athlete_id}/bioathlete_id*
espnCfbAthleteCareerStatscore_v2 /football/leagues/college-football/athletes/{athlete_id}/statistics[/{stat_type}]athlete_id*, stat_type
espnCfbAthleteContractscore_v2 /football/leagues/college-football/athletes/{athlete_id}/contractsathlete_id*
espnCfbAthleteCorecore_v2 /football/leagues/college-football/athletes/{athlete_id}athlete_id*
espnCfbAthleteEventlogcore_v2 /football/leagues/college-football/athletes/{athlete_id}/eventlogathlete_id*
espnCfbAthleteGamelogweb_v3 /football/college-football/athletes/{athlete_id}/gamelogathlete_id*season
espnCfbAthleteInfosite_v2 /football/college-football/athletes/{athlete_id}athlete_id*
espnCfbAthleteInjuriescore_v2 /football/leagues/college-football/athletes/{athlete_id}/injuriesathlete_id*
espnCfbAthleteNewssite_v2 /football/college-football/athletes/{athlete_id}/newsathlete_id*
espnCfbAthleteNotescore_v2 /football/leagues/college-football/athletes/{athlete_id}/notesathlete_id*
espnCfbAthleteOverviewweb_v3 /football/college-football/athletes/{athlete_id}/overviewathlete_id*
espnCfbAthleteRecordscore_v2 /football/leagues/college-football/athletes/{athlete_id}/recordsathlete_id*
espnCfbAthleteSeasonscore_v2 /football/leagues/college-football/athletes/{athlete_id}/seasonsathlete_id*
espnCfbAthleteSplitsweb_v3 /football/college-football/athletes/{athlete_id}/splitsathlete_id*season
espnCfbAthleteStatisticslogcore_v2 /football/leagues/college-football/athletes/{athlete_id}/statisticslogathlete_id*
espnCfbAthleteStatsweb_v3 /football/college-football/athletes/{athlete_id}/statsathlete_id*season
espnCfbAthleteVsAthletecore_v2 /football/leagues/college-football/athletes/{athlete_id}/vsathlete/{opp_id}athlete_id*, opp_id*
espnCfbAthletesIndexcore_v2 /football/leagues/college-football/athletesactive, limit, page
espnCfbAwardcore_v2 /football/leagues/college-football/awards/{award_id}award_id*
espnCfbAwardscore_v2 /football/leagues/college-football/awards
espnCfbCalendarsite_v2 /football/college-football/calendar
espnCfbCoachcore_v2 /football/leagues/college-football/coaches/{coach_id}coach_id*
espnCfbCoachRecordcore_v2 /football/leagues/college-football/coaches/{coach_id}/record/{record_type}coach_id*, record_type
espnCfbCoachSeasoncore_v2 /football/leagues/college-football/coaches/{coach_id}/seasons/{season}coach_id*, season*
espnCfbConferencessite_v2 /football/college-football/groups
espnCfbDraftsite_v2 /football/college-football/draft
espnCfbEventcore_v2 /football/leagues/college-football/events/{event_id}event_id*
espnCfbEventBroadcastscore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/broadcastsevent_id*, cid
espnCfbEventCompetitioncore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}event_id*, cid
espnCfbEventCompetitorcore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/competitors/{team_id}event_id*, team_id*, cid
espnCfbEventCompetitorLeaderscore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/competitors/{team_id}/leadersevent_id*, team_id*, cid
espnCfbEventCompetitorLinescorescore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/competitors/{team_id}/linescoresevent_id*, team_id*, cid
espnCfbEventCompetitorRecordcore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/competitors/{team_id}/recordevent_id*, team_id*, cid
espnCfbEventCompetitorRostercore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/competitors/{team_id}/rosterevent_id*, team_id*, cid
espnCfbEventCompetitorStatisticscore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/competitors/{team_id}/statisticsevent_id*, team_id*, cid
espnCfbEventCompetitorscore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/competitorsevent_id*, cid
espnCfbEventLeaderscore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/leadersevent_id*, cid
espnCfbEventOddscore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/oddsevent_id*, cid
espnCfbEventOfficialDetailcore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/officials/{official_id}event_id*, official_id*, cid
espnCfbEventOfficialscore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/officialsevent_id*, cid
espnCfbEventPlaycore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/plays/{play_id}event_id*, play_id*, cid
espnCfbEventPlayPersonnelcore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/plays/{play_id}/personnelevent_id*, play_id*, cid
espnCfbEventPlayscore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/playsevent_id*, cidlimit
espnCfbEventPowerindexcore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/powerindexevent_id*, cid
espnCfbEventPredictorcore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/predictorevent_id*, cid
espnCfbEventProbabilitiescore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/probabilitiesevent_id*, cidlimit
espnCfbEventPropbetscore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/propbetsevent_id*, cid
espnCfbEventScoringplayscore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/scoringplaysevent_id*, cid
espnCfbEventSituationcore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/situationevent_id*, cid
espnCfbEventStatuscore_v2 /football/leagues/college-football/events/{event_id}/competitions/{cid}/statusevent_id*, cid
espnCfbEventscore_v2 /football/leagues/college-football/eventsdates, limit
espnCfbFranchisecore_v2 /football/leagues/college-football/franchises/{franchise_id}franchise_id*
espnCfbFranchisescore_v2 /football/leagues/college-football/franchiseslimit
espnCfbInjuriessite_v2 /football/college-football/injuries
espnCfbLeadersweb_v3 /football/college-football/statistics/byathletecategory, season, season_typeseasontype, limit, page, sort
espnCfbLeadersCorecore_v2 /football/leagues/college-football/leaders
espnCfbLeagueNotescore_v2 /football/leagues/college-football/notes
espnCfbLeagueRootcore_v2 /football/leagues/college-football
espnCfbNewssite_v2 /football/college-football/newslimit
espnCfbPositioncore_v2 /football/leagues/college-football/positions/{position_id}position_id*
espnCfbPositionscore_v2 /football/leagues/college-football/positions
espnCfbScoreboardsite_v2 /football/college-football/scoreboarddates, week, season_typeseasontype, groups, limit
espnCfbSeasonAthletescore_v2 /football/leagues/college-football/seasons/{season}/athletesseason*limit, page
espnCfbSeasonAwardscore_v2 /football/leagues/college-football/seasons/{season}/awardsseason*
espnCfbSeasonCoachescore_v2 /football/leagues/college-football/seasons/{season}/coachesseason*limit
espnCfbSeasonDraftcore_v2 /football/leagues/college-football/seasons/{season}/draftseason*
espnCfbSeasonDraftRoundPickscore_v2 /football/leagues/college-football/seasons/{season}/draft/rounds/{round_num}/picksseason*, round_num*
espnCfbSeasonFreeagentscore_v2 /football/leagues/college-football/seasons/{season}/freeagentsseason*
espnCfbSeasonFuturescore_v2 /football/leagues/college-football/seasons/{season}/futuresseason*
espnCfbSeasonGroupcore_v2 /football/leagues/college-football/seasons/{season}/types/{season_type}/groups/{group_id}season*, season_type*, group_id*
espnCfbSeasonGroupChildrencore_v2 /football/leagues/college-football/seasons/{season}/types/{season_type}/groups/{group_id}/childrenseason*, season_type*, group_id*
espnCfbSeasonGroupTeamscore_v2 /football/leagues/college-football/seasons/{season}/types/{season_type}/groups/{group_id}/teamsseason*, season_type*, group_id*limit
espnCfbSeasonGroupscore_v2 /football/leagues/college-football/seasons/{season}/types/{season_type}/groupsseason*, season_type*
espnCfbSeasonInfocore_v2 /football/leagues/college-football/seasons/{season}season*
espnCfbSeasonPointercore_v2 /football/leagues/college-football/season
espnCfbSeasonPowerindexcore_v2 /football/leagues/college-football/seasons/{season}/powerindex[/{team_id}]season*, team_id
espnCfbSeasonPowerindexLeaderscore_v2 /football/leagues/college-football/seasons/{season}/powerindex/leadersseason*
espnCfbSeasonTeamcore_v2 /football/leagues/college-football/seasons/{season}/teams/{team_id}season*, team_id*
espnCfbSeasonTeamscore_v2 /football/leagues/college-football/seasons/{season}/teamsseason*limit
espnCfbSeasonTypecore_v2 /football/leagues/college-football/seasons/{season}/types/{season_type}season*, season_type*
espnCfbSeasonTypeCorrectionscore_v2 /football/leagues/college-football/seasons/{season}/types/{season_type}/correctionsseason*, season_type*
espnCfbSeasonTypeLeaderscore_v2 /football/leagues/college-football/seasons/{season}/types/{season_type}/leadersseason*, season_type*
espnCfbSeasonTypescore_v2 /football/leagues/college-football/seasons/{season}/typesseason*
espnCfbSeasonWeekcore_v2 /football/leagues/college-football/seasons/{season}/types/{season_type}/weeks/{week}season*, season_type*, week*
espnCfbSeasonWeekEventscore_v2 /football/leagues/college-football/seasons/{season}/types/{season_type}/weeks/{week}/eventsseason*, season_type*, week*limit
espnCfbSeasonWeekscore_v2 /football/leagues/college-football/seasons/{season}/types/{season_type}/weeksseason*, season_type*
espnCfbSeasonscore_v2 /football/leagues/college-football/seasonslimit
espnCfbStandingssite_v2_alt /football/college-football/standingsseason, group, standings_typetype
espnCfbStandingsCorecore_v2 /football/leagues/college-football/standings
espnCfbStatisticsLeaguesite_v2 /football/college-football/statistics
espnCfbSummarysite_v2 /football/college-football/summaryevent_idevent
espnCfbTalentpickscore_v2 /football/leagues/college-football/talentpicks
espnCfbTeamsite_v2 /football/college-football/teams/{team_id}team_id*
espnCfbTeamCorecore_v2 /football/leagues/college-football/teams/{team_id}team_id*
espnCfbTeamDepthchartssite_v2 /football/college-football/teams/{team_id}/depthchartsteam_id*
espnCfbTeamHistorysite_v2 /football/college-football/teams/{team_id}/historyteam_id*
espnCfbTeamInjuriessite_v2 /football/college-football/teams/{team_id}/injuriesteam_id*
espnCfbTeamLeaderssite_v2 /football/college-football/teams/{team_id}/leadersteam_id*
espnCfbTeamNewssite_v2 /football/college-football/teams/{team_id}/newsteam_id*limit
espnCfbTeamRecordsite_v2 /football/college-football/teams/{team_id}/recordteam_id*
espnCfbTeamRostersite_v2 /football/college-football/teams/{team_id}/rosterteam_id*
espnCfbTeamSchedulesite_v2 /football/college-football/teams/{team_id}/scheduleteam_id*season
espnCfbTeamTransactionssite_v2 /football/college-football/teams/{team_id}/transactionsteam_id*
espnCfbTeamsCorecore_v2 /football/leagues/college-football/teamslimit
espnCfbTeamsSitesite_v2 /football/college-football/teamslimit
espnCfbTournamentscore_v2 /football/leagues/college-football/tournaments
espnCfbTransactionssite_v2 /football/college-football/transactions
espnCfbVenuecore_v2 /football/leagues/college-football/venues/{venue_id}venue_id*
espnCfbVenuescore_v2 /football/leagues/college-football/venueslimit

NCAA endpoints

MethodHTTPPath paramsQuery params
espnCfbRankingssite_v2 /football/college-football/rankings
espnCfbSeasonRecruitscore_v2 /football/leagues/college-football/seasons/{season}/recruitsseason*limit
espnCfbSeasonWeekRankingscore_v2 /football/leagues/college-football/seasons/{season}/types/{season_type}/weeks/{week}/rankingsseason*, season_type*, week*

Football endpoints

MethodHTTPPath paramsQuery params
espnCfbSeasonQbrcore_v2 /football/leagues/college-football/seasons/{season}/types/{season_type}[/groups/{group_id}]/qbr/{split}season*, season_type, group_id, split
espnCfbSeasonQbrWeekcore_v2 /football/leagues/college-football/seasons/{season}/types/{season_type}/weeks/{week}/qbr/{split}season*, week*, season_type, split

Parsed output: pass { parsed: true } to any endpoint above to get tidy rows instead of raw JSON. The columns are determined by each endpoint's parser — see ESPN parsed returns for the full column reference (and the summary dispatcher's 21 sub-frames).