Skip to main content

Yahoo Sports — Yahoo Sports Shangrila (graphite-secure.sports.yahoo.com) — League

yahoo_league_conferences​

Yahoo shangrila persisted query leagueConferences -> one row per leagues entry

Endpoint URL: GET https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueConferences

Valid URL: https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueConferences

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYleague query parameter.
divisionIdsdivision_idsYdivisionIds query parameter.

Returns​

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

col_nametypedescription
short_nameString
conferencesStringJSON-encoded list of the league's conference nodes, each carrying an id, a name and its member teams.

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

yahoo_league_conferences()

yahoo_league_filters_data​

Yahoo shangrila persisted query leagueFiltersData -> one row per leagues entry

Endpoint URL: GET https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueFiltersData

Valid URL: https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueFiltersData

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYleague query parameter.
seasonseasonYSeason year (e.g. 2024).
viewTypeview_typeYviewType query parameter.
includePosAndSplitsDatainclude_pos_and_splits_dataYincludePosAndSplitsData query parameter.

Returns​

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

col_nametypedescription
sport_sport_idStringYahoo identifier of the sport the league belongs to.
sport_nameString
short_nameString
full_nameString
nameString
current_league_dayStringCalendar date the league's live scoreboard is anchored on, in YYYY-MM-DD form.
teamsString
current_weekInt64Week number within the league's current season phase, counting from 1.
current_season_phaseStringPhase of the season currently in effect (e.g., "season.phase.season", "season.phase.offseason").
current_game_season_phaseStringSeason phase of the games the league feed is currently serving.
current_seasonInt64Season the league is currently playing, as the four-digit starting year.
current_league_seasonStringYahoo league-season identifier for the season currently in progress.
league_seasonsStringJSON-encoded list of the seasons for which Yahoo carries data for this league.
league_weeksStringJSON-encoded list of the league's week nodes for the season.
current_season_league_weeksStringJSON-encoded list of the week nodes making up the current league season.
divisionsStringJSON-encoded list of the league's division nodes, each carrying its member conferences and teams.
conferencesStringJSON-encoded list of the league's conference nodes, each carrying an id, a name and its member teams.

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

yahoo_league_filters_data()

yahoo_league_future_odds​

Yahoo shangrila persisted query leagueFutureOdds -> one row per leagues entry

Endpoint URL: GET https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueFutureOdds

Valid URL: https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueFutureOdds

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYleague query parameter.
betCategoriesbet_categoriesYbetCategories query parameter.

Returns​

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

col_nametypedescription
betsStringJSON-encoded list of the betting markets offered on the event (spread, moneyline and total).
leagueString

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

yahoo_league_future_odds()

yahoo_league_game_ids​

Yahoo shangrila persisted query leagueGameIds -> one row per leagues entry

Endpoint URL: GET https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueGameIds

Valid URL: https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueGameIds

API ParameterPythonPatternRequiredNullableDescription
countcountYcount query parameter.
leagueleagueYleague query parameter.
weekweekYWeek number within the season.
datedateYdate query parameter.
seasonseasonYSeason year (e.g. 2024).
gameStatusOrdergame_status_orderYgameStatusOrder query parameter.
startTimeOrderstart_time_orderYstartTimeOrder query parameter.
dateFlipOffsetdate_flip_offsetYdateFlipOffset query parameter.
seasonPhaseseason_phaseYseasonPhase query parameter.
conferenceIdsconference_idsYconferenceIds query parameter.
top25top25Ytop25 query parameter.
gameDayQueryTypegame_day_query_typeYgameDayQueryType query parameter.

Returns​

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

col_nametypedescription
alias_urlStringAbsolute sports.yahoo.com URL of the entity's page (e.g., "https://sports.yahoo.com/ncaaf/players/464024/").
alias_navigation_linksStringJSON-encoded map of navigation links (scores, standings, teams) hanging off the entity's Yahoo alias.
current_weekInt64Week number within the league's current season phase, counting from 1.
gamesString

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

yahoo_league_game_ids()

yahoo_league_game_ids_by_date​

Yahoo shangrila persisted query leagueGameIdsByDate -> one row per leagues entry

Endpoint URL: GET https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueGameIdsByDate

Valid URL: https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueGameIdsByDate

API ParameterPythonPatternRequiredNullableDescription
leaguesleaguesYleagues query parameter.
weekweekYWeek number within the season.
datesdatesYDate or date range filter (YYYYMMDD or YYYYMMDD-YYYYMMDD).
startRangestart_rangeYstartRange query parameter.
endRangeend_rangeYendRange query parameter.
seasonseasonYSeason year (e.g. 2024).
seasonPhasesseason_phasesYseasonPhases query parameter.
conferenceIdsconference_idsYconferenceIds query parameter.
divisionIdsdivision_idsYdivisionIds query parameter.
top25top25Ytop25 query parameter.
tournamentIdstournament_idsYtournamentIds query parameter.
isTennisis_tennisYisTennis query parameter.

Returns​

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

col_nametypedescription
display_shortStringShort league label used in navigation and compact UI (e.g., "NCAA FB").
full_nameString
nameString
current_weekInt64Week number within the league's current season phase, counting from 1.
current_game_season_phaseStringSeason phase of the games the league feed is currently serving.
current_league_seasonStringYahoo league-season identifier for the season currently in progress.
gamesString

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

yahoo_league_game_ids_by_date()

yahoo_league_games_by_round​

Yahoo shangrila persisted query leagueGamesByRound -> one row per leagues entry

Endpoint URL: GET https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueGamesByRound

Valid URL: https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueGamesByRound

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYleague query parameter.
tournamentRoundIdstournament_round_idsYtournamentRoundIds query parameter.
seasonseasonYSeason year (e.g. 2024).

Returns​

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_yahoo_shangrila); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

yahoo_league_games_by_round()

yahoo_league_info​

Yahoo shangrila persisted query leagueInfo -> one row per leagues entry

Endpoint URL: GET https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueInfo

Valid URL: https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueInfo

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYleague query parameter.

Returns​

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

col_nametypedescription
display_shortStringShort league label used in navigation and compact UI (e.g., "NCAA FB").
nameString
full_nameString
short_nameString

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

yahoo_league_info()

yahoo_league_injuries​

Yahoo shangrila persisted query leagueInjuries -> one row per leagues.teams entry

Endpoint URL: GET https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueInjuries

Valid URL: https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueInjuries

API ParameterPythonPatternRequiredNullableDescription
leagueIdleague_idYleagueId query parameter.

Returns​

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

col_nametypedescription
team_idString
nicknameString
full_nameString
locationString
display_nameString
primary_colorString
abbreviationString
aliasStringJSON-encoded Yahoo alias object for the entity, carrying the site URL, path and subpage routing used to build links to its page.
team_logo_whiteStringJSON-encoded image node for the team's white knockout logo.
team_logoString
playersString

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

yahoo_league_injuries()

yahoo_league_names​

Yahoo shangrila persisted query leagueNames -> one row per leagues entry

Endpoint URL: GET https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueNames

Valid URL: https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueNames

API ParameterPythonPatternRequiredNullableDescription
leaguesleaguesYleagues query parameter.

Returns​

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

col_nametypedescription
league_idInt64
short_nameString
full_nameString
nameString
display_shortStringShort league label used in navigation and compact UI (e.g., "NCAA FB").
display_abbrStringCompact league abbreviation used in dense UI (e.g., "NCAAF").
current_seasonInt64Season the league is currently playing, as the four-digit starting year.
league_seasonsStringJSON-encoded list of the seasons for which Yahoo carries data for this league.
alias_urlStringAbsolute sports.yahoo.com URL of the entity's page (e.g., "https://sports.yahoo.com/ncaaf/players/464024/").
alias_pathStringSite-relative path portion of the entity's Yahoo alias (e.g., "/ncaaf/teams/tcu/").
alias_subpagesStringJSON-encoded list of subpage aliases (roster, schedule, stats) available beneath the entity's Yahoo page.

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

yahoo_league_names()

yahoo_league_prop_odds​

