Skip to main content

YAHOO — 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_namecharacterShort display name.
conferencescharacterJSON-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.

Example​

yahoo_league_conferences()

Last validated n/a.

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_idcharacterYahoo identifier of the sport the league belongs to.
sport_namecharacterSport name (e.g., Major League Baseball).
short_namecharacterShort display name.
full_namecharacterPlayer's full name.
namecharacterDisplay name.
current_league_daycharacterCalendar date the league's live scoreboard is anchored on, in YYYY-MM-DD form.
teamscharacterNested list of member-team membership spans.
current_weekintegerWeek number within the league's current season phase, counting from 1.
current_season_phasecharacterPhase of the season currently in effect (e.g., "season.phase.season", "season.phase.offseason").
current_game_season_phasecharacterSeason phase of the games the league feed is currently serving.
current_seasonintegerSeason the league is currently playing, as the four-digit starting year.
current_league_seasoncharacterYahoo league-season identifier for the season currently in progress.
league_seasonscharacterJSON-encoded list of the seasons for which Yahoo carries data for this league.
league_weekscharacterJSON-encoded list of the league's week nodes for the season.
current_season_league_weekscharacterJSON-encoded list of the week nodes making up the current league season.
divisionscharacterJSON-encoded list of the league's division nodes, each carrying its member conferences and teams.
conferencescharacterJSON-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.

Example​

yahoo_league_filters_data()

Last validated n/a.

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
betscharacterJSON-encoded list of the betting markets offered on the event (spread, moneyline and total).
leaguecharacterLeague slug.

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

Example​

yahoo_league_future_odds()

Last validated n/a.

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_urlcharacterAbsolute sports.yahoo.com URL of the entity's page (e.g., "https://sports.yahoo.com/ncaaf/players/464024/").
alias_navigation_linkscharacterJSON-encoded map of navigation links (scores, standings, teams) hanging off the entity's Yahoo alias.
current_weekintegerWeek number within the league's current season phase, counting from 1.
gamescharacterGames played.

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

Example​

yahoo_league_game_ids()

Last validated n/a.

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_shortcharacterShort league label used in navigation and compact UI (e.g., "NCAA FB").
full_namecharacterPlayer's full name.
namecharacterDisplay name.
current_weekintegerWeek number within the league's current season phase, counting from 1.
current_game_season_phasecharacterSeason phase of the games the league feed is currently serving.
current_league_seasoncharacterYahoo league-season identifier for the season currently in progress.
gamescharacterGames played.

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

Example​

yahoo_league_game_ids_by_date()

Last validated n/a.

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.

Example​

yahoo_league_games_by_round()

Last validated n/a.

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_shortcharacterShort league label used in navigation and compact UI (e.g., "NCAA FB").
namecharacterDisplay name.
full_namecharacterPlayer's full name.
short_namecharacterShort display name.

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

Example​

yahoo_league_info()

Last validated n/a.

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_idcharacterUnique team identifier.
nicknamecharacterTeam or athlete nickname.
full_namecharacterPlayer's full name.
locationcharacterEither Home if the home team is playing in their home stadium, or Neutral if the game is being played at a neutral location. This still shows as Home for games between the Giants and Jets even though they share the same home stadium.
display_namecharacterDisplay name.
primary_colorcharacterPrimary team color (hex).
abbreviationcharacterShort abbreviation.
aliascharacterJSON-encoded Yahoo alias object for the entity, carrying the site URL, path and subpage routing used to build links to its page.
team_logo_whitecharacterJSON-encoded image node for the team's white knockout logo.
team_logocharacterTeam logo image URL.
playerscharacterNested list of per-player box scores.

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

Example​

yahoo_league_injuries()

