Skip to main content

EasySoccerData

PyPI - Version Pepy Total Downloads GitHub License GitHub Actions Workflow Status

A simple python package for extracting real-time soccer/football data from diverse online sources, providing essential statistics and insights.

[!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)

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.

Metadata

Release files for EasySoccerData 0.0.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for EasySoccerData 0.0.8
File Size Uploaded
easysoccerdata-0.0.8.tar.gz 36.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for EasySoccerData 0.0.8
File Interpreter ABI Platform
easysoccerdata-0.0.8-py3-none-any.whl Python 3 none any Details

Total release size: 89.8 kB

Release files / easysoccerdata-0.0.8.tar.gz

Download URL easysoccerdata-0.0.8.tar.gz
Size 36.0 kB
Tags Source
SHA-256 checksum
How to use checksums
cb3eeafeda39f6cafc71a4dac2fc3364ac91311ea41bea9c0580f5cf0f1730f7
BLAKE2b-256 checksum
How to use checksums
54dde7f12205476a8807197224011ab6b3eda25a466f46461f25c61f9c4fe790
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 12, 2025.

Transparency log

Release files / easysoccerdata-0.0.8-py3-none-any.whl

Download URL easysoccerdata-0.0.8-py3-none-any.whl
Size 53.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
dcb8e8c3e33119285d60322ed377003ff2da77b2b56ad133356d8ccfffdc13dd
BLAKE2b-256 checksum
How to use checksums
58471344d0304d6d2be1eda1648a6fbdb48b7fe87fe34befa8ff0f739c1401ea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 12, 2025.

Transparency log

Release history Release notifications | RSS feed

This release

0.0.8 This release

2 release files

0.0.7

2 release files

0.0.6

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page