Skip to main content

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

yahoo_oly_medal_count​

Yahoo shangrila persisted query OlyMedalCount -> one row per olympics entry

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

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

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason year (e.g. 2024).
sortMethodsort_methodYsortMethod 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
short_display_nameString
start_dateString
end_dateString
seasonInt64
aliasStringJSON-encoded Yahoo alias object for the entity, carrying the site URL, path and subpage routing used to build links to its page.
olympic_teamStringJSON-encoded national team node whose medal count this row reports.

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

yahoo_oly_seasons​

Yahoo shangrila persisted query OlySeasons -> one row per olympics entry

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

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

API ParameterPythonPatternRequiredNullableDescription
seasonsseasonsYseasons 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
seasonInt64
display_nameString
typeString

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

yahoo_alias​

Yahoo shangrila persisted query alias -> one row per pageMetaData entry

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

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

API ParameterPythonPatternRequiredNullableDescription
aliasaliasYalias 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
page_typeString
league_short_nameString
league_display_nameStringDisplay name of the league as rendered on the aliased page.
entity_typeStringKind of entity the alias record points at (e.g., "team", "player", "league").
subpage_translationStringLocalized display label for the subpage this alias record describes.
entity_aliasStringAlias template Yahoo serves the entity's own page under.
subpage_aliasStringAlias template for the subpage this alias record describes.
hotlist_data_desktop_space_idStringContent-space identifier for the desktop hotlist module rendered on the aliased page.
hotlist_data_tablet_space_idStringContent-space identifier for the tablet hotlist module rendered on the aliased page.
hotlist_data_mobile_space_idStringContent-space identifier for the mobile hotlist module rendered on the aliased page.
entity_list_id_desktop_list_idStringIdentifier of the curated desktop entity list rendered on the aliased page.
entity_list_id_mobile_list_idStringIdentifier of the curated mobile entity list rendered on the aliased page.
entity_list_id_tablet_list_idStringIdentifier of the curated tablet entity list rendered on the aliased page.
gameString
matchStringAlias template Yahoo serves the match page under for this league.
raceStringAlias template Yahoo serves the motorsport race page under for this league.
leagueString
teamString
golf_tournamentStringAlias template Yahoo serves the golf-tournament page under for this league.
tennis_tournamentStringAlias template Yahoo serves the tennis-tournament page under for this league.
playerString

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

yahoo_article_list_card_players​

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

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

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

API ParameterPythonPatternRequiredNullableDescription
playerIdsplayer_idsYplayerIds query parameter.

Returns​

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

col_nametypedescription
alias_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").
player_idString
display_nameString
short_display_nameString
player_cutoutStringJSON-encoded image node for the player's transparent cut-out portrait.
team_aliasStringJSON-encoded alias object for the entity's team, carrying its Yahoo page URL and path.
team_display_nameString
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_team_idString
team_team_logo_whiteStringJSON-encoded image node for the team's white knockout logo.
team_team_logoStringJSON-encoded image node for the team's standard logo.
team_gametime_ticket_urlStringGametime affiliate ticket-purchase URL for the team's home games.

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

yahoo_article_list_card_teams​

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

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

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

API ParameterPythonPatternRequiredNullableDescription
teamIdsteam_idsYteamIds query parameter.

Returns​

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

col_nametypedescription
alias_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").
display_nameString
nicknameString
primary_colorString
secondary_colorString
team_idString
team_logo_white_widthStringPixel width of the team's white knockout logo image.
team_logo_white_last_updatedStringTimestamp at which the team's white knockout logo asset was last refreshed.
team_logo_white_image_typeStringFile format of the team's white knockout logo asset (e.g., "png").
team_logo_white_urlStringAbsolute URL of the team's white knockout logo, the variant used on dark backgrounds.
team_logo_white_heightStringPixel height of the team's white knockout logo image.
team_logo_white_team_idStringYahoo composite team id the white knockout logo asset belongs to.
team_logo_widthStringPixel width of the team's standard logo image.
team_logo_last_updatedStringTimestamp at which the team's standard logo asset was last refreshed.
team_logo_image_typeStringFile format of the team's standard logo asset (e.g., "png").
team_logo_urlStringAbsolute URL of the team's standard logo image on Yahoo's image CDN.
team_logo_heightStringPixel height of the team's standard logo image.
team_logo_team_idStringYahoo composite team id the standard logo asset belongs to.
gametime_ticket_urlStringGametime affiliate ticket-purchase URL for the event or 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_article_list_card_teams()

yahoo_basic_players​

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

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

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

API ParameterPythonPatternRequiredNullableDescription
playersplayersYplayers 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
display_nameString
suggested_headshotStringJSON-encoded image node for the headshot Yahoo recommends for this player.
alias_urlStringAbsolute sports.yahoo.com URL of the entity's page (e.g., "https://sports.yahoo.com/ncaaf/players/464024/").

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

yahoo_betting_disclaimer​

Yahoo shangrila persisted query bettingDisclaimer -> one row per bettingDisclaimers entry

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

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

API ParameterPythonPatternRequiredNullableDescription
bettingDisclaimerIdbetting_disclaimer_idYbettingDisclaimerId 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
disclaimer_idStringIdentifier of the responsible-gambling disclaimer block to render alongside the odds.
textString

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

yahoo_combat_event_fights​

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

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

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

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

Returns​

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

col_nametypedescription
short_nameString
full_nameString

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

Raises​

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

Example​

yahoo_combat_event_fights()

yahoo_combat_schedule​

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

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

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

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

Returns​

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

col_nametypedescription
short_nameString
full_nameString

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

Raises​

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

Example​

yahoo_combat_schedule()

yahoo_common_pills​

Yahoo shangrila persisted query common/pills (response body not captured; shape unknown)

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

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

API ParameterPythonPatternRequiredNullableDescription
addTeamLogosadd_team_logosYaddTeamLogos query parameter.
datedateYdate query parameter.
teamIdsteam_idsYteamIds 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_common_pills()

yahoo_consensus_rankings_php​

Yahoo shangrila persisted query consensus-rankings.php (response body not captured; shape unknown)

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

Valid URL: https://graphite-secure.sports.yahoo.com/v1/query/shangrila/consensus-rankings.php

API ParameterPythonPatternRequiredNullableDescription
sportsportYsport query parameter.
positionpositionYposition query parameter.
filtersfiltersYfilters query parameter.
expertsexpertsYexperts query parameter.
scoringscoringYscoring query parameter.
typetypeYtype 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_consensus_rankings_php()

yahoo_draft​

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

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

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

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

Returns​

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

Raises​

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

Example​

yahoo_draft()

yahoo_draft_prospects​

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

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

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

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYleague query parameter.
seasonseasonYSeason year (e.g. 2024).
imageHeightimage_heightYimageHeight query parameter.
imageWidthimage_widthYimageWidth 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_draft_prospects()

yahoo_driver_results​

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

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

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

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

Returns​

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

Raises​

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

Example​

yahoo_driver_results()

yahoo_driver_splits​

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

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

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

API ParameterPythonPatternRequiredNullableDescription
playerIdplayer_idYplayerId 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_driver_splits()

Yahoo shangrila persisted query featuredGameIds -> one row per featuredGames entry

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

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

API ParameterPythonPatternRequiredNullableDescription

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

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

yahoo_gametime_game​

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

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

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

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
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.

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

yahoo_gametime_team​

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

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

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

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
gametime_ticket_urlStringGametime affiliate ticket-purchase URL for the event or team.
team_idString

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

yahoo_golf_tournament_seasons​

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

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

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

API ParameterPythonPatternRequiredNullableDescription
eventGroupIdevent_group_idYeventGroupId 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_golf_tournament_seasons()

yahoo_golf_tournaments​

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

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

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

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

Returns​

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

col_nametypedescription
alias_urlStringAbsolute sports.yahoo.com URL of the entity's page (e.g., "https://sports.yahoo.com/ncaaf/players/464024/").
alias_pathStringSite-relative path portion of the entity's Yahoo alias (e.g., "/ncaaf/teams/tcu/").
event_group_idStringYahoo identifier that groups the rounds or legs making up a single tournament.
nameString
display_nameString
start_timeString
start_dateString
end_dateString
statusString
status_display_nameStringShort game or event status as shown on the scoreboard (e.g., "Final", "12:00 pm ET").
player_tournament_statsStringJSON-encoded per-player statistics recorded at the golf tournament.
purseStringTotal prize money on offer at the tournament, in US dollars.
majorBooleanFlag indicating that the golf tournament is one of the sport's majors.
venue_display_nameStringName of the venue hosting the event.
venue_countryStringCountry the venue is located in.
venue_cityString
venue_stateString
parInt64Par of the golf course in play for the tournament.
yardageInt64Total yardage of the golf course in play for the tournament.

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

yahoo_golf_tournaments_basic​

Yahoo shangrila persisted query golfTournamentsBasic -> one row per golfTournaments entry

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

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

API ParameterPythonPatternRequiredNullableDescription
eventGroupIdevent_group_idYeventGroupId query parameter.
associationassociationYassociation 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
event_group_idStringYahoo identifier that groups the rounds or legs making up a single tournament.
start_timeString
start_dateString
end_dateString
seasonInt64
clubsStringJSON-encoded list of the golf clubs hosting the tournament.
coursesStringJSON-encoded list of the courses in play at the tournament, with their par and yardage.
nameString
statusString
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/").
associationStringGoverning tour that sanctions the event (e.g., "pga").
league_short_nameString
league_full_nameStringFull league name (e.g., "NCAA Football").
league_aliasStringJSON-encoded Yahoo alias object for the league, carrying its site URL and path.
purseStringTotal prize money on offer at the tournament, in US dollars.

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

yahoo_module_game​

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

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

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

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_abbrStringCompact league abbreviation used in dense UI alongside the game.
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_recordString
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_gametime_ticket_urlStringGametime affiliate ticket-purchase URL for the away team's games.
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_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_recordString
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_gametime_ticket_urlStringGametime affiliate ticket-purchase URL for the home team's games.
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_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
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.
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.
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

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

yahoo_motorsport_standings​

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

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

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

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYleague 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
nameString
full_nameString
current_league_seasonStringYahoo league-season identifier for the season currently in progress.

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

yahoo_nascar_drivers​

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

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

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

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYleague query parameter.

Returns​

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

col_nametypedescription
short_nameString
playersString

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

Raises​

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

Example​

yahoo_nascar_drivers()

yahoo_nav_dropdown_tray​

Yahoo shangrila persisted query navDropdownTray -> tables: nfl, nhl, nba, mlb, wnba, ncaab, ncaaf, ncaaw, sportsbook_legal_states

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

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

API ParameterPythonPatternRequiredNullableDescription
getSoccerDataget_soccer_dataYgetSoccerData query parameter.
soccerLeagueIdssoccer_league_idsYsoccerLeagueIds query parameter.
soccerTeamIdssoccer_team_idsYsoccerTeamIds 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).

nfl

col_nametypedescription
short_nameString
teamsString

nhl

col_nametypedescription
short_nameString
teamsString

nba

col_nametypedescription
short_nameString
teamsString

mlb

col_nametypedescription
short_nameString
teamsString

wnba

col_nametypedescription
short_nameString
teamsString

ncaab

col_nametypedescription
poll_nameString
rankString
team_idString
teamString

ncaaf

col_nametypedescription
poll_nameString
rankString
team_idString
teamString

ncaaw

col_nametypedescription
poll_nameString
rankString
team_idString
teamString

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

yahoo_pick_distribution​

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

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

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

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYleague query parameter.
datesdatesYDate or date range filter (YYYYMMDD or YYYYMMDD-YYYYMMDD).
countcountYcount 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_pick_distribution()

yahoo_playoff_bracket​

Yahoo shangrila persisted query playoffBracket -> one row per leagues.bracketSlots entry

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

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

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYleague query parameter.
seasonseasonYSeason year (e.g. 2024).
tournamenttournamentYtournament query parameter.
typetypeYtype query parameter.
playoffRoundsplayoff_roundsYplayoffRounds 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
conferenceString
idString
locationString
playoff_roundString
display_orderStringPosition of the bracket slot within its round, controlling top-to-bottom rendering.
seasonString
max_gamesStringMaximum number of games the playoff series can run to.
winner_bracket_slot_idStringIdentifier of the bracket slot the winner of this slot advances into.
playoff_seriesStringJSON-encoded playoff-series node the game belongs to.

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

yahoo_playoff_series_game​

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

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

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

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
playoff_seriesStringJSON-encoded playoff-series node the game belongs to.

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

yahoo_polymarket_game​

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

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

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

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
polymarket_urlStringPolymarket prediction-market URL for wagering on the game.

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

yahoo_racing_schedule​

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

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

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

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

Returns​

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

col_nametypedescription
league_seasonsStringJSON-encoded list of the seasons for which Yahoo carries data for this league.
current_seasonInt64Season the league is currently playing, as the four-digit starting year.

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