Transfermarkt

Complete list of all transfermarkt functions

Player functions

.transfermarkt.tm_player_data(url: str, html_file: BeautifulSoup = None, json_file_mv: json = None, json_file_transfers: json = None, save_files: bool = False) → tuple

Extracts metadata, market value history, and transfer history for a given player

Parameters

  • url (str) – path of transfermarkt player page

  • html_file (BeautifulSoup or None) – pageSoup html file of profile page. Defaults to None.

  • json_file_mv (json or None) – json file of player market value history. Defaults to None.

  • json_file_transfers (json or None) – json file of player transfer history. Defaults to None.

  • save_files (bool) – whether to save html and json files. Defaults to False.

Returns

player metadata, historical market values, transfer history, BeautifulSoup file of player page (optional), json file of market value history (optional), and json file of transfer history (optional)

Return type

(dict, list, list, BeautifulSoup, json, json) or (dict, list, list)

.transfermarkt.tm_player_injury(pageSoup) → list

Extracts player injury history and equipped to handle players with multiple pages of injuries

Parameters

pageSoup (bs4) – bs4 object of injury page for player referenced in url

Returns

player injuries

Return type

list

.transfermarkt.tm_player_market_value(json_file: json = None, player_id: str = None) → list

Extracts date, team, and market value from highchart

Parameters

  • json_file (json or None) – json file of player market value history. Defaults to None.

  • player_id (str or None) – transfermarkt player id. Defaults to None.

Returns

market value of player by date

Return type

list

.transfermarkt.tm_player_metadata(pageSoup=None, url: str = None) → dict:

Extracts general player information (biographical, club, contract, market value, and miscellaneous)

Parameters

  • pageSoup (bs4 or None) – bs4 object of player page referenced in url. Defaults to None.

  • url (str or None) – path of transfermarkt player page. Defaults to None.

Returns

player metadata

Return type

dict

.transfermarkt.tm_player_transfers(json_file: json = None, player_id: str = None) → list

Extracts player transfer information

Parameters

  • json_file (json or None) – json file of player transfer history. Defaults to None.

  • player_id (str or None) – transfermarkt player id. Defaults to None.

Returns

player transfers

Return type

list

Team functions

.transfermarkt.tm_team_transfers(club: str, season: str, domain: str = 'us', position_group='All', main_position='All', window='All', team_id: int = None, transfermarkt_name: bool = False) → list

Extracts player transfer information

Parameters

  • club (str) – club name

  • season (str or int) – year at start of season

  • domain (str) – domain to use for transfermarkt. Defaults to us.

  • position_group (str) – position group to filter by. Defaults to All.

  • main_position (str) – main position to filter by. Defaults to All.

  • window (str) – transfer window to filter by. Defaults to All.

  • team_id (int) – transfermarkt team id. Defaults to None.

  • transfermarkt_name (bool) – if True, club is a transfermarkt name. Defaults to False.

Returns

team transfers

Return type

list

.transfermarkt.tm_team_player_data(club: str, season: str, domain: str = 'us', team_id: int = None, transfermarkt_name: bool = False) → list

Extracts basic player information for each player in a squad including basic player information, market value, and contract expiration

Parameters

  • club (str) – club name

  • season (str or int) – year at start of season

  • domain (str) – domain to use for transfermarkt. Defaults to us.

  • team_id (int) – transfermarkt team id. Defaults to None.

  • transfermarkt_name (bool) – if True, club is a transfermarkt name. Defaults to False.

Returns

squad players

Return type

list

.transfermarkt.tm_team_staff(club: str = None, team_id: int = None, pageSoup=None, url: str = None) → list

Extracts team staff information

Parameters

  • club (str) – club name

  • team_id (int) – transfermarkt team id. Defaults to None.

  • pageSoup (bs4) – bs4 object of staff page for team referenced in url. Defaults to None.

  • url (str) – path of transfermarkt staff page. Defaults to None.

Returns

team staff

Return type

list

.transfermarkt.tm_team_staff_history(club: str = None, team_id: int = None, pageSoup=None, url: str = None, role: str = None) → list

Extracts historical team staff information for a given role

Parameters

  • club (str) – club name

  • team_id (int) – transfermarkt team id. Defaults to None.

  • pageSoup (bs4) – bs4 object of staff page for team referenced in url. Defaults to None.

  • url (str) – path of transfermarkt staff page. Defaults to None.

  • role (str) – role of staff member. Defaults to None.

Returns

team role staff history

Return type

list

Helper functions

.transfermarkt.tm_player_injury_scraper(pageSoup) → list

Helper function extracts player injury history

Parameters

pageSoup (bs4) – bs4 object of player page referenced in url

Returns

player injuries for specific page

Return type

list

.transfermarkt.tm_format_currency(value: str) → float

Helper function to convert values from string to float values

Parameters

value (str) – raw value of fee or market value

Returns

converted value

Return type

float