Home

Welcome to the espn-api wiki!

I am going to use this wiki as the main source for package documentation and a better explanation of package fields and functions.

If you can't find something or have a question please feel free to open a issue!

Getting Started

You will need your league id and year. For private leagues you will also need two more parameters; your swid and espn_s2 or username and password. I would suggest to still login with your credentials even if your league is public so that you will be able to use the recent activity feature.
This API currently supports Football and Basketball.

# Football Import
from espn_api.football import League
# Basketball Import
from espn_api.basketball import League

# public league
league = League(league_id=1245, year=2018)
# private league with cookies
league = League(league_id=1245, year=2018, espn_s2='ASCWDWheghjwwqfwjqhgjkjgegkje', swid='{03JFJHW-FWFWF-044G}')
# private league with username and password
league = League(league_id=1245, year=2018, username='userName', password='pass')
# debug mode
league = League(league_id=1245, year=2018, debug=True)

Check out Football or Basketball page to find out all the information you can get on your League!
You should only need to access the League Object to get all of the data you need.