Get FBref advanced match stats

Description

Returns data frame of selected statistics for each match, for either whole team or individual players. Multiple URLs can be passed to the function, but only one 'stat_type' can be selected. Replaces the deprecated function get_advanced_match_stats()

Usage

fb_advanced_match_stats(match_url, stat_type, team_or_player, time_pause = 3)

Arguments

Value

returns a dataframe of a selected team statistic type for a selected match(es)

Examples

## Not run: 
try({
urls <- fb_match_urls(country = "AUS", gender = "F", season_end_year = 2021, tier = "1st")

df <- fb_advanced_match_stats(match_url=urls,stat_type="possession",team_or_player="player")
})

## End(Not run)

Big 5 Euro League Season Stats

Description

Returns data frame of selected statistics for seasons of the big 5 Euro leagues, for either whole team or individual players. Multiple seasons can be passed to the function, but only one 'stat_type' can be selected

Usage

fb_big5_advanced_season_stats(
  season_end_year,
  stat_type,
  team_or_player,
  time_pause = 3
)

Arguments

Value

returns a dataframe of a selected team or player statistic type for a selected season(s)

Examples

## Not run: 
try({
fb_big5_advanced_season_stats(season_end_year=2021,stat_type="possession",team_or_player="player")
})

## End(Not run)

Get fbref League URLs

Description

Returns the URLs for season leagues of a selected country

Usage

fb_league_urls(country, gender, season_end_year, tier = "1st")

Arguments

Value

returns a character vector of all fbref league URLs for selected country, season, gender and tier

Examples

## Not run: 
try({
fb_league_urls(country = "ENG", gender = "M", season_end_year = 2021, tier = '1st')
})

## End(Not run)

Get FBref match lineups

Description

Returns lineups for home and away teams for a selected match Replaces the deprecated function get_match_lineups

Usage

fb_match_lineups(match_url, time_pause = 3)

Arguments

Value

returns a dataframe with the team lineups for a selected match

Examples

## Not run: 
try({
match <- fb_match_urls(country = "AUS", gender = "F", season_end_year = 2021, tier = "1st")[1]
df <- fb_match_lineups(match_url = match)
})

## End(Not run)

Get FBref match report

Description

Returns match report details for selected matches. Replaces the deprecated function get_match_report

Usage

fb_match_report(match_url, time_pause = 3)

Arguments

Value

returns a dataframe with the match details for a selected match

Examples

## Not run: 
try({
match <- fb_match_urls(country = "AUS", gender = "F", season_end_year = 2021, tier = "1st")[1]
df <- fb_match_report(match_url = match)
})

## End(Not run)

Get FBref match results

Description

Returns the game results for a given league season(s) Replaces the deprecated function get_match_results

Usage

fb_match_results(
  country,
  gender,
  season_end_year,
  tier = "1st",
  non_dom_league_url = NA
)

Arguments

Value

returns a dataframe with the results of the competition, season and gender

Examples

## Not run: 
try({
df <- fb_match_results(country = c("ITA"), gender = "M", season_end_year = 2021)
# for results from English Championship:
df <- fb_match_results(country = "ENG", gender = "M", season_end_year = 2021, tier = "2nd")
# for international friendlies:

})

## End(Not run)

Get FBref match shooting event data

Description

Returns detailed player shooting data for home and away teams for a selected match(es) Replaces the deprecated function get_match_shooting

Usage

fb_match_shooting(match_url, time_pause = 3)

Arguments

Value

returns a dataframe

Examples

## Not run: 
try({
match <- "https://fbref.com/en/matches/bf52349b/Fulham-Arsenal-September-12-2020-Premier-League"
df <- fb_match_shooting(match_url = match)
})

## End(Not run)

Get FBref match summary

Description

Returns match summary data for selected match URLs, including goals, subs and cards Replaces the deprecated function get_match_summary

Usage

fb_match_summary(match_url, time_pause = 3)

Arguments

Value

returns a dataframe with the match events (goals, cards, subs) for selected matches

