soccer — Site API

24 endpoints on sdv.soccer. Each is exposed under a camelCase canonical name and a snake_case alias (py/R parity), accepts snake_case or camelCase params, and returns raw ESPN JSON by default ({ parsed: true } for tidy rows).

espnSoccerAthleteBio

SOCCER — athlete bio (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/athletes/{athlete_id}/bio

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
{athlete_id}	athlete_id	yes	path parameter
—	parsed	no	return tidy rows instead of raw JSON

Returns: raw ESPN Dict by default. With { parsed: true } the payload is routed through its parser (parse_single_entity); the column set varies by league — see ESPN parsed returns.

Example:

await sdv.soccer.espnSoccerAthleteBio({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_athlete_bio(...)

espnSoccerAthleteInfo

SOCCER — athlete info (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/athletes/{athlete_id}

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
{athlete_id}	athlete_id	yes	path parameter
—	parsed	no	return tidy rows instead of raw JSON

Returns: raw ESPN Dict by default. With { parsed: true } the payload is routed through its parser (parse_single_entity); the column set varies by league — see ESPN parsed returns.

Example:

await sdv.soccer.espnSoccerAthleteInfo({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_athlete_info(...)

espnSoccerAthleteNews

SOCCER — athlete news (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/athletes/{athlete_id}/news

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
{athlete_id}	athlete_id	yes	path parameter
—	parsed	no	return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_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

Example:

await sdv.soccer.espnSoccerAthleteNews({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_athlete_news(...)

espnSoccerCalendar

SOCCER — calendar (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/calendar

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
—	parsed	no	return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_items):

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

Example:

await sdv.soccer.espnSoccerCalendar({ league: 'eng.1' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_calendar(...)

espnSoccerConferences

SOCCER — conferences (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/groups

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
—	parsed	no	return tidy rows instead of raw JSON

Returns: raw ESPN Dict by default. With { parsed: true } the payload is routed through its parser (parse_groups); the column set varies by league — see ESPN parsed returns.

Example:

await sdv.soccer.espnSoccerConferences({ league: 'eng.1' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_conferences(...)

espnSoccerDraft

SOCCER — draft (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/draft

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
—	parsed	no	return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_items):

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

Example:

await sdv.soccer.espnSoccerDraft({ league: 'eng.1' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_draft(...)

espnSoccerInjuries

SOCCER — injuries (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/injuries

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
—	parsed	no	return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_injuries):

col_name	type	description
id	character
display_name	character
injuries	character

Example:

await sdv.soccer.espnSoccerInjuries({ league: 'eng.1' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_injuries(...)

espnSoccerNews

SOCCER — news (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/news

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
limit	limit	no	query parameter (default 50)
—	parsed	no	return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_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

Example:

await sdv.soccer.espnSoccerNews({ league: 'eng.1' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_news(...)

espnSoccerScoreboard

SOCCER — scoreboard (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/scoreboard

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
dates	dates	no	query parameter
week	week	no	query parameter
seasontype	season_type	no	query parameter
groups	groups	no	query parameter
limit	limit	no	query parameter (default 500)
—	parsed	no	return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_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

Example:

await sdv.soccer.espnSoccerScoreboard({ league: 'eng.1' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_scoreboard(...)

espnSoccerStandings

SOCCER — standings (ESPN site.api.espn.com (v2)).

Endpoint URL: GET https://site.api.espn.com/apis/v2/sports/soccer/{league}/standings

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
season	season	no	query parameter
group	group	no	query parameter
type	standings_type	no	query parameter
—	parsed	no	return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_standings):

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

Example:

await sdv.soccer.espnSoccerStandings({ league: 'eng.1' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_standings(...)

espnSoccerStatisticsLeague

SOCCER — statistics league (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/statistics

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
—	parsed	no	return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_items):

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

Example:

await sdv.soccer.espnSoccerStatisticsLeague({ league: 'eng.1' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_statistics_league(...)

espnSoccerSummary

SOCCER — summary (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/summary

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
event	event_id	no	query parameter
—	parsed	no	return tidy rows instead of raw JSON
—	section	no	with parsed, return one named sub-frame (e.g. boxscore, plays, winprobability) instead of all

Returns: raw ESPN Dict by default. With { parsed: true } the summary dispatcher returns an object of 21 sub-frames keyed by section ({ parsed: true, section: '<name>' } for one); see ESPN parsed returns.

Example:

await sdv.soccer.espnSoccerSummary({ league: 'eng.1' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_summary(...)

espnSoccerTeam

SOCCER — team (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/teams/{team_id}

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
{team_id}	team_id	yes	path parameter
—	parsed	no	return tidy rows instead of raw JSON

Returns: raw ESPN Dict by default. With { parsed: true } the payload is routed through its parser (parse_single_entity); the column set varies by league — see ESPN parsed returns.

Example:

await sdv.soccer.espnSoccerTeam({ team_id: '…' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_team(...)

espnSoccerTeamDepthcharts

SOCCER — team depthcharts (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/teams/{team_id}/depthcharts

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
{team_id}	team_id	yes	path parameter
—	parsed	no	return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_items):

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

Example:

await sdv.soccer.espnSoccerTeamDepthcharts({ team_id: '…' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_team_depthcharts(...)

espnSoccerTeamHistory

SOCCER — team history (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/teams/{team_id}/history

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
{team_id}	team_id	yes	path parameter
—	parsed	no	return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_items):

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

Example:

await sdv.soccer.espnSoccerTeamHistory({ team_id: '…' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_team_history(...)

espnSoccerTeamInjuries

SOCCER — team injuries (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/teams/{team_id}/injuries

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
{team_id}	team_id	yes	path parameter
—	parsed	no	return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_injuries):

col_name	type	description
id	character
display_name	character
injuries	character

Example:

await sdv.soccer.espnSoccerTeamInjuries({ team_id: '…' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_team_injuries(...)

espnSoccerTeamLeaders

SOCCER — team leaders (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/teams/{team_id}/leaders

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
{team_id}	team_id	yes	path parameter
—	parsed	no	return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_items):

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

Example:

await sdv.soccer.espnSoccerTeamLeaders({ team_id: '…' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_team_leaders(...)

espnSoccerTeamNews

SOCCER — team news (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/teams/{team_id}/news

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
{team_id}	team_id	yes	path parameter
limit	limit	no	query parameter (default 50)
—	parsed	no	return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_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

Example:

await sdv.soccer.espnSoccerTeamNews({ team_id: '…' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_team_news(...)

espnSoccerTeamRecord

SOCCER — team record (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/teams/{team_id}/record

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
{team_id}	team_id	yes	path parameter
—	parsed	no	return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_items):

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

Example:

await sdv.soccer.espnSoccerTeamRecord({ team_id: '…' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_team_record(...)

espnSoccerTeamRoster

SOCCER — team roster (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/teams/{team_id}/roster

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
{team_id}	team_id	yes	path parameter
—	parsed	no	return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_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

Example:

await sdv.soccer.espnSoccerTeamRoster({ team_id: '…' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_team_roster(...)

espnSoccerTeamSchedule

SOCCER — team schedule (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/teams/{team_id}/schedule

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
{team_id}	team_id	yes	path parameter
season	season	no	query parameter
—	parsed	no	return tidy rows instead of raw JSON

Returns: raw ESPN Dict by default. With { parsed: true } the payload is routed through its parser (parse_team_schedule); the column set varies by league — see ESPN parsed returns.

Example:

await sdv.soccer.espnSoccerTeamSchedule({ team_id: '…' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_team_schedule(...)

espnSoccerTeamTransactions

SOCCER — team transactions (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/teams/{team_id}/transactions

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
{team_id}	team_id	yes	path parameter
—	parsed	no	return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_items):

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

Example:

await sdv.soccer.espnSoccerTeamTransactions({ team_id: '…' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_team_transactions(...)

espnSoccerTeamsSite

SOCCER — teams site (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/teams

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
limit	limit	no	query parameter (default 1000)
—	parsed	no	return tidy rows instead of raw JSON

Returns: raw ESPN Dict by default. With { parsed: true } the payload is routed through its parser (parse_teams); the column set varies by league — see ESPN parsed returns.

Example:

await sdv.soccer.espnSoccerTeamsSite({ league: 'eng.1' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_teams_site(...)

espnSoccerTransactions

SOCCER — transactions (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/{league}/transactions

API param	JS	required	description
league	league	no	ESPN league slug override (default eng.1)
—	parsed	no	return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_items):

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

Example:

await sdv.soccer.espnSoccerTransactions({ league: 'eng.1' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_transactions(...)