Skip to contents

Load Tournament Leaderboard

Source: R/load_leaderboard.R
load_leaderboard.Rd

Retrieves leaderboard data for tournaments. Can load a single tournament or all tournaments for a year.

Usage

load_leaderboard(
  year = as.integer(format(Sys.Date(), "%Y")),
  tournament = NULL,
  tour = "pga",
  live = FALSE
)

get_tournament_leaderboard(event_id)

Arguments

year

Season year (e.g., 2026). Defaults to current year.

tournament

Tournament identifier - either event_id or partial name match. If NULL, returns all tournaments for the year.

tour

Tour identifier. Currently supports "pga" (default).

live

If TRUE, skip the hosted data and fetch directly from the ESPN API. Defaults to FALSE.

event_id

ESPN event identifier (for legacy function)

Value

A tibble with leaderboard data including:

  • position: Final standing

  • player_id: ESPN athlete ID

  • player_name: Player display name

  • total_score: Total strokes

  • score_to_par: Score relative to par (e.g., "-11")

  • tournament_id: Event ID

  • tournament_name: Tournament name

A tibble with leaderboard data

Details

For PGA Tour data, completed tournaments are served from pre-built files hosted on GitHub releases (updated daily), which is much faster than querying ESPN tournament by tournament. The live ESPN API is used as a fallback for in-progress tournaments, other tours, or when the hosted data is unavailable.

Functions

  • get_tournament_leaderboard(): Deprecated, use `load_leaderboard()` instead

Examples

# \donttest{
# Load specific tournament by name
sony <- load_leaderboard(2026, "Sony")
# }