football-data

Football Open source · MIT Read-only 25 commands 2.2k installs

Football (soccer) data across the world's major leagues — standings, schedules, match stats, xG, transfers, player profiles, head-to-head history, team strength (Elo), and match forecasts.

View source

About

Football (soccer) data across the world's major leagues — standings, schedules, match stats, xG, transfers, player profiles, head-to-head history, team strength (Elo), and match forecasts. Zero config, no API keys. Covers Premier League, La Liga, Bundesliga, Serie A, Ligue 1, MLS, Champions League, World Cup, Championship, Eredivisie, Primeira Liga, Serie A Brazil, Russian Premier League, Scottish/Belgian/Turkish top flights, European Championship, and more (call get_competitions for the live list).

Commands 25

get_current_season

--competition_id

Detect current season for a competition

get_competitions

List available competitions with current season info

get_competition_seasons

--competition_id

Available seasons for a competition

get_season_schedule

--season_id

Full season match schedule

get_season_standings

--season_id

League table for a season

get_season_leaders

--season_id

Top scorers/leaders (Premier League only)

get_season_teams

--season_id

Teams in a season

search_team

--query[--competition_id]

Search for a team by name

search_player

--query

Search for a player by name

get_team_profile

--team_id[--league_slug]

Team info + current squad (roster)

get_daily_schedule

[--date]

All matches for a date across all leagues

get_event_summary

--event_id

Match summary with scores

get_event_lineups

--event_id

Match lineups

get_event_statistics

--event_id

Match team statistics

get_event_timeline

--event_id

Match timeline (goals, cards, subs)

get_team_schedule

--team_id[--league_slug][--season_year][--competition_id]

Schedule for a specific team

get_head_to_head

--team_id--team_id_2[--league_slug][--max_seasons]

Historical H2H results + stats (European domestic leagues)

get_team_strength

--team_id[--team_id_2][--date][--league_slug][--max_seasons]

Elo rating / two-team comparison (European clubs); local-Elo fallback if ClubElo is down

get_match_forecast

--team_id[--team_id_2][--league_slug]

ClubElo win/draw/loss + scoreline forecast (~week ahead)

get_event_xg

--event_id

xG data (top 5 leagues only)

get_event_players_statistics

--event_id

Player-level match stats with optional xG

get_missing_players

--season_id

Injured/doubtful players (Premier League only)

get_season_transfers

--season_id[--tm_player_ids]

Transfer history via Transfermarkt

get_player_season_stats

--player_id[--league_slug]

Player season stats via ESPN

get_player_profile

[--player_id][--fpl_id][--tm_player_id]

Player profile (FPL and/or Transfermarkt)

Example Prompts

Show me the Premier League table
How did Arsenal vs Liverpool go?
Deep dive on Chelsea's recent form
What's Saka's market value?
Tell me about Corinthians

Quick Start

# CLI

sports-skills football get_competitions

# Python

from sports_skills import football
football.get_competitions()