Skip to main content

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

yahoo_playbook_boxscore​

Yahoo shangrila persisted query playbookBoxscore -> tables: football_positions, football_stat_types, games

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

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

API ParameterPythonPatternRequiredNullableDescription
gameIdgame_idYgameId query parameter.
standingsSeasonPhasesstandings_season_phasesYstandingsSeasonPhases query parameter.
imageHeightimage_heightYimageHeight query parameter.
imageWidthimage_widthYimageWidth query parameter.
isBaseballis_baseballYisBaseball query parameter.
isFootballis_footballYisFootball query parameter.
isProBasketballis_pro_basketballYisProBasketball query parameter.
isCollegeBasketballis_college_basketballYisCollegeBasketball query parameter.
isHockeyis_hockeyYisHockey query parameter.
isSocceris_soccerYisSoccer query parameter.
eventStateevent_stateYeventState query parameter.

Returns​

return_parsed=True (default) — A dict of polars/pandas DataFrames keyed by the payload's data collections (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

football_positions

col_nametypedescription
position_idString
nameString
abbreviationString

football_stat_types

col_nametypedescription
stat_idStringYahoo stat-type key the leader board is built on (e.g., "PASSING_YARDS", "GAMES_RUSHING").
abbreviationString
display_nameString
short_nameString
context_agnostic_abbreviationStringAbbreviation for the statistic that still reads correctly outside its category (e.g., "PassYds" where the in-category abbreviation is only "Yds").
sort_orderString

games

