DOI: 10.5281/zenodo.7341037
title: 21st Century Spanish Football League Dataset

description: 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 <strong>Match</strong>, <strong>Event</strong> and <strong>Player</strong> 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: <strong>Season</strong>: JSON documents represent a season, their root contains the following information: <strong>competition</strong>: Name by which the competition is known <strong>country</strong>: Country where the competition is held <strong>season_id</strong>: Identifier of the season, example: Season 2021/22 <strong>season_url</strong>: Relative URL of the season's web page <strong>rounds</strong>: List of Round elements, the days into which the championship is divided <strong>Rounds</strong>: (or matchdays) Collection of matches: <strong>number</strong>: Name of the matchday, e.g.: Matchday 1. <strong>matches</strong>: List of Match elements, matches that are played on the same day/s of the championship. <strong>Match</strong>: contains relevant match information. <strong>id</strong>: Match identifier used at BeSoccer.com <strong>status</strong>: Code representing the status of the match: Played (1), Not Played (0) <strong>home_team</strong>: Name of the home team <strong>away_team</strong>: Name of the away team <strong>result</strong>: List of two integers representing the match score <strong>date_time</strong>: Date and time at which the match started <strong>referee</strong>: First and last name of the referee of the match <strong>href</strong>: URL relative to the match page <strong>home_tactic</strong>: Tactical arrangement of the home team, e.g.: 4-3-3 <strong>home_lineup</strong>: List of players in the starting lineup of the home team <strong>home_bench</strong>: List of the home team's substitute players <strong>away_tactic</strong>: Tactical arrangement of the away team, e.g. 4-3-3 <strong>away_lineup</strong>: List of players in the home team's starting lineup <strong>away_bench</strong>: List of substitute players of the away team <strong>Event</strong>: contains information that defines each of the relevant actions that occur during a soccer match. Events can be described by the following attributes: <strong>player</strong>: Player identifier. Relative URL <strong>team</strong>: Team of the player who participates in the event <strong>minute</strong>: Minute of the match in which the event occurs <strong>type</strong>: Event type (Enumeration) <strong>Players</strong>: Player information: <strong>name</strong>: First name <strong>fullname</strong>: Player's full name <strong>dob</strong>: Date of birth <strong>country</strong>: Nationality <strong>position</strong>: Position the player usually occupies: GOA (GoalKeeper), DF (Defender), MID (Midfielder), STR (Striker) <strong>foot</strong>: Dominant Foot: Right-footed, Left-footed, Two-footed, Unknown <strong>weight</strong>: Weight of player in kilograms <strong>height</strong>: Player height in centimeters <strong>elo</strong>: Measurement of the player's skills on a scale of 1 to 100 <strong>potential</strong>: Estimate of the maximum ELO that a player can reach on a scale of 1 to 100. <strong>href</strong>: Relative URL of the player's record