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/pl_61928103/stats?season_id=sn_8406098&competition_id=comp_3039

Example request

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

JSON response

{
  "data": {
    "player_id": "pl_61928103",
    "season_id": "sn_8406098",
    "competition_id": "comp_3039",
    "team_id": "tm_3039",
    "position": "F",
    "appearances": 5,
    "minutes_played": 450,
    "scoring": { "goals": 5, "assists": 0, "penalty_goals": 0 },
    "shooting": { "total_shots": 20, "shots_on_target": 10 },
    "discipline": { "yellow_cards": 0, "red_cards": 0 }
  }
}

Key response fields

player_id

Stable identifier for the player.

scoring.goals / scoring.assists

Attacking output for the season.

minutes_played

Total minutes played — useful for per-90 metrics.

shooting.total_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.

Related endpoints

Frequently Asked Questions

Do you provide per-match player stats?

Yes. Call /football/matches/{match_id}/player-stats for per-match breakdowns, or /football/players/{player_id}/stats with a season_id (and optional competition_id) for season totals.

Which player stats are included?

Goals, assists, appearances, minutes, yellow and red cards, and shots. Availability varies by competition tier.

How do I build a top scorers list?

Fetch season stats for each player you track (squads come from /football/teams/{team_id}/players), then sort by scoring.goals — see our player stats tutorial.

Pricing_Plans

Simple, Transparent Pricing

All stats data — fixtures, results, match & player stats, xG, and history.

Starter

$50/month

For prototypes, side projects, and early products

Included in every plan:

All football data endpoints included
Pre-match & live odds endpoints
Bet365, Pinnacle, Paddy Power, Betfair Sportsbook & Kambi odds
1X2, Asian handicap, totals, BTTS, DNB & corners
Fixtures, results, match stats, teams & players
xG, player season stats & team stats
10 years of historical match data
Build with AI
150 competitions by default, up to 1,196 on request
100,000 requests/month
120 requests/min
Email & chat support

Growth

$129/month

For production apps with steady traffic

Everything in Starter, plus:

500,000 requests/month
300 requests/min
Priority support for production teams

Scale

$379/month

For high-volume, production-grade usage

Everything in Growth, upgraded to:

5,000,000 requests/month
1,000 requests/min
Dedicated support & SLA

Cancel anytime

7-day free trial on all plans

Build with the Football Player Stats API today

Start a 7-day free trial. Every endpoint and competition is included on every plan.

Get your API key