{"id":46720,"library":"understat","title":"Understat","description":"A Python wrapper for the football statistics website Understat.com. Provides access to shot data, player statistics, team statistics, and match data. Version 0.1.14, released in 2018; no recent activity.","status":"active","version":"0.1.14","language":"python","source_language":"en","source_url":"https://github.com/amosbastian/understat","tags":["football","soccer","stats","scraping"],"install":[{"cmd":"pip install understat","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Async HTTP requests","package":"aiohttp","optional":false},{"reason":"Async event loop","package":"asyncio","optional":true}],"imports":[{"note":"Wrong import gives module object, not class.","wrong":"import understat","symbol":"Understat","correct":"from understat import Understat"}],"quickstart":{"code":"import asyncio\nfrom understat import Understat\n\nasync def main():\n    async with Understat() as understat:\n        leagues = await understat.get_league(\"EPL\", 2019)\n        print(leagues)\n\nasyncio.run(main())\n","lang":"python","description":"Fetch league data from Understat using async context manager."},"warnings":[{"fix":"Always use async/await with asyncio or an event loop.","message":"The entire library is built on async/await. Calling methods synchronously will raise errors.","severity":"breaking","affected_versions":"ALL"},{"fix":"Check the GitHub repo for updates or consider caching data.","message":"Understat.com may block requests or change its API. The library might break without notice.","severity":"gotcha","affected_versions":"ALL"},{"fix":"Use Python 3.8 or below, or pin aiohttp to a compatible version.","message":"The library has not been updated since 2018; Python 3.9+ may have compatibility issues.","severity":"deprecated","affected_versions":"ALL"}],"env_vars":null,"search_vec":"'0.1.14':24 '2018':27 'access':12 'activ':30 'data':15,22 'footbal':7,31 'match':21 'player':16 'provid':11 'python':3 'recent':29 'releas':25 'scrape':34 'shot':14 'soccer':32 'stat':33 'statist':8,17,19 'team':18 'understat':1 'understat.com':10 'version':23 'websit':9 'wrapper':4","created_at":"2026-06-07T13:01:18.184689+00:00","updated_at":"2026-06-07T13:01:18.184689+00:00","problems":{"verify_error":"× Failed to build `aiohttp==3.8.3`\n  ├─▶ The build backend returned an error\n  ╰─▶ Call to `setuptools.build_meta.build_wheel` failed (exit status: 1)\n\n      [stdout]\n      running bdist_wheel\n      running build\n      running build_py\n      creating build/lib.linux-x86_64-cpython-312/aiohttp\n      "},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/amosbastian/understat","github":"https://github.com/amosbastian/fpl","docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["analytics","productivity"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"install_fail","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-06","install_tag":null}}