Skip to content
Python wrapper for the Everysport API
Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
dist
everysport
examples
test
.gitignore
README.md
setup.py

README.md

Everysport Python

A Python wrapper for the Everysport API. The API lets you access events, standings and results from everysport.com.

Note: This is NOT an official Everysport SDK and is subject to change at any time.

Installation

Using PIP:

pip install everysport

Or download and unpack the distribution:

python setup.py install

Getting Started

To start you need an API-key from support@everysport.com. See instructions and usage terms at https://github.com/menmo/everysport-api-documentation.

With the API-key you create an Everysport instance.

APIKEY = os.environ['EVERYSPORT_APIKEY'] 

es = everysport.Everysport(APIKEY)

Getting a specific League

To get a specific league, you need the League ID from everysport.com: Navigate to the league page on eversport.com, the League ID is in the URL. This is the URL for Allsvenskan:

http://www.everysport.com/sport/fotboll/fotbollsserier-2013/allsvenskan-herr/allsvenskan/57973

The League ID for Allsvenskan is 57973.

allsvenskan = es.get_league(57973) # Allsvenskan

print allsvenskan.league

Leagues like NHL, which has many different groups, are more complicated:

nhl = es.get_standings(58878)

for group_type in nhl.grouptypes: # e.g. 'conference'
    print group_type.upper()    
    for group_name in nhl.get_groupnames_by_type(group_type):         
        print nhl.get_group_by_name(group_name)

Note that the League ID is different for every season!

Queries

Create queries to get list of leagues and events. There are two types of queries:

  • everysport.events
  • everysport.leagues

From events you get query object that lets you select what kind of events you want to fetch, for example:

  • today()
  • ongoing()
  • fromdate()
  • todate()
  • round()
  • finished()
  • upcoming()
  • leagues()
  • To filter a specific sport, you can use football(), hockey(), etc.

For example:

football_today = es.events.football().today()

To fetch the events, use the query as an iterator, as in

for event in football_today:
	print event

Or use fetch to get all back as one list (not recommended, the number of events may be large for some leagues):

all_hockey = es.events.leagues(everysport.SHL, everysport.NHL).fetch()

In the same way you can query for leagues using leagues.

for league in es.leagues.hockey():
    print league

The leagues are the current leagues, as seen on everysport.com!

You can’t perform that action at this time.