Yahoo shangrila persisted query leaguePropOdds -> one row per leagues entry

Endpoint URL: GET https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leaguePropOdds

Valid URL: https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leaguePropOdds

API ParameterPythonPatternRequiredNullableDescription
countcountYcount query parameter.
leagueleagueYleague query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_yahoo_shangrila); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

yahoo_league_prop_odds()

yahoo_league_standings​

Yahoo shangrila persisted query leagueStandings -> one row per leagues entry

Endpoint URL: GET https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueStandings

Valid URL: https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueStandings

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYleague query parameter.
seasonseasonYSeason year (e.g. 2024).
seasonPhaseseason_phaseYseasonPhase query parameter.

Returns​

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

col_nametypedescription
sport_nameString
current_season_phaseStringPhase of the season currently in effect (e.g., "season.phase.season", "season.phase.offseason").
current_league_seasonStringYahoo league-season identifier for the season currently in progress.
divisionsStringJSON-encoded list of the league's division nodes, each carrying its member conferences and teams.
teamsString
conferencesStringJSON-encoded list of the league's conference nodes, each carrying an id, a name and its member teams.

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

yahoo_league_standings()

yahoo_league_stats_by_team​

Yahoo shangrila persisted query leagueStatsByTeam -> one row per leagues entry

Endpoint URL: GET https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueStatsByTeam

Valid URL: https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueStatsByTeam

API ParameterPythonPatternRequiredNullableDescription
leaguesleaguesYleagues query parameter.
countcountYcount query parameter.
seasonseasonYSeason year (e.g. 2024).
leagueStructureIdleague_structure_idYleagueStructureId query parameter.
baseballCutTypebaseball_cut_typeYbaseballCutType query parameter.
basketballCutTypebasketball_cut_typeYbasketballCutType query parameter.
footballCutTypefootball_cut_typeYfootballCutType query parameter.
hockeyCutTypehockey_cut_typeYhockeyCutType query parameter.

Returns​

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

col_nametypedescription
sport_sport_idStringYahoo identifier of the sport the league belongs to.
sport_nameString
short_nameString
full_nameString
nameString
football_statsStringJSON-encoded football statistics block returned by the league stats query.

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

yahoo_league_stats_by_team()

yahoo_league_stats_individual​

Yahoo shangrila persisted query leagueStatsIndividual -> one row per leagues entry

Endpoint URL: GET https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueStatsIndividual

Valid URL: https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueStatsIndividual

API ParameterPythonPatternRequiredNullableDescription
leaguesleaguesYleagues query parameter.
countcountYcount query parameter.
seasonseasonYSeason year (e.g. 2024).
qualifiedqualifiedYqualified query parameter.
leagueStructureIdleague_structure_idYleagueStructureId query parameter.
baseballCutTypebaseball_cut_typeYbaseballCutType query parameter.
baseballPositionbaseball_positionYbaseballPosition query parameter.
basketballCutTypebasketball_cut_typeYbasketballCutType query parameter.
basketballPositionbasketball_positionYbasketballPosition query parameter.
footballCutTypefootball_cut_typeYfootballCutType query parameter.
hockeyCutTypehockey_cut_typeYhockeyCutType query parameter.
hockeyPositionhockey_positionYhockeyPosition query parameter.
golfSortStatgolf_sort_statYgolfSortStat query parameter.
golfStatIdsgolf_stat_idsYgolfStatIds query parameter.
motorsportsSortStatmotorsports_sort_statYmotorsportsSortStat query parameter.
motorsportsStatIdsmotorsports_stat_idsYmotorsportsStatIds query parameter.

Returns​

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

col_nametypedescription
sport_sport_idStringYahoo identifier of the sport the league belongs to.
sport_nameString
short_nameString
full_nameString
nameString
football_statsStringJSON-encoded football statistics block returned by the league stats query.

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

yahoo_league_stats_individual()

yahoo_league_stats_overview​

Yahoo shangrila persisted query leagueStatsOverview (response body not captured; shape unknown)

Endpoint URL: GET https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueStatsOverview

Valid URL: https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueStatsOverview

API ParameterPythonPatternRequiredNullableDescription
leaguesleaguesYleagues query parameter.
countcountYcount query parameter.
weekweekYWeek number within the season.
weekSeasonPhaseweek_season_phaseYweekSeasonPhase query parameter.
seasonPhaseseason_phaseYseasonPhase query parameter.
leagueStructureIdleague_structure_idYleagueStructureId query parameter.
golfSortStatgolf_sort_statYgolfSortStat query parameter.
golfStatIdsgolf_stat_idsYgolfStatIds query parameter.
motorsportsSortStatmotorsports_sort_statYmotorsportsSortStat query parameter.
motorsportsStatIdsmotorsports_stat_idsYmotorsportsStatIds query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_yahoo_shangrila); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

yahoo_league_stats_overview()

yahoo_league_stats_weekly​

Yahoo shangrila persisted query leagueStatsWeekly -> one row per leagues entry

Endpoint URL: GET https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueStatsWeekly

Valid URL: https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueStatsWeekly

API ParameterPythonPatternRequiredNullableDescription
leaguesleaguesYleagues query parameter.
countcountYcount query parameter.
weekweekYWeek number within the season.
seasonseasonYSeason year (e.g. 2024).
seasonPhaseseason_phaseYseasonPhase query parameter.

Returns​

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

col_nametypedescription
sport_sport_idStringYahoo identifier of the sport the league belongs to.
sport_nameString
short_nameString
full_nameString
nameString
football_statsStringJSON-encoded football statistics block returned by the league stats query.

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

yahoo_league_stats_weekly()

yahoo_league_team_ids​

Yahoo shangrila persisted query leagueTeamIds -> one row per leagues entry

Endpoint URL: GET https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueTeamIds

Valid URL: https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueTeamIds

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYleague query parameter.
divisionIdsdivision_idsYdivisionIds query parameter.
getTeamsByDivisionget_teams_by_divisionYgetTeamsByDivision query parameter.

Returns​

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

col_nametypedescription
short_nameString
teamsString

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

yahoo_league_team_ids()

yahoo_league_teams​

Yahoo shangrila persisted query leagueTeams -> one row per leagues entry

Endpoint URL: GET https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueTeams

Valid URL: https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leagueTeams

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYleague query parameter.
seasonseasonYSeason year (e.g. 2024).
divisionIdsdivision_idsYdivisionIds query parameter.
getTeamsByDivisionget_teams_by_divisionYgetTeamsByDivision query parameter.

Returns​

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

col_nametypedescription
short_nameString
teamsString

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

yahoo_league_teams()

yahoo_leagues_season_states​

Yahoo shangrila persisted query leaguesSeasonStates -> one row per leagues entry

Endpoint URL: GET https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leaguesSeasonStates

Valid URL: https://graphite-secure.sports.yahoo.com/v1/query/shangrila/leaguesSeasonStates

API ParameterPythonPatternRequiredNullableDescription
leaguesleaguesYleagues query parameter.

Returns​

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

col_nametypedescription
nameString
short_nameString
full_nameString
display_shortStringShort league label used in navigation and compact UI (e.g., "NCAA FB").
current_season_phaseStringPhase of the season currently in effect (e.g., "season.phase.season", "season.phase.offseason").
current_weekInt64Week number within the league's current season phase, counting from 1.
current_seasonInt64Season the league is currently playing, as the four-digit starting year.
stats_seasonStringSeason the returned statistics cover, as a four-digit year.
sport_nameString
league_weeksStringJSON-encoded list of the league's week nodes for the season.
alias_urlStringAbsolute sports.yahoo.com URL of the entity's page (e.g., "https://sports.yahoo.com/ncaaf/players/464024/").
alias_navigation_linksStringJSON-encoded map of navigation links (scores, standings, teams) hanging off the entity's Yahoo alias.
league_seasonsStringJSON-encoded list of the seasons for which Yahoo carries data for this league.
bye_weeksStringJSON-encoded list of the week numbers in which the team has no scheduled game.
divisionsStringJSON-encoded list of the league's division nodes, each carrying its member conferences and teams.

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

yahoo_leagues_season_states()