Fantasy-Premier-League

A FPL library that gets all the basic stats for each player, gw-specific data for each player and season history of each player

How to CIte this dataset?

BibTeX:

@misc{anand2016fantasypremierleague,
  title = {{FPL Historical Dataset}},
  author = {Anand, Vaastav},
  year = {2022},
  howpublished = {Retrieved August 2022 from \url{https://github.com/vaastav/Fantasy-Premier-League/}}
}

Acknowledgement

rin-hairie for adding master team lists and merge scripts
ergest for adding merged_gw.csv files for 2016-17 and 2017-18 seasons
BDooley11 for providing top managers script
speeder1987 for providing 2018/19 fixtures.csv file
ravgeetdhillon for github actions automation for data update
kz4killua for fixing GW37 data for the 21-22 season
SaintJuniper for id-dictionary update for the 21-22 season

FAQ

Data Structure

The data folder contains the data from past seasons as well as the current season. It is structured as follows:

season/cleaned_players.csv : The overview stats for the season
season/gws/gw_number.csv : GW-specific stats for the particular season
season/gws/merged_gws.csv : GW-by-GW stats for each player in a single file
season/players/player_name/gws.csv : GW-by-GW stats for that specific player
season/players/player_name/history.csv : Prior seasons history stats for that specific player.

Player Position Data

In players_raw.csv, element_type is the field that corresponds to the position. 1 = GK 2 = DEF 3 = MID 4 = FWD

Errata

GW35 expected points data is wrong (all values are 0).

Contributing

If you feel like there is some data that is missing which you would like to see, then please feel free to create a PR or create an issue highlighting what is missing and what you would like to be added
If you have access to old data (pre-2016) then please feel free to create Pull Requests adding the data to the repo or create an issue with links to old data and I will add them myself.

Using

If you use data from here for your website or blog posts, then I would humbly request that you please add a link back to this repo as the data source (and I would in turn add a link to your post/site as a notable usage of this repo).

Downloading Your Team Data

You can download the data for your team by executing the following steps:

python teams_scraper.py <team_id>
#Eg: python teams_scraper.py 4582

This will create a new folder called "team_<team_id>_data18-19" with individual files of all the important data

Notable Usages of this Repository

Name		Name	Last commit message	Last commit date
Latest commit History 454 Commits
data		data
reports		reports
team_4582_data18_19		team_4582_data18_19
.gitignore		.gitignore
FUNDING.yml		FUNDING.yml
LICENSE		LICENSE
README.md		README.md
cleaners.py		cleaners.py
collector.py		collector.py
deprecated_script.py		deprecated_script.py
fbref.py		fbref.py
gameweek.py		gameweek.py
getters.py		getters.py
global_merger.py		global_merger.py
global_scraper.py		global_scraper.py
lateriser_report_1920.pdf		lateriser_report_1920.pdf
magnus_report_1920.pdf		magnus_report_1920.pdf
mergers.py		mergers.py
new_position_checker.py		new_position_checker.py
parsers.py		parsers.py
requirements.txt		requirements.txt
schedule.py		schedule.py
teams_scraper.py		teams_scraper.py
top_managers.py		top_managers.py
top_players.py		top_players.py
understat.py		understat.py
utility.py		utility.py
vaastav_report_1920.pdf		vaastav_report_1920.pdf

License

vaastav/Fantasy-Premier-League

Folders and files

Latest commit

History

Repository files navigation

Fantasy-Premier-League

How to CIte this dataset?

Acknowledgement

FAQ

Data Structure

Player Position Data

Errata

Contributing

Using

Downloading Your Team Data

Notable Usages of this Repository

About

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Languages