col_nametypedescription
game_idString
display_nameString
display_resultString
sport_nameString
league_nameString
league_full_nameStringFull league name (e.g., "NCAA Football").
league_display_shortStringShort league label used in navigation and compact UI (e.g., "NCAA FB").
league_short_nameString
league_sportStringSport the league belongs to (e.g., "football").
league_aliasStringJSON-encoded Yahoo alias object for the league, carrying its site URL and path.
alias_urlStringAbsolute sports.yahoo.com URL of the entity's page (e.g., "https://sports.yahoo.com/ncaaf/players/464024/").
special_event_typeStringMarker identifying a special framing for the game, such as a bowl game or neutral-site showcase.
away_team_idString
basic_away_team_abbreviationStringShort abbreviation for the away team used in compact displays, as carried on the boxscore's lightweight team node.
basic_away_team_display_nameStringDisplay name of the away team as shown on the scoreboard, as carried on the boxscore's lightweight team node.
basic_away_team_team_idStringYahoo composite team id of the away team (e.g., "ncaaf.t.29"), as carried on the boxscore's lightweight team node.
basic_away_team_team_logo_whiteStringJSON-encoded image node for the away team's white knockout logo, used on dark backgrounds, as carried on the boxscore's lightweight team node.
basic_away_team_team_logoStringJSON-encoded image node for the away team's standard logo, as carried on the boxscore's lightweight team node.
basic_away_team_playoff_seedsStringJSON-encoded list of the away team's playoff-seed entries for the season, as carried on the boxscore's lightweight team node.
basic_away_team_nicknameStringNickname or mascot of the away team, as carried on the boxscore's lightweight team node.
basic_away_team_primary_colorStringPrimary brand color of the away team, as a hex RGB string without the leading hash, as carried on the boxscore's lightweight team node.
basic_away_team_secondary_colorStringSecondary brand color of the away team, as a hex RGB string without the leading hash, as carried on the boxscore's lightweight team node.
away_team_full_nameString
away_team_team_idStringYahoo composite team id of the away team (e.g., "ncaaf.t.29").
away_team_primary_colorStringPrimary brand color of the away team, as a hex RGB string without the leading hash.
away_team_secondary_colorStringSecondary brand color of the away team, as a hex RGB string without the leading hash.
away_team_display_nameString
away_team_abbreviationString
away_team_locationString
away_team_aliasStringJSON-encoded Yahoo alias object for the away team, carrying its site URL and path.
away_team_nicknameString
away_team_last_gamesStringJSON-encoded list of the away team's most recently completed games.
away_team_team_logo_whiteStringJSON-encoded image node for the away team's white knockout logo, used on dark backgrounds.
away_team_team_logoStringJSON-encoded image node for the away team's standard logo.
away_team_team_logo_white_largeStringJSON-encoded image node for the large-format white knockout away-team logo.
away_team_team_logo_largeStringJSON-encoded image node for the large-format away-team logo.
away_team_team_standingsStringJSON-encoded standings node for the away team, carrying its record, position and streak.
away_team_gametime_ticket_urlStringGametime affiliate ticket-purchase URL for the away team's games.
away_team_injured_playersStringJSON-encoded list of away-team players currently carrying an injury designation.
away_team_rank_pollsStringJSON-encoded list of the poll rankings the away team currently holds.
away_team_playoff_seedsStringJSON-encoded list of the away team's playoff-seed entries for the season.
away_team_recordString
home_team_idString
basic_home_team_abbreviationStringShort abbreviation for the home team used in compact displays, as carried on the boxscore's lightweight team node.
basic_home_team_display_nameStringDisplay name of the home team as shown on the scoreboard, as carried on the boxscore's lightweight team node.
basic_home_team_team_idStringYahoo composite team id of the home team (e.g., "ncaaf.t.29"), as carried on the boxscore's lightweight team node.
basic_home_team_team_logo_whiteStringJSON-encoded image node for the home team's white knockout logo, used on dark backgrounds, as carried on the boxscore's lightweight team node.
basic_home_team_team_logoStringJSON-encoded image node for the home team's standard logo, as carried on the boxscore's lightweight team node.
basic_home_team_playoff_seedsStringJSON-encoded list of the home team's playoff-seed entries for the season, as carried on the boxscore's lightweight team node.
basic_home_team_nicknameStringNickname or mascot of the home team, as carried on the boxscore's lightweight team node.
basic_home_team_primary_colorStringPrimary brand color of the home team, as a hex RGB string without the leading hash, as carried on the boxscore's lightweight team node.
basic_home_team_secondary_colorStringSecondary brand color of the home team, as a hex RGB string without the leading hash, as carried on the boxscore's lightweight team node.
home_team_full_nameString
home_team_team_idStringYahoo composite team id of the home team (e.g., "ncaaf.t.29").
home_team_primary_colorStringPrimary brand color of the home team, as a hex RGB string without the leading hash.
home_team_secondary_colorStringSecondary brand color of the home team, as a hex RGB string without the leading hash.
home_team_display_nameString
home_team_abbreviationString
home_team_locationString
home_team_aliasStringJSON-encoded Yahoo alias object for the home team, carrying its site URL and path.
home_team_nicknameString
home_team_last_gamesStringJSON-encoded list of the home team's most recently completed games.
home_team_team_logo_whiteStringJSON-encoded image node for the home team's white knockout logo, used on dark backgrounds.
home_team_team_logoStringJSON-encoded image node for the home team's standard logo.
home_team_team_logo_white_largeStringJSON-encoded image node for the large-format white knockout home-team logo.
home_team_team_logo_largeStringJSON-encoded image node for the large-format home-team logo.
home_team_team_standingsStringJSON-encoded standings node for the home team, carrying its record, position and streak.
home_team_gametime_ticket_urlStringGametime affiliate ticket-purchase URL for the home team's games.
home_team_injured_playersStringJSON-encoded list of home-team players currently carrying an injury designation.
home_team_rank_pollsStringJSON-encoded list of the poll rankings the home team currently holds.
home_team_playoff_seedsStringJSON-encoded list of the home team's playoff-seed entries for the season.
home_team_recordString
away_scoreInt64
home_scoreInt64
start_timeString
start_dateString
if_necessaryString
statusString
status_display_nameStringShort game or event status as shown on the scoreboard (e.g., "Final", "12:00 pm ET").
full_status_display_nameStringLong-form game status label including overtime and date context (e.g., "Final/OT").
seasonInt64
season_phaseStringPhase of the season the game falls in (e.g., "season.phase.season").
time_leftString
is_halftimeBooleanFlag indicating that the game is currently stopped at halftime.
tournament_idString
weekInt64
playoff_seriesStringJSON-encoded playoff-series node the game belongs to.
winning_team_idStringComposite Yahoo team id of the side that won the game (e.g., "ncaaf.t.29").
broadcast_channelsStringJSON-encoded list of the channels broadcasting the event.
news_break_subtextStringSecondary line of the news-break banner attached to the game.
news_break_titleStringHeadline of the news-break banner attached to the game.
news_break_urlStringURL of the article behind the game's news-break banner.
news_break_uuidStringYahoo content UUID of the article behind the game's news-break banner.
briefStringShort editorial blurb summarizing the game's state or result.
event_extended_display_nameStringLong-form event title used for marquee games, such as a bowl or rivalry name.
game_odds_summary_pregame_odds_displayStringPregame line formatted for display (e.g., "MICH -6.5").
game_odds_summary_favorite_idStringYahoo composite team id of the pregame betting favorite.
game_odds_summary_underdog_team_predicted_scoreStringProjected final score for the betting underdog implied by the pregame line.
game_odds_summary_favorite_team_predicted_scoreStringProjected final score for the betting favorite implied by the pregame line.
betsStringJSON-encoded list of the betting markets offered on the event (spread, moneyline and total).
partial_game_betsStringJSON-encoded list of in-game betting markets covering only part of the game, such as halves or quarters.
venue_display_nameStringName of the venue hosting the event.
venue_cityString
venue_cover_typeStringWhether the venue is open-air, domed or fitted with a retractable roof.
venue_stateString
venue_venue_idStringYahoo identifier of the venue hosting the event.
venue_countryStringCountry the venue is located in.
tv_coverageStringNetwork carrying the game, as a short broadcast abbreviation (e.g., "CBS", "ESPN").
weatherString
regular_season_series_series_scoreStringFormatted head-to-head record for the regular-season series between the two teams (e.g., "1-1").
regular_season_series_gamesStringJSON-encoded list of the games making up the regular-season series between the two teams.
regular_season_series_first_home_team_idStringYahoo team id of the side that hosted the first meeting of the regular-season series.
regular_season_series_first_home_team_winsStringWins recorded across the regular-season series by the side that hosted the first meeting.
regular_season_series_first_away_team_idStringYahoo team id of the side that visited in the first meeting of the regular-season series.
regular_season_series_first_away_team_winsStringWins recorded across the regular-season series by the side that visited in the first meeting.
regular_season_series_winning_team_idStringYahoo team id of the side leading, or having won, the regular-season series.
game_win_probability_time_line_win_probability_timelineStringJSON-encoded series of win-probability observations across the course of the game.
current_period_short_display_nameStringAbbreviated label for the period in progress (e.g., "4th").
current_period_periodStringOrdinal number of the period currently in progress within the game.
current_period_display_nameStringFull label for the period in progress (e.g., "4th Quarter").
current_period_overtimeStringFlag indicating that the period in progress is an overtime period.
regulation_periodsString
away_team_lineupStringJSON-encoded starting lineup fielded by the away team.
home_team_lineupStringJSON-encoded starting lineup fielded by the home team.
game_ticket_priceStringLowest available ticket price for the game from the Gametime affiliate feed, in US dollars.
gametime_ticket_urlStringGametime affiliate ticket-purchase URL for the event or team.
game_coverageStringJSON-encoded node describing which live feeds Yahoo carries for the game.
downString
distanceString
field_positionStringBall spot expressed on Yahoo's 0-100 field scale, measured toward the offense's target goal line.
field_position_display_nameStringBall spot rendered the way a scoreboard shows it (e.g., "MICH 35").
home_timeouts_remainingInt64
away_timeouts_remainingInt64
timeouts_grantedInt64Number of timeouts granted so far in the current period.
team_possessing_ballStringYahoo team id of the side currently possessing the ball.
away_line_scoreStringJSON-encoded per-period scoring line for the away team.
home_line_scoreStringJSON-encoded per-period scoring line for the home team.
first_playStringJSON-encoded first play of the game or of the current period.
last_playString
recap_videosStringJSON-encoded list of recap videos published for the game.
play_by_playStringJSON-encoded data-island pointer to the game's play-by-play collection in the same editorial payload.
drivesStringJSON-encoded data-island pointer to the game's drive collection; football only.

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_playbook_boxscore()

