Pricing

from $3.00 / 1,000 results

Understat xG Football Data Scraper

Scrape Understat (understat.com) for xG (expected goals) football analytics. Get player stats, team stats, and match data for Premier League, La Liga, Bundesliga, Serie A, Ligue 1, and RFPL.

Pricing

from $3.00 / 1,000 results

Rating

0.0

(0)

Developer

Crawler Bros

Actor stats

Bookmarked

Total users

Monthly active users

8 days ago

Last modified

What This Actor Does

Fetches xG football analytics from Understat including:

League Stats: All player xG stats for a season (xG, xA, xGChain, xGBuildup, goals, assists, shots)
Team Stats: Aggregated team performance with xG and xGA over a season
Player Stats: Full match-by-match xG history for a specific player

Supported Leagues

Code	League
`EPL`	Premier League (England)
`La_liga`	La Liga (Spain)
`Bundesliga`	Bundesliga (Germany)
`Serie_A`	Serie A (Italy)
`Ligue_1`	Ligue 1 (France)
`RFPL`	Russian Premier League

Input

Field	Type	Description
`mode`	string	`leagueStats`, `teamStats`, or `playerStats`
`league`	string	League code (e.g. `EPL`, `La_liga`)
`season`	string	Season start year, e.g. `2024` for 2024/25
`teamName`	string	Filter by team name (teamStats mode)
`playerId`	string	Understat player ID (playerStats mode)
`playerName`	string	Player name filter or lookup
`maxItems`	integer	Max records to return (default: 10)

Example Input

{
  "mode": "leagueStats",
  "league": "EPL",
  "season": "2024",
  "maxItems": 10
}

Output

Player Record (leagueStats / playerStats)

Field	Description
`playerId`	Understat player ID
`playerName`	Player's name
`team`	Club name
`position`	Playing position
`games`	Matches played
`goals`	Goals scored
`assists`	Assists
`xG`	Expected goals
`xA`	Expected assists
`xGChain`	xG from all actions in a chain
`xGBuildup`	xG contribution without shot/key pass
`yellowCards`	Yellow cards
`redCards`	Red cards
`shots`	Total shots
`minutesPlayed`	Minutes on pitch
`season`	Season year
`league`	League name
`playerUrl`	Link to Understat player page

Example Output

{
  "playerId": "1250",
  "playerName": "Mohamed Salah",
  "team": "Liverpool",
  "position": "AML",
  "games": 32,
  "goals": 20,
  "assists": 12,
  "xG": 18.5,
  "xA": 9.2,
  "xGChain": 22.1,
  "season": "2024",
  "league": "Premier League",
  "playerUrl": "https://understat.com/player/1250"
}

FAQs

Is this free to use? Yes. Understat is publicly accessible and embeds all data as JSON in the page HTML — no API key required.

What is xG? Expected Goals (xG) measures the quality of goal-scoring chances. Each shot is assigned a probability of being scored based on historical data.

What is xGChain? xGChain is the total xG from every action (pass, dribble, shot) in the sequence of play that led to a shot, credited to every player involved.

How do I get a player ID? Run leagueStats mode first to get the playerId field, then use it in playerStats mode. You can also use playerName to auto-find the ID.

Why does the 2024 season use year 2024 not 2024-2025? Understat uses the start year of the season as the identifier (e.g. 2024 = 2024/25 season).

Understat xG Football Scraper — Expected Goals & Shot Data API

mirthful_radish/understat-xg-football-scraper

Extract xG, xA, and advanced football stats from Understat.com. 562+ players per league, 18 metrics including expected goals, npxG, xG chain. Covers Premier League, La Liga, Bundesliga, Serie A, Ligue 1, RFPL. Seasons from 2014/15.

Sean Caldwell

100

Understat xG Player Stats Scraper

parseforge/understat-xg-scraper

Pull player expected goals data from Understat for the top European leagues. Each player returns games, minutes, goals, assists, shots, xG, xA, non penalty xG, xGChain, and xGBuildup for a chosen season. Great for football analytics, model building, and player scouting.

ParseForge

Understat xG & Shot Data - Football Analytics

constructive_calm/understat-football-analytics

Scrapes Understat: player/team season aggregates, per-match xG/PPDA/win-probabilities, shot-level data with x/y coords + xG, situation/formation/game-state breakdowns, player career histories, and fixtures across the Big 5 + RFPL (2014–2025). Multi-season + multi-league in a single run.

Omar Eldeeb

5.0

Football Stats Scraper

crawlergang/football-stats-scraper

Scrape football statistics from ESPN's public API, standings, match results, team stats, and player profiles for all major leagues worldwide including Premier League, La Liga, Bundesliga, Serie A, Ligue 1, MLS, and more. No API key required.

Crawler Gang

5.0

Football Stats Scraper

crawlerbros/football-stats-scraper

Crawler Bros

FBref Football Statistics Scraper

crawlerbros/fbref-scraper

Scrape FBref (fbref.com) - the Football Reference site. Get league stats, match results, and player statistics for Premier League, La Liga, Bundesliga, Serie A, and Ligue 1.

Crawler Bros

Premier League API - Football Stats

alizarin_refrigerator-owner/premier-league-api

Access Premier League football statistics, fixtures, standings, player data & match results. Historical data & real-time updates for sports analytics.

The Howlers

Football-Data.org Competitions Scraper

parseforge/football-data-org-competitions-scraper

Collect football competitions, teams, fixtures, results, standings, scorers, and seasons from football-data.org. Covers Premier League, La Liga, Bundesliga, Serie A, Champions League, World Cup. Export to JSON, CSV, or Excel for sports analytics, betting models, and fan dashboards.

ParseForge

Football Fixtures Api

martin_sabo/football-fixtures-api

Get upcoming football fixtures for any team via Football-Data.org API. Fetch match schedules for Premier League, Champions League & major European competitions. Perfect for sports analytics, betting research, and fantasy football. Clean JSON data, free tier available, no scraping needed.

Martin Sabo

ESPN Sports Data Scraper

parseforge/espn-sports-scraper

Extract live scores, standings, team rosters, and news from ESPN. Covers NFL, NBA, MLB, NHL, Premier League, La Liga, Serie A, Bundesliga, Ligue 1, and MLS. Get game schedules, odds, venue info, and team details. No proxy needed, pure API.

ParseForge