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.

Installation

pip install EasySoccerData

Development

git clone https://github.com/manucabral/EasySoccerData.git
cd EasySoccerData
pip install -e .[dev]

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

Goaloo

import esd

client = esd.GoalooClient()
league = client.get_league(36)          # 36 = English Premier League
standings = client.get_standings(36)
for row in standings[:5]:
    print(row.rank, row.team.name, row.points)

Check out Goaloo module examples

365Scores

import esd

client = esd.Scores365Client()
games = client.get_games("today")
standings = client.get_standings(72)    # 72 = Liga Profesional Argentina
for row in standings[0].rows[:5]:
    print(row.position, row.team.name, row.points)

Check out 365Scores module examples

Understat

import esd

client = esd.UnderstatClient()
matches = client.get_league_matches("EPL", 2024)
shots = client.get_match_shots(26602)

Check out Understat module examples

Transfermarkt

import esd

client = esd.TransfermarktClient()
player = client.get_player(28003)
print(player.name, player.market_value_display)
transfers = client.get_player_transfers(28003)

Check out Transfermarkt module examples

ESPN

import esd

client = esd.ESPNClient()
matches = client.get_scoreboard("arg.1")
standings = client.get_standings("arg.1")

Check out ESPN module examples

BeSoccer

import esd

client = esd.BeSoccerClient()
matches = client.get_matches("today")
standings = client.get_standings("torneo_final")

Check out BeSoccer module examples

Parallel fetching

Fetch multiple leagues or matches concurrently with fetch_many:

from functools import partial

import esd
from esd.utils import fetch_many

client = esd.GoalooClient()
standings = fetch_many(
    [partial(client.get_standings, league) for league in (36, 31, 8)]
)

Requests use a pooled HTTP session, cache recent responses briefly, and retry transient failures automatically.

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 PyPI version Repository version
Sofascore ✅ ✅
Promiedos ✅ ✅
FBRef ✅ ✅
Goaloo ✅ ✅
365Scores ✅ ✅
Understat ✅ ✅
Transfermarkt ✅ ✅
ESPN ✅ ✅
BeSoccer ✅ ✅

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.

Contributions

All contributions, bug reports, fixes, and ideas are welcome.

Metadata

Release files for EasySoccerData 0.1.0

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.1.0
File Size Uploaded Provenance Actions
easysoccerdata-0.1.0.tar.gz 86.4 kB With provenance Details for easysoccerdata-0.1.0.tar.gz

Built distribution (wheel)

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

Total release size: 195.5 kB

Release files / easysoccerdata-0.1.0.tar.gz

Download URL easysoccerdata-0.1.0.tar.gz
Size 86.4 kB
Tags Source
SHA-256 checksum
How to use checksums
7d83fb409eb9a4f21f349a3586e2494d00c2bbd1ca6a55371efcf0b4900a1484
BLAKE2b-256 checksum
How to use checksums
af1706aebcfebbd2533804abe771e13cf8d5358da2b2350ed3073a7bc8360cb0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 6, 2026.

Transparency log

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

Download URL easysoccerdata-0.1.0-py3-none-any.whl
Size 109.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5a80a636b5a2cd158b5cdd6d5360e296edbb4150ecefaa6b2fb314bc5219a787
BLAKE2b-256 checksum
How to use checksums
0e98a9ee12418e0df581309be23a3a1321ed3775694bc8cc95745d49e1f6b604
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 6, 2026.

Transparency log

Security for EasySoccerData 0.1.0

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for easysoccerdata-0.1.0.tar.gz

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 Nov 6, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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