soccer — Web API
5 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).
espnSoccerAthleteGamelog
SOCCER — athlete gamelog (ESPN site.web.api.espn.com (web v3)).
Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/soccer/{league}/athletes/{athlete_id}/gamelog
| API param | JS | required | description |
|---|---|---|---|
league | league | no | ESPN league slug override (default eng.1) |
{athlete_id} | athlete_id | yes | path parameter |
season | season | no | query parameter |
| — | parsed | no | return tidy rows instead of raw JSON |
Returns (with { parsed: true }, via parse_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 |
Example:
await sdv.soccer.espnSoccerAthleteGamelog({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_athlete_gamelog(...)
espnSoccerAthleteOverview
SOCCER — athlete overview (ESPN site.web.api.espn.com (web v3)).
Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/soccer/{league}/athletes/{athlete_id}/overview
| 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_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 |
Example:
await sdv.soccer.espnSoccerAthleteOverview({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_athlete_overview(...)
espnSoccerAthleteSplits
SOCCER — athlete splits (ESPN site.web.api.espn.com (web v3)).
Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/soccer/{league}/athletes/{athlete_id}/splits
| API param | JS | required | description |
|---|---|---|---|
league | league | no | ESPN league slug override (default eng.1) |
{athlete_id} | athlete_id | yes | path parameter |
season | season | no | query parameter |
| — | parsed | no | return tidy rows instead of raw JSON |
Returns (with { parsed: true }, via parse_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 |
Example:
await sdv.soccer.espnSoccerAthleteSplits({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_athlete_splits(...)
espnSoccerAthleteStats
SOCCER — athlete stats (ESPN site.web.api.espn.com (web v3)).
Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/soccer/{league}/athletes/{athlete_id}/stats
| API param | JS | required | description |
|---|---|---|---|
league | league | no | ESPN league slug override (default eng.1) |
{athlete_id} | athlete_id | yes | path parameter |
season | season | no | query parameter |
| — | parsed | no | return tidy rows instead of raw JSON |
Returns (with { parsed: true }, via parse_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 |
Example:
await sdv.soccer.espnSoccerAthleteStats({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_athlete_stats(...)
espnSoccerLeaders
SOCCER — leaders (ESPN site.web.api.espn.com (web v3)).
Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/soccer/{league}/statistics/byathlete
| API param | JS | required | description |
|---|---|---|---|
league | league | no | ESPN league slug override (default eng.1) |
category | category | no | query parameter |
season | season | no | query parameter |
seasontype | season_type | no | query parameter |
limit | limit | no | query parameter (default 50) |
page | page | no | query parameter (default 1) |
sort | sort | no | query parameter |
| — | parsed | no | return tidy rows instead of raw JSON |
Returns (with { parsed: true }, via parse_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 |
Example:
await sdv.soccer.espnSoccerLeaders({ league: 'eng.1' });
// snake_case alias (py/R parity): sdv.soccer.espn_soccer_leaders(...)