xG endpoint

Football xG (Expected Goals) API

Access expected goals (xG) — per match, per team, and per shot — to measure underlying performance beyond the scoreline.

Start free trial Browse leagues

Quick answer

The football xG API returns expected goals values per team and per shot for covered matches, letting you quantify chance quality, spot over- and under-performance, and feed predictive models.

GET /football/matches/{match_id}/stats

Example request

const res = await fetch(
  "https://api.thestatsapi.com/api/football/matches/{match_id}/stats",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
const data = await res.json();
console.log(data);

JSON response

{
  "data": {
    "match_id": "mt_10477",
    "home": { "team": "Liverpool", "goals": 3, "xg": 2.41 },
    "away": { "team": "Leicester City", "goals": 1, "xg": 0.88 },
    "shots": [
      { "team": "Liverpool", "minute": 23, "xg": 0.34, "result": "goal" },
      { "team": "Liverpool", "minute": 41, "xg": 0.07, "result": "saved" }
    ]
  }
}

Key response fields

xg (team)

Total expected goals for the team in the match.

shots[].xg

Expected goals value for each individual shot.

result

Outcome of the shot (goal, saved, missed, blocked).

goals

Actual goals, to compare against xG.

What you can build with the Football xG API

xG vs goals overperformance reports

Poisson and Monte Carlo models

Team and player shot-quality analysis

Data-led social content

The Football xG API is part of TheStatsAPI, a single REST API covering 1,000+ football competitions with fixtures, results, standings, player and match stats, odds, and xG. Plans start at $50/month with a 7-day free trial and every endpoint included.