​
Overview

The MatchPlayerStats API returns the recorded statistics for one player in one match. The player and match are selected using the player_id and match_id query parameters. A successful response contains:
  • The API operation status
  • A response title and message
  • The player’s identifier and profile information
  • The player’s shirt number for the match
  • The player’s registered position
  • A categorized collection of match statistics
The returned stats object groups the player’s statistics into sections such as:
  • KoraStats index values
  • Match participation
  • Attempts
  • Ball losses
  • Ball receptions
  • Ball wins and recoveries
  • Chances created
  • Cards
  • Crosses
  • Dribbles
  • Defensive actions
  • Fouls
  • Goalkeeper actions
  • Goals scored
  • Goals conceded
  • Passing
  • Penalties
The endpoint returns the statistical categories provided by the API for the requested player. This includes goalkeeper-related fields even when the requested player is not a goalkeeper. In such cases, the goalkeeper values may be returned as zero. No statistical category, field, or calculation should be assumed beyond the fields present in the API response.

​
Typical Use Cases

  • Displaying a player’s match statistics
  • Building a player match-performance page
  • Producing match reports
  • Supporting scouting and player-review workflows
  • Supplying player data to broadcast or graphics systems
  • Comparing the recorded actions of players within a match
  • Importing player match statistics into another application

​
Parameters

​
module
string
API module selector. For this endpoint, use the fixed value api.
​
api
string
Name of the API operation. For this endpoint, use the fixed value MatchPlayerStats.
​
version
string
Version of the API operation. For the documented response structure, use V2.
​
response
string
Requested response format. The documented request uses json.
​
lang
string
Language code used for returned textual values. The documented request uses en.
​
match_id
integer
Unique identifier of the match for which the player’s statistics are requested. Example: 79356.
​
player_id
integer
Unique identifier of the player whose match statistics are requested. Example: 58143.

​
Endpoint

GET /api.php

​
Examples ٌRequest

curl --request GET \
  --url "https://premium.korastats.pro/api.php?module=api&api=MatchPlayerStats&version=V2&response=json&lang=en&match_id=79356&player_id=58143"

{
  "result": true,
  "title": "Success",
  "message": "Player stats successfully retrieved.",
  "object": {
    "_type": "PLAYER",
    "id": 58143,
    "name": "Sakina Ouzraoui Diki",
    "nickname": "Sakina Ouzraoui",
    "dob": "2001-08-29",
    "shirtnumber": 19,
    "position": {
      "_type": "POSITION",
      "id": 9,
      "name": "RW"
    },
    "stats": {
      "KIndex": {
        "Points": 4,
        "Rating": 3
      },
      "Admin": {
        "MatchesPlayed": 1,
        "MinutesPlayed": 99,
        "MatchesPlayedasSub": 0,
        "MatchesPlayerSubstitutedIn": 0,
        "Offside": 0
      },
      "Attempts": {
        "Total": 2,
        "Success": 1,
        "Saved": 1,
        "PenaltyMissed": 0,
        "Bars": 0,
        "OneOnOneMissed": 0,
        "AttemptToScore": 0,
        "SuccessAttemptToScore": 0,
        "Accuracy": 0.5
      },
      "BallLost": {
        "Total": 14,
        "UnderPressure": 7,
        "Aerial": 5
      },
      "BallReceive": {
        "Total": 21,
        "Success": 20,
        "Fail": 1,
        "Accuracy": 0.95
      },
      "BallWon": {
        "Total": 15,
        "TackleWon": 3,
        "InterceptionWon": 0,
        "Aerial": 2,
        "BallRecover": 10
      },
      "Chances": {
        "KeyPasses": 1,
        "Assists": 0,
        "ChancesCreated": 1
      },
      "Cards": {
        "Yellow": 0,
        "SecondYellow": 0,
        "Red": 0
      },
      "Cross": {
        "Success": 1,
        "Total": 2,
        "Accuracy": 0.5
      },
      "OpenPlayCross": {
        "Success": 1,
        "Total": 2,
        "Accuracy": 0.5
      },
      "SetPieceCross": {
        "Success": 0,
        "Total": 0,
        "Accuracy": 0
      },
      "Dribble": {
        "Total": 2,
        "Success": 1,
        "Fail": 1,
        "Accuracy": 0.5
      },
      "Defensive": {
        "TackleFail": 0,
        "TackleClear": 1,
        "InterceptionClear": 1,
        "Clear": 0,
        "Cleansheet": 0,
        "GoalsSaved": 0,
        "Blocks": 1,
        "OpportunitySaved": 0,
        "xGA": 2.88
      },
      "Fouls": {
        "Committed": 1,
        "Awarded": 1,
        "CommittedInDefensiveThird": 0,
        "AwardedInOffensiveThird": 1
      },
      "GK": {
        "Attempts": {
          "Total": 0,
          "Success": 0,
          "Saved": 0
        },
        "OneonOne": {
          "Total": 0,
          "Saved": 0,
          "Goal": 0
        },
        "Cross": {
          "Total": 0,
          "Saved": 0
        },
        "Shoot": {
          "Goal": 0,
          "Saved": 0
        },
        "Penalty": {
          "Total": 0,
          "Saved": 0,
          "Goal": 0
        },
        "Freekick": {
          "Goal": 0,
          "Saved": 0
        },
        "GoalConceded": 0
      },
      "GoalsScored": {
        "Total": 0,
        "PenaltyScored": 0,
        "OwnGoals": 0,
        "Head": 0,
        "T_0_15": 0,
        "T_15_30": 0,
        "T_30_45": 0,
        "T_45_60": 0,
        "T_60_75": 0,
        "T_75_90": 0,
        "RightFoot": 0,
        "LeftFoot": 0,
        "Other": 0,
        "SetPiece": 0,
        "T_90_105": 0,
        "T_105_120": 0,
        "XG": 0.28
      },
      "GoalsConceded": {
        "OwnGoals": 0,
        "Total": 0
      },
      "LongPass": {
        "Success": 1,
        "Accuracy": 0.33,
        "Total": 3
      },
      "Pass": {
        "Success": 14,
        "Total": 21,
        "Accuracy": 0.67
      },
      "Penalty": {
        "Committed": 0,
        "Awarded": 0
      },
      "ShortPass": {
        "Total": 16,
        "Success": 12,
        "Accuracy": 0.75
      }
    }
  }
}