yahoo_playbook_boxscore_poll​

Yahoo shangrila persisted query playbookBoxscorePoll -> tables: football_positions, football_stat_types, games

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

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

API ParameterPythonPatternRequiredNullableDescription
gameIdgame_idYgameId query parameter.
standingsSeasonPhasesstandings_season_phasesYstandingsSeasonPhases query parameter.
isBaseballis_baseballYisBaseball query parameter.
isFootballis_footballYisFootball query parameter.
isProBasketballis_pro_basketballYisProBasketball query parameter.
isCollegeBasketballis_college_basketballYisCollegeBasketball query parameter.
isHockeyis_hockeyYisHockey query parameter.
isSocceris_soccerYisSoccer query parameter.
eventStateevent_stateYeventState query parameter.

Returns​

return_parsed=True (default) — A dict of polars/pandas DataFrames keyed by the payload's data collections (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

football_positions

col_nametypedescription
position_idString
nameString
abbreviationString

football_stat_types

col_nametypedescription
stat_idStringYahoo stat-type key the leader board is built on (e.g., "PASSING_YARDS", "GAMES_RUSHING").
abbreviationString
display_nameString
short_nameString
context_agnostic_abbreviationStringAbbreviation for the statistic that still reads correctly outside its category (e.g., "PassYds" where the in-category abbreviation is only "Yds").
sort_orderString

games

