Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

A Python wrapper for

Project description

A Python package for

Installing understat

The recommended way to install understat is via pip.

pip install understat

To install it directly from GitHub you can do the following:

git clone git://

You can also install a .tar file or .zip file

$ curl -OL
$ curl -OL # Windows

Once it has been downloaded you can easily install it using pip::

$ cd understat
$ pip install .


An example of using Understat can be found below:

import asyncio
import json

import aiohttp

from understat import Understat

async def main():
    async with aiohttp.ClientSession() as session:
        understat = Understat(session)
        data = await understat.get_league_players("epl", 2018, {"team_title": "Manchester United"})

if __name__ == "__main__":
    loop = asyncio.get_event_loop()


  1. Fork the repository on GitHub.
  2. Run the tests with pytest tests/ to confirm they all pass on your system. If the tests fail, then try and find out why this is happening. If you aren't able to do this yourself, then don't hesitate to either create an issue on GitHub, or send an email to
  3. Either create your feature and then write tests for it, or do this the other way around.
  4. Run all tests again with with pytest tests/ to confirm that everything still passes, including your newly added test(s).
  5. Create a pull request for the main repository's master branch.


Documentation and examples for understat can be found at

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for understat, version 0.1.2
Filename, size File type Python version Upload date Hashes
Filename, size understat-0.1.2-py3-none-any.whl (6.6 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size understat-0.1.2.tar.gz (4.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page