Skip to main content
Version: 0.1.5

SOCCER (sportsdataverse.soccer)

Data sources​

SourceAPIs / hostsFunctionsAuth
ESPNsite.api.espn.com, site.web.api.espn.com, sports.core.api.espn.com112none
American Soccer Analysisapp.americansocceranalysis.com16none
FotMobwww.fotmob.com14none (unofficial)
UEFAcomp.uefa.com7none
FIFAapi.fifa.com9none
Football-Data.co.ukwww.football-data.co.uk3none (CSV archive)
OpenLigaDBapi.openligadb.de11none
kloppy open event datakloppy.pysport.org8none (optional soccer extra)
Additional functionshand-written wrappers & helpers8—

ESPN​

ReferenceFunctions
ESPN site API (v2)24
ESPN web API (v3)5
ESPN core API (v2)82
ESPN FPI API (fitt v3)1

American Soccer Analysis​

ReferenceFunctions
American Soccer Analysis (app.americansocceranalysis.com)16

FotMob​

ReferenceFunctions
FotMob data API (fotmob.com, unofficial)14

UEFA​

ReferenceFunctions
UEFA front-end APIs (comp/match/standings/matchstats.uefa.com)7

FIFA​

ReferenceFunctions
FIFA public API v3 (api.fifa.com)9

Football-Data.co.uk​

ReferenceFunctions
Football-Data.co.uk CSV archive (football-data.co.uk)3

OpenLigaDB​

ReferenceFunctions
OpenLigaDB (api.openligadb.de, community German football)11

kloppy open event data​

ReferenceFunctions
Hand-written wrappers8

See also​

  • kloppy — reads ~15 event and tracking providers behind the soccer extra's open-data loader
  • socceraction — the SPADL and xT reference implementation these ports follow
  • sdvplot — pitch_coords() puts any provider's events on the 105 x 68 pitch
  • sdvplotR — the R twin (sdv_pitch_coords())
  • itscalledsoccer — American Soccer Analysis's own client for the API behind asa_*
  • soccerdata — FBref, Understat, WhoScored and Sofascore scrapers that sdv-py does not wrap
  • mplsoccer — matplotlib pitches and StatsBomb helpers that sdvplot's pitch frame interoperates with

Examples​

Worked examples — executed notebooks rendered as pages (refreshed weekly against the live APIs):