Examples

## Not run: 
try({
match <- fb_match_urls(country = "AUS", gender = "F", season_end_year = 2021, tier = "1st")[1]
df <- fb_match_summary(match_url = match)
})

## End(Not run)

Get FBref match URLs

Description

Returns the URL for each match played for a given league season Replaces the deprecated get_match_urls

Usage

fb_match_urls(
  country,
  gender,
  season_end_year,
  tier = "1st",
  non_dom_league_url = NA,
  time_pause = 3
)

Arguments

Value

returns a character vector of all fbref match URLs for selected competition, season and gender

Examples

## Not run: 
try({
fb_match_urls(country = "ENG", gender = "M", season_end_year = c(2019:2021), tier = "1st")
non_dom <- "https://fbref.com/en/comps/218/history/Friendlies-M-Seasons"
fb_match_urls(country = "", gender = "M", season_end_year = 2021, non_dom_league_url = non_dom)
})

## End(Not run)

Get player goal logs

Description

Returns the player's career goal and assist logs

Usage

fb_player_goal_logs(player_urls, time_pause = 3, goals_or_assists = "goals")

Arguments

Value

returns a dataframe of the player's goals and assists

Examples

## Not run: 
try({
# for single players:
jwp_url <- "https://fbref.com/en/players/3515d404/"
fb_player_goal_logs(player_urls = jwp_url, goals_or_assists = "goals")
})

## End(Not run)

Get fbref Player Match Logs

Description

Returns all match logs for a selected player, season and stat type

Usage

fb_player_match_logs(player_url, season_end_year, stat_type, time_pause = 3)

Arguments

Value

returns a dataframe of a player's match logs for a season

Examples

try({
fb_player_match_logs("https://fbref.com/en/players/3bb7b8b4/Ederson",
season_end_year = 2021, stat_type = 'summary')
})

Get fbref Full Player Scouting Report

Description

Returns the scouting report for a selected player

Usage

fb_player_scouting_report(player_url, pos_versus, time_pause = 3)

Arguments

Value

returns a dataframe of a player's full scouting information for all seasons available on FBref

Examples

## Not run: 
try({
fb_player_scouting_report(player_url = "https://fbref.com/en/players/d70ce98e/Lionel-Messi",
pos_versus = "primary")

# to filter for the last 365 days:
fb_player_scouting_report(player_url = "https://fbref.com/en/players/d70ce98e/Lionel-Messi",
pos_versus = "primary") %>% dplyr::filter(scouting_period == "Last 365 Days")

# to get secondary positions
fb_player_scouting_report(player_url = "https://fbref.com/en/players/d70ce98e/Lionel-Messi",
pos_versus = "secondary")

# for the 2020-2021 La Liga season
fb_player_scouting_report(player_url = "https://fbref.com/en/players/d70ce98e/Lionel-Messi",
pos_versus = "secondary") %>% dplyr::filter(scouting_period == "2020-2021 La Liga")
})

## End(Not run)

Get fbref Player Season Statistics

Description

Returns the historical season stats for a selected player(s) and stat type

Usage

fb_player_season_stats(player_url, stat_type, time_pause = 3)

Arguments

Value

returns a dataframe of a player's historical season stats

Examples

## Not run: 
try({
fb_player_season_stats("https://fbref.com/en/players/3bb7b8b4/Ederson",
                       stat_type = 'standard')

multiple_playing_time <- fb_player_season_stats(
 player_url = c("https://fbref.com/en/players/d70ce98e/Lionel-Messi",
           "https://fbref.com/en/players/dea698d9/Cristiano-Ronaldo"),
 stat_type = "playing_time")
})

## End(Not run)

Get fbref Player URLs

Description

Returns the URLs for all players for a given team

Usage

fb_player_urls(team_url, time_pause = 3)

Arguments

Value

returns a character vector of all fbref player URLs for a selected team

Examples

## Not run: 
try({
fb_player_urls("https://fbref.com/en/squads/fd962109/Fulham-Stats")
})

