Player stats endpoint

Football Player Stats API

Fetch player statistics — goals, assists, minutes, cards, and shots — per season and per match for thousands of players.

Start free trial Browse leagues

Quick answer

The football player stats API returns per-player season and per-match statistics including goals, assists, appearances, minutes, yellow and red cards, and shots, joined to teams and competitions by ID.

GET /football/players/stats?competition_id=1&season=2025

Example request

const res = await fetch(
  "https://api.thestatsapi.com/api/football/players/stats?competition_id=1&season=2025",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
const data = await res.json();
console.log(data);

JSON response

{
  "data": [
    {
      "player_id": 1101,
      "name": "Erling Haaland",
      "team": "Manchester City",
      "appearances": 19,
      "minutes": 1680,
      "goals": 21,
      "assists": 4,
      "shots": 78,
      "yellow_cards": 2
    }
  ],
  "meta": { "page": 1, "per_page": 25, "total": 540 }
}

Key response fields

player_id

Stable identifier for the player.

goals / assists

Attacking output for the season or match.

minutes

Total minutes played — useful for per-90 metrics.

shots

Total shots, a common model feature.

What you can build with the Football Player Stats API

Fantasy football scoring

Top scorer and assist leaderboards

Player comparison tools

Scouting and analytics dashboards

The Football Player 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.