col_nametypedescription
game_idString
display_nameString
seasonInt64
league_nameString
league_full_nameStringFull league name (e.g., "NCAA Football").
sport_nameString
alias_urlStringAbsolute sports.yahoo.com URL of the entity's page (e.g., "https://sports.yahoo.com/ncaaf/players/464024/").
away_scoreInt64
basic_away_team_abbreviationStringShort abbreviation for the away team used in compact displays, as carried on the boxscore's lightweight team node.
basic_away_team_display_nameStringDisplay name of the away team as shown on the scoreboard, as carried on the boxscore's lightweight team node.
basic_away_team_team_idStringYahoo composite team id of the away team (e.g., "ncaaf.t.29"), as carried on the boxscore's lightweight team node.
basic_away_team_team_logo_whiteStringJSON-encoded image node for the away team's white knockout logo, used on dark backgrounds, as carried on the boxscore's lightweight team node.
basic_away_team_team_logoStringJSON-encoded image node for the away team's standard logo, as carried on the boxscore's lightweight team node.
basic_away_team_playoff_seedsStringJSON-encoded list of the away team's playoff-seed entries for the season, as carried on the boxscore's lightweight team node.
basic_away_team_nicknameStringNickname or mascot of the away team, as carried on the boxscore's lightweight team node.
basic_away_team_primary_colorStringPrimary brand color of the away team, as a hex RGB string without the leading hash, as carried on the boxscore's lightweight team node.
basic_away_team_secondary_colorStringSecondary brand color of the away team, as a hex RGB string without the leading hash, as carried on the boxscore's lightweight team node.
away_team_full_nameString
away_team_team_idStringYahoo composite team id of the away team (e.g., "ncaaf.t.29").
away_team_primary_colorStringPrimary brand color of the away team, as a hex RGB string without the leading hash.
away_team_secondary_colorStringSecondary brand color of the away team, as a hex RGB string without the leading hash.
away_team_display_nameString
away_team_abbreviationString
away_team_locationString
away_team_aliasStringJSON-encoded Yahoo alias object for the away team, carrying its site URL and path.
away_team_nicknameString
away_team_team_logo_whiteStringJSON-encoded image node for the away team's white knockout logo, used on dark backgrounds.
away_team_team_logoStringJSON-encoded image node for the away team's standard logo.
away_team_team_logo_white_largeStringJSON-encoded image node for the large-format white knockout away-team logo.
away_team_team_logo_largeStringJSON-encoded image node for the large-format away-team logo.
away_team_team_standingsStringJSON-encoded standings node for the away team, carrying its record, position and streak.
away_team_rank_pollsStringJSON-encoded list of the poll rankings the away team currently holds.
away_team_playoff_seedsStringJSON-encoded list of the away team's playoff-seed entries for the season.
away_team_recordString
away_team_idString
betsStringJSON-encoded list of the betting markets offered on the event (spread, moneyline and total).
partial_game_betsStringJSON-encoded list of in-game betting markets covering only part of the game, such as halves or quarters.
briefStringShort editorial blurb summarizing the game's state or result.
broadcast_channelsStringJSON-encoded list of the channels broadcasting the event.
home_scoreInt64
home_team_full_nameString
home_team_team_idStringYahoo composite team id of the home team (e.g., "ncaaf.t.29").
home_team_primary_colorStringPrimary brand color of the home team, as a hex RGB string without the leading hash.
home_team_secondary_colorStringSecondary brand color of the home team, as a hex RGB string without the leading hash.
home_team_display_nameString
home_team_abbreviationString
home_team_locationString
home_team_aliasStringJSON-encoded Yahoo alias object for the home team, carrying its site URL and path.
home_team_nicknameString
home_team_team_logo_whiteStringJSON-encoded image node for the home team's white knockout logo, used on dark backgrounds.
home_team_team_logoStringJSON-encoded image node for the home team's standard logo.
home_team_team_logo_white_largeStringJSON-encoded image node for the large-format white knockout home-team logo.
home_team_team_logo_largeStringJSON-encoded image node for the large-format home-team logo.
home_team_team_standingsStringJSON-encoded standings node for the home team, carrying its record, position and streak.
home_team_rank_pollsStringJSON-encoded list of the poll rankings the home team currently holds.
home_team_playoff_seedsStringJSON-encoded list of the home team's playoff-seed entries for the season.
home_team_recordString
home_team_idString
basic_home_team_abbreviationStringShort abbreviation for the home team used in compact displays, as carried on the boxscore's lightweight team node.
basic_home_team_display_nameStringDisplay name of the home team as shown on the scoreboard, as carried on the boxscore's lightweight team node.
basic_home_team_team_idStringYahoo composite team id of the home team (e.g., "ncaaf.t.29"), as carried on the boxscore's lightweight team node.
basic_home_team_team_logo_whiteStringJSON-encoded image node for the home team's white knockout logo, used on dark backgrounds, as carried on the boxscore's lightweight team node.
basic_home_team_team_logoStringJSON-encoded image node for the home team's standard logo, as carried on the boxscore's lightweight team node.
basic_home_team_playoff_seedsStringJSON-encoded list of the home team's playoff-seed entries for the season, as carried on the boxscore's lightweight team node.
basic_home_team_nicknameStringNickname or mascot of the home team, as carried on the boxscore's lightweight team node.
basic_home_team_primary_colorStringPrimary brand color of the home team, as a hex RGB string without the leading hash, as carried on the boxscore's lightweight team node.
basic_home_team_secondary_colorStringSecondary brand color of the home team, as a hex RGB string without the leading hash, as carried on the boxscore's lightweight team node.
start_dateString
start_timeString
statusString
status_display_nameStringShort game or event status as shown on the scoreboard (e.g., "Final", "12:00 pm ET").
full_status_display_nameStringLong-form game status label including overtime and date context (e.g., "Final/OT").
time_leftString
venue_display_nameStringName of the venue hosting the event.
venue_cityString
venue_cover_typeStringWhether the venue is open-air, domed or fitted with a retractable roof.
venue_stateString
venue_venue_idStringYahoo identifier of the venue hosting the event.
venue_countryStringCountry the venue is located in.
weatherString
game_win_probability_time_line_win_probability_timelineStringJSON-encoded series of win-probability observations across the course of the game.
playoff_seriesStringJSON-encoded playoff-series node the game belongs to.
regular_season_series_gamesStringJSON-encoded list of the games making up the regular-season series between the two teams.
is_halftimeBooleanFlag indicating that the game is currently stopped at halftime.
regulation_periodsString
current_period_short_display_nameStringAbbreviated label for the period in progress (e.g., "4th").
current_period_periodStringOrdinal number of the period currently in progress within the game.
current_period_display_nameStringFull label for the period in progress (e.g., "4th Quarter").
current_period_overtimeStringFlag indicating that the period in progress is an overtime period.
away_team_lineupStringJSON-encoded starting lineup fielded by the away team.
home_team_lineupStringJSON-encoded starting lineup fielded by the home team.
winning_team_idStringComposite Yahoo team id of the side that won the game (e.g., "ncaaf.t.29").
game_coverageStringJSON-encoded node describing which live feeds Yahoo carries for the game.
away_line_scoreStringJSON-encoded per-period scoring line for the away team.
away_timeouts_remainingInt64
downString
distanceString
field_position_display_nameStringBall spot rendered the way a scoreboard shows it (e.g., "MICH 35").
field_positionStringBall spot expressed on Yahoo's 0-100 field scale, measured toward the offense's target goal line.
home_line_scoreStringJSON-encoded per-period scoring line for the home team.
home_timeouts_remainingInt64
team_possessing_ballStringYahoo team id of the side currently possessing the ball.
drivesStringJSON-encoded data-island pointer to the game's drive collection; football only.
first_playStringJSON-encoded first play of the game or of the current period.
play_by_playStringJSON-encoded data-island pointer to the game's play-by-play collection in the same editorial payload.
timeouts_grantedInt64Number of timeouts granted so far in the current period.

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_playbook_boxscore_poll()