## End(Not run)

Get FBref season team stats

Description

Returns different team season statistics results for a given league season and stat type Replaces the deprecated function get_season_team_stats

Usage

fb_season_team_stats(
  country,
  gender,
  season_end_year,
  tier,
  stat_type,
  time_pause = 3
)

Arguments

Value

returns a dataframe of a selected team statistic type for a selected league season

Examples

## Not run: 
try({
fb_season_team_stats("ITA", "M", 2021, "1st", "defense")
})

## End(Not run)

Get team player wages

Description

Returns all player wages from FBref via Capology

Usage

fb_squad_wages(team_urls, time_pause = 3)

Arguments

Value

returns a dataframe with all available estimated player wages for the selected team(s)

Examples

## Not run: 
try({
# for single teams:
man_city_url <- "https://fbref.com/en/squads/b8fd03ef/Manchester-City-Stats"
fb_squad_wages(team_urls = man_city_url)
})

## End(Not run)

Get team goal logs

Description

Returns the team's season goal logs

Usage

fb_team_goal_logs(team_urls, time_pause = 3, for_or_against = "for")

Arguments

Value

returns a dataframe of the team's goals scored and conceded in the season

Examples

## Not run: 
try({
# for single teams:
man_city_url <- "https://fbref.com/en/squads/b8fd03ef/Manchester-City-Stats"
fb_team_goal_logs(team_urls = man_city_url, for_or_against = "for")
})

## End(Not run)

Get team match log stats

Description

Returns all match statistics for a team(s) in a given season

Usage

fb_team_match_log_stats(team_urls, stat_type, time_pause = 3)

Arguments

Value

returns a dataframe with the selected stat outputs of all games played by the selected team(s)

Examples

## Not run: 
try({
# for single teams:
man_city_url <- "https://fbref.com/en/squads/b8fd03ef/Manchester-City-Stats"
fb_team_match_log_stats(team_urls = man_city_url, stat_type = "passing")
})

## End(Not run)

Get FBref team match results

Description

Returns all game results for a team in a given season Replaces the deprecated function get_team_match_results

Usage

fb_team_match_results(team_url, time_pause = 3)

Arguments

Value

returns a dataframe with the results of all games played by the selected team(s)

Examples

## Not run: 
try({
# for single teams:
man_city_url <- "https://fbref.com/en/squads/b8fd03ef/Manchester-City-Stats"
fb_team_match_results(man_city_url)
})

## End(Not run)

Get fbref Team's Player Season Statistics

Description

Returns the team's players season stats for a selected team(s) and stat type

Usage

fb_team_player_stats(team_urls, stat_type, time_pause = 3)

Arguments

Value

returns a dataframe of all players of a team's season stats

Examples

## Not run: 
try({
fb_team_player_stats("https://fbref.com/en/squads/d6a369a2/Fleetwood-Town-Stats",
                       stat_type = 'standard')

league_url <- fb_league_urls(country = "ENG", gender = "M",
                                             season_end_year = 2022, tier = "3rd")
team_urls <- fb_teams_urls(league_url)
multiple_playing_time <- fb_team_player_stats(team_urls,
                         stat_type = "playing_time")
})

## End(Not run)

Get fbref Team URLs

Description

Returns the URLs for all teams for a given league

Usage

fb_teams_urls(league_url, time_pause = 3)

Arguments

Value

returns a character vector of all fbref team URLs for a selected league

Examples

## Not run: 
try({
fb_teams_urls("https://fbref.com/en/comps/9/Premier-League-Stats")
})

## End(Not run)

Get fotmob league ids

Description

Returns a dataframe of the league ids available on fotmob

Usage

fotmob_get_league_ids(cached = TRUE)

Arguments

Get fotmob match results by league

Description

Returns match results for all matches played on the selected date from fotmob.com.

Usage

fotmob_get_league_matches(country, league_name, league_id, cached = TRUE)

Arguments

Value

returns a dataframe of league matches

Examples

