Football xG Scraper: Understat Matches, Shots & Tables

What does Football xG Scraper do?

It gets expected goals (xG) data from Understat as clean rows you can open in Excel, Google Sheets, Python or R. No login, no cookies, no API key.

• Leagues: Premier League, La Liga, Bundesliga, Serie A, Ligue 1, Russian Premier League
• Seasons: 2014/15 to the current 2026/27 season (updated after every match on Understat)
• 7 modes: xG league table, matches, team match logs, player stats, shots, lineups, player match logs

Built for football analysts, betting and fantasy modellers, scouts, journalists and students who need xG without copying tables by hand.

What data can I get?

Mode	One row per	Main fields
xG league table	team	points, xPts, points minus xPts, xG, xGA, xGD, npxG, PPDA, deep passes, xPts position. Optional form table from the last N matches
Matches	fixture or result	kickoff, teams, score, home and away xG, Understat's win / draw / loss probabilities from the match xG
Team match logs	team per match	opponent, home/away, result, xG, xGA, npxG, xPts, PPDA, opponent PPDA, deep passes
Player stats	player per season	minutes, goals, assists, shots, key passes, xG, npxG, xA, xGChain, xGBuildup, goals minus xG, per 90 numbers
Shots	shot	minute, player, assisted by, result, xG, x and y position, situation (open play, set piece, penalty), shot type, last action
Lineups	player per match	position, minutes, goals, shots, xG, xA, key passes, xGChain, xGBuildup, cards
Player match logs	player per match	every match of a player with minutes, goals, xG, npxG, xA, key passes, xGChain

Example output

xG league table, Premier League 2026/27 (real run, 16 October 2026):

position	team	played	points	xG	xGA	xPts	pointsMinusXPts	ppda
1	Manchester City	6	18	12.63	7.94	11.72	6.28	8.57

A shot from the same run:

{
  "type": "shot",
  "league": "Premier League (England)",
  "season": "2026/27",
  "matchId": "31239",
  "date": "2026-10-12 19:00:00",
  "homeTeam": "Coventry",
  "awayTeam": "Newcastle United",
  "minute": 5,
  "team": "Coventry",
  "player": "Jack Rudoni",
  "result": "Goal",
  "isGoal": true,
  "xG": 0.7612,
  "x": 0.885,
  "y": 0.5,
  "situation": "Penalty",
  "shotType": "LeftFoot"
}

Every row of a type has the same columns in the same order, so exports open cleanly in a spreadsheet. Each mode has its own table view in the Output tab.

How to use it

1. Pick a mode.
2. Pick one or more leagues and seasons (start year: 2026 = 2026/27, or write current).
3. Click Start. A league table takes a few seconds.

For shots and lineups, either paste Understat match links (https://understat.com/match/28778) or leave them empty to get the most recent played matches of your leagues (set Max matches). For player match logs, paste player links (https://understat.com/player/8260).

Input examples

Form table from the last 5 matches, two leagues:

{ "mode": "table", "leagues": ["EPL", "La_liga"], "seasons": ["current"], "lastMatches": 5 }

All shots from the last 50 Premier League matches:

{ "mode": "shots", "leagues": ["EPL"], "maxMatches": 50 }

Upcoming Serie A fixtures:

{ "mode": "matches", "leagues": ["Serie_A"], "matchStatus": "fixtures" }

What do the numbers mean?

Definitions as Understat gives them:

• xG: the chance a shot becomes a goal, from 0 to 1, as estimated by Understat. A team's xG is the sum of its shots.
• npxG: xG without penalties and own goals.
• xA: the sum of xG of shots from a player's key passes.
• xPts: points a team would expect from its xG and xGA in each match.
• PPDA: passes allowed per defensive action in the opposition half. Lower = more pressing. oppda is the same for the opponent.
• deep: passes completed within an estimated 20 yards of goal, crosses excluded. deepAllowed is the same for the opponent.
• xGChain: total xG of every possession the player is involved in. xGBuildup: the same without key passes and shots.
• x, y (shots): position on the pitch from 0 to 1, as given by Understat.
• xgWinProbHome / xgDrawProb / xgWinProbAway (played matches): Understat's probabilities computed from the match xG.

Times are as listed by Understat.

How much does it cost?

You pay only for rows saved to the dataset. Matches, players or seasons that do not exist are skipped and never charged, and the run's status message lists them. Apify's free plan includes monthly usage credit, which covers many runs.

Can I use it from AI agents or code?

Yes. Call it from the Apify API, Python or JavaScript clients, Make, Zapier, n8n, or any MCP client (Claude, ChatGPT, Cursor) through Apify's MCP server: https://mcp.apify.com?tools=serenido/football-xg-scraper.

FAQ

Which leagues are covered? The six leagues Understat covers: EPL, La Liga, Bundesliga, Serie A, Ligue 1, RFPL. Other leagues are not on Understat.

How fresh is the data? Each run reads Understat live, so you get exactly what Understat shows at that moment.

Why is a season empty? Understat has data from 2014/15. A season that has not started yet has no matches.

Is this affiliated with Understat? No. This scraper reads Understat's public pages. Please respect Understat's terms and credit Understat when you publish its data.