espn_cfb_player_eventlog: *ESPN College Football Player Event Log*

In cfbfastR: Access College Football Play by Play Data

ESPN College Football Player Event Log

Description

Get the per-game event log for a single college football player in a season – one row per game, with the ⁠$ref⁠ URLs to each game's event, competition, and the player's per-game statistics.

Usage

espn_cfb_player_eventlog(
  athlete_id = NULL,
  year = NULL,
  team_detail = TRUE,
  athlete_detail = TRUE
)

Arguments

athlete_id	(Character/Integer required): ESPN athlete id.
year	(Integer required): Season, 4 digit format (YYYY). Minimum value accepted: 2004
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.
athlete_detail	(Logical): when TRUE (default), fetch the requested athlete's ESPN record once and append the ⁠athlete_*⁠ name columns (see Details). Set FALSE to skip the fetch, reproducing the prior output exactly.

Details

Wraps the ESPN core-v2 endpoint sports.core.api.espn.com/v2/sports/football/leagues/college-football/seasons/{year}/athletes/{athlete_id}/eventlog. The event log lists every game the player appeared on a roster for in the requested season. Per-game statistics are referenced by a statistics_ref URL rather than being inlined – they are not auto-dereferenced, since one fetch per game would be costly; resolve a particular game with a direct request to that URL when needed. If the player did not play in the requested season ESPN returns an empty payload and this wrapper returns an empty data 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.

When athlete_detail = TRUE (the default) the requested athlete's ESPN record is fetched once and the human-readable name columns athlete_display_name, athlete_first_name, athlete_last_name, athlete_jersey, athlete_position, and athlete_position_abbreviation are appended to every row. This is a single cheap fetch – the wrapper already takes one athlete_id. A fetch failure degrades the name columns to NA rather than erroring the wrapper. Set athlete_detail = FALSE to skip the fetch and reproduce the prior output exactly.

Value

A data frame with one row per game:

col_name	types	description
athlete_id	character	ESPN athlete id.
season	integer	Season (4-digit year).
game_id	character	ESPN event (game) id (parsed from event_ref).
team_id	character	ESPN team id the player played for in the game.
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.
played	logical	Whether the player played in the game.
event_ref	character	⁠$ref⁠ URL to the event resource.
competition_ref	character	⁠$ref⁠ URL to the competition resource.
statistics_ref	character	⁠$ref⁠ URL to the player's per-game statistics.
athlete_display_name	character	Player display name; athlete_detail = TRUE only.
athlete_first_name	character	Player first name; athlete_detail = TRUE only.
athlete_last_name	character	Player last name; athlete_detail = TRUE only.
athlete_jersey	character	Player jersey number; athlete_detail = TRUE only.
athlete_position	character	Player position name; athlete_detail = TRUE only.
athlete_position_abbreviation	character	Player position abbreviation; athlete_detail = TRUE only.

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_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_ats(), 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_player_eventlog(athlete_id = 102597, year = 2024))
  try(espn_cfb_player_eventlog(athlete_id = 102597, year = 2024,
                               team_detail = FALSE,
                               athlete_detail = FALSE))

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