try({
library(dplyr)
library(tidyr)

# one league
fotmob_get_league_matches(
  country = "ENG",
  league_name = "Premier League"
)

# one league, by id
fotmob_get_league_matches(
  league_id = 47
)

# multiple leagues (could also use ids)
league_matches <- fotmob_get_league_matches(
  country =     c("ENG",            "ESP"   ),
  league_name = c("Premier League", "LaLiga")
)

# probably the data that you care about
league_matches %>%
  dplyr::select(match_id = id, home, away) %>%
  tidyr::unnest_wider(c(home, away), names_sep = "_")
})

Get standings from fotmob

Description

Returns league standings from fotmob.com. 3 types are returned: all, home, away

Usage

fotmob_get_league_tables(country, league_name, league_id, cached = TRUE)

Arguments

Value

returns a dataframe of league standings

Examples

try({
library(dplyr)
library(tidyr)

# one league
fotmob_get_league_tables(
  country = "ENG",
  league_name = "Premier League"
)

# one league, by id
fotmob_get_league_tables(
  league_id = 47
)

# multiple leagues (could also use ids)
league_tables <- fotmob_get_league_tables(
  country =     c("ENG",            "ESP"   ),
  league_name = c("Premier League", "LaLiga")
)

# look at tables if only away matches are considered
league_tables %>%
  dplyr::filter(table_type == "away")
})

Get fotmob match details by match id

Description

Returns match details from fotmob.com

Usage

fotmob_get_match_details(match_ids)

Arguments

Value

returns a dataframe of match shots

Examples

try({
library(dplyr)
library(tidyr)
results <- fotmob_get_matches_by_date(date = "20210926")
match_ids <- results %>%
  dplyr::select(primary_id, ccode, league_name = name, match_id) %>%
  dplyr::filter(league_name == "Premier League", ccode == "ENG") %>%
  dplyr::pull(match_id)
match_ids # 3609987 3609979
details <- fotmob_get_match_details(match_ids)
})

Get fotmob match info by match id

Description

Returns match info from fotmob.com

Usage

fotmob_get_match_info(match_ids)

Arguments

Value

returns a dataframe of match info

Examples

try({
library(dplyr)
library(tidyr)
results <- fotmob_get_matches_by_date(date = "20210926")
match_ids <- results %>%
  dplyr::select(primary_id, ccode, league_name = name, match_id) %>%
  dplyr::filter(league_name == "Premier League", ccode == "ENG") %>%
  dplyr::pull(match_id)
match_ids # 3609987 3609979
details <- fotmob_get_match_info(match_ids)
})

Get fotmob match player details by match id

Description

Returns match details from fotmob.com

Usage

fotmob_get_match_players(match_ids)

Arguments

Value

returns a dataframe of match players

Examples

try({
library(dplyr)
library(tidyr)
## single match
players <- fotmob_get_match_players(3610132)
salah_id <- "292462"
players %>%
  dplyr::filter(id == salah_id) %>%
  dplyr::select(player_id = id, stats) %>%
  tidyr::unnest(stats)

## multiple matches
fotmob_get_match_players(c(3609987, 3609979))
})

Get fotmob match top team stats by match id

Description

Returns match top team stats from fotmob.com

Usage

fotmob_get_match_team_stats(match_ids)

Arguments

Value

returns a dataframe of match top team stats

Examples

try({
library(dplyr)
library(tidyr)
results <- fotmob_get_matches_by_date(date = "20210926")
match_ids <- results %>%
  dplyr::select(primary_id, ccode, league_name = name, match_id) %>%
  dplyr::filter(league_name == "Premier League", ccode == "ENG") %>%
  dplyr::pull(match_id)
match_ids # 3609987 3609979
details <- fotmob_get_match_team_stats(match_ids)
})

Get fotmob match results by date

Description

Returns match results for all matches played on the selected date from fotmob.com

Usage

fotmob_get_matches_by_date(dates)

Arguments

Value

returns a dataframe of match results

Examples

