ESPN parsed returns

Every ESPN endpoint returns the raw ESPN Dict by default. Pass { parsed: true } to route the payload through the parser registered for that endpoint and get a tidy array of row objects instead (the JS analogue of a tidy DataFrame — mirrors sdv-py's return_parsed=True):

const raw  = await sdv.nba.espnNbaScoreboard({});               // raw Dict
const rows = await sdv.nba.espnNbaScoreboard({ parsed: true }); // tidy row[]

The 116 ESPN endpoints route through just 22 parsers, so the returned columns are determined by the endpoint's parser, not the league — the same parser yields the same shape across every league. Each parser's column set is documented once below; the Endpoints line under each lists the short names that use it. Columns are snake_cased and nested objects flattened with _ (e.g. team.abbreviation -> team_abbreviation). Generic / league-variable passthroughs show no fixed table.

parse_scoreboard

One row per game on a Site v2 scoreboard (teams, score, status, odds).

Endpoints (1): scoreboard

col_name	type	description
game_id	character
uid	character
date	character
name	character
short_name	character
season_year	integer
season_type	integer
season_slug	character
status_type_id	character
status_type_name	character
status_type_state	character
status_type_completed	logical
status_type_description	character
status_type_detail	character
status_type_short_detail	character
status_clock	integer
status_display_clock	character
status_period	integer
neutral_site	logical
conference_competition	logical
attendance	integer
venue_id	character
venue_full_name	character
venue_city	character
venue_state	character
venue_indoor	logical
broadcast	character
note	character
home_id	character
home_name	character
home_abbreviation	character
home_display_name	character
home_location	character
home_color	character
home_alternate_color	character
home_logo	character
home_score	character
home_winner	logical
home_rank	character
away_id	character
away_name	character
away_abbreviation	character
away_display_name	character
away_location	character
away_color	character
away_alternate_color	character
away_logo	character
away_score	character
away_winner	logical
away_rank	character

parse_teams

League team catalog (Site v2 / Core v2).

Endpoints (2): teams_core, teams_site

Generic / dynamic passthrough — the column set varies by league and payload (e.g. Core v2 $ref items or a league-specific catalog). Call with { parsed: true } to inspect the columns for a given league.

parse_standings

One row per team-standings entry with its stat columns.

Endpoints (2): standings, standings_core

col_name	type	description
group_name	character
group_abbreviation	character
team_id	character	ESPN team id
team_name	character
team_abbreviation	character	Team abbreviation
team_display_name	character	Team display name
team_location	character
team_logo	character
avg_points_against	number
avg_points_for	number
clincher	integer
differential	integer
division_win_percent	number
games_behind	integer
league_win_percent	number
losses	integer
playoff_seed	integer
point_differential	integer
points	integer
points_against	integer
points_for	integer
streak	integer
win_percent	number
wins	integer
games_ahead	integer
overall	character
home	character
road	character
vs_div	character
vs_conf	character
last_ten_games	character

parse_groups

Conferences / groups (divisions) for the league.

Endpoints (1): conferences

Generic / dynamic passthrough — the column set varies by league and payload (e.g. Core v2 $ref items or a league-specific catalog). Call with { parsed: true } to inspect the columns for a given league.

parse_athlete_overview

Web v3 athlete overview (bio + recent splits).

Endpoints (1): athlete_overview

col_name	type	description
athlete_id	character	ESPN athlete id
athlete_display_name	character	Athlete display name
athlete_short_name	character	Athlete short name
athlete_position	character	Position abbreviation
athlete_jersey	character	Jersey number
athlete_team_id	character	Athlete's team id
athlete_team_abbreviation	character	Athlete's team abbreviation
split_name	character	Split / season-segment name
split_category	character	Split category

parse_athlete_stats

Web v3 athlete statistics blocks.

Endpoints (1): athlete_stats

col_name	type	description
category	character	Stat / leader category name
split_name	character	Split / season-segment name
split_category	character	Split category
split_value	character	Split value

parse_athlete_gamelog

Web v3 athlete game log (one row per game).

Endpoints (1): athlete_gamelog

col_name	type	description
season_type_id	character	Season type id (regular/post)
season_type_name	character	Season type name
category	character	Stat / leader category name
event_id	character	ESPN event/game id
event_date	character	Event date (ISO 8601)
home_away	character	home or away
score	character	Final score for the athlete's team
opponent_id	character	Opponent ESPN team id
opponent_abbreviation	character	Opponent abbreviation
opponent_display_name	character	Opponent display name
game_result	character	Game result (W/L)
game_processed	logical	Whether the game has been processed

parse_athlete_splits

Web v3 athlete splits.

Endpoints (1): athlete_splits

col_name	type	description
category	character	Stat / leader category name
split_name	character	Split / season-segment name
split_abbreviation	character	Split abbreviation
split_category	character	Split category
split_value	character	Split value
split_description	character	Split description

parse_leaders

League statistical leaders (one row per leader entry).

Endpoints (1): leaders

col_name	type	description
category	character	Stat / leader category name
rank	integer	Rank within the category
athlete_id	character	ESPN athlete id
athlete_display_name	character	Athlete display name
athlete_short_name	character	Athlete short name
athlete_jersey	character	Jersey number
athlete_position	character	Position abbreviation
team_id	character	ESPN team id
team_abbreviation	character	Team abbreviation
team_display_name	character	Team display name

parse_coaches

Coaches catalog.

Endpoints (1): season_coaches

Generic / dynamic passthrough — the column set varies by league and payload (e.g. Core v2 $ref items or a league-specific catalog). Call with { parsed: true } to inspect the columns for a given league.

parse_draft

Draft rounds / picks.

Endpoints (1): season_draft

Generic / dynamic passthrough — the column set varies by league and payload (e.g. Core v2 $ref items or a league-specific catalog). Call with { parsed: true } to inspect the columns for a given league.

parse_event_competitor_roster

Per-competitor roster on an event.

Endpoints (1): event_competitor_roster

Generic / dynamic passthrough — the column set varies by league and payload (e.g. Core v2 $ref items or a league-specific catalog). Call with { parsed: true } to inspect the columns for a given league.

parse_event_competitor_statistics

Per-competitor statistics on an event.

Endpoints (1): event_competitor_statistics

col_name	type	description
split_name	character	Split / season-segment name
category_name	character	Statistic category name
stat_name	character	Statistic name
stat_abbreviation	character	Statistic abbreviation
stat_value	number	Numeric statistic value
stat_display_value	character	Formatted statistic value
stat_description	character	Statistic description

parse_event_competitor_linescores

Per-competitor linescores on an event.

Endpoints (1): event_competitor_linescores

Generic / dynamic passthrough — the column set varies by league and payload (e.g. Core v2 $ref items or a league-specific catalog). Call with { parsed: true } to inspect the columns for a given league.

parse_event_plays

Core v2 event plays.

Endpoints (1): event_plays

Generic / dynamic passthrough — the column set varies by league and payload (e.g. Core v2 $ref items or a league-specific catalog). Call with { parsed: true } to inspect the columns for a given league.

parse_team_schedule

A team's Site v2 schedule (one row per event).

Endpoints (1): team_schedule

Generic / dynamic passthrough — the column set varies by league and payload (e.g. Core v2 $ref items or a league-specific catalog). Call with { parsed: true } to inspect the columns for a given league.

parse_team_roster

A team's roster (one row per athlete).

Endpoints (1): team_roster

col_name	type	description
id	character
uid	character
guid	character
alternate_ids_sdr	character
first_name	character
last_name	character
full_name	character
display_name	character
short_name	character
weight	integer
display_weight	character
height	integer
display_height	character
age	integer
date_of_birth	character
debut_year	integer
links	character
birth_place_city	character
birth_place_country	character
college_id	character
college_guid	character
college_mascot	character
college_name	character
college_short_name	character
college_abbrev	character
college_logos	character
slug	character
headshot_href	character
headshot_alt	character
jersey	character
position_id	character
position_name	character
position_display_name	character
position_abbreviation	character
position_leaf	logical
injuries	character
teams	character
contracts	character
experience_years	integer
contract_bird_status	integer
contract_base_year_compensation_active	logical
contract_poison_pill_provision_active	logical
contract_incoming_trade_value	integer
contract_outgoing_trade_value	integer
contract_minimum_salary_exception	logical
contract_option_type	integer
contract_salary	integer
contract_salary_remaining	integer
contract_years_remaining	integer
contract_season_year	integer
contract_season_start_date	character
contract_season_end_date	character
contract_trade_kicker_active	logical
contract_trade_kicker_percentage	integer
contract_trade_kicker_value	integer
contract_trade_kicker_trade_value	integer
contract_trade_restriction	logical
contract_unsigned_foreign_pick	logical
contract_active	logical
status_id	character
status_name	character
status_type	character
status_abbreviation	character
citizenship	character
birth_place_state	character
hand_type	character
hand_abbreviation	character
hand_display_value	character

parse_news

ESPN news articles (league / team / athlete scoped).

Endpoints (3): athlete_news, news, team_news

col_name	type	description
id	integer
now_id	character
content_key	character
data_source_identifier	character
type	character
headline	character
description	character
last_modified	character
published	character
images	character
categories	character
premium	logical
links_web_href	character
links_mobile_href	character
links_api_self_href	character
links_app_sportscenter_href	character
byline	character

parse_injuries

Injury report rows (league / team / athlete scoped).

Endpoints (3): athlete_injuries, injuries, team_injuries

col_name	type	description
id	character
display_name	character
injuries	character

parse_summary

Site v2 game summary dispatcher — returns 21 sub-frames.

Endpoints (1): summary

summary is a dispatcher: { parsed: true } returns an object of all 21 sub-frames keyed by section; { parsed: true, section: '<name>' } returns just that one. See Summary sub-frames below.

parse_items

Generic Core v2 paginated list — one row per item (often a $ref pointer).

Endpoints (59): athlete_awards, athlete_career_stats, athlete_contracts, athlete_eventlog, athlete_notes, athlete_records, athlete_seasons, athlete_statisticslog, athletes_index, awards, calendar, draft, event_broadcasts, event_competitor_leaders, event_competitors, event_leaders, event_odds, event_officials, event_play_personnel, event_probabilities, event_propbets, event_scoringplays, events, franchises, leaders_core, league_notes, positions, rankings, season_athletes, season_awards, season_draft_round_picks, season_freeagents, season_futures, season_group_children, season_group_teams, season_groups, season_powerindex, season_powerindex_leaders, season_qbr, season_qbr_week, season_recruits, season_teams, season_type_corrections, season_type_leaders, season_types, season_week_events, season_week_rankings, season_weeks, seasons, statistics_league, talentpicks, team_depthcharts, team_history, team_leaders, team_record, team_transactions, tournaments, transactions, venues

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

parse_single_entity

Generic Core v2 single resource — one row for the entity.

Endpoints (31): athlete_bio, athlete_core, athlete_hotzones, athlete_info, athlete_vs_athlete, award, coach, coach_record, coach_season, event, event_competition, event_competitor, event_competitor_record, event_official_detail, event_play, event_powerindex, event_predictor, event_situation, event_status, franchise, league_root, position, season_group, season_info, season_pointer, season_team, season_type, season_week, team, team_core, venue

Generic / dynamic passthrough — the column set varies by league and payload (e.g. Core v2 $ref items or a league-specific catalog). Call with { parsed: true } to inspect the columns for a given league.

Summary sub-frames

The summary dispatcher (parse_summary) yields these 21 sub-frames. Football (NFL / CFB) games additionally populate drives / drive_plays / scoring_plays; other sports return those as zero-row frames. Betting sections (against_the_spread / pickcenter / odds) are sparse in past-game captures.

boxscore_player

col_name	type	description
team_id	character	ESPN team id
team_abbreviation	character	Team abbreviation
team_display_name	character	Team display name
team_location	character
athlete_id	character	ESPN athlete id
athlete_display_name	character	Athlete display name
athlete_short_name	character	Athlete short name
athlete_jersey	character	Jersey number
athlete_position	character	Position abbreviation
starter	logical
active	logical
did_not_play	logical
ejected	logical
reason	character
minutes	character
points	character
field_goals_made_field_goals_attempted	character
three_point_field_goals_made_three_point_field_goals_attempted	character
free_throws_made_free_throws_attempted	character
rebounds	character
assists	character
turnovers	character
steals	character
blocks	character
offensive_rebounds	character
defensive_rebounds	character
fouls	character
plus_minus	character

boxscore_team

col_name	type	description
team_id	character	ESPN team id
team_abbreviation	character	Team abbreviation
team_display_name	character	Team display name
home_away	character	home or away
display_order	integer
stat_name	character	Statistic name
stat_label	character
stat_display_value	character	Formatted statistic value
stat_value	character	Numeric statistic value

plays

col_name	type	description
id	character
sequence_number	character
type_id	character
type_text	character
text	character
away_score	integer
home_score	integer
period_number	integer
period_display_value	character
clock_display_value	character
scoring_play	logical
score_value	integer
team_id	character	ESPN team id
participants	character
wallclock	character
shooting_play	logical
coordinate_x	integer
coordinate_y	integer
points_attempted	integer
short_description	character

winprobability

col_name	type	description
home_win_percentage	number
tie_percentage	integer
play_id	character

leaders

col_name	type	description
team_id	character	ESPN team id
team_abbreviation	character	Team abbreviation
category_name	character	Statistic category name
category_display_name	character
athlete_id	character	ESPN athlete id
athlete_display_name	character	Athlete display name
athlete_position	character	Position abbreviation
value	integer
display_value	character
main_stat_value	character
main_stat_label	character
summary	character

game_info

col_name	type	description
attendance	integer
venue_id	character
venue_guid	character
venue_full_name	character
venue_short_name	character
venue_address_city	character
venue_address_state	character
venue_grass	logical

officials

col_name	type	description
full_name	character
display_name	character
position_name	character
position_display_name	character
position_id	character
order	integer

header

col_name	type	description
id	character
uid	character
season_year	integer
season_current	logical
season_type	integer
time_valid	logical
competitions	character
links	character
league_id	character
league_uid	character
league_name	character
league_abbreviation	character
league_slug	character
league_is_tournament	logical
league_links	character
league_logos	character

season_series

col_name	type	description
type	character
title	character
description	character
summary	character
completed	logical
total_competitions	integer
series_label	character
series_score	character
short_summary	character
events	character

against_the_spread

Zero rows in the reference capture (football-only or sparse-in-past-games); the shape populates on a live game of the relevant sport.

standings

col_name	type	description
group_header	character
conference_header	character
division_header	character
team_id	character	ESPN team id
team_uid	character
team_location	character
games_behind	character
losses	character
streak	character
win_percent	character
wins	character

broadcasts

Zero rows in the reference capture (football-only or sparse-in-past-games); the shape populates on a live game of the relevant sport.

format

col_name	type	description
regulation_periods	integer
regulation_display_name	character
regulation_slug	character
regulation_clock	integer
overtime_display_name	character
overtime_slug	character
overtime_clock	integer

pickcenter

Zero rows in the reference capture (football-only or sparse-in-past-games); the shape populates on a live game of the relevant sport.

odds

Zero rows in the reference capture (football-only or sparse-in-past-games); the shape populates on a live game of the relevant sport.

article

col_name	type	description
id	integer
now_id	character
content_key	character
data_source_identifier	character
publishedkey	character
type	character
game_id	character
headline	character
description	character
link_text	character
categorized	character
originally_posted	character
last_modified	character
published	character
section	character
source	character
images	character
video	character
categories	character
keywords	character
story	character
premium	logical
is_live_blog	logical
links_web_href	character
links_mobile_href	character
links_api_self_href	character
links_app_sportscenter_href	character
allow_comments	logical
allow_search	logical
allow_content_reactions	logical

injuries

col_name	type	description
team_id	character	ESPN team id
team_uid	character
team_display_name	character	Team display name
team_abbreviation	character	Team abbreviation
team_links	character
team_logo	character
team_logos	character
injuries	character

news

col_name	type	description
id	integer
now_id	character
content_key	character
data_source_identifier	character
type	character
headline	character
description	character
last_modified	character
published	character
images	character
categories	character
premium	logical
links_web_href	character
links_mobile_href	character
links_api_self_href	character
links_app_sportscenter_href	character
byline	character

drives

col_name	type	description
id	character	ESPN id.
description	character	Human-readable description.
team_id	character	ESPN team id.
team_name	character	Team name.
team_abbreviation	character	Team abbreviation.
team_display_name	character	Team display name.
team_short_display_name	character
team_logos	character
start_period_type	character
start_period_number	integer
start_clock_display_value	character
start_yard_line	integer	Yard line at the start of the play.
start_text	character
end_period_type	character
end_period_number	integer
end_clock_display_value	character
end_yard_line	integer
end_text	character
time_elapsed_display_value	character
yards	integer	Net yards on the drive.
is_score	logical	Whether the drive ended in a score.
offensive_plays	integer	Number of offensive plays on the drive.
result	character	Drive result code.
short_display_result	character
display_result	character	Human-readable drive result.
plays	character	JSON list of play ids on the drive (unrolled in drive_plays).

drive_plays

col_name	type	description
drive_id	character	Parent drive id (join key to the drives frame).
drive_sequence	integer	1-based index of the play within its drive.
id	character	ESPN id.
sequence_number	character
type_id	character
type_text	character	Play type label.
text	character	Play description text.
away_score	integer	Away score after the play.
home_score	integer	Home score after the play.
period_number	integer	Quarter / period number.
clock_display_value	character	Game clock at the play (MM:SS).
scoring_play	logical	Whether the play resulted in a score.
priority	logical
modified	character
wallclock	character
team_participants	character
is_penalty	logical	Whether the play was a penalty.
stat_yardage	integer	Yards gained/lost on the play.
start_down	integer	Down at the start of the play.
start_distance	integer	Yards to go at the start of the play.
start_yard_line	integer	Yard line at the start of the play.
start_yards_to_endzone	integer
start_team_id	character
end_down	integer
end_distance	integer
end_yard_line	integer
end_yards_to_endzone	integer
end_team_id	character
is_turnover	logical	Whether the play was a turnover.
type_abbreviation	character
start_down_distance_text	character
start_short_down_distance_text	character
start_possession_text	character
end_down_distance_text	character
end_short_down_distance_text	character
end_possession_text	character
scoring_type_name	character
scoring_type_display_name	character
scoring_type_abbreviation	character
point_after_attempt_id	integer
point_after_attempt_text	character
point_after_attempt_abbreviation	character
point_after_attempt_value	integer

scoring_plays

col_name	type	description
id	character	ESPN id.
type_id	character
type_text	character	Play type label.
type_abbreviation	character
text	character	Play description text.
away_score	integer	Away score after the play.
home_score	integer	Home score after the play.
period_number	integer	Quarter / period number.
clock_value	integer
clock_display_value	character	Game clock at the play (MM:SS).
team_id	character	ESPN team id.
team_uid	character
team_display_name	character	Team display name.
team_abbreviation	character	Team abbreviation.
team_links	character
team_logo	character
team_logos	character
scoring_type_name	character
scoring_type_display_name	character
scoring_type_abbreviation	character