ligue1 — Site API
24 endpoints on sdv.ligue1. 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).
espnLigue1AthleteBio
LIGUE1 — athlete bio (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/athletes/{athlete_id}/bio
| API param | JS | required | description |
|---|---|---|---|
{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.ligue1.espnLigue1AthleteBio({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_athlete_bio(...)
espnLigue1AthleteInfo
LIGUE1 — athlete info (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/athletes/{athlete_id}
| API param | JS | required | description |
|---|---|---|---|
{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.ligue1.espnLigue1AthleteInfo({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_athlete_info(...)
espnLigue1AthleteNews
LIGUE1 — athlete news (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/athletes/{athlete_id}/news
| API param | JS | required | description |
|---|---|---|---|
{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.ligue1.espnLigue1AthleteNews({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_athlete_news(...)
espnLigue1Calendar
LIGUE1 — calendar (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/calendar
| API param | JS | required | description |
|---|---|---|---|
| — | 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.ligue1.espnLigue1Calendar({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_calendar(...)
espnLigue1Conferences
LIGUE1 — conferences (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/groups
| API param | JS | required | description |
|---|---|---|---|
| — | 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.ligue1.espnLigue1Conferences({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_conferences(...)
espnLigue1Draft
LIGUE1 — draft (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/draft
| API param | JS | required | description |
|---|---|---|---|
| — | 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.ligue1.espnLigue1Draft({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_draft(...)
espnLigue1Injuries
LIGUE1 — injuries (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/injuries
| API param | JS | required | description |
|---|---|---|---|
| — | 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.ligue1.espnLigue1Injuries({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_injuries(...)
espnLigue1News
LIGUE1 — news (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/news
| API param | JS | required | description |
|---|---|---|---|
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.ligue1.espnLigue1News({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_news(...)
espnLigue1Scoreboard
LIGUE1 — scoreboard (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/scoreboard
| API param | JS | required | description |
|---|---|---|---|
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.ligue1.espnLigue1Scoreboard({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_scoreboard(...)
espnLigue1Standings
LIGUE1 — standings (ESPN site.api.espn.com (v2)).
Endpoint URL: GET https://site.api.espn.com/apis/v2/sports/soccer/fra.1/standings
| API param | JS | required | description |
|---|---|---|---|
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.ligue1.espnLigue1Standings({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_standings(...)
espnLigue1StatisticsLeague
LIGUE1 — statistics league (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/statistics
| API param | JS | required | description |
|---|---|---|---|
| — | 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.ligue1.espnLigue1StatisticsLeague({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_statistics_league(...)
espnLigue1Summary
LIGUE1 — summary (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/summary
| API param | JS | required | description |
|---|---|---|---|
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.ligue1.espnLigue1Summary({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_summary(...)
espnLigue1Team
LIGUE1 — team (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/teams/{team_id}
| API param | JS | required | description |
|---|---|---|---|
{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.ligue1.espnLigue1Team({ team_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_team(...)
espnLigue1TeamDepthcharts
LIGUE1 — team depthcharts (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/teams/{team_id}/depthcharts
| API param | JS | required | description |
|---|---|---|---|
{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.ligue1.espnLigue1TeamDepthcharts({ team_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_team_depthcharts(...)
espnLigue1TeamHistory
LIGUE1 — team history (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/teams/{team_id}/history
| API param | JS | required | description |
|---|---|---|---|
{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.ligue1.espnLigue1TeamHistory({ team_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_team_history(...)
espnLigue1TeamInjuries
LIGUE1 — team injuries (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/teams/{team_id}/injuries
| API param | JS | required | description |
|---|---|---|---|
{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.ligue1.espnLigue1TeamInjuries({ team_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_team_injuries(...)
espnLigue1TeamLeaders
LIGUE1 — team leaders (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/teams/{team_id}/leaders
| API param | JS | required | description |
|---|---|---|---|
{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.ligue1.espnLigue1TeamLeaders({ team_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_team_leaders(...)
espnLigue1TeamNews
LIGUE1 — team news (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/teams/{team_id}/news
| API param | JS | required | description |
|---|---|---|---|
{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.ligue1.espnLigue1TeamNews({ team_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_team_news(...)
espnLigue1TeamRecord
LIGUE1 — team record (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/teams/{team_id}/record
| API param | JS | required | description |
|---|---|---|---|
{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.ligue1.espnLigue1TeamRecord({ team_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_team_record(...)
espnLigue1TeamRoster
LIGUE1 — team roster (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/teams/{team_id}/roster
| API param | JS | required | description |
|---|---|---|---|
{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.ligue1.espnLigue1TeamRoster({ team_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_team_roster(...)
espnLigue1TeamSchedule
LIGUE1 — team schedule (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/teams/{team_id}/schedule
| API param | JS | required | description |
|---|---|---|---|
{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.ligue1.espnLigue1TeamSchedule({ team_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_team_schedule(...)
espnLigue1TeamTransactions
LIGUE1 — team transactions (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/teams/{team_id}/transactions
| API param | JS | required | description |
|---|---|---|---|
{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.ligue1.espnLigue1TeamTransactions({ team_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_team_transactions(...)
espnLigue1TeamsSite
LIGUE1 — teams site (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/teams
| API param | JS | required | description |
|---|---|---|---|
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.ligue1.espnLigue1TeamsSite({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_teams_site(...)
espnLigue1Transactions
LIGUE1 — transactions (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/fra.1/transactions
| API param | JS | required | description |
|---|---|---|---|
| — | 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.ligue1.espnLigue1Transactions({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_transactions(...)