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.

• 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.

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.

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

• 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

• FBref
• Fotmob
• Transfermarkt
• FC Python
• 538