try({
library(dplyr)
library(tidyr)

results <- fotmob_get_matches_by_date(date = c("20210925", "20210926"))
results %>%
  dplyr::select(primary_id, ccode, league_name = name, match_id)
})

Get season statistics from fotmob

Description

Returns team or player season-long statistics standings from fotmob.com.

Usage

fotmob_get_season_stats(
  country,
  league_name,
  league_id,
  season_name,
  team_or_player = c("team", "player"),
  stat_name,
  stat_league_name = league_name,
  cached = TRUE
)

Arguments

Value

returns a dataframe of team or player stats

Examples

try({
epl_team_xg_2021 <- fotmob_get_season_stats(
  country = "ENG",
  league_name = "Premier League",
  season = "2020/2021",
  stat_name = "Expected goals",
  team_or_player = "team"
)
})

Get advanced match stats

Description

Returns data frame of selected statistics for each match, for either whole team or individual players. Multiple URLs can be passed to the function, but only one 'stat_type' can be selected

Usage

get_advanced_match_stats(match_url, stat_type, team_or_player, time_pause = 3)

Arguments

Value

returns a dataframe of a selected team statistic type for a selected match(es)

Examples

## Not run: 
try({
urls <- get_match_urls(country = "AUS", gender = "F", season_end_year = 2021, tier = "1st")

df <- get_advanced_match_stats(match_url=urls,stat_type="possession",team_or_player="player")
})

## End(Not run)

Get match lineups

Description

Returns lineups for home and away teams for a selected match

Usage

get_match_lineups(match_url, time_pause = 3)

Arguments

Value

returns a dataframe with the team lineups for a selected match

Examples

## Not run: 
try({
match <- get_match_urls(country = "AUS", gender = "F", season_end_year = 2021, tier = "1st")[1]
df <- get_match_lineups(match_url = match)
})

## End(Not run)

Get match report

Description

Returns match report details for selected matches

Usage

get_match_report(match_url, time_pause = 3)

Arguments

Value

returns a dataframe with the match details for a selected match

Examples

## Not run: 
try({
match <- get_match_urls(country = "AUS", gender = "F", season_end_year = 2021, tier = "1st")[1]
df <- get_match_report(match_url = match)
})

## End(Not run)

Get match results

Description

Returns the game results for a given league season(s)

Usage

get_match_results(
  country,
  gender,
  season_end_year,
  tier = "1st",
  non_dom_league_url = NA
)

Arguments

Value

returns a dataframe with the results of the competition, season and gender

Examples

## Not run: 
try({
df <- get_match_results(country = c("ITA"), gender = "M", season_end_year = 2021)
# for results from English Championship:
df <- get_match_results(country = "ENG", gender = "M", season_end_year = 2021, tier = "2nd")
# for international friendlies:

})

## End(Not run)

Get match shooting event data

Description

Returns detailed player shooting data for home and away teams for a selected match(es)

Usage

get_match_shooting(match_url, time_pause = 3)

Arguments

Value

returns a dataframe

Examples

## Not run: 
try({
match <- "https://fbref.com/en/matches/bf52349b/Fulham-Arsenal-September-12-2020-Premier-League"
df <- get_match_shooting(match_url = match)
})

## End(Not run)

Get match summary

Description

Returns match summary data for selected match URLs, including goals, subs and cards

Usage

get_match_summary(match_url, time_pause = 3)

Arguments

Value

returns a dataframe with the match events (goals, cards, subs) for selected matches

Examples

## Not run: 
try({
match <- get_match_urls(country = "AUS", gender = "F", season_end_year = 2021, tier = "1st")[1]
df <- get_match_summary(match_url = match)
})

## End(Not run)

Get match URLs

Description

Returns the URL for each match played for a given league season

Usage

get_match_urls(
  country,
  gender,
  season_end_year,
  tier = "1st",
  non_dom_league_url = NA,
  time_pause = 3
)

Arguments

Value

returns a character vector of all fbref match URLs for selected competition, season and gender

Examples

