Skip to main content

A client library for the REST API

Project description

Documentation Status Travis CI Status

pyfootball is a client library for written in Python.

You can familiarize yourself with pyfootball’s API with the documentation.


  • A valid API key for football-data. You can request for one at

  • Python 3.5+

  • The requests library. pip should handle this for you when installing pyfootball.


pip install pyfootball

Example Usage

>>> import pyfootball
>>> f = pyfootball.Football(api_key='your_api_key')
>>> bayern = f.get_team(5)
>>> bayern.market_value
582,225,000 €


If you encounter any bugs, please let me know by creating an issue or tweeting at me @timorthi.


Please see the repository’s CONTRIBUTING file.


The project is licensed under the MIT license.

Project details

Download files

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

Source Distribution

pyfootball-1.0.1.tar.gz (8.5 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page