Last validated n/a.

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_idintegerLeague identifier ('10' = WNBA).
short_namecharacterShort display name.
full_namecharacterPlayer's full name.
namecharacterDisplay name.
display_shortcharacterShort league label used in navigation and compact UI (e.g., "NCAA FB").
display_abbrcharacterCompact league abbreviation used in dense UI (e.g., "NCAAF").
current_seasonintegerSeason the league is currently playing, as the four-digit starting year.
league_seasonscharacterJSON-encoded list of the seasons for which Yahoo carries data for this league.
alias_urlcharacterAbsolute sports.yahoo.com URL of the entity's page (e.g., "https://sports.yahoo.com/ncaaf/players/464024/").
alias_pathcharacterSite-relative path portion of the entity's Yahoo alias (e.g., "/ncaaf/teams/tcu/").
alias_subpagescharacterJSON-encoded list of subpage aliases (roster, schedule, stats) available beneath the entity's Yahoo page.

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

Example​

yahoo_league_names()

Last validated n/a.

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.

Example​

yahoo_league_prop_odds()

Last validated n/a.

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_namecharacterSport name (e.g., Major League Baseball).
current_season_phasecharacterPhase of the season currently in effect (e.g., "season.phase.season", "season.phase.offseason").
current_league_seasoncharacterYahoo league-season identifier for the season currently in progress.
divisionscharacterJSON-encoded list of the league's division nodes, each carrying its member conferences and teams.
teamscharacterNested list of member-team membership spans.
conferencescharacterJSON-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.

Example​

yahoo_league_standings()

Last validated n/a.

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_idcharacterYahoo identifier of the sport the league belongs to.
sport_namecharacterSport name (e.g., Major League Baseball).
short_namecharacterShort display name.
full_namecharacterPlayer's full name.
namecharacterDisplay name.
football_statscharacterJSON-encoded football statistics block returned by the league stats query.

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

Example​

yahoo_league_stats_by_team()

Last validated n/a.

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_idcharacterYahoo identifier of the sport the league belongs to.
sport_namecharacterSport name (e.g., Major League Baseball).
short_namecharacterShort display name.
full_namecharacterPlayer's full name.
namecharacterDisplay name.
football_statscharacterJSON-encoded football statistics block returned by the league stats query.

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

Example​

yahoo_league_stats_individual()

Last validated n/a.

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.

Example​

yahoo_league_stats_overview()

Last validated n/a.

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_idcharacterYahoo identifier of the sport the league belongs to.
sport_namecharacterSport name (e.g., Major League Baseball).
short_namecharacterShort display name.
full_namecharacterPlayer's full name.
namecharacterDisplay name.
football_statscharacterJSON-encoded football statistics block returned by the league stats query.

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

Example​

yahoo_league_stats_weekly()

Last validated n/a.

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_namecharacterShort display name.
teamscharacterNested list of member-team membership spans.

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

Example​

yahoo_league_team_ids()

Last validated n/a.

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_namecharacterShort display name.
teamscharacterNested list of member-team membership spans.

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

Example​

yahoo_league_teams()

Last validated n/a.

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
namecharacterDisplay name.
short_namecharacterShort display name.
full_namecharacterPlayer's full name.
display_shortcharacterShort league label used in navigation and compact UI (e.g., "NCAA FB").
current_season_phasecharacterPhase of the season currently in effect (e.g., "season.phase.season", "season.phase.offseason").
current_weekintegerWeek number within the league's current season phase, counting from 1.
current_seasonintegerSeason the league is currently playing, as the four-digit starting year.
stats_seasoncharacterSeason the returned statistics cover, as a four-digit year.
sport_namecharacterSport name (e.g., Major League Baseball).
league_weekscharacterJSON-encoded list of the league's week nodes for the season.
alias_urlcharacterAbsolute sports.yahoo.com URL of the entity's page (e.g., "https://sports.yahoo.com/ncaaf/players/464024/").
alias_navigation_linkscharacterJSON-encoded map of navigation links (scores, standings, teams) hanging off the entity's Yahoo alias.
league_seasonscharacterJSON-encoded list of the seasons for which Yahoo carries data for this league.
bye_weekscharacterJSON-encoded list of the week numbers in which the team has no scheduled game.
divisionscharacterJSON-encoded list of the league's division nodes, each carrying its member conferences and teams.

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

Example​

yahoo_leagues_season_states()

Last validated n/a.