## Not run: 
try({
get_match_urls(country = "ENG", gender = "M", season_end_year = c(2019:2021), tier = "1st")
non_dom <- "https://fbref.com/en/comps/218/history/Friendlies-M-Seasons"
get_match_urls(country = "", gender = "M", season_end_year = 2021, non_dom_league_url = non_dom)
})

## End(Not run)

Get player market values

Description

Returns data frame of player valuations (in Euros) from transfermarkt.com

Usage

get_player_market_values(country_name, start_year, league_url = NA)

Arguments

Value

returns a dataframe of player valuations for country/seasons

Get season team stats

Description

Returns different team season statistics results for a given league season and stat type

Usage

get_season_team_stats(
  country,
  gender,
  season_end_year,
  tier,
  stat_type,
  time_pause = 3
)

Arguments

Value

returns a dataframe of a selected team statistic type for a selected league season

Examples

## Not run: 
try({
get_season_team_stats("ITA", "M", 2021, "1st", "defense")
})

## End(Not run)

Get team match results

Description

Returns all game results for a team in a given season

Usage

get_team_match_results(team_url, time_pause = 3)

Arguments

Value

returns a dataframe with the results of all games played by the selected team(s)

Examples

## Not run: 
try({
# for single teams:
man_city_url <- "https://fbref.com/en/squads/b8fd03ef/Manchester-City-Stats"
get_team_match_results(man_city_url)
})

## End(Not run)

Load Big 5 Euro League Season Stats

Description

Loading version of fb_big5_advanced_season_stats Returns data frame of selected statistics for seasons of the big 5 Euro leagues, for either whole team or individual players. Multiple seasons can be passed to the function, but only one 'stat_type' can be selected

Usage

load_fb_big5_advanced_season_stats(
  season_end_year = NA,
  stat_type,
  team_or_player
)

Arguments

Value

returns a dataframe of a selected team or player statistic type for a selected season(s)

Examples

try({
df <- load_fb_big5_advanced_season_stats(
season_end_year = c(2018:2022), stat_type = "defense", team_or_player = "player"
)

df <- load_fb_big5_advanced_season_stats(
season_end_year = 2022, stat_type = "defense", team_or_player = "player"
)
})

Load pre saved fotmob match details

Description

Loading version of fotmob_get_match_details, but for all seasons for which data is available, not just the current season. Note that fotmobonly has match details going back to the 2020-21 season for most leagues.

Usage

load_fotmob_match_details(country, league_name, league_id, cached = TRUE)

Arguments

Value

returns a dataframe of league matches

Examples

## Not run: 
try({
# one league
load_fotmob_match_details(
  country = "ENG",
  league_name = "Premier League"
)

## this is the same output format as the following
fotmob_get_match_details(match_id = 3411352)

# one league, by id
load_fotmob_match_details(league_id = 47)

# multiple leagues (could also use ids)
load_fotmob_match_details(
  country =     c("ENG",            "ESP"   ),
  league_name = c("Premier League", "LaLiga")
)
})

## End(Not run)

Load pre saved fotmob match ids by date

Description

Loading version of fotmob_get_matches_by_date. Goes back to August 2017.

Usage

load_fotmob_matches_by_date(country, league_name, league_id, cached = TRUE)

Arguments

Value

returns a dataframe of league match ids

Examples

## Not run: 
try({
## just load match ids
load_fotmob_matches_by_date(
  country = "ENG",
  league_name = "Premier League"
)

## can also do it for multiple leagues
load_fotmob_matches_by_date(
  country =     c("ENG",            "ESP"   ),
  league_name = c("Premier League", "LaLiga")
)
})

## End(Not run)

Load match competition results

Description

Returns the game results for a competition(s), ie League cups or international competitions from FBref. comp_name comes from https://github.com/JaseZiv/worldfootballR_data/tree/master/data/match_results_cups#readme

Usage

load_match_comp_results(comp_name)

Arguments

Value

returns a dataframe with the results of the competition name

Examples

