Skip to main content

A simple python wrapper to get soccer odds

Project description


PyPI version Code style: black

soccerapi (Application Programming Interface) is a simple wrapper build on top of some bookmakers (888sport, bet365 and Unibet) in order to get data about soccer (aka football) odds using python commands.

⚽️ The goal

The goal of the project is provided an enjoyable way to get odds data for different soccer leagues. Usually, if someone wants to get these types of data, have to build by him self (and from scratch) a program able to scrape the betting site or use some kind paid API. Soccer API try to address this problem.

💡 The philosophy

Keep it simple. Simple API, simple http requests, few dependencies. In the past I have tried to build some heavy framework able to scraping site (using selenium able to handle complex JavaScript): was an unmaintainable nightmare.

📘 The documentation

The following section contain all the useful information to use this API at its best. Read it carefully.


Use your favorite python package manager (like pip, pipenv, poetry). For example if you use pip type in your terminal:

pip install soccerapi

Alternatively, if you want a kind of testing/developing setup, you can install Soccer API directly from source code by first cloning the repository from github and then install dev dependencies (poetry is required)

git clone
cd soccerapi
poetry install

and then activate the environment

poetry shell


Import the soccerapi bookmaker, define the api variable and request odds.

from soccerapi.api import Api888Sport
# from soccerapi.api import ApiUnibet
# from soccerapi.api import ApiBet365

api = Api888Sport()
url = ''
odds = api.odds(url)

    'time': '2020-01-12T19:45:00Z'
    'home_team': 'Roma',
    'away_team': 'Juventus',
    'both_teams_to_score': {'no': 2380, 'yes': 1560},
    'double_chance': {'12': 1320, '1X': 1710, '2X': 1360},
    'full_time_resut': {'1': 3200, '2': 2160, 'X': 3450},


    'time': '2020-01-13T19:45:00Z'
    'home_team': 'Parma',
    'away_team': 'Lecce',
    'both_teams_to_score': {'no': 2280, 'yes': 1600},
    'double_chance': {'12': 1270, '1X': 1270, '2X': 1960},
    'full_time_resut': {'1': 1850, '2': 3850, 'X': 3800},

The odds method return a list of next events of the request competition (in the example: the url points to italy-serie_a, try to open on your browser). To get these url, open the bookmaker site and browser to competitions you want to scrape: that's the urls you have to pass to odds().

For example urls for england-premier_league are:

  • bet365
  • 888sport
  • unibet

(note that these are urls that works for me, maybe your urls are not .it but .com)

Country restriction

The regulation of online gambling varies from country to country. There are different versions of the betting site depending on the provenience of your http request. Moreover, most bookmakers implement some kind of VPN detection that block VPN-http requests. Due to this constrains it's difficult to test soccerapi for worldwide usability. Here is reported some results about bookmaker accessibility from various country.

bet365 888sport / unibet
accessible :it: :brazil: :us: :canada: :australia: :brazil: :switzerland: :it: :de: :denmark: :es: :finland: :jp: :netherlands: :norway: :sweden: :ireland: :india: :singapore: :hong_kong: :new_zealand: :mexico: :romania:
inaccessible :fr: :uk:


If you like to contribute to the project read

Project details

Download files

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

Files for soccerapi, version 0.6.3
Filename, size File type Python version Upload date Hashes
Filename, size soccerapi-0.6.3-py3-none-any.whl (10.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size soccerapi-0.6.3.tar.gz (10.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page