Skip to main content

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

yahoo_team_injuries​

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

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

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

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
team_idString
nicknameString
full_nameString
locationString
display_nameString
primary_colorString
abbreviationString
alias_pathStringSite-relative path portion of the entity's Yahoo alias (e.g., "/ncaaf/teams/tcu/").
alias_urlStringAbsolute sports.yahoo.com URL of the entity's page (e.g., "https://sports.yahoo.com/ncaaf/players/464024/").
team_logo_white_urlStringAbsolute URL of the team's white knockout logo, the variant used on dark backgrounds.
team_logo_urlStringAbsolute URL of the team's standard logo image on Yahoo's image CDN.
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_team_injuries()

yahoo_team_playoff_series​

Yahoo shangrila persisted query teamPlayoffSeries -> one row per teams.playoffSeries entry

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

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

API ParameterPythonPatternRequiredNullableDescription
teamIdteam_idYteamId 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_team_playoff_series()

yahoo_team_roster​

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

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

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

API ParameterPythonPatternRequiredNullableDescription
teamIdteam_idYteamId query parameter.
playerImageHeightplayer_image_heightYplayerImageHeight query parameter.
playerImageWidthplayer_image_widthYplayerImageWidth 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_current_seasonStringYahoo league-season identifier for the league's season currently in progress.
rosterStringJSON-encoded roster of the players on the team for the requested season.

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

yahoo_team_schedule_by_season​

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

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

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

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason year (e.g. 2024).
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
team_idString
display_nameString
primary_colorString
secondary_colorString
gametime_ticket_urlStringGametime affiliate ticket-purchase URL for the event or team.
bye_weeksStringJSON-encoded list of the week numbers in which the team has no scheduled game.
gamesString
leaguesStringJSON-encoded list of the league nodes the team's schedule spans.
full_nameString
abbreviationString
nicknameString
team_logo_white_urlStringAbsolute URL of the team's white knockout logo, the variant used on dark backgrounds.
team_logo_urlStringAbsolute URL of the team's standard logo image on Yahoo's image CDN.
team_standings_team_recordStringFormatted overall record for the team (e.g., "8-2").
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_team_schedule_by_season()

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

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

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

API ParameterPythonPatternRequiredNullableDescription
namenameYname 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
team_idString
display_nameString
full_nameString
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/").
primary_colorString
secondary_colorString
abbreviationString
league_short_nameString
league_display_shortStringShort league label used in navigation and compact UI (e.g., "NCAA FB").
league_nameString
team_logo_urlStringAbsolute URL of the team's standard logo image on Yahoo's image CDN.
team_logo_white_urlStringAbsolute URL of the team's white knockout logo, the variant used on dark backgrounds.

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

Raises​

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

Example​

yahoo_team_search()

yahoo_team_stats_leaders_v2​

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

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

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

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYleague query parameter.
teamIdteam_idYteamId query parameter.
countcountYcount query parameter.
seasonseasonYSeason year (e.g. 2024).
baseballCutTypebaseball_cut_typeYbaseballCutType query parameter.
qualifiedqualifiedYqualified query parameter.
includeTeamStatsinclude_team_statsYincludeTeamStats query parameter.
includePlayerStatsinclude_player_statsYincludePlayerStats query parameter.
isBaseballis_baseballYisBaseball query parameter.

Returns​

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

teams

col_nametypedescription
display_nameString
full_nameString
nicknameString
team_footballStringJSON-encoded team-level football leader board for the team.
individual_footballStringJSON-encoded player-level football leader board for the 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_team_stats_leaders_v2()

yahoo_team_transactions​

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

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

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

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
team_idString
nicknameString
full_nameString
locationString
display_nameString
primary_colorString
abbreviationString
alias_pathStringSite-relative path portion of the entity's Yahoo alias (e.g., "/ncaaf/teams/tcu/").
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").
team_logo_white_urlStringAbsolute URL of the team's white knockout logo, the variant used on dark backgrounds.
team_logo_urlStringAbsolute URL of the team's standard logo image on Yahoo's image CDN.
transactionsStringJSON-encoded list of the team's roster transactions over the requested window.

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

Raises​

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

Example​

yahoo_team_transactions()

yahoo_teams_basic​

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

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

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

API ParameterPythonPatternRequiredNullableDescription
teamIdsteam_idsYteamIds 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
team_idString
team_logo_urlStringAbsolute URL of the team's standard logo image on Yahoo's image CDN.
team_logo_white_urlStringAbsolute URL of the team's white knockout logo, the variant used on dark backgrounds.
display_nameString
full_nameString
nicknameString
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/").
primary_colorString
secondary_colorString
abbreviationString
league_display_shortStringShort league label used in navigation and compact UI (e.g., "NCAA FB").
league_nameString
league_short_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_teams_basic()