Skip to main content

Python Binding (API wrapper) for the Football API.

Project description


A simple wrapper around the football API provided by @API-SPORTS. For full documentation on the API endpoints and subscription details, refer to API-FOOTBALL. Usage of this package requires any level of subscription and an API-KEY.


pip install footballapiclient


Create the client

from  footballAPIClient  import  footballAPI

fp  =  footballAPI.FootballAPI("api-sports", api_key="YOUR_API_KEY")

- account_type: Indicates weather the account is used from Rapid-API or from dashboard. It consists of values: "rapid-api", and "api-sports", passing values other than this will raise an error.
- api_key: Valid API key required, or, it must be accessible via API_KEY environment variable.


Getting the country data by calling the countries API.


name: (optional) The name of the country  
code:  (optional) The Alpha2 code of the country 
search:  (optional) The name of the country
:return: Returns the Country json schema


{ "get": "countries", "parameters": { "name": "england" }, "errors": [], "results": 1, "paging": { "current": 1, "total": 1 }, "response": [ { "name": "England", "code": "GB", "flag": "" } ] }

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

footballapiclient-0.0.4.tar.gz (14.4 kB view hashes)

Uploaded source

Built Distribution

footballapiclient-0.0.4-py3-none-any.whl (13.2 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page