Skip to content

calestini/sportmonks_api

master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 

Sportmonks API

Unnoficial Python API to retrieve soccer data from Sportmonks. Disclaimer: I have no relationship with Sportmonks and this project is simply to aid those who work with their soccer API.

Using the module

In order to use the module a user token is needed. Bear in mind the results might differ based on the subscription plan. Results hereby shown are for the full subscription pagkage.

For more information on the details and scope of Sportmonks API, please refer to its official documentation.

Installation

  • Cloning Repo
git clone https://github.com/calestini/sportmonks_api.git

Dependencies

Import module

>>> import sportmonks_calls as sm

Example

Load features class

>>> fixtures = sm.Fixtures(sportmonks_token)

Query all fixtures by specific date

>>> fixture_date = '2017-10-10'
>>> fixtures.by_date(fixture_date)
>>> print (fixtures.request.results)
[{'aggregate_id': None,
  'attendance': None,
  'coaches': {'localteam_coach_id': None, 'visitorteam_coach_id': None},
  'commentaries': True,
  'deleted': False,
  'formations': {'localteam_formation': '4-4-2',
   'visitorteam_formation': '4-2-3-1'},
  'group_id': None,
  'id': 236705,
  'league_id': 720,
  'localteam_id': 18701,
  'pitch': None,
  'referee_id': 3,
  'round_id': 28849,
  'scores': {'et_score': None,
   'ft_score': '2-0',
   'ht_score': '1-0',
   'localteam_pen_score': None,
   'localteam_score': 2,
   'visitorteam_pen_score': None,
   'visitorteam_score': 0},
  'season_id': 898,
  'stage_id': 1753,
  'standings': {'localteam_position': 2, 'visitorteam_position': 1},
  'time': {'added_time': None,
   'extra_minute': None,
   'injury_time': 3,
   'minute': 90,
   'second': None,
   'starting_at': {'date': '2017-10-10',
    'date_time': '2017-10-10 18:45:00',
    'time': '18:45:00',
    'timestamp': 1507661100,
    'timezone': 'UTC'},
   'status': 'FT'},
  'venue_id': 8412,
  'visitorteam_id': 18708,
  'weather_report': None,
  'winning_odds_calculated': True}]

Documentation

Every endpoint is a class, and below are the classes available:

Endpoint Class Methods Mapped Level (0-100)
Fixture ... ...
... Pre_Match_Odds ... ...
... Continents ... ...
... Countries ... ...
... Leagues ... ...
... Seasons ... ...
... Commentaries ... ...
... Videos ... ...
... Head2Head ... ...
... TVStations ... ...
... Standings ... ...
... Teams ... ...
... Topscorers ... ...
... Venues ... ...
... Rounds ... ...
... In_Play_Odds ... ...
... Players ... ...
... Bookmakers ... ...
... Team_Squads ... ...

About

Python wrapper for SportMonks soccer API

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages