espn_cfb_team_ats: *ESPN College Football Team Against-the-Spread Records*

In cfbfastR: Access College Football Play by Play Data

ESPN College Football Team Against-the-Spread Records

Description

Get a college football team's against-the-spread (ATS) records for a season – the 6-7 betting split rows ESPN tracks (overall, as favorite, as underdog, home, away, ...).

Usage

espn_cfb_team_ats(
  team_id = NULL,
  year = NULL,
  season_type = 2,
  team_detail = TRUE
)

Arguments

team_id	(Integer required): ESPN team id.
year	(Integer required): Season, 4 digit format (YYYY). Minimum value accepted: 2007
season_type	(Integer default 2): ESPN season type. 2 = regular season, 3 = postseason.
team_detail	(Logical): when TRUE (default), fetch the ESPN team catalog once and join friendly team fields next to the team_id column (see Details). Set FALSE to skip the catalog fetch and the join.

Details

Wraps the ESPN core-v2 team ATS endpoint sports.core.api.espn.com/v2/sports/football/leagues/college-football/seasons/{year}/types/{season_type}/teams/{team_id}/ats. ESPN returns one item per ATS split, each carrying a wins/losses/ pushes triple and a type block (id, name, description). This wrapper returns one row per split. The ATS records are populated only for completed games, so an in-progress or future season may return an empty frame.

When team_detail = TRUE (the default) the ESPN team catalog (espn_cfb_teams()) is fetched once and friendly team fields are joined in next to the team_id column – team_name, team_abbreviation, team_location, team_display_name, team_short_display_name, team_nickname, team_color, team_alternate_color, team_logo_href, and team_logo_dark_href, inserted immediately after team_id. A catalog failure degrades to NA rather than erroring the wrapper. Set team_detail = FALSE to skip the catalog fetch and the join.

Value

A data frame with one row per ATS split:

col_name	types	description
season	integer	Season (4-digit year).
season_type	integer	ESPN season type (2 = regular, 3 = postseason).
team_id	character	ESPN team id.
team_name	character	Team nickname; team_detail = TRUE only.
team_abbreviation	character	Team abbreviation; team_detail = TRUE only.
team_location	character	Team location / school name; team_detail = TRUE only.
team_display_name	character	Full team display name; team_detail = TRUE only.
team_short_display_name	character	Short team display name; team_detail = TRUE only.
team_nickname	character	Team nickname label; team_detail = TRUE only.
team_color	character	Primary team color; team_detail = TRUE only.
team_alternate_color	character	Alternate team color; team_detail = TRUE only.
team_logo_href	character	Default team logo URL; team_detail = TRUE only.
team_logo_dark_href	character	Dark-variant team logo URL; team_detail = TRUE only.
ats_type_id	character	ATS split type id (e.g. 0, 1, 2).
ats_type_name	character	ATS split type key (e.g. atsOverall, atsFavorite).
ats_description	character	ESPN's description of the ATS split.
wins	integer	Wins against the spread in the split.
losses	integer	Losses against the spread in the split.
pushes	integer	Pushes (no cover, no loss) in the split.

See Also

Other ESPN CFB Functions: espn_cfb_award(), espn_cfb_awards(), espn_cfb_clear_cache(), espn_cfb_coach(), espn_cfb_coach_record(), espn_cfb_coaches(), espn_cfb_franchise(), espn_cfb_franchises(), espn_cfb_futures(), espn_cfb_game_broadcasts(), espn_cfb_game_drive_plays(), espn_cfb_game_drives(), espn_cfb_game_leaders(), espn_cfb_game_odds(), espn_cfb_game_pbp(), espn_cfb_game_play(), espn_cfb_game_player_box(), espn_cfb_game_player_statistics(), espn_cfb_game_powerindex(), espn_cfb_game_predictor(), espn_cfb_game_probabilities(), espn_cfb_game_situation(), espn_cfb_game_status(), espn_cfb_game_team_leaders(), espn_cfb_game_team_linescores(), espn_cfb_game_team_records(), espn_cfb_game_team_roster(), espn_cfb_game_team_statistics(), espn_cfb_game_teams(), espn_cfb_groups(), espn_cfb_pbp_v2(), espn_cfb_player(), espn_cfb_player_career_stats(), espn_cfb_player_eventlog(), espn_cfb_player_gamelog(), espn_cfb_player_overview(), espn_cfb_player_seasons(), espn_cfb_player_splits(), espn_cfb_player_stats_v3(), espn_cfb_players(), espn_cfb_position(), espn_cfb_positions(), espn_cfb_powerindex(), espn_cfb_qbr(), espn_cfb_rankings(), espn_cfb_recruits(), espn_cfb_season_info(), espn_cfb_season_types(), espn_cfb_season_weeks(), espn_cfb_seasons(), espn_cfb_standings(), espn_cfb_team(), espn_cfb_team_awards(), espn_cfb_team_coaches(), espn_cfb_team_events(), espn_cfb_team_leaders(), espn_cfb_team_powerindex(), espn_cfb_team_ranks(), espn_cfb_team_record(), espn_cfb_team_roster(), espn_cfb_team_schedule(), espn_cfb_teams(), espn_cfb_unnest_plays(), espn_cfb_venue(), espn_cfb_venues(), espn_cfb_week_rankings()

Examples

  try(espn_cfb_team_ats(team_id = 61, year = 2024))
  try(espn_cfb_team_ats(team_id = 61, year = 2024, team_detail = FALSE))

cfbfastR documentation built on Aug. 24, 2026, 5:13 p.m.