<h1 align="center">EasySoccerData</h1> <p align="center"> <img alt="PyPI - Version" src="https://img.shields.io/pypi/v/EasySoccerData?color=00329e"> <img alt="Pepy Total Downloads" src="https://img.shields.io/pepy/dt/EasySoccerData?color=009903"> <img alt="GitHub License" src="https://img.shields.io/github/license/manucabral/easysoccerdata"> <img alt="GitHub Actions Workflow Status" src="https://img.shields.io/github/actions/workflow/status/manucabral/easysoccerdata/pylint.yml"> </p> <p align="center"> A simple python package for extracting real-time soccer/football data from diverse online sources, providing essential statistics and insights. </p>

[!IMPORTANT]
Currently in the early development phase. Please take this into consideration.

Installation

pip install EasySoccerData

Usage

Sofascore

import esd

client = esd.SofascoreClient()
events = client.get_events(live=True)
for event in events:
    print(event)

How to search for matches, teams, tournaments, and players

How to get tournament brackets

How to get live match statistics

Check out Sofascore module examples

FBRef

import esd

client = esd.FBrefClient()
matchs = client.get_matchs()
for match in matchs:
    print(match)

Check out FBref module examples

Promiedos

import esd

client = esd.PromiedosClient()
events = client.get_events()
for event in events:
    print(event)

Check out Promiedos module examples

Demo

Simple demonstration of a live table using Sofascore module (see source code)

<p align="center"> <img src="https://github.com/manucabral/EasySoccerData/blob/main/assets/sofascore-live-table.gif" width="550" title="LiveTableUsingSofascore"> </p>

Documentation

For the full documentation, please visit the Documentation Page

If you have any questions or need further assistance, feel free to open an issue.

Supported modules

| Name | Implemented | | :--- | :---: | | Sofascore | 90% | | FBref | 10% | | Promiedos | 70% |

Keep in mind that it is still under active development.

Disclaimer

The data provided in this repository is gathered from various external sources and is intended solely for informational purposes. This software is distributed "as-is," without any warranties or guarantees. Users are solely responsible for ensuring that their use of this data complies with the terms of service of the respective data sources and all applicable laws.

The developers of this project assume no liability for any misuse, legal issues, or damages arising from the use of the data or software.

Constributions

All constributions, bug reports or fixes and ideas are welcome.