YAHOO — Yahoo Sports Shangrila (graphite-secure.sports.yahoo.com) — Playbook: boxscore–team
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
gameId | game_id | Y | gameId query parameter. | ||
standingsSeasonPhases | standings_season_phases | Y | standingsSeasonPhases query parameter. | ||
imageHeight | image_height | Y | imageHeight query parameter. | ||
imageWidth | image_width | Y | imageWidth query parameter. | ||
isBaseball | is_baseball | Y | isBaseball query parameter. | ||
isFootball | is_football | Y | isFootball query parameter. | ||
isProBasketball | is_pro_basketball | Y | isProBasketball query parameter. | ||
isCollegeBasketball | is_college_basketball | Y | isCollegeBasketball query parameter. | ||
isHockey | is_hockey | Y | isHockey query parameter. | ||
isSoccer | is_soccer | Y | isSoccer query parameter. | ||
eventState | event_state | Y | eventState query parameter. |
Returns
return_parsed=True (default) — A dict of polars/pandas DataFrames keyed by the payload's data collections (representative columns below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).
football_positions
| col_name | type | description |
|---|---|---|
position_id | character | Unique position identifier. |
name | character | Display name. |
abbreviation | character | Short abbreviation. |
football_stat_types
| col_name | type | description |
|---|---|---|
stat_id | character | Yahoo stat-type key the leader board is built on (e.g., "PASSING_YARDS", "GAMES_RUSHING"). |
abbreviation | character | Short abbreviation. |
display_name | character | Display name. |
short_name | character | Short display name. |
context_agnostic_abbreviation | character | Abbreviation for the statistic that still reads correctly outside its category (e.g., "PassYds" where the in-category abbreviation is only "Yds"). |
sort_order | character | Display sort order for the sport. |
games
| col_name | type | description |
|---|---|---|
game_id | character | Unique game identifier. |
display_name | character | Display name. |
display_result | character | Drive-result label (e.g. Punt, Touchdown). |
sport_name | character | Sport name (e.g., Major League Baseball). |
league_name | character | League name. |
league_full_name | character | Full league name (e.g., "NCAA Football"). |
league_display_short | character | Short league label used in navigation and compact UI (e.g., "NCAA FB"). |
league_short_name | character | League short name. |
league_sport | character | Sport the league belongs to (e.g., "football"). |
league_alias | character | JSON-encoded Yahoo alias object for the league, carrying its site URL and path. |
alias_url | character | Absolute sports.yahoo.com URL of the entity's page (e.g., "https://sports.yahoo.com/ncaaf/players/464024/"). |
special_event_type | character | Marker identifying a special framing for the game, such as a bowl game or neutral-site showcase. |
away_team_id | character | Unique identifier for the away team. |
basic_away_team_abbreviation | character | Short abbreviation for the away team used in compact displays, as carried on the boxscore's lightweight team node. |
basic_away_team_display_name | character | Display name of the away team as shown on the scoreboard, as carried on the boxscore's lightweight team node. |
basic_away_team_team_id | character | Yahoo 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_white | character | JSON-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_logo | character | JSON-encoded image node for the away team's standard logo, as carried on the boxscore's lightweight team node. |
basic_away_team_playoff_seeds | character | JSON-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_nickname | character | Nickname or mascot of the away team, as carried on the boxscore's lightweight team node. |
basic_away_team_primary_color | character | Primary 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_color | character | Secondary 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_name | character | Full away team name (e.g. 'Las Vegas Aces'). |
away_team_team_id | character | Yahoo composite team id of the away team (e.g., "ncaaf.t.29"). |
away_team_primary_color | character | Primary brand color of the away team, as a hex RGB string without the leading hash. |
away_team_secondary_color | character | Secondary brand color of the away team, as a hex RGB string without the leading hash. |
away_team_display_name | character | Away team full display name; team_detail = TRUE only. |
away_team_abbreviation | character | Away team abbreviation; team_detail = TRUE only. |
away_team_location | character | Away team's team location. |
away_team_alias | character | JSON-encoded Yahoo alias object for the away team, carrying its site URL and path. |
away_team_nickname | character | Away team nickname label; team_detail = TRUE only. |
away_team_last_games | character | JSON-encoded list of the away team's most recently completed games. |
away_team_team_logo_white | character | JSON-encoded image node for the away team's white knockout logo, used on dark backgrounds. |
away_team_team_logo | character | JSON-encoded image node for the away team's standard logo. |
away_team_team_logo_white_large | character | JSON-encoded image node for the large-format white knockout away-team logo. |
away_team_team_logo_large | character | JSON-encoded image node for the large-format away-team logo. |
away_team_team_standings | character | JSON-encoded standings node for the away team, carrying its record, position and streak. |
away_team_gametime_ticket_url | character | Gametime affiliate ticket-purchase URL for the away team's games. |
away_team_injured_players | character | JSON-encoded list of away-team players currently carrying an injury designation. |
away_team_rank_polls | character | JSON-encoded list of the poll rankings the away team currently holds. |
away_team_playoff_seeds | character | JSON-encoded list of the away team's playoff-seed entries for the season. |
away_team_record | character | Away team's win-loss record. |
home_team_id | character | Unique identifier for the home team. |
basic_home_team_abbreviation | character | Short abbreviation for the home team used in compact displays, as carried on the boxscore's lightweight team node. |
basic_home_team_display_name | character | Display name of the home team as shown on the scoreboard, as carried on the boxscore's lightweight team node. |
basic_home_team_team_id | character | Yahoo 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_white | character | JSON-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_logo | character | JSON-encoded image node for the home team's standard logo, as carried on the boxscore's lightweight team node. |
basic_home_team_playoff_seeds | character | JSON-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_nickname | character | Nickname or mascot of the home team, as carried on the boxscore's lightweight team node. |
basic_home_team_primary_color | character | Primary 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_color | character | Secondary 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_name | character | Full home team name (e.g. 'Las Vegas Aces'). |
home_team_team_id | character | Yahoo composite team id of the home team (e.g., "ncaaf.t.29"). |
home_team_primary_color | character | Primary brand color of the home team, as a hex RGB string without the leading hash. |
home_team_secondary_color | character | Secondary brand color of the home team, as a hex RGB string without the leading hash. |
home_team_display_name | character | Home team full display name; team_detail = TRUE only. |
home_team_abbreviation | character | Home team abbreviation; team_detail = TRUE only. |
home_team_location | character | Home team's team location. |
home_team_alias | character | JSON-encoded Yahoo alias object for the home team, carrying its site URL and path. |
home_team_nickname | character | Home team nickname label; team_detail = TRUE only. |
home_team_last_games | character | JSON-encoded list of the home team's most recently completed games. |
home_team_team_logo_white | character | JSON-encoded image node for the home team's white knockout logo, used on dark backgrounds. |
home_team_team_logo | character | JSON-encoded image node for the home team's standard logo. |
home_team_team_logo_white_large | character | JSON-encoded image node for the large-format white knockout home-team logo. |
home_team_team_logo_large | character | JSON-encoded image node for the large-format home-team logo. |
home_team_team_standings | character | JSON-encoded standings node for the home team, carrying its record, position and streak. |
home_team_gametime_ticket_url | character | Gametime affiliate ticket-purchase URL for the home team's games. |
home_team_injured_players | character | JSON-encoded list of home-team players currently carrying an injury designation. |
home_team_rank_polls | character | JSON-encoded list of the poll rankings the home team currently holds. |
home_team_playoff_seeds | character | JSON-encoded list of the home team's playoff-seed entries for the season. |
home_team_record | character | Home team's win-loss record. |
away_score | integer | Away team score at the time of the play. |
home_score | integer | Home team score at the time of the play. |
start_time | character | Kickoff time in eastern time zone. |
start_date | character | Start date (YYYY-MM-DD). |
if_necessary | character | If necessary. |
status | character | Status label. |
status_display_name | character | Short game or event status as shown on the scoreboard (e.g., "Final", "12:00 pm ET"). |
full_status_display_name | character | Long-form game status label including overtime and date context (e.g., "Final/OT"). |
season | integer | Season year. |
season_phase | character | Phase of the season the game falls in (e.g., "season.phase.season"). |
time_left | character | Time left. |
is_halftime | logical | Flag indicating that the game is currently stopped at halftime. |
tournament_id | character | ESPN tournament identifier. |
week | integer | Week number. |
playoff_series | character | JSON-encoded playoff-series node the game belongs to. |
winning_team_id | character | Composite Yahoo team id of the side that won the game (e.g., "ncaaf.t.29"). |
broadcast_channels | character | JSON-encoded list of the channels broadcasting the event. |
news_break_subtext | character | Secondary line of the news-break banner attached to the game. |
news_break_title | character | Headline of the news-break banner attached to the game. |
news_break_url | character | URL of the article behind the game's news-break banner. |
news_break_uuid | character | Yahoo content UUID of the article behind the game's news-break banner. |
brief | character | Short editorial blurb summarizing the game's state or result. |
event_extended_display_name | character | Long-form event title used for marquee games, such as a bowl or rivalry name. |
game_odds_summary_pregame_odds_display | character | Pregame line formatted for display (e.g., "MICH -6.5"). |
game_odds_summary_favorite_id | character | Yahoo composite team id of the pregame betting favorite. |
game_odds_summary_underdog_team_predicted_score | character | Projected final score for the betting underdog implied by the pregame line. |
game_odds_summary_favorite_team_predicted_score | character | Projected final score for the betting favorite implied by the pregame line. |
bets | character | JSON-encoded list of the betting markets offered on the event (spread, moneyline and total). |
partial_game_bets | character | JSON-encoded list of in-game betting markets covering only part of the game, such as halves or quarters. |
venue_display_name | character | Name of the venue hosting the event. |
venue_city | character | Venue city. |
venue_cover_type | character | Whether the venue is open-air, domed or fitted with a retractable roof. |
venue_state | character | Venue state / region. |
venue_venue_id | character | Yahoo identifier of the venue hosting the event. |
venue_country | character | Country the venue is located in. |
tv_coverage | character | Network carrying the game, as a short broadcast abbreviation (e.g., "CBS", "ESPN"). |
weather | character | String describing the weather including temperature, humidity and wind (direction and speed). Doesn't change during the game! |
regular_season_series_series_score | character | Formatted head-to-head record for the regular-season series between the two teams (e.g., "1-1"). |
regular_season_series_games | character | JSON-encoded list of the games making up the regular-season series between the two teams. |
regular_season_series_first_home_team_id | character | Yahoo team id of the side that hosted the first meeting of the regular-season series. |
regular_season_series_first_home_team_wins | character | Wins recorded across the regular-season series by the side that hosted the first meeting. |
regular_season_series_first_away_team_id | character | Yahoo team id of the side that visited in the first meeting of the regular-season series. |
regular_season_series_first_away_team_wins | character | Wins recorded across the regular-season series by the side that visited in the first meeting. |
regular_season_series_winning_team_id | character | Yahoo team id of the side leading, or having won, the regular-season series. |
game_win_probability_time_line_win_probability_timeline | character | JSON-encoded series of win-probability observations across the course of the game. |
current_period_short_display_name | character | Abbreviated label for the period in progress (e.g., "4th"). |
current_period_period | character | Ordinal number of the period currently in progress within the game. |
current_period_display_name | character | Full label for the period in progress (e.g., "4th Quarter"). |
current_period_overtime | character | Flag indicating that the period in progress is an overtime period. |
regulation_periods | character | Regulation periods. |
away_team_lineup | character | JSON-encoded starting lineup fielded by the away team. |
home_team_lineup | character | JSON-encoded starting lineup fielded by the home team. |
game_ticket_price | character | Lowest available ticket price for the game from the Gametime affiliate feed, in US dollars. |
gametime_ticket_url | character | Gametime affiliate ticket-purchase URL for the event or team. |
game_coverage | character | JSON-encoded node describing which live feeds Yahoo carries for the game. |
down | character | The down for the given play. |
distance | character | Distance value (in feet for shot data; otherwise context-dependent). |
field_position | character | Ball spot expressed on Yahoo's 0-100 field scale, measured toward the offense's target goal line. |
field_position_display_name | character | Ball spot rendered the way a scoreboard shows it (e.g., "MICH 35"). |
home_timeouts_remaining | integer | Numeric timeouts remaining in the half for the home team. |
away_timeouts_remaining | integer | Numeric timeouts remaining in the half for the away team. |
timeouts_granted | integer | Number of timeouts granted so far in the current period. |
team_possessing_ball | character | Yahoo team id of the side currently possessing the ball. |
away_line_score | character | JSON-encoded per-period scoring line for the away team. |
home_line_score | character | JSON-encoded per-period scoring line for the home team. |
first_play | character | JSON-encoded first play of the game or of the current period. |
last_play | character | Free-text description of the most recent play. |
recap_videos | character | JSON-encoded list of recap videos published for the game. |
play_by_play | character | JSON-encoded data-island pointer to the game's play-by-play collection in the same editorial payload. |
drives | character | JSON-encoded data-island pointer to the game's drive collection; football only. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
yahoo_playbook_boxscore()
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
gameId | game_id | Y | gameId query parameter. | ||
standingsSeasonPhases | standings_season_phases | Y | standingsSeasonPhases query parameter. | ||
isBaseball | is_baseball | Y | isBaseball query parameter. | ||
isFootball | is_football | Y | isFootball query parameter. | ||
isProBasketball | is_pro_basketball | Y | isProBasketball query parameter. | ||
isCollegeBasketball | is_college_basketball | Y | isCollegeBasketball query parameter. | ||
isHockey | is_hockey | Y | isHockey query parameter. | ||
isSoccer | is_soccer | Y | isSoccer query parameter. | ||
eventState | event_state | Y | eventState query parameter. |
Returns
return_parsed=True (default) — A dict of polars/pandas DataFrames keyed by the payload's data collections (representative columns below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).
football_positions
| col_name | type | description |
|---|---|---|
position_id | character | Unique position identifier. |
name | character | Display name. |
abbreviation | character | Short abbreviation. |
football_stat_types
| col_name | type | description |
|---|---|---|
stat_id | character | Yahoo stat-type key the leader board is built on (e.g., "PASSING_YARDS", "GAMES_RUSHING"). |
abbreviation | character | Short abbreviation. |
display_name | character | Display name. |
short_name | character | Short display name. |
context_agnostic_abbreviation | character | Abbreviation for the statistic that still reads correctly outside its category (e.g., "PassYds" where the in-category abbreviation is only "Yds"). |
sort_order | character | Display sort order for the sport. |
games
| col_name | type | description |
|---|---|---|
game_id | character | Unique game identifier. |
display_name | character | Display name. |
season | integer | Season year. |
league_name | character | League name. |
league_full_name | character | Full league name (e.g., "NCAA Football"). |
sport_name | character | Sport name (e.g., Major League Baseball). |
alias_url | character | Absolute sports.yahoo.com URL of the entity's page (e.g., "https://sports.yahoo.com/ncaaf/players/464024/"). |
away_score | integer | Away team score at the time of the play. |
basic_away_team_abbreviation | character | Short abbreviation for the away team used in compact displays, as carried on the boxscore's lightweight team node. |
basic_away_team_display_name | character | Display name of the away team as shown on the scoreboard, as carried on the boxscore's lightweight team node. |
basic_away_team_team_id | character | Yahoo 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_white | character | JSON-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_logo | character | JSON-encoded image node for the away team's standard logo, as carried on the boxscore's lightweight team node. |
basic_away_team_playoff_seeds | character | JSON-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_nickname | character | Nickname or mascot of the away team, as carried on the boxscore's lightweight team node. |
basic_away_team_primary_color | character | Primary 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_color | character | Secondary 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_name | character | Full away team name (e.g. 'Las Vegas Aces'). |
away_team_team_id | character | Yahoo composite team id of the away team (e.g., "ncaaf.t.29"). |
away_team_primary_color | character | Primary brand color of the away team, as a hex RGB string without the leading hash. |
away_team_secondary_color | character | Secondary brand color of the away team, as a hex RGB string without the leading hash. |
away_team_display_name | character | Away team full display name; team_detail = TRUE only. |
away_team_abbreviation | character | Away team abbreviation; team_detail = TRUE only. |
away_team_location | character | Away team's team location. |
away_team_alias | character | JSON-encoded Yahoo alias object for the away team, carrying its site URL and path. |
away_team_nickname | character | Away team nickname label; team_detail = TRUE only. |
away_team_team_logo_white | character | JSON-encoded image node for the away team's white knockout logo, used on dark backgrounds. |
away_team_team_logo | character | JSON-encoded image node for the away team's standard logo. |
away_team_team_logo_white_large | character | JSON-encoded image node for the large-format white knockout away-team logo. |
away_team_team_logo_large | character | JSON-encoded image node for the large-format away-team logo. |
away_team_team_standings | character | JSON-encoded standings node for the away team, carrying its record, position and streak. |
away_team_rank_polls | character | JSON-encoded list of the poll rankings the away team currently holds. |
away_team_playoff_seeds | character | JSON-encoded list of the away team's playoff-seed entries for the season. |
away_team_record | character | Away team's win-loss record. |
away_team_id | character | Unique identifier for the away team. |
bets | character | JSON-encoded list of the betting markets offered on the event (spread, moneyline and total). |
partial_game_bets | character | JSON-encoded list of in-game betting markets covering only part of the game, such as halves or quarters. |
brief | character | Short editorial blurb summarizing the game's state or result. |
broadcast_channels | character | JSON-encoded list of the channels broadcasting the event. |
home_score | integer | Home team score at the time of the play. |
home_team_full_name | character | Full home team name (e.g. 'Las Vegas Aces'). |
home_team_team_id | character | Yahoo composite team id of the home team (e.g., "ncaaf.t.29"). |
home_team_primary_color | character | Primary brand color of the home team, as a hex RGB string without the leading hash. |
home_team_secondary_color | character | Secondary brand color of the home team, as a hex RGB string without the leading hash. |
home_team_display_name | character | Home team full display name; team_detail = TRUE only. |
home_team_abbreviation | character | Home team abbreviation; team_detail = TRUE only. |
home_team_location | character | Home team's team location. |
home_team_alias | character | JSON-encoded Yahoo alias object for the home team, carrying its site URL and path. |
home_team_nickname | character | Home team nickname label; team_detail = TRUE only. |
home_team_team_logo_white | character | JSON-encoded image node for the home team's white knockout logo, used on dark backgrounds. |
home_team_team_logo | character | JSON-encoded image node for the home team's standard logo. |
home_team_team_logo_white_large | character | JSON-encoded image node for the large-format white knockout home-team logo. |
home_team_team_logo_large | character | JSON-encoded image node for the large-format home-team logo. |
home_team_team_standings | character | JSON-encoded standings node for the home team, carrying its record, position and streak. |
home_team_rank_polls | character | JSON-encoded list of the poll rankings the home team currently holds. |
home_team_playoff_seeds | character | JSON-encoded list of the home team's playoff-seed entries for the season. |
home_team_record | character | Home team's win-loss record. |
home_team_id | character | Unique identifier for the home team. |
basic_home_team_abbreviation | character | Short abbreviation for the home team used in compact displays, as carried on the boxscore's lightweight team node. |
basic_home_team_display_name | character | Display name of the home team as shown on the scoreboard, as carried on the boxscore's lightweight team node. |
basic_home_team_team_id | character | Yahoo 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_white | character | JSON-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_logo | character | JSON-encoded image node for the home team's standard logo, as carried on the boxscore's lightweight team node. |
basic_home_team_playoff_seeds | character | JSON-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_nickname | character | Nickname or mascot of the home team, as carried on the boxscore's lightweight team node. |
basic_home_team_primary_color | character | Primary 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_color | character | Secondary 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_date | character | Start date (YYYY-MM-DD). |
start_time | character | Kickoff time in eastern time zone. |
status | character | Status label. |
status_display_name | character | Short game or event status as shown on the scoreboard (e.g., "Final", "12:00 pm ET"). |
full_status_display_name | character | Long-form game status label including overtime and date context (e.g., "Final/OT"). |
time_left | character | Time left. |
venue_display_name | character | Name of the venue hosting the event. |
venue_city | character | Venue city. |
venue_cover_type | character | Whether the venue is open-air, domed or fitted with a retractable roof. |
venue_state | character | Venue state / region. |
venue_venue_id | character | Yahoo identifier of the venue hosting the event. |
venue_country | character | Country the venue is located in. |
weather | character | String describing the weather including temperature, humidity and wind (direction and speed). Doesn't change during the game! |
game_win_probability_time_line_win_probability_timeline | character | JSON-encoded series of win-probability observations across the course of the game. |
playoff_series | character | JSON-encoded playoff-series node the game belongs to. |
regular_season_series_games | character | JSON-encoded list of the games making up the regular-season series between the two teams. |
is_halftime | logical | Flag indicating that the game is currently stopped at halftime. |
regulation_periods | character | Regulation periods. |
current_period_short_display_name | character | Abbreviated label for the period in progress (e.g., "4th"). |
current_period_period | character | Ordinal number of the period currently in progress within the game. |
current_period_display_name | character | Full label for the period in progress (e.g., "4th Quarter"). |
current_period_overtime | character | Flag indicating that the period in progress is an overtime period. |
away_team_lineup | character | JSON-encoded starting lineup fielded by the away team. |
home_team_lineup | character | JSON-encoded starting lineup fielded by the home team. |
winning_team_id | character | Composite Yahoo team id of the side that won the game (e.g., "ncaaf.t.29"). |
game_coverage | character | JSON-encoded node describing which live feeds Yahoo carries for the game. |
away_line_score | character | JSON-encoded per-period scoring line for the away team. |
away_timeouts_remaining | integer | Numeric timeouts remaining in the half for the away team. |
down | character | The down for the given play. |
distance | character | Distance value (in feet for shot data; otherwise context-dependent). |
field_position_display_name | character | Ball spot rendered the way a scoreboard shows it (e.g., "MICH 35"). |
field_position | character | Ball spot expressed on Yahoo's 0-100 field scale, measured toward the offense's target goal line. |
home_line_score | character | JSON-encoded per-period scoring line for the home team. |
home_timeouts_remaining | integer | Numeric timeouts remaining in the half for the home team. |
team_possessing_ball | character | Yahoo team id of the side currently possessing the ball. |
drives | character | JSON-encoded data-island pointer to the game's drive collection; football only. |
first_play | character | JSON-encoded first play of the game or of the current period. |
play_by_play | character | JSON-encoded data-island pointer to the game's play-by-play collection in the same editorial payload. |
timeouts_granted | integer | Number of timeouts granted so far in the current period. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
yahoo_playbook_boxscore_poll()
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
gameId | game_id | Y | gameId 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_name | type | description |
|---|---|---|
game_id | character | Unique game identifier. |
away_team_active | character | Whether the away team is active. |
away_team_primary_color | character | Primary brand color of the away team, as a hex RGB string without the leading hash. |
away_team_secondary_color | character | Secondary brand color of the away team, as a hex RGB string without the leading hash. |
away_team_team_logo_white | character | JSON-encoded image node for the away team's white knockout logo, used on dark backgrounds. |
away_team_team_logo | character | JSON-encoded image node for the away team's standard logo. |
home_team_active | character | Whether the home team is active. |
home_team_primary_color | character | Primary brand color of the home team, as a hex RGB string without the leading hash. |
home_team_secondary_color | character | Secondary brand color of the home team, as a hex RGB string without the leading hash. |
home_team_team_logo_white | character | JSON-encoded image node for the home team's white knockout logo, used on dark backgrounds. |
home_team_team_logo | character | JSON-encoded image node for the home team's standard logo. |
league_league_logo | character | JSON-encoded image node for the league's logo. |
start_time | character | Kickoff time in eastern time zone. |
start_date | character | Start date (YYYY-MM-DD). |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
yahoo_playbook_boxscore_social_share()
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
gameId | game_id | Y | gameId query parameter. | ||
imageHeight | image_height | Y | imageHeight query parameter. | ||
imageWidth | image_width | Y | imageWidth query parameter. | ||
headshotHeight | headshot_height | Y | headshotHeight query parameter. | ||
headshotWidth | headshot_width | Y | headshotWidth 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_playbook_combat_match()
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
gameId | game_id | Y | gameId query parameter. | ||
imageHeight | image_height | Y | imageHeight query parameter. | ||
imageWidth | image_width | Y | imageWidth 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_name | type | description |
|---|---|---|
game_id | character | Unique game identifier. |
display_name | character | Display name. |
league_name | character | League name. |
league_full_name | character | Full league name (e.g., "NCAA Football"). |
league_display_short | character | Short league label used in navigation and compact UI (e.g., "NCAA FB"). |
league_short_name | character | League short name. |
league_sport | character | Sport the league belongs to (e.g., "football"). |
league_alias | character | JSON-encoded Yahoo alias object for the league, carrying its site URL and path. |
alias_url | character | Absolute sports.yahoo.com URL of the entity's page (e.g., "https://sports.yahoo.com/ncaaf/players/464024/"). |
away_team_id | character | Unique identifier for the away team. |
away_team_full_name | character | Full away team name (e.g. 'Las Vegas Aces'). |
away_team_team_id | character | Yahoo composite team id of the away team (e.g., "ncaaf.t.29"). |
away_team_primary_color | character | Primary brand color of the away team, as a hex RGB string without the leading hash. |
away_team_secondary_color | character | Secondary brand color of the away team, as a hex RGB string without the leading hash. |
away_team_display_name | character | Away team full display name; team_detail = TRUE only. |
away_team_abbreviation | character | Away team abbreviation; team_detail = TRUE only. |
away_team_location | character | Away team's team location. |
away_team_alias | character | JSON-encoded Yahoo alias object for the away team, carrying its site URL and path. |
away_team_nickname | character | Away team nickname label; team_detail = TRUE only. |
away_team_last_games | character | JSON-encoded list of the away team's most recently completed games. |
away_team_team_logo_white | character | JSON-encoded image node for the away team's white knockout logo, used on dark backgrounds. |
away_team_team_logo | character | JSON-encoded image node for the away team's standard logo. |
away_team_team_standings | character | JSON-encoded standings node for the away team, carrying its record, position and streak. |
away_team_players | character | JSON-encoded roster of away-team players attached to the game. |
away_team_rank_polls | character | JSON-encoded list of the poll rankings the away team currently holds. |
away_team_playoff_seeds | character | JSON-encoded list of the away team's playoff-seed entries for the season. |
home_team_id | character | Unique identifier for the home team. |
home_team_full_name | character | Full home team name (e.g. 'Las Vegas Aces'). |
home_team_team_id | character | Yahoo composite team id of the home team (e.g., "ncaaf.t.29"). |
home_team_primary_color | character | Primary brand color of the home team, as a hex RGB string without the leading hash. |
home_team_secondary_color | character | Secondary brand color of the home team, as a hex RGB string without the leading hash. |
home_team_display_name | character | Home team full display name; team_detail = TRUE only. |
home_team_abbreviation | character | Home team abbreviation; team_detail = TRUE only. |
home_team_location | character | Home team's team location. |
home_team_alias | character | JSON-encoded Yahoo alias object for the home team, carrying its site URL and path. |
home_team_nickname | character | Home team nickname label; team_detail = TRUE only. |
home_team_last_games | character | JSON-encoded list of the home team's most recently completed games. |
home_team_team_logo_white | character | JSON-encoded image node for the home team's white knockout logo, used on dark backgrounds. |
home_team_team_logo | character | JSON-encoded image node for the home team's standard logo. |
home_team_team_standings | character | JSON-encoded standings node for the home team, carrying its record, position and streak. |
home_team_players | character | JSON-encoded roster of home-team players attached to the game. |
home_team_rank_polls | character | JSON-encoded list of the poll rankings the home team currently holds. |
home_team_playoff_seeds | character | JSON-encoded list of the home team's playoff-seed entries for the season. |
away_score | integer | Away team score at the time of the play. |
home_score | integer | Home team score at the time of the play. |
start_time | character | Kickoff time in eastern time zone. |
start_date | character | Start date (YYYY-MM-DD). |
if_necessary | character | If necessary. |
status | character | Status label. |
status_display_name | character | Short game or event status as shown on the scoreboard (e.g., "Final", "12:00 pm ET"). |
season | integer | Season year. |
season_phase | character | Phase of the season the game falls in (e.g., "season.phase.season"). |
time_left | character | Time left. |
tournament_id | character | ESPN tournament identifier. |
playoff_series | character | JSON-encoded playoff-series node the game belongs to. |
winning_team_id | character | Composite Yahoo team id of the side that won the game (e.g., "ncaaf.t.29"). |
broadcast_channels | character | JSON-encoded list of the channels broadcasting the event. |
news_break_subtext | character | Secondary line of the news-break banner attached to the game. |
news_break_title | character | Headline of the news-break banner attached to the game. |
news_break_url | character | URL of the article behind the game's news-break banner. |
news_break_uuid | character | Yahoo content UUID of the article behind the game's news-break banner. |
brief | character | Short editorial blurb summarizing the game's state or result. |
bets | character | JSON-encoded list of the betting markets offered on the event (spread, moneyline and total). |
venue_display_name | character | Name of the venue hosting the event. |
venue_city | character | Venue city. |
venue_cover_type | character | Whether the venue is open-air, domed or fitted with a retractable roof. |
venue_state | character | Venue state / region. |
venue_venue_id | character | Yahoo identifier of the venue hosting the event. |
venue_country | character | Country the venue is located in. |
tv_coverage | character | Network carrying the game, as a short broadcast abbreviation (e.g., "CBS", "ESPN"). |
weather | character | String describing the weather including temperature, humidity and wind (direction and speed). Doesn't change during the game! |
away_line_score | character | JSON-encoded per-period scoring line for the away team. |
current_period_period | character | Ordinal number of the period currently in progress within the game. |
field_position | character | Ball spot expressed on Yahoo's 0-100 field scale, measured toward the offense's target goal line. |
field_position_display_name | character | Ball spot rendered the way a scoreboard shows it (e.g., "MICH 35"). |
home_line_score | character | JSON-encoded per-period scoring line for the home team. |
home_timeouts_remaining | integer | Numeric timeouts remaining in the half for the home team. |
away_timeouts_remaining | integer | Numeric timeouts remaining in the half for the away team. |
last_play | character | Free-text description of the most recent play. |
game_stat_leaders | character | JSON-encoded pointer to the per-category statistical leaders for the game. |
team_possessing_ball | character | Yahoo team id of the side currently possessing the ball. |
recap_videos | character | JSON-encoded list of recap videos published for the game. |
week | integer | Week number. |
play_by_play | character | JSON-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.
Example
yahoo_playbook_game()
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
gameId | game_id | Y | gameId query parameter. | ||
eventState | event_state | Y | eventState 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_name | type | description |
|---|---|---|
game_id | character | Unique game identifier. |
bets | character | JSON-encoded list of the betting markets offered on the event (spread, moneyline and total). |
partial_game_bets | character | JSON-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.
Example
yahoo_playbook_game_odds_poll()
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
gameId | game_id | Y | gameId query parameter. | ||
season | season | Y | Season year (e.g. 2024). | ||
count | count | Y | count query parameter. | ||
statIds | stat_ids | Y | statIds query parameter. | ||
showHoleResults | show_hole_results | Y | showHoleResults 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_playbook_golf_tournament()
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
league | league | Y | league query parameter. | ||
dates | dates | Y | Date or date range filter (YYYYMMDD or YYYYMMDD-YYYYMMDD). | ||
count | count | Y | count query parameter. | ||
startTimeFilter | start_time_filter | Y | startTimeFilter query parameter. | ||
rangeStartDate | range_start_date | Y | rangeStartDate query parameter. | ||
rangeEndDate | range_end_date | Y | rangeEndDate 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_name | type | description |
|---|---|---|
ncaaf_games | character | JSON-encoded list of NCAAF game nodes carrying the pick or odds distribution for the slate. |
conferences | character | JSON-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_playbook_league_odds()
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
playerId | player_id | Y | playerId query parameter. | ||
seasonPhases | season_phases | Y | seasonPhases 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_name | type | description |
|---|---|---|
player_id | character | Unique player identifier. |
alias_url | character | Absolute sports.yahoo.com URL of the entity's page (e.g., "https://sports.yahoo.com/ncaaf/players/464024/"). |
alias_subpages | character | JSON-encoded list of subpage aliases (roster, schedule, stats) available beneath the entity's Yahoo page. |
sport_name | character | Sport name (e.g., Major League Baseball). |
first_name | character | Player's first name. |
last_name | character | Player's last name. |
display_name | character | Display name. |
college | character | Official college (usually the last one attended) |
birth_state | character | Birth state / region. |
birth_city | character | Birth city. |
birth_country | character | Player birth country. |
birth_date | character | Date of birth (YYYY-MM-DD). |
height | integer | Player height (string e.g. '6-2' or inches). |
display_height | character | Player height in display format (e.g. '6-2'). |
weight | integer | Player weight in pounds. |
status | character | Status label. |
active | logical | TRUE if the row represents an active record (player / team / season). |
suggested_headshot | character | JSON-encoded image node for the headshot Yahoo recommends for this player. |
uniform_number | character | Jersey number the player wears for the team. |
positions | character | Positions. |
team_id | character | Unique team identifier. |
team_team_id | character | Unique identifier for team team. |
team_display_name | character | Full team display name. |
team_full_name | character | Full team name. |
team_alias | character | JSON-encoded alias object for the entity's team, carrying its Yahoo page URL and path. |
team_team_logo | character | JSON-encoded image node for the team's standard logo. |
team_team_logo_white | character | JSON-encoded image node for the team's white knockout logo. |
team_primary_color | character | Primary brand color of the entity's team, as a hex RGB string without the leading hash. |
team_secondary_color | character | Secondary brand color of the entity's team, as a hex RGB string without the leading hash. |
draft_position | character | Round and pick at which the player was drafted, left null for undrafted players. |
player_seasons | character | JSON-encoded list of the seasons for which Yahoo carries data on this player. |
header_stats_passing | character | JSON-encoded headline passing statistics shown at the top of the player's page. |
season_stats_passing | character | JSON-encoded full-season passing statistics for the player. |
header_stats_rushing | character | JSON-encoded headline rushing statistics shown at the top of the player's page. |
season_stats_rushing | character | JSON-encoded full-season rushing statistics for the player. |
header_stats_receiving | character | JSON-encoded headline receiving statistics shown at the top of the player's page. |
season_stats_receiving | character | JSON-encoded full-season receiving statistics for the player. |
header_stats_defense | character | JSON-encoded headline defensive statistics shown at the top of the player's page. |
season_stats_defense | character | JSON-encoded full-season defensive statistics for the player. |
header_stats_kicking | character | JSON-encoded headline kicking statistics shown at the top of the player's page. |
season_stats_kicking | character | JSON-encoded full-season kicking statistics for the player. |
header_stats_punting | character | JSON-encoded headline punting statistics shown at the top of the player's page. |
season_stats_punting | character | JSON-encoded full-season punting statistics for the player. |
earnings | character | Prize money the player has earned over the covered period, in US dollars. |
first_year | character | First season in which the player appeared in this league. |
last_year | integer | Most recent season in which the player appeared in this league. |
injury | character | Injury (body part / description). |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
yahoo_playbook_player()
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
playerId | player_id | Y | playerId 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_name | type | description |
|---|---|---|
sport_name | character | Sport name (e.g., Major League Baseball). |
short_display_name | character | Short display name. |
suggested_headshot | character | JSON-encoded image node for the headshot Yahoo recommends for this player. |
team_primary_color | character | Primary brand color of the entity's team, as a hex RGB string without the leading hash. |
team_secondary_color | character | Secondary brand color of the entity's team, as a hex RGB string without the leading hash. |
team_league | character | JSON-encoded league node for the entity's team. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
yahoo_playbook_player_social_share()
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
gameId | game_id | Y | gameId query parameter. | ||
playerImageHeight | player_image_height | Y | playerImageHeight query parameter. | ||
playerImageWidth | player_image_width | Y | playerImageWidth 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_playbook_race()
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
teamId | team_id | Y | teamId query parameter. | ||
imageHeight | image_height | Y | imageHeight query parameter. | ||
imageWidth | image_width | Y | imageWidth query parameter. | ||
leagueShortName | league_short_name | Y | leagueShortName query parameter. | ||
disableConference | disable_conference | Y | disableConference query parameter. | ||
disableDivision | disable_division | Y | disableDivision query parameter. |
Returns
return_parsed=True (default) — A dict of polars/pandas DataFrames keyed by the payload's data collections (representative columns below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).
teams
| col_name | type | description |
|---|---|---|
sport_sport_id | character | Yahoo identifier of the sport the league belongs to. |
sport_name | character | Sport name (e.g., Major League Baseball). |
league_name | character | League name. |
league_short_name | character | League short name. |
league_current_season_phase | character | Phase the league's season is currently in (e.g., "season.phase.season"). |
team_id | character | Unique team identifier. |
conference_id | integer | Conference identifier. |
full_name | character | Player's full name. |
display_name | character | Display name. |
location | character | Either 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. |
nickname | character | Team or athlete nickname. |
primary_color | character | Primary team color (hex). |
secondary_color | character | Secondary team color (hex). |
team_logo_white_url | character | Absolute URL of the team's white knockout logo, the variant used on dark backgrounds. |
team_logo_url | character | Absolute URL of the team's standard logo image on Yahoo's image CDN. |
alias_navigation_links | character | JSON-encoded map of navigation links (scores, standings, teams) hanging off the entity's Yahoo alias. |
alias_url | character | Absolute sports.yahoo.com URL of the entity's page (e.g., "https://sports.yahoo.com/ncaaf/players/464024/"). |
alias_path | character | Site-relative path portion of the entity's Yahoo alias (e.g., "/ncaaf/teams/tcu/"). |
last_games | character | JSON-encoded list of the team's most recently completed games, used for form and streak displays. |
next_games | character | JSON-encoded list of the team's next scheduled games. |
division_name | character | Division name. |
division_teams | character | JSON-encoded list of the teams that make up the division. |
conference_short_name | character | Conference short name (e.g. 'ACC'). |
conference_name | character | Full conference name. |
conference_conference_id | character | Yahoo numeric identifier of the conference carried on the team's conference node. |
conference_team_standings | character | JSON-encoded standings rows for every team in the conference. |
conference_abbreviation | character | Conference abbreviation. |
team_standings_team | character | JSON-encoded team node the standings row describes. |
team_standings_conference_id | character | Yahoo numeric conference id for the team's standings row. |
team_standings_conference | character | JSON-encoded conference node the standings row sits under. |
team_standings_display_name | character | Display name of the team on its standings row. |
team_standings_full_name | character | Full name of the team on its standings row. |
team_standings_position | character | Rank of the team within the standings grouping it is listed in. |
team_standings_sequence | character | Tie-break ordering value Yahoo uses to sequence teams holding identical records. |
team_standings_team_record | character | Formatted overall record for the team (e.g., "8-2"). |
team_standings_conference_position | character | Rank of the team within its conference standings. |
team_standings_points_for | character | Points the team has scored over the standings period. |
team_standings_points_against | character | Points the team has allowed over the standings period. |
team_standings_clinched_playoff | character | Flag indicating that the team has clinched a playoff berth. |
team_standings_clinched_division | character | Flag indicating that the team has clinched its division. |
team_standings_streak_display | character | Formatted current streak for the team (e.g., "W3", "L2"). |
gametime_ticket_url | character | Gametime affiliate ticket-purchase URL for the event or team. |
football_team_season_stats | character | JSON-encoded team-level season statistics for the team's football side. |
football_player_season_stats | character | JSON-encoded per-player season statistics for the team's football roster. |
injured_players | character | JSON-encoded list of the team's players currently carrying an injury designation. |
transactions | character | JSON-encoded list of the team's roster transactions over the requested window. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
yahoo_playbook_team()
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
teamId | team_id | Y | teamId query parameter. | ||
imageHeight | image_height | Y | imageHeight query parameter. | ||
imageWidth | image_width | Y | imageWidth 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_name | type | description |
|---|---|---|
sport_sport_id | character | Yahoo identifier of the sport the league belongs to. |
sport_name | character | Sport name (e.g., Major League Baseball). |
league_name | character | League name. |
league_short_name | character | League short name. |
league_current_season_phase | character | Phase the league's season is currently in (e.g., "season.phase.season"). |
team_id | character | Unique team identifier. |
conference_id | integer | Conference identifier. |
full_name | character | Player's full name. |
display_name | character | Display name. |
location | character | Either 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. |
nickname | character | Team or athlete nickname. |
primary_color | character | Primary team color (hex). |
secondary_color | character | Secondary team color (hex). |
team_logo_white_url | character | Absolute URL of the team's white knockout logo, the variant used on dark backgrounds. |
team_logo_url | character | Absolute URL of the team's standard logo image on Yahoo's image CDN. |
alias_navigation_links | character | JSON-encoded map of navigation links (scores, standings, teams) hanging off the entity's Yahoo alias. |
alias_url | character | Absolute sports.yahoo.com URL of the entity's page (e.g., "https://sports.yahoo.com/ncaaf/players/464024/"). |
alias_path | character | Site-relative path portion of the entity's Yahoo alias (e.g., "/ncaaf/teams/tcu/"). |
last_games | character | JSON-encoded list of the team's most recently completed games, used for form and streak displays. |
next_games | character | JSON-encoded list of the team's next scheduled games. |
division_name | character | Division name. |
conference_short_name | character | Conference short name (e.g. 'ACC'). |
conference_name | character | Full conference name. |
conference_conference_id | character | Yahoo numeric identifier of the conference carried on the team's conference node. |
conference_abbreviation | character | Conference abbreviation. |
team_standings_team | character | JSON-encoded team node the standings row describes. |
team_standings_conference_id | character | Yahoo numeric conference id for the team's standings row. |
team_standings_conference | character | JSON-encoded conference node the standings row sits under. |
team_standings_display_name | character | Display name of the team on its standings row. |
team_standings_full_name | character | Full name of the team on its standings row. |
team_standings_position | character | Rank of the team within the standings grouping it is listed in. |
team_standings_sequence | character | Tie-break ordering value Yahoo uses to sequence teams holding identical records. |
team_standings_team_record | character | Formatted overall record for the team (e.g., "8-2"). |
team_standings_conference_position | character | Rank of the team within its conference standings. |
team_standings_points_for | character | Points the team has scored over the standings period. |
team_standings_points_against | character | Points the team has allowed over the standings period. |
team_standings_clinched_playoff | character | Flag indicating that the team has clinched a playoff berth. |
team_standings_clinched_division | character | Flag indicating that the team has clinched its division. |
team_standings_streak_display | character | Formatted current streak for the team (e.g., "W3", "L2"). |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
yahoo_playbook_team_basic()
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
teamId | team_id | Y | teamId 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_name | type | description |
|---|---|---|
sport_sport_id | character | Yahoo identifier of the sport the league belongs to. |
sport_name | character | Sport name (e.g., Major League Baseball). |
team_id | character | Unique team identifier. |
primary_color | character | Primary team color (hex). |
team_logo_url | character | Absolute URL of the team's standard logo image on Yahoo's image CDN. |
team_logo_white_url | character | Absolute URL of the team's white knockout logo, the variant used on dark backgrounds. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
yahoo_playbook_team_social_share()
Last validated n/a.