understat

library0.1.14pypypiunverified

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.

analytics productivity

pip install understat

github ↗homepage ↗

INSTALL

IMPORT

SIG · UNDERSTAT

understat

analyticspythonv0.1.14

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Understat

✓ from understat import Understat

✗ import understat

Wrong import gives module object, not class.

Fetch league data from Understat using async context manager.

import asyncio from understat import Understat async def main(): async with Understat() as understat: leagues = await understat.get_league("EPL", 2019) print(leagues) asyncio.run(main())

Debug

Known issues

breakingThe entire library is built on async/await. Calling methods synchronously will raise errors.

fix

Always use async/await with asyncio or an event loop.

affects: ALL

gotchaUnderstat.com may block requests or change its API. The library might break without notice.

fix

Check the GitHub repo for updates or consider caching data.

affects: ALL

deprecatedThe library has not been updated since 2018; Python 3.9+ may have compatibility issues.

fix

Use Python 3.8 or below, or pin aiohttp to a compatible version.

affects: ALL

Upgrade

Version history

0.1.14latest on PyPI · released Dec 16, 2025

Audit

Dependencies

aiohttprequiredAsync HTTP requests

asynciooptionalAsync event loop

Agent activity

42 hits · last 30 days

node

Amazon

Anthropic

OpenAI (training)

Resources

githubhttps://github.com/amosbastian/fpl ↗

homepagehttps://github.com/amosbastian/understat ↗