yahoo_playbook_boxscore_social_share​

Yahoo shangrila persisted query playbookBoxscoreSocialShare -> one row per games entry

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

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

API ParameterPythonPatternRequiredNullableDescription
gameIdgame_idYgameId 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
game_idString
away_team_activeString
away_team_primary_colorStringPrimary brand color of the away team, as a hex RGB string without the leading hash.
away_team_secondary_colorStringSecondary brand color of the away team, as a hex RGB string without the leading hash.
away_team_team_logo_whiteStringJSON-encoded image node for the away team's white knockout logo, used on dark backgrounds.
away_team_team_logoStringJSON-encoded image node for the away team's standard logo.
home_team_activeString
home_team_primary_colorStringPrimary brand color of the home team, as a hex RGB string without the leading hash.
home_team_secondary_colorStringSecondary brand color of the home team, as a hex RGB string without the leading hash.
home_team_team_logo_whiteStringJSON-encoded image node for the home team's white knockout logo, used on dark backgrounds.
home_team_team_logoStringJSON-encoded image node for the home team's standard logo.
league_league_logoStringJSON-encoded image node for the league's logo.
start_timeString
start_dateString

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_playbook_boxscore_social_share()

yahoo_playbook_combat_match​

Yahoo shangrila persisted query playbookCombatMatch -> one row per games entry

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

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

API ParameterPythonPatternRequiredNullableDescription
gameIdgame_idYgameId query parameter.
imageHeightimage_heightYimageHeight query parameter.
imageWidthimage_widthYimageWidth query parameter.
headshotHeightheadshot_heightYheadshotHeight query parameter.
headshotWidthheadshot_widthYheadshotWidth 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_playbook_combat_match()

yahoo_playbook_game​

Yahoo shangrila persisted query playbookGame -> one row per games entry

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

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

API ParameterPythonPatternRequiredNullableDescription
gameIdgame_idYgameId query parameter.
imageHeightimage_heightYimageHeight query parameter.
imageWidthimage_widthYimageWidth 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
game_idString
display_nameString
league_nameString
league_full_nameStringFull league name (e.g., "NCAA Football").
league_display_shortStringShort league label used in navigation and compact UI (e.g., "NCAA FB").
league_short_nameString
league_sportStringSport the league belongs to (e.g., "football").
league_aliasStringJSON-encoded Yahoo alias object for the league, carrying its site URL and path.
alias_urlStringAbsolute sports.yahoo.com URL of the entity's page (e.g., "https://sports.yahoo.com/ncaaf/players/464024/").
away_team_idString
away_team_full_nameString
away_team_team_idStringYahoo composite team id of the away team (e.g., "ncaaf.t.29").
away_team_primary_colorStringPrimary brand color of the away team, as a hex RGB string without the leading hash.
away_team_secondary_colorStringSecondary brand color of the away team, as a hex RGB string without the leading hash.
away_team_display_nameString
away_team_abbreviationString
away_team_locationString
away_team_aliasStringJSON-encoded Yahoo alias object for the away team, carrying its site URL and path.
away_team_nicknameString
away_team_last_gamesStringJSON-encoded list of the away team's most recently completed games.
away_team_team_logo_whiteStringJSON-encoded image node for the away team's white knockout logo, used on dark backgrounds.
away_team_team_logoStringJSON-encoded image node for the away team's standard logo.
away_team_team_standingsStringJSON-encoded standings node for the away team, carrying its record, position and streak.
away_team_playersStringJSON-encoded roster of away-team players attached to the game.
away_team_rank_pollsStringJSON-encoded list of the poll rankings the away team currently holds.
away_team_playoff_seedsStringJSON-encoded list of the away team's playoff-seed entries for the season.
home_team_idString
home_team_full_nameString
home_team_team_idStringYahoo composite team id of the home team (e.g., "ncaaf.t.29").
home_team_primary_colorStringPrimary brand color of the home team, as a hex RGB string without the leading hash.
home_team_secondary_colorStringSecondary brand color of the home team, as a hex RGB string without the leading hash.
home_team_display_nameString
home_team_abbreviationString
home_team_locationString
home_team_aliasStringJSON-encoded Yahoo alias object for the home team, carrying its site URL and path.
home_team_nicknameString
home_team_last_gamesStringJSON-encoded list of the home team's most recently completed games.
home_team_team_logo_whiteStringJSON-encoded image node for the home team's white knockout logo, used on dark backgrounds.
home_team_team_logoStringJSON-encoded image node for the home team's standard logo.
home_team_team_standingsStringJSON-encoded standings node for the home team, carrying its record, position and streak.
home_team_playersStringJSON-encoded roster of home-team players attached to the game.
home_team_rank_pollsStringJSON-encoded list of the poll rankings the home team currently holds.
home_team_playoff_seedsStringJSON-encoded list of the home team's playoff-seed entries for the season.
away_scoreInt64
home_scoreInt64
start_timeString
start_dateString
if_necessaryString
statusString
status_display_nameStringShort game or event status as shown on the scoreboard (e.g., "Final", "12:00 pm ET").
seasonInt64
season_phaseStringPhase of the season the game falls in (e.g., "season.phase.season").
time_leftString
tournament_idString
playoff_seriesStringJSON-encoded playoff-series node the game belongs to.
winning_team_idStringComposite Yahoo team id of the side that won the game (e.g., "ncaaf.t.29").
broadcast_channelsStringJSON-encoded list of the channels broadcasting the event.
news_break_subtextStringSecondary line of the news-break banner attached to the game.
news_break_titleStringHeadline of the news-break banner attached to the game.
news_break_urlStringURL of the article behind the game's news-break banner.
news_break_uuidStringYahoo content UUID of the article behind the game's news-break banner.
briefStringShort editorial blurb summarizing the game's state or result.
betsStringJSON-encoded list of the betting markets offered on the event (spread, moneyline and total).
venue_display_nameStringName of the venue hosting the event.
venue_cityString
venue_cover_typeStringWhether the venue is open-air, domed or fitted with a retractable roof.
venue_stateString
venue_venue_idStringYahoo identifier of the venue hosting the event.
venue_countryStringCountry the venue is located in.
tv_coverageStringNetwork carrying the game, as a short broadcast abbreviation (e.g., "CBS", "ESPN").
weatherString
away_line_scoreStringJSON-encoded per-period scoring line for the away team.
current_period_periodStringOrdinal number of the period currently in progress within the game.
field_positionStringBall spot expressed on Yahoo's 0-100 field scale, measured toward the offense's target goal line.
field_position_display_nameStringBall spot rendered the way a scoreboard shows it (e.g., "MICH 35").
home_line_scoreStringJSON-encoded per-period scoring line for the home team.
home_timeouts_remainingInt64
away_timeouts_remainingInt64
last_playString
game_stat_leadersStringJSON-encoded pointer to the per-category statistical leaders for the game.
team_possessing_ballStringYahoo team id of the side currently possessing the ball.
recap_videosStringJSON-encoded list of recap videos published for the game.
weekInt64
play_by_playStringJSON-encoded data-island pointer to the game's play-by-play collection in the same editorial payload.

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_playbook_game()

yahoo_playbook_game_odds_poll​

Yahoo shangrila persisted query playbookGameOddsPoll -> one row per games entry

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

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

API ParameterPythonPatternRequiredNullableDescription
gameIdgame_idYgameId query parameter.
eventStateevent_stateYeventState 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
game_idString
betsStringJSON-encoded list of the betting markets offered on the event (spread, moneyline and total).
partial_game_betsStringJSON-encoded list of in-game betting markets covering only part of the game, such as halves or quarters.

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_playbook_game_odds_poll()

yahoo_playbook_golf_tournament​

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

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

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

API ParameterPythonPatternRequiredNullableDescription
gameIdgame_idYgameId query parameter.
seasonseasonYSeason year (e.g. 2024).
countcountYcount query parameter.
statIdsstat_idsYstatIds query parameter.
showHoleResultsshow_hole_resultsYshowHoleResults 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_playbook_golf_tournament()

yahoo_playbook_league_odds​

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

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

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

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYleague query parameter.
datesdatesYDate or date range filter (YYYYMMDD or YYYYMMDD-YYYYMMDD).
countcountYcount query parameter.
startTimeFilterstart_time_filterYstartTimeFilter query parameter.
rangeStartDaterange_start_dateYrangeStartDate query parameter.
rangeEndDaterange_end_dateYrangeEndDate 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
ncaaf_gamesStringJSON-encoded list of NCAAF game nodes carrying the pick or odds distribution for the slate.
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_playbook_league_odds()

