Match stats endpoint

Football Match Stats API

Get detailed per-match statistics — possession, shots, passes, corners, cards, and xG — for every covered fixture.

Quick answer

The football match stats API returns team-level statistics for a single match: possession, shots, shots on target, passes, corners, fouls, cards, and expected goals (xG) where available.

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", "possession": 58, "shots": 17,
      "shots_on_target": 8, "corners": 9, "xg": 2.41
    },
    "away": {
      "team": "Leicester City", "possession": 42, "shots": 7,
      "shots_on_target": 3, "corners": 3, "xg": 0.88
    }
  }
}

Key response fields

possession

Ball possession percentage per team.

shots / shots_on_target

Shot volume and accuracy.

corners

Corner counts — useful for corners markets.

xg

Expected goals per team where available.

What you can build with the Football Match Stats API

Match centre and stats widgets

Performance and tactical analysis

Corners and totals modelling

Post-match content automation

The Football Match Stats 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.