try({
df <- load_match_comp_results(
comp_name = "Coppa Italia"
)
# for multiple competitions:
cups <- c("FIFA Women's World Cup",
          "FIFA World Cup")
df <- load_match_comp_results(
comp_name = cups
)
})

Load match results

Description

Loading version of get_match_results Returns the game results for a given league season(s) from FBref

Usage

load_match_results(country, gender, season_end_year, tier)

Arguments

Value

returns a dataframe with the results of the competition, season and gender

Examples

try({
df <- load_match_results(
country = c("ITA"), gender = "M", season_end_year = 2021, tier = "1st"
)
# for results from English 1st div for men and women:
df <- load_match_results(
country = "ENG", gender = c("M", "F"), season_end_year = 2021, tier = "1st"
)
})

Load Understat league shot locations

Description

Loading version of understat_league_season_shots, but for all seasons Returns shooting locations for all matches played in the selected league

Usage

load_understat_league_shots(league)

Arguments

Value

returns a dataframe of shooting locations for a selected league

Examples

## Not run: 
try({
df <- load_understat_league_shots(league="Serie A")
})

## End(Not run)

Player Mapping Dictionary

Description

Returns data frame of players from the top 5 Euro leagues, their player URL and their respective Transfermarkt URL. Currently only for the players who have been in the top 5 leagues since the 2017-2018 season

Usage

player_dictionary_mapping()

Value

returns a dataframe of FBref players and respective Transfermarkt URL

Examples

try({
mapped_players <- player_dictionary_mapping()
})

Get player transfer history

Description

Returns data frame of player(s) transfer history from transfermarkt.com

Usage

player_transfer_history(player_urls)

Arguments

Value

returns a dataframe of player transfers

Get expiring contracts

Description

Returns a data frame of players with expiring contracts for a selected league and time period

Usage

tm_expiring_contracts(country_name, contract_end_year, league_url = NA)

Arguments

Value

returns a dataframe of expiring contracts in the selected league

Get league debutants

Description

Returns a data frame of debutants for a selected league

Usage

tm_league_debutants(
  country_name,
  league_url = NA,
  debut_type,
  debut_start_year,
  debut_end_year
)

Arguments

Value

returns a dataframe of players who debuted in the selected league

Get league injuries

Description

Returns a data frame of all currently injured players players for a selected league

Usage

tm_league_injuries(country_name, league_url = NA)

Arguments

Value

returns a dataframe of injured players in the selected league

Get transfermarkt Team URLs

Description

Returns the URLs for all teams for a given league season

Usage

tm_league_team_urls(country_name, start_year, league_url = NA)

Arguments

Value

returns a character vector of all transfermarkt team URLs for a selected league

Get weekly league table

Description

Returns the league table for each chosen matchday from transfermarkt

Usage

tm_matchday_table(country_name, start_year, matchday, league_url = NA)

Arguments

Value

returns a dataframe of the table for a selected league and matchday

Examples

## Not run: 
try({
tm_matchday_table(country_name="England", start_year="2020", matchday=1)
tm_matchday_table(country_name="England", start_year="2020", matchday=c(1:5))
})

## End(Not run)

Get transfermarkt player bios

Description

Returns data frame of player bios from transfermarkt.com

Usage

tm_player_bio(player_urls)

Arguments

Value

returns a dataframe of player bios

Examples

## Not run: 
try({
player_url <- "https://www.transfermarkt.com/eden-hazard/profil/spieler/50202"
tm_player_bio(player_url)
tm_player_bio(player_urls = c("https://www.transfermarkt.com/eden-hazard/profil/spieler/50202",
                              "https://www.transfermarkt.com/sergio-ramos/profil/spieler/25557",
                              "https://www.transfermarkt.com/ivo-grbic/profil/spieler/226073"))
})

## End(Not run)

Get player injury history

Description

Returns data frame of a player's injury history transfermarkt.com

Usage

tm_player_injury_history(player_urls)

Arguments

Value

returns a dataframe of player injury history

Get Transfermarkt player market values

Description