yahoo_playbook_player​

Yahoo shangrila persisted query playbookPlayer -> one row per players entry

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

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

API ParameterPythonPatternRequiredNullableDescription
playerIdplayer_idYplayerId query parameter.
seasonPhasesseason_phasesYseasonPhases 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
player_idString
alias_urlStringAbsolute sports.yahoo.com URL of the entity's page (e.g., "https://sports.yahoo.com/ncaaf/players/464024/").
alias_subpagesStringJSON-encoded list of subpage aliases (roster, schedule, stats) available beneath the entity's Yahoo page.
sport_nameString
first_nameString
last_nameString
display_nameString
collegeString
birth_stateString
birth_cityString
birth_countryString
birth_dateString
heightInt64
display_heightString
weightInt64
statusString
activeBoolean
suggested_headshotStringJSON-encoded image node for the headshot Yahoo recommends for this player.
uniform_numberStringJersey number the player wears for the team.
positionsString
team_idString
team_team_idString
team_display_nameString
team_full_nameString
team_aliasStringJSON-encoded alias object for the entity's team, carrying its Yahoo page URL and path.
team_team_logoStringJSON-encoded image node for the team's standard logo.
team_team_logo_whiteStringJSON-encoded image node for the team's white knockout logo.
team_primary_colorStringPrimary brand color of the entity's team, as a hex RGB string without the leading hash.
team_secondary_colorStringSecondary brand color of the entity's team, as a hex RGB string without the leading hash.
draft_positionStringRound and pick at which the player was drafted, left null for undrafted players.
player_seasonsStringJSON-encoded list of the seasons for which Yahoo carries data on this player.
header_stats_passingStringJSON-encoded headline passing statistics shown at the top of the player's page.
season_stats_passingStringJSON-encoded full-season passing statistics for the player.
header_stats_rushingStringJSON-encoded headline rushing statistics shown at the top of the player's page.
season_stats_rushingStringJSON-encoded full-season rushing statistics for the player.
header_stats_receivingStringJSON-encoded headline receiving statistics shown at the top of the player's page.
season_stats_receivingStringJSON-encoded full-season receiving statistics for the player.
header_stats_defenseStringJSON-encoded headline defensive statistics shown at the top of the player's page.
season_stats_defenseStringJSON-encoded full-season defensive statistics for the player.
header_stats_kickingStringJSON-encoded headline kicking statistics shown at the top of the player's page.
season_stats_kickingStringJSON-encoded full-season kicking statistics for the player.
header_stats_puntingStringJSON-encoded headline punting statistics shown at the top of the player's page.
season_stats_puntingStringJSON-encoded full-season punting statistics for the player.
earningsStringPrize money the player has earned over the covered period, in US dollars.
first_yearStringFirst season in which the player appeared in this league.
last_yearInt64Most recent season in which the player appeared in this league.
injuryString

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_playbook_player()

yahoo_playbook_player_social_share​

Yahoo shangrila persisted query playbookPlayerSocialShare -> one row per players entry

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

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

API ParameterPythonPatternRequiredNullableDescription
playerIdplayer_idYplayerId 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
short_display_nameString
suggested_headshotStringJSON-encoded image node for the headshot Yahoo recommends for this player.
team_primary_colorStringPrimary brand color of the entity's team, as a hex RGB string without the leading hash.
team_secondary_colorStringSecondary brand color of the entity's team, as a hex RGB string without the leading hash.
team_leagueStringJSON-encoded league node for the entity's team.

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_playbook_player_social_share()

yahoo_playbook_race​

Yahoo shangrila persisted query playbookRace -> one row per games entry

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

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

API ParameterPythonPatternRequiredNullableDescription
gameIdgame_idYgameId query parameter.
playerImageHeightplayer_image_heightYplayerImageHeight query parameter.
playerImageWidthplayer_image_widthYplayerImageWidth 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_playbook_race()

yahoo_playbook_team​

Yahoo shangrila persisted query playbookTeam -> tables: teams, leagues

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

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

API ParameterPythonPatternRequiredNullableDescription
teamIdteam_idYteamId query parameter.
imageHeightimage_heightYimageHeight query parameter.
imageWidthimage_widthYimageWidth query parameter.
leagueShortNameleague_short_nameYleagueShortName query parameter.
disableConferencedisable_conferenceYdisableConference query parameter.
disableDivisiondisable_divisionYdisableDivision query parameter.

Returns​

return_parsed=True (default) — A dict of polars/pandas DataFrames keyed by the payload's data collections (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

teams

