ESPN
/cw/dtaijupiter/NoCsBack/dtai/pieterr/Projects/soccerdata/soccerdata/_common.py:466: UserWarning: Season id "2021" is ambiguous: interpreting as "20-21"
warnings.warn(msg)
Provides pd.DataFrames from JSON api available at http://site.api.espn.com.
Data will be downloaded as necessary and cached locally in
``~/soccerdata/data/ESPN``.
Parameters
----------
leagues : string or iterable, optional
IDs of leagues to include.
seasons : string, int or list, optional
Seasons to include. Supports multiple formats.
Examples: '16-17'; 2016; '2016-17'; [14, 15, 16]
proxy : 'tor' or or dict or list(dict) or callable, optional
Use a proxy to hide your IP address. Valid options are:
- "tor": Uses the Tor network. Tor should be running in
the background on port 9050.
- dict: A dictionary with the proxy to use. The dict should be
a mapping of supported protocols to proxy addresses. For example::
{
'http': 'http://10.10.1.10:3128',
'https': 'http://10.10.1.10:1080',
}
- list(dict): A list of proxies to choose from. A different proxy will
be selected from this list after failed requests, allowing rotating
proxies.
- callable: A function that returns a valid proxy. This function will
be called after failed requests, allowing rotating proxies.
no_cache : bool
If True, will not use cached data.
no_store : bool
If True, will not store downloaded data.
data_dir : Path
Path to directory where data will be cached.
Game schedule
|
|
|
date |
home_team |
away_team |
game_id |
league_id |
| league |
season |
game |
|
|
|
|
|
| ENG-Premier League |
2021 |
2019-08-09 Liverpool-Norwich City |
2019-08-09 19:00:00+00:00 |
Liverpool |
Norwich City |
541844 |
eng.1 |
| 2019-08-10 AFC Bournemouth-Sheffield United |
2019-08-10 14:00:00+00:00 |
AFC Bournemouth |
Sheffield United |
541840 |
eng.1 |
| 2019-08-10 Burnley-Southampton |
2019-08-10 14:00:00+00:00 |
Burnley |
Southampton |
541841 |
eng.1 |
| 2019-08-10 Crystal Palace-Everton |
2019-08-10 14:00:00+00:00 |
Crystal Palace |
Everton |
541839 |
eng.1 |
| 2019-08-10 Tottenham Hotspur-Aston Villa |
2019-08-10 16:30:00+00:00 |
Tottenham Hotspur |
Aston Villa |
541837 |
eng.1 |
Match sheet data
|
|
|
|
is_home |
venue |
attendance |
capacity |
roster |
fouls_committed |
yellow_cards |
red_cards |
offsides |
won_corners |
saves |
possession_pct |
total_shots |
shots_on_target |
| league |
season |
game |
team |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| ENG-Premier League |
2021 |
2020-07-26 West Ham United-Aston Villa |
Aston Villa |
False |
None |
0 |
None |
[{'active': True, 'starter': True, 'jersey': '... |
16 |
2 |
0 |
0 |
0 |
3 |
63 |
10 |
1 |
| West Ham United |
True |
None |
0 |
None |
[{'active': True, 'starter': True, 'jersey': '... |
13 |
1 |
0 |
1 |
7 |
0 |
37 |
13 |
4 |
Line ups
|
|
|
|
|
is_home |
position |
formation_place |
sub_in |
sub_out |
appearances |
fouls_committed |
fouls_suffered |
own_goals |
red_cards |
sub_ins |
yellow_cards |
goal_assists |
shots_on_target |
total_goals |
total_shots |
goals_conceded |
saves |
shots_faced |
offsides |
| league |
season |
game |
team |
player |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| ENG-Premier League |
2021 |
2020-07-26 West Ham United-Aston Villa |
Aston Villa |
Anwar El Ghazi |
False |
Substitute |
0 |
90 |
end |
1.0 |
0.0 |
0.0 |
0.0 |
0.0 |
1.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
NaN |
0.0 |
0.0 |
| Conor Hourihane |
False |
Center Left Midfielder |
10 |
start |
76 |
1.0 |
0.0 |
1.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
NaN |
0.0 |
0.0 |
| Douglas Luiz |
False |
Defensive Midfielder |
4 |
start |
end |
1.0 |
2.0 |
2.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
1.0 |
NaN |
0.0 |
0.0 |
| Ezri Konsa |
False |
Center Right Defender |
5 |
start |
end |
1.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
1.0 |
NaN |
0.0 |
0.0 |
| Frédéric Guilbert |
False |
Right Back |
2 |
start |
76 |
1.0 |
1.0 |
1.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
0.0 |
NaN |
0.0 |
0.0 |