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
Actor stats
0
Bookmarked
3
Total users
0
Monthly active users
23 days ago
Last modified
Categories
Share
Scrape Understat (understat.com) for advanced expected goals (xG) football analytics across 6 major leagues. Get player xG, xA, xGChain, xGBuildup, and team performance data.
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
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
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).
