Skip to main content

UFL — ESPN CDN API (cdn.espn.com)

sportsdataverse.ufl — 1 endpoint.

espn_ufl_cdn_schedule​

espn.com schedule page data, one row per game: up to 7 days starting at date (mbb and wbb: that day only; cfb and nfl: one week).

Endpoint URL: GET https://cdn.espn.com/core/ufl/schedule

Valid URL: https://cdn.espn.com/core/ufl/schedule?xhr=1&date=20250115

API ParameterPythonPatternRequiredNullableDescription
datedateYSingle date (YYYYMMDD). Ignored by cfb and nfl, which are week-oriented. Defaults to today.
weekweekYWeek number (cfb and nfl).
yearseasonYSeason year that week belongs to (cfb and nfl).
seasontypeseason_typeYSeason phase for week: 1=preseason, 2=regular season, 3=postseason (cfb and nfl).

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
game_idintegerESPN event id.
seasonintegerFour-digit season year.
game_datecharacterISO 8601 kickoff timestamp (UTC).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

espn_ufl_cdn_schedule(date='20250115')

Last validated n/a.