​
Response Fields

​
Top-Level Response

FieldTypeDescription
resultbooleanIndicates whether the API operation was successful.
titlestringShort title describing the API result.
messagestringHuman-readable message describing the result of the request.
objectobjectContains the requested player profile and match statistics.

​
Player Object

FieldTypeDescription
object._typestringType label of the returned object. The example response returns PLAYER.
object.idintegerUnique identifier of the player.
object.namestringPlayer’s full name.
object.nicknamestringPlayer’s nickname or shortened display name.
object.dobstringPlayer’s date of birth in YYYY-MM-DD format.
object.shirtnumberintegerPlayer’s shirt number for the match.
object.positionobjectContains the player’s position information.
object.statsobjectContains the player’s match statistics, grouped by statistical category.

​
Position Object

FieldTypeDescription
object.position._typestringType label of the position object. The example response returns POSITION.
object.position.idintegerUnique identifier of the position.
object.position.namestringPosition name or abbreviation. The example response returns RW.

​
Statistics Object

The object.stats object contains separate statistical categories. Each category contains only the fields returned by the endpoint. A value of 0 means the API returned zero for that statistic in the requested player-match record. Accuracy fields are returned as decimal numbers. For example, the response returns 0.95, 0.75, and 0.5. The API response does not include a separate percentage-formatted value.

​
KIndex

The KIndex object contains the player’s returned KoraStats index values. This doesn’t return values during the Live but it work after the game has been fully analyzed. The response does not expose the calculation methodology for these values.
FieldTypeDescription
stats.KIndex.Pointsinteger or numberKIndex points returned for the player.
stats.KIndex.Ratinginteger or numberKIndex rating returned for the player.

​
Admin

The Admin object contains match-participation and administrative statistics.
FieldTypeDescription
stats.Admin.MatchesPlayedintegerNumber of matches represented by the returned player statistics.
stats.Admin.MinutesPlayedintegerNumber of minutes played.
stats.Admin.MatchesPlayedasSubintegerNumber of matches recorded as played as a substitute.
stats.Admin.MatchesPlayerSubstitutedInintegerNumber of matches in which the player was substituted in.
stats.Admin.OffsideintegerNumber of offsides recorded for the player.

​
Attempts

The Attempts object contains the attempt-related values returned for the player.
FieldTypeDescription
stats.Attempts.TotalintegerTotal number of attempts.
stats.Attempts.SuccessintegerNumber of attempts recorded as successful.
stats.Attempts.SavedintegerNumber of attempts recorded as saved.
stats.Attempts.PenaltyMissedintegerNumber of missed penalty attempts.
stats.Attempts.BarsintegerNumber of attempts recorded as hitting the bar or frame of the goal.
stats.Attempts.OneOnOneMissedintegerNumber of missed one-on-one attempts.
stats.Attempts.AttemptToScoreintegerNumber of actions recorded as attempts to score.
stats.Attempts.SuccessAttemptToScoreintegerNumber of successful actions recorded under attempt to score.
stats.Attempts.AccuracynumberAccuracy value returned for the player’s attempts.

​
Ball Lost

