Skip to main content

Yahoo Sports — Yahoo Sports Shangrila (graphite-secure.sports.yahoo.com) — Other: scoreboard_game–trending_game

yahoo_scoreboard_game​

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

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

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

API ParameterPythonPatternRequiredNullableDescription
gameIdgame_idYgameId query parameter.
seasonseasonYSeason year (e.g. 2024).
seasonPhaseseason_phaseYseasonPhase query parameter.
statLeaderCountstat_leader_countYstatLeaderCount query parameter.
singleStatLeadersingle_stat_leaderYsingleStatLeader query parameter.
betEventStatebet_event_stateYbetEventState 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.
league_league_logoStringJSON-encoded image node for the league's logo.
partner_urlStringPartner or affiliate deep link associated with the scoreboard game.
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_display_nameString
away_team_abbreviationString
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_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
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_display_nameString
home_team_abbreviationString
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_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
current_period_overtimeStringFlag indicating that the period in progress is an overtime period.
current_period_short_display_nameStringAbbreviated label for the period in progress (e.g., "4th").
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
tournament_idString
display_resultString
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.
news_break_typeStringCategory of the news-break banner, such as an injury note, preview or recap.
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.
special_event_typeStringMarker identifying a special framing for the game, such as a bowl game or neutral-site showcase.
betsStringJSON-encoded list of the betting markets offered on the event (spread, moneyline and total).
venue_display_nameStringName of the venue hosting the event.
weatherString
gametime_ticket_urlStringGametime affiliate ticket-purchase URL for the event or team.
game_ticket_priceStringLowest available ticket price for the game from the Gametime affiliate feed, in US dollars.
teamsString
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").
team_possessing_ballStringYahoo team id of the side currently possessing the ball.
weekInt64
passing_leaderStringJSON-encoded leading passer for the game or team, with the statistics that earned the billing.
rushing_leaderStringJSON-encoded leading rusher for the game or team, with the statistics that earned the billing.
receiving_leaderStringJSON-encoded leading receiver for the game or team, with the statistics that earned the billing.

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

yahoo_tennis_matches_by_date​

Yahoo shangrila persisted query tennisMatchesByDate -> one row per tennisTournaments entry

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

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

API ParameterPythonPatternRequiredNullableDescription
tournamentIdtournament_idYtournamentId query parameter.
seasonseasonYSeason year (e.g. 2024).
datedateYdate query parameter.

Returns​

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

col_nametypedescription
display_nameString
tournament_statusStringState of the tournament, distinguishing scheduled, in-progress and completed events.
start_timeString
end_timeString
eventsString
championsStringJSON-encoded list of the current champions of the tennis event, one entry per draw.
previous_championsStringJSON-encoded list of the champions of the previous edition of the tennis event.
venue_countryStringCountry the venue is located in.
venue_cityString
venue_stateString

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

yahoo_tennis_tournament​

Yahoo shangrila persisted query tennisTournament -> one row per tennisTournaments entry

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

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

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

Returns​

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

col_nametypedescription
display_nameString
tournament_statusStringState of the tournament, distinguishing scheduled, in-progress and completed events.
start_timeString
end_timeString
eventsString
championsStringJSON-encoded list of the current champions of the tennis event, one entry per draw.
previous_championsStringJSON-encoded list of the champions of the previous edition of the tennis event.
venue_countryStringCountry the venue is located in.
venue_cityString
venue_stateString

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

yahoo_tennis_tournaments​

Yahoo shangrila persisted query tennisTournaments -> one row per tennisTournaments entry

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

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

API ParameterPythonPatternRequiredNullableDescription
leagueIdleague_idYleagueId query parameter.
matchTypematch_typeYmatchType query parameter.
seasonseasonYSeason year (e.g. 2024).

Returns​

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

col_nametypedescription
genderString
event_group_idStringYahoo identifier that groups the rounds or legs making up a single tournament.
display_nameString
match_typeStringFormat of the matches in the tennis draw (e.g., "SINGLES", "DOUBLES").
surfaceString
start_timeString
end_timeString
tournament_statusStringState of the tournament, distinguishing scheduled, in-progress and completed events.
championsStringJSON-encoded list of the current champions of the tennis event, one entry per draw.
alias_pathStringSite-relative path portion of the entity's Yahoo alias (e.g., "/ncaaf/teams/tcu/").
alias_langStringLanguage/locale tag attached to the entity's Yahoo alias (e.g., "en-US").
alias_urlStringAbsolute sports.yahoo.com URL of the entity's page (e.g., "https://sports.yahoo.com/ncaaf/players/464024/").
alias_domainStringHost the entity's Yahoo alias resolves against (e.g., "sports.yahoo.com").
previous_championsStringJSON-encoded list of the champions of the previous edition of the tennis event.
venue_countryStringCountry the venue is located in.
venue_cityString
venue_stateString

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

yahoo_tennis_tournaments_by_date​

Yahoo shangrila persisted query tennisTournamentsByDate -> one row per tennisTournaments entry

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

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

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason year (e.g. 2024).
datedateYdate 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_tennis_tournaments_by_date()

Yahoo shangrila persisted query trendingEventIds -> one row per trendingEvents entry

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

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

API ParameterPythonPatternRequiredNullableDescription
countcountYcount query parameter.
leagueleagueYleague query parameter.
dateFlipOffsetdate_flip_offsetYdateFlipOffset query parameter.

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.

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.
yahoo_trending_event_ids()

Yahoo shangrila persisted query trendingGameIds -> one row per trendingGames entry

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

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

API ParameterPythonPatternRequiredNullableDescription
countcountYcount query parameter.
leagueleagueYleague query parameter.
dateFlipOffsetdate_flip_offsetYdateFlipOffset query parameter.
datesdatesYDate or date range filter (YYYYMMDD or YYYYMMDD-YYYYMMDD).

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.

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.
yahoo_trending_game_ids()