21st Century Spanish Football League Dataset

This dataset consists in 22 JSON files representing a season of the Spanish Football League ("La Liga").

The dataset represents several hierarchically related elements, however, only the Match, Event and Player elements contain relevant information for analysis. The rest of the elements simply serve to keep the data structured, by seasons and matchdays. The dataset collects information from several seasons between the years 2000 and 2022. The attributes of each of the elements that make up the dataset are described below:

Season: JSON documents represent a season, their root contains the following information:

competition: Name by which the competition is known

country: Country where the competition is held

season_id: Identifier of the season, example: Season 2021/22

season_url: Relative URL of the season's web page

rounds: List of Round elements, the days into which the championship is divided

Rounds: (or matchdays) Collection of matches:

number: Name of the matchday, e.g.: Matchday 1.

matches: List of Match elements, matches that are played on the same day/s of the championship.

Match: contains relevant match information.

id: Match identifier used at BeSoccer.com

status: Code representing the status of the match: Played (1), Not Played (0)

home_team: Name of the home team

away_team: Name of the away team

result: List of two integers representing the match score

date_time: Date and time at which the match started

referee: First and last name of the referee of the match

href: URL relative to the match page

home_tactic: Tactical arrangement of the home team, e.g.: 4-3-3

home_lineup: List of players in the starting lineup of the home team

home_bench: List of the home team's substitute players

away_tactic: Tactical arrangement of the away team, e.g. 4-3-3

away_lineup: List of players in the home team's starting lineup

away_bench: List of substitute players of the away team

Event: contains information that defines each of the relevant actions that occur during a soccer match. Events can be described by the following attributes:

player: Player identifier. Relative URL

team: Team of the player who participates in the event

minute: Minute of the match in which the event occurs

type: Event type (Enumeration)

Players: Player information:

name: First name

fullname: Player's full name

dob: Date of birth

country: Nationality

position: Position the player usually occupies: GOA (GoalKeeper), DF (Defender), MID (Midfielder), STR (Striker)

foot: Dominant Foot: Right-footed, Left-footed, Two-footed, Unknown

weight: Weight of player in kilograms

height: Player height in centimeters

elo: Measurement of the player's skills on a scale of 1 to 100

potential: Estimate of the maximum ELO that a player can reach on a scale of 1 to 100.

href: Relative URL of the player's record