Skip to content

python package for getting soccer statistics and general information

License

Notifications You must be signed in to change notification settings

ian-shepherd/reus

Repository files navigation

PyPI version fury.io Lifecycle: experimental Twitter Follow Twitter Follow

Overview

Reus is a Python library that provides a convenient way to scrape soccer data from various sources, including FBref, FotMob, and Transfermarkt. It aims to simplify the process of accessing and analyzing soccer-related information for data enthusiasts and sports analysts.

Features

  • Retrieve detailed soccer statistics, including player and team performance metrics.
  • Fetch fixture information for specific seasons and competitions.
  • Access transfer market data, including player transfers, contract details, and market values.

Inspiration

Reus takes inspiration from the R package worldfootballR, and their associated dataset, which is known for its extensive soccer data scraping capabilities. While Reus mimics some of the functionalities of worldfootballR, it is designed specifically for Python users, providing similar functionality and ease of use.

Installation

You can install reus from PyPi with:

pip install reus

Then to import the package:

import reus

Please scrape responsibly. Do not make calls faster than 1 per 3 seconds. If you are iterating over multiple pages, please use a sleep time of at least 3 seconds.

time.sleep(4)

It is a minor inconvenience to you but lets us all keep accessing the data.

More detailed documentation is provided here

Roadmap

  • translation function for players and teams
  • change outputs of fbref functions from lists and tuples to dictionaries
  • fbref player scouting reports
  • transfermarkt team staff
  • transfermarkt staff history
  • understat data

Resources

About

python package for getting soccer statistics and general information

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages