htyyang / tmarket

TMARKET:  FETCH SOCCER PLAYERS' DATA FROM https://www.transfermarkt.com

What is tmarket?

A simple and useful Python package can help you get the data of a soccer player conveniently.

Quick Start

The Player module

The Player module, which allows you to create an object for a soccer player and get the data by calling its own methods.

import tmarket as tm

# create an object for a player by providing the player's name.
messi = tm.Player(name = "Messi")

# get core info of the player "Messi"
messi.get_core_info()

# get the basic data of the player "Messi"
messi.get_basic_data()

Another way to create Player object

import tmarket as tm

# create an object for a player by providing its profile's url.
messi = tm.Player(url="https://www.transfermarkt.com/lionel-messi/profil/spieler/28003")

Another simple usage

import tmarket as tm

# create an object for a player by providing its profile's ID.
messi = tm.Player(id=28003)

# get core info of the player "Messi"
# "True" will make the method return the info in format of Pandas DataFrames
messi.get_core_info(df=True)

# get the basic data of the player "Messi"
# 1st "True" will make the method return the data in format of Pandas DataFrames
# 2nd "True" will filter all columns with considered missing values
messi.get_basic_data(df=True,drop_na=True)

Method to get the transfer history

import tmarket as tm

# create an object for a player by providing its profile's ID.
messi = tm.Player(id=28003)

# show every section of transfer history
for history in messi.get_transfer_history():
    print(history) 

Usage

The steps to use tmarket

Import

import tmarket as tm

Create Player object

player = tm.Player(name = "Messi")

Player object can be created by providing name, id(on transfermarkt.com), profile url(on transfermarkt.com) The easiest usage is providing the player name. The most stable way is to providing id or url.

Use methods of Player object

player.get_core_info(True)

Detail explanations of Player class methods are on the following Player part.

Recent Goals

What I am trying to improve tmarket package in the next step:

1. Log (created).
2. Optimization on the structure.

What I am trying to improve Player module in the next step:

1. Be able to create an Player object by a player's name. It will be achieved by automatically searching for profiles by the providing name (solved).
2. Develop more methods for detail data, such as the number of goals in a specific year (working).
3. Improve the speed (trying to corporate with Beautiful Soup).