eplda 0.2.1

An unofficial API handler to footballapi.pulselive.com. Permitted for study purposes only.

⚽ English-Premier-League-Data-API

EPL-Data is an unofficial lightweight Python API client for www.premierleague.com, providing quick access to data on Premier League players and clubs. It is ideal for data analysis and visualization.

Note: This project is for personal interest and learning only. Commercial use is strictly not permitted.

Features

• ✅ Super user-friendly (hopefully)
• ✅ Player and club data access
• ✅ Supports both JSON and pandas DataFrame output formats
• ✅ Live Data

What's New with version 0.2.1

• Improved documentation and usage examples
• Self-explanatory naming
• More robust error handling and clearer API responses
• Expanded notebook example with step-by-step usage and visualization

Setup Instructions

Install the required dependencies:

pip install -r requirements.txt

Or install manually:

pip install requests pandas

Installation

Install the package directly:

pip install eplda

Quick Start Guide

Get the season ID for a specific season:

from eplda import EPLAPI

epl = EPLAPI()
season_id = epl.get_season_id("2024/25")

Get the top scorer's list and convert it to a pandas DataFrame:

df_goals = epl.get_player_rankings("goals", season_id, output="df")

Search for a player ID by name and get player information:

player_id = epl.get_player_id("Erling Haaland", season_id)
player_info = epl.get_player_details(player_id, season_id)

Example Notebook

A comprehensive demonstration is available in examples.ipynb, including:

• Brief explanation of all methods
• Club and player data queries
• Data visualization

Known Issues

• For some reason, some players cannot be found by search_player_by_name() or get_player_list(). (The temporary solution is to read the player's ID in the URL of the official website, e.g. Bukayo Saka's ID is 49481)

License & Terms of Use

API Client

The eplda is open source with an MIT License.

T&C

www.premierleague.com has a Terms and Conditions regarding the INTELLECTUAL PROPERTY RIGHTS.

Please note that this project has been created for research purposes only and should not be misused in any way with this project or the data obtained from this it.

Acknowledgement

This project is based on Erick Ghuron's premier-league-data.