The BallLost object contains the recorded ways in which the player lost the ball.
FieldTypeDescription
stats.BallLost.TotalintegerTotal number of ball losses.
stats.BallLost.UnderPressureintegerNumber of ball losses recorded while under pressure.
stats.BallLost.AerialintegerNumber of ball losses recorded in aerial situations.

​
Ball Receive

The BallReceive object contains the player’s recorded ball receptions.
FieldTypeDescription
stats.BallReceive.TotalintegerTotal number of ball-reception actions.
stats.BallReceive.SuccessintegerNumber of successful ball receptions.
stats.BallReceive.FailintegerNumber of failed ball receptions.
stats.BallReceive.AccuracynumberAccuracy value returned for ball receptions.

​
Ball Won

The BallWon object contains the actions through which the player was recorded as winning or recovering the ball.
FieldTypeDescription
stats.BallWon.TotalintegerTotal number of ball-won actions.
stats.BallWon.TackleWonintegerNumber of ball-won actions recorded through tackles.
stats.BallWon.InterceptionWonintegerNumber of ball-won actions recorded through interceptions.
stats.BallWon.AerialintegerNumber of aerial ball-won actions.
stats.BallWon.BallRecoverintegerNumber of ball recoveries.

​
Chances

The Chances object contains chance-creation values.
FieldTypeDescription
stats.Chances.KeyPassesintegerNumber of key passes.
stats.Chances.AssistsintegerNumber of assists.
stats.Chances.ChancesCreatedintegerNumber of chances created.

​
Cards

The Cards object contains disciplinary-card statistics.
FieldTypeDescription
stats.Cards.YellowintegerNumber of yellow cards.
stats.Cards.SecondYellowintegerNumber of second-yellow cards.
stats.Cards.RedintegerNumber of red cards.

​
Cross

The Cross object contains the player’s overall crossing statistics.
FieldTypeDescription
stats.Cross.SuccessintegerNumber of successful crosses.
stats.Cross.TotalintegerTotal number of crosses.
stats.Cross.AccuracynumberAccuracy value returned for crosses.

​
Open-Play Cross

The OpenPlayCross object contains crosses classified as open-play crosses.
FieldTypeDescription
stats.OpenPlayCross.SuccessintegerNumber of successful open-play crosses.
stats.OpenPlayCross.TotalintegerTotal number of open-play crosses.
stats.OpenPlayCross.AccuracynumberAccuracy value returned for open-play crosses.

​
Set-Piece Cross

The SetPieceCross object contains crosses classified as set-piece crosses.
FieldTypeDescription
stats.SetPieceCross.SuccessintegerNumber of successful set-piece crosses.
stats.SetPieceCross.TotalintegerTotal number of set-piece crosses.
stats.SetPieceCross.AccuracynumberAccuracy value returned for set-piece crosses.

​
Dribble

The Dribble object contains the player’s dribbling statistics.
FieldTypeDescription
stats.Dribble.TotalintegerTotal number of dribbles.
stats.Dribble.SuccessintegerNumber of successful dribbles.
stats.Dribble.FailintegerNumber of failed dribbles.
stats.Dribble.AccuracynumberAccuracy value returned for dribbles.

​
Defensive

The Defensive object contains defensive actions and defensive-related values returned by the endpoint.
FieldTypeDescription
stats.Defensive.TackleFailintegerNumber of failed tackles.
stats.Defensive.TackleClearintegerNumber of actions recorded as tackle clearances.
stats.Defensive.InterceptionClearintegerNumber of actions recorded as interception clearances.
stats.Defensive.ClearintegerNumber of clearances.
stats.Defensive.CleansheetintegerClean-sheet value returned for the player.
stats.Defensive.GoalsSavedintegerNumber of goals saved as returned in the defensive category.
stats.Defensive.BlocksintegerNumber of blocks.
stats.Defensive.OpportunitySavedintegerNumber of opportunities saved.
stats.Defensive.xGAnumberxGA value returned for the player in the defensive category.

​
Fouls

The Fouls object contains fouls committed by and awarded to the player.
FieldTypeDescription
stats.Fouls.CommittedintegerNumber of fouls committed by the player.
stats.Fouls.AwardedintegerNumber of fouls awarded to the player.
stats.Fouls.CommittedInDefensiveThirdintegerNumber of fouls committed in the defensive third.
stats.Fouls.AwardedInOffensiveThirdintegerNumber of fouls awarded to the player in the offensive third.

​
Goalkeeper Statistics

The GK object contains goalkeeper-related statistics. This object may be included even when the requested player is not a goalkeeper. The presence of the object does not by itself indicate that the player played as a goalkeeper.

​
Goalkeeper Attempts

FieldTypeDescription
stats.GK.Attempts.TotalintegerTotal goalkeeper attempt actions returned by the API.
stats.GK.Attempts.SuccessintegerNumber of goalkeeper attempt actions recorded as successful.
stats.GK.Attempts.SavedintegerNumber of goalkeeper attempt actions recorded as saved.

​
Goalkeeper One-on-One

FieldTypeDescription
stats.GK.OneonOne.TotalintegerTotal number of goalkeeper one-on-one situations.
stats.GK.OneonOne.SavedintegerNumber of one-on-one situations saved.
stats.GK.OneonOne.GoalintegerNumber of goals recorded from one-on-one situations.

​
Goalkeeper Cross

FieldTypeDescription
stats.GK.Cross.TotalintegerTotal number of goalkeeper cross actions.
stats.GK.Cross.SavedintegerNumber of goalkeeper cross actions recorded as saved.

​
Goalkeeper Shoot

FieldTypeDescription
stats.GK.Shoot.GoalintegerNumber of goals recorded in the goalkeeper shooting category.
stats.GK.Shoot.SavedintegerNumber of saves recorded in the goalkeeper shooting category.

​
Goalkeeper Penalty

FieldTypeDescription
stats.GK.Penalty.TotalintegerTotal number of goalkeeper penalty situations.
stats.GK.Penalty.SavedintegerNumber of penalties saved.
stats.GK.Penalty.GoalintegerNumber of penalty goals recorded against the goalkeeper.

​
Goalkeeper Free Kick

FieldTypeDescription
stats.GK.Freekick.GoalintegerNumber of free-kick goals recorded against the goalkeeper.
stats.GK.Freekick.SavedintegerNumber of free-kick saves.

​
Goalkeeper Goals Conceded

FieldTypeDescription
stats.GK.GoalConcededintegerNumber of goals conceded in the goalkeeper category.

​
Goals Scored

The GoalsScored object contains the player’s total goals and the returned goal classifications.
FieldTypeDescription
stats.GoalsScored.TotalintegerTotal number of goals scored.
stats.GoalsScored.PenaltyScoredintegerNumber of penalty goals scored.
stats.GoalsScored.OwnGoalsintegerNumber of own goals recorded for the player.
stats.GoalsScored.HeadintegerNumber of goals recorded as scored with the head.
stats.GoalsScored.T_0_15integerNumber of goals recorded from minute 0 through minute 15.
stats.GoalsScored.T_15_30integerNumber of goals recorded from minute 15 through minute 30.
stats.GoalsScored.T_30_45integerNumber of goals recorded from minute 30 through minute 45.
stats.GoalsScored.T_45_60integerNumber of goals recorded from minute 45 through minute 60.
stats.GoalsScored.T_60_75integerNumber of goals recorded from minute 60 through minute 75.
stats.GoalsScored.T_75_90integerNumber of goals recorded from minute 75 through minute 90.
stats.GoalsScored.RightFootintegerNumber of goals recorded as scored with the right foot.
stats.GoalsScored.LeftFootintegerNumber of goals recorded as scored with the left foot.
stats.GoalsScored.OtherintegerNumber of goals recorded under another scoring-body-part classification.
stats.GoalsScored.SetPieceintegerNumber of goals recorded as set-piece goals.
stats.GoalsScored.T_90_105integerNumber of goals recorded from minute 90 through minute 105.
stats.GoalsScored.T_105_120integerNumber of goals recorded from minute 105 through minute 120.
stats.GoalsScored.XGnumberExpected-goals value returned for the player.

​
Goals Conceded

The GoalsConceded object contains goals-conceded values returned for the player.
FieldTypeDescription
stats.GoalsConceded.OwnGoalsintegerNumber of own goals included in the goals-conceded category.
stats.GoalsConceded.TotalintegerTotal number of goals conceded returned for the player.

​
Long Pass

The LongPass object contains passes classified as long passes.
FieldTypeDescription
stats.LongPass.SuccessintegerNumber of successful long passes.
stats.LongPass.AccuracynumberAccuracy value returned for long passes.
stats.LongPass.TotalintegerTotal number of long passes.

​
Pass

The Pass object contains the player’s overall passing statistics.
FieldTypeDescription
stats.Pass.SuccessintegerNumber of successful passes.
stats.Pass.TotalintegerTotal number of passes.
stats.Pass.AccuracynumberAccuracy value returned for passes.

​
Penalty

The Penalty object contains penalties committed by or awarded to the player.
FieldTypeDescription
stats.Penalty.CommittedintegerNumber of penalties committed by the player.
stats.Penalty.AwardedintegerNumber of penalties awarded to the player.

​
Short Pass

The ShortPass object contains passes classified as short passes.
FieldTypeDescription
stats.ShortPass.TotalintegerTotal number of short passes.
stats.ShortPass.SuccessintegerNumber of successful short passes.
stats.ShortPass.AccuracynumberAccuracy value returned for short passes.