col_nametypedescription
sport_sport_idStringYahoo identifier of the sport the league belongs to.
sport_nameString
league_nameString
league_short_nameString
league_current_season_phaseStringPhase the league's season is currently in (e.g., "season.phase.season").
team_idString
conference_idInt64
full_nameString
display_nameString
locationString
nicknameString
primary_colorString
secondary_colorString
team_logo_white_urlStringAbsolute URL of the team's white knockout logo, the variant used on dark backgrounds.
team_logo_urlStringAbsolute URL of the team's standard logo image on Yahoo's image CDN.
alias_navigation_linksStringJSON-encoded map of navigation links (scores, standings, teams) hanging off the entity's Yahoo alias.
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/").
last_gamesStringJSON-encoded list of the team's most recently completed games, used for form and streak displays.
next_gamesStringJSON-encoded list of the team's next scheduled games.
division_nameString
division_teamsStringJSON-encoded list of the teams that make up the division.
conference_short_nameString
conference_nameString
conference_conference_idStringYahoo numeric identifier of the conference carried on the team's conference node.
conference_team_standingsStringJSON-encoded standings rows for every team in the conference.
conference_abbreviationString
team_standings_teamStringJSON-encoded team node the standings row describes.
team_standings_conference_idStringYahoo numeric conference id for the team's standings row.
team_standings_conferenceStringJSON-encoded conference node the standings row sits under.
team_standings_display_nameStringDisplay name of the team on its standings row.
team_standings_full_nameStringFull name of the team on its standings row.
team_standings_positionStringRank of the team within the standings grouping it is listed in.
team_standings_sequenceStringTie-break ordering value Yahoo uses to sequence teams holding identical records.
team_standings_team_recordStringFormatted overall record for the team (e.g., "8-2").
team_standings_conference_positionStringRank of the team within its conference standings.
team_standings_points_forStringPoints the team has scored over the standings period.
team_standings_points_againstStringPoints the team has allowed over the standings period.
team_standings_clinched_playoffStringFlag indicating that the team has clinched a playoff berth.
team_standings_clinched_divisionStringFlag indicating that the team has clinched its division.
team_standings_streak_displayStringFormatted current streak for the team (e.g., "W3", "L2").
gametime_ticket_urlStringGametime affiliate ticket-purchase URL for the event or team.
football_team_season_statsStringJSON-encoded team-level season statistics for the team's football side.
football_player_season_statsStringJSON-encoded per-player season statistics for the team's football roster.
injured_playersStringJSON-encoded list of the team's players currently carrying an injury designation.
transactionsStringJSON-encoded list of the team's roster transactions over the requested window.

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_playbook_team()

yahoo_playbook_team_basic​

Yahoo shangrila persisted query playbookTeamBasic -> one row per teams entry

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

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

API ParameterPythonPatternRequiredNullableDescription
teamIdteam_idYteamId query parameter.
imageHeightimage_heightYimageHeight query parameter.
imageWidthimage_widthYimageWidth 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
league_nameString
league_short_nameString
league_current_season_phaseStringPhase the league's season is currently in (e.g., "season.phase.season").
team_idString
conference_idInt64
full_nameString
display_nameString
locationString
nicknameString
primary_colorString
secondary_colorString
team_logo_white_urlStringAbsolute URL of the team's white knockout logo, the variant used on dark backgrounds.
team_logo_urlStringAbsolute URL of the team's standard logo image on Yahoo's image CDN.
alias_navigation_linksStringJSON-encoded map of navigation links (scores, standings, teams) hanging off the entity's Yahoo alias.
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/").
last_gamesStringJSON-encoded list of the team's most recently completed games, used for form and streak displays.
next_gamesStringJSON-encoded list of the team's next scheduled games.
division_nameString
conference_short_nameString
conference_nameString
conference_conference_idStringYahoo numeric identifier of the conference carried on the team's conference node.
conference_abbreviationString
team_standings_teamStringJSON-encoded team node the standings row describes.
team_standings_conference_idStringYahoo numeric conference id for the team's standings row.
team_standings_conferenceStringJSON-encoded conference node the standings row sits under.
team_standings_display_nameStringDisplay name of the team on its standings row.
team_standings_full_nameStringFull name of the team on its standings row.
team_standings_positionStringRank of the team within the standings grouping it is listed in.
team_standings_sequenceStringTie-break ordering value Yahoo uses to sequence teams holding identical records.
team_standings_team_recordStringFormatted overall record for the team (e.g., "8-2").
team_standings_conference_positionStringRank of the team within its conference standings.
team_standings_points_forStringPoints the team has scored over the standings period.
team_standings_points_againstStringPoints the team has allowed over the standings period.
team_standings_clinched_playoffStringFlag indicating that the team has clinched a playoff berth.
team_standings_clinched_divisionStringFlag indicating that the team has clinched its division.
team_standings_streak_displayStringFormatted current streak for the team (e.g., "W3", "L2").

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_playbook_team_basic()

yahoo_playbook_team_social_share​

Yahoo shangrila persisted query playbookTeamSocialShare -> one row per teams entry

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

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

API ParameterPythonPatternRequiredNullableDescription
teamIdteam_idYteamId 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
team_idString
primary_colorString
team_logo_urlStringAbsolute URL of the team's standard logo image on Yahoo's image CDN.
team_logo_white_urlStringAbsolute URL of the team's white knockout logo, the variant used on dark backgrounds.

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_playbook_team_social_share()

yahoo_playbook_tennis_match​

Yahoo shangrila persisted query playbookTennisMatch -> one row per events entry

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

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

API ParameterPythonPatternRequiredNullableDescription
gameIdgame_idYgameId 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_playbook_tennis_match()