Returns data frame of player valuations (in Euros) from transfermarkt.com Replaces the deprecated function get_player_market_values

Usage

tm_player_market_values(country_name, start_year, league_url = NA)

Arguments

Value

returns a dataframe of player valuations for country/seasons

Get Transfermarkt player transfer history

Description

Returns data frame of player(s) transfer history from transfermarkt.com Replaces the deprecated function player_transfer_history

Usage

tm_player_transfer_history(player_urls)

Arguments

Value

returns a dataframe of player transfers

Get squad player stats

Description

Returns basic stats for players of a team season

Usage

tm_squad_stats(team_url)

Arguments

Value

returns a dataframe of all player stats for team(s)

Get Staff Member's job history

Description

Returns all roles a selected staff member(s) has held and performance data

Usage

tm_staff_job_history(staff_urls)

Arguments

Value

returns a data frame of all roles a selected staff member(s) has held and performance data

Get transfermarkt Player URLs

Description

Returns the transfermarkt URLs for all players for a given team

Usage

tm_team_player_urls(team_url)

Arguments

Value

returns a character vector of all transfermarkt player URLs for a selected team

Get team staff history

Description

Returns all people who have held the selected role in a team's history

Usage

tm_team_staff_history(team_urls, staff_role = "Manager")

Arguments

Value

returns a data frame of all selected staff roles for a team(s) history

Get transfermarkt Club Staff URLs

Description

Returns the transfermarkt URLs for all staff of selected roles for a given team

Usage

tm_team_staff_urls(team_urls, staff_role)

Arguments

Value

returns a character vector of all transfermarkt staff URLs for a selected team(s)

Team transfer balances

Description

Returns all team's transfer aggregated performances for a chosen league season

Usage

tm_team_transfer_balances(country_name, start_year, league_url = NA)

Arguments

Value

returns a dataframe of the summarised financial transfer performance of all teams for a league season

Get team transfers

Description

Returns all transfer arrivals and departures for a given team season

Usage

tm_team_transfers(team_url, transfer_window = "all")

Arguments

Value

returns a dataframe of all team transfers

Get Understat season match results

Description

Returns match results for all matches played in the selected league season from Understat.com

Usage

understat_league_match_results(league, season_start_year)

Arguments

Value

returns a dataframe of match results for a selected league season

Get Understat league season shot locations

Description

Returns shooting locations for all matches played in the selected league season from Understat.com

Usage

understat_league_season_shots(league, season_start_year)

Arguments

Value

returns a dataframe of shooting locations for a selected league season

Get Understat match shot locations

Description

Returns shooting locations for a selected match from Understat.com

Usage

understat_match_shots(match_url)

Arguments

Value

returns a dataframe of shooting locations for a selected team season

Get all Understat shot locations for a player

Description

Returns shooting locations for a selected player for all matches played from Understat.com

Usage

understat_player_shots(player_url)

Arguments

Value

returns a dataframe of shooting locations for a selected player

Get Understat team info

Description

Retrieve Understat team metadata, including team URLs. Similar to 'understatr::get_team_meta'.

Usage

understat_team_meta(team_names)

Arguments

Value

a data.frame

Examples

## Not run: 
try({
understat_team_meta(team_name = c("Liverpool", "Manchester City"))
})

## End(Not run)

Get Understat team player stats

Description

Retrieve Understat team player stats.

Usage

understat_team_players_stats(team_url)

Arguments

Value

a dataframe of player stats for a selected team season

Get Understat team season shot locations

Description

Returns shooting locations for all matches played by a selected team from Understat.com

Usage

understat_team_season_shots(team_url)

Arguments

Value

returns a dataframe of shooting locations for a selected team season

Get Understat team statistics breakdowns

Description

Returns a data frame for the selected team(s) with stats broken down in different ways. Breakdown groups include:

Usage

understat_team_stats_breakdown(team_urls)

Arguments

Details

"Situation", "Formation", "Game state", "Timing", "Shot zones", "Attack speed", "Result"

Value

returns a dataframe of all stat groups and values