Overview

The MatchPlayersStats API returns the players associated with a specified match together with each player’s profile, team, position, shirt number, and recorded match statistics. The match is selected using the match_id query parameter. Unlike MatchPlayerStats, this endpoint does not require a player_id; it returns a players array containing the available player records for the match. A successful response contains:
  • The API operation status
  • A response title and message
  • A PLAYERS collection object
  • A players array
  • Player identity and profile information
  • Position and team information for each player
  • A categorized stats object for each player
The response may include players from both teams and may include starters, substitutes, and players with limited recorded minutes. The exact number of returned players is stated in the response message. The statistical categories shown in this document are based only on the supplied response. The endpoint may return goalkeeper-related fields for outfield players, commonly with zero values.

Typical Use Cases

  • Loading all player statistics for a match
  • Building match player-statistics tables
  • Producing post-match player reports
  • Comparing players from both teams
  • Supplying match-level player data to broadcast graphics
  • Importing player match data into scouting or analytics systems

Parameters

module
string
API module selector. Use the fixed value api.
api
string
API operation name. Use the fixed value MatchPlayersStats.
version
string
API version. Use V2 for the response structure documented on this page.
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 whose player statistics are requested. Example: 79356.

Endpoint

GET /api.php

Code Examples

curl --request GET \
  --url "https://premium.korastats.pro/api.php?module=api&api=MatchPlayersStats&version=V2&response=json&lang=en&match_id=79356"
{
    "result": true,
    "title": "Success",
    "message": "30 players retrieved in 0.0185 seconds.",
    "object": {
        "_type": "PLAYERS",
        "players": [
            {
                "_type": "PLAYER",
                "id": 41363,
                "name": "Khadija Er-Rmichi",
                "nickname": "Khadija Er-Rmichi",
                "dob": "1989-09-16",
                "shirtnumber": 1,
                "position": {
                    "_type": "POSITION",
                    "id": 1,
                    "name": "GK"
                },
                "team": {
                    "_type": "TEAM",
                    "id": 2145,
                    "name": "Morocco"
                },
                "stats": {
                    "KIndex": {
                        "Points": 6,
                        "Rating": 3.7
                    },
                    "Admin": {
                        "MatchesPlayed": 1,
                        "MinutesPlayed": 99,
                        "MatchesPlayedasSub": 0,
                        "MatchesPlayerSubstitutedIn": 0,
                        "Offside": 0
                    },
                    "Attempts": {
                        "Total": 0,
                        "Success": 0,
                        "Saved": 0,
                        "PenaltyMissed": 0,
                        "Bars": 0,
                        "OneOnOneMissed": 0,
                        "AttemptToScore": 0,
                        "SuccessAttemptToScore": 0,
                        "Accuracy": 0
                    },
                    "BallLost": {
                        "Total": 0,
                        "UnderPressure": 0,
                        "Aerial": 0
                    },
                    "BallReceive": {
                        "Total": 3,
                        "Success": 3,
                        "Fail": 0,
                        "Accuracy": 1
                    },
                    "BallWon": {
                        "Total": 5,
                        "TackleWon": 0,
                        "InterceptionWon": 0,
                        "Aerial": 0,
                        "BallRecover": 5
                    },
                    "Chances": {
                        "KeyPasses": 0,
                        "Assists": 0,
                        "ChancesCreated": 0
                    },
                    "Cards": {
                        "Yellow": 0,
                        "SecondYellow": 0,
                        "Red": 0
                    },
                    "Cross": {
                        "Success": 0,
                        "Total": 0,
                        "Accuracy": 0
                    },
                    "OpenPlayCross": {
                        "Success": 0,
                        "Total": 0,
                        "Accuracy": 0
                    },
                    "SetPieceCross": {
                        "Success": 0,
                        "Total": 0,
                        "Accuracy": 0
                    },
                    "Dribble": {
                        "Total": 0,
                        "Success": 0,
                        "Fail": 0,
                        "Accuracy": 0
                    },
                    "Defensive": {
                        "TackleFail": 0,
                        "TackleClear": 0,
                        "InterceptionClear": 0,
                        "Clear": 0,
                        "Cleansheet": 0,
                        "GoalsSaved": 0,
                        "Blocks": 0,
                        "OpportunitySaved": 0,
                        "xGA": 2.88
                    },
                    "Fouls": {
                        "Committed": 0,
                        "Awarded": 1,
                        "CommittedInDefensiveThird": 0,
                        "AwardedInOffensiveThird": 0
                    },
                    "GK": {
                        "Attempts": {
                            "Total": 15,
                            "Success": 5,
                            "Saved": 2
                        },
                        "OneonOne": {
                            "Total": 0,
                            "Saved": 0,
                            "Goal": 0
                        },
                        "Cross": {
                            "Total": 22,
                            "Saved": 5
                        },
                        "Shoot": {
                            "Goal": 2,
                            "Saved": 2
                        },
                        "Penalty": {
                            "Total": 1,
                            "Saved": 0,
                            "Goal": 1
                        },
                        "Freekick": {
                            "Goal": 0,
                            "Saved": 0
                        },
                        "GoalConceded": 3
                    },
                    "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
                    },
                    "GoalsConceded": {
                        "OwnGoals": 0,
                        "Total": 3
                    },
                    "LongPass": {
                        "Success": 4,
                        "Accuracy": 0.29,
                        "Total": 14
                    },
                    "Pass": {
                        "Success": 6,
                        "Total": 16,
                        "Accuracy": 0.38
                    },
                    "Penalty": {
                        "Committed": 0,
                        "Awarded": 0
                    },
                    "ShortPass": {
                        "Total": 2,
                        "Success": 2,
                        "Accuracy": 1
                    }
                }
            },
            {
                "_type": "PLAYER",
                "id": 57553,
                "name": "Chiamaka Nnadozie",
                "nickname": "Chiamaka Nnadozie",
                "dob": "2000-12-08",
                "shirtnumber": 16,
                "position": {
                    "_type": "POSITION",
                    "id": 1,
                    "name": "GK"
                },
                "team": {
                    "_type": "TEAM",
                    "id": 2118,
                    "name": "Nigeria"
                },
                "stats": {
                    "KIndex": {
                        "Points": 3,
                        "Rating": 2.5
                    },
                    "Admin": {
                        "MatchesPlayed": 1,
                        "MinutesPlayed": 99,
                        "MatchesPlayedasSub": 0,
                        "MatchesPlayerSubstitutedIn": 0,
                        "Offside": 0
                    },
                    "Attempts": {
                        "Total": 0,
                        "Success": 0,
                        "Saved": 0,
                        "PenaltyMissed": 0,
                        "Bars": 0,
                        "OneOnOneMissed": 0,
                        "AttemptToScore": 0,
                        "SuccessAttemptToScore": 0,
                        "Accuracy": 0
                    },
                    "BallLost": {
                        "Total": 0,
                        "UnderPressure": 0,
                        "Aerial": 0
                    },
                    "BallReceive": {
                        "Total": 4,
                        "Success": 4,
                        "Fail": 0,
                        "Accuracy": 1
                    },
                    "BallWon": {
                        "Total": 3,
                        "TackleWon": 0,
                        "InterceptionWon": 0,
                        "Aerial": 0,
                        "BallRecover": 3
                    },
                    "Chances": {
                        "KeyPasses": 0,
                        "Assists": 0,
                        "ChancesCreated": 0
                    },
                    "Cards": {
                        "Yellow": 0,
                        "SecondYellow": 0,
                        "Red": 0
                    },
                    "Cross": {
                        "Success": 0,
                        "Total": 0,
                        "Accuracy": 0
                    },
                    "OpenPlayCross": {
                        "Success": 0,
                        "Total": 0,
                        "Accuracy": 0
                    },
                    "SetPieceCross": {
                        "Success": 0,
                        "Total": 0,
                        "Accuracy": 0
                    },
                    "Dribble": {
                        "Total": 0,
                        "Success": 0,
                        "Fail": 0,
                        "Accuracy": 0
                    },
                    "Defensive": {
                        "TackleFail": 0,
                        "TackleClear": 0,
                        "InterceptionClear": 0,
                        "Clear": 0,
                        "Cleansheet": 0,
                        "GoalsSaved": 0,
                        "Blocks": 0,
                        "OpportunitySaved": 0,
                        "xGA": 1.21
                    },
                    "Fouls": {
                        "Committed": 0,
                        "Awarded": 0,
                        "CommittedInDefensiveThird": 0,
                        "AwardedInOffensiveThird": 0
                    },
                    "GK": {
                        "Attempts": {
                            "Total": 10,
                            "Success": 3,
                            "Saved": 1
                        },
                        "OneonOne": {
                            "Total": 0,
                            "Saved": 0,
                            "Goal": 0
                        },
                        "Cross": {
                            "Total": 8,
                            "Saved": 1
                        },
                        "Shoot": {
                            "Goal": 2,
                            "Saved": 1
                        },
                        "Penalty": {
                            "Total": 0,
                            "Saved": 0,
                            "Goal": 0
                        },
                        "Freekick": {
                            "Goal": 0,
                            "Saved": 0
                        },
                        "GoalConceded": 2
                    },
                    "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
                    },
                    "GoalsConceded": {
                        "OwnGoals": 0,
                        "Total": 2
                    },
                    "LongPass": {
                        "Success": 2,
                        "Accuracy": 0.29,
                        "Total": 7
                    },
                    "Pass": {
                        "Success": 5,
                        "Total": 10,
                        "Accuracy": 0.5
                    },
                    "Penalty": {
                        "Committed": 0,
                        "Awarded": 0
                    },
                    "ShortPass": {
                        "Total": 3,
                        "Success": 3,
                        "Accuracy": 1
                    }
                }
            }
        ]
    }
}

Response Fields

Top-Level Response

FieldTypeDescription
resultbooleanIndicates whether the API operation was successful.
titlestringShort title describing the API result.
messagestringHuman-readable result message. In the supplied response, it also states the number of players returned and the retrieval time.
objectobjectContains the returned players collection.

Players Collection

FieldTypeDescription
object._typestringType label for the collection. The supplied response returns PLAYERS.
object.playersarrayArray of player objects returned for the requested match.

Player Object

FieldTypeDescription
object.players[]._typestringType label for a player record. The supplied response returns PLAYER.
object.players[].idintegerUnique identifier of the player.
object.players[].namestringPlayer’s full name.
object.players[].nicknamestringPlayer’s nickname or shortened display name.
object.players[].dobstringPlayer’s date of birth in YYYY-MM-DD format.
object.players[].shirtnumberintegerPlayer’s shirt number in the returned match record.
object.players[].positionobjectPlayer position information.
object.players[].teamobjectTeam information associated with the player.
object.players[].statsobjectCategorized statistics recorded for the player in the match.

Position Object

FieldTypeDescription
object.players[].position._typestringType label for the position object. The supplied response returns POSITION.
object.players[].position.idintegerUnique identifier of the position.
object.players[].position.namestringPosition name or abbreviation, such as GK, CB, RB, LB, DM, CM, AM, RW, LW, or CF in the supplied response.

Team Object

FieldTypeDescription
object.players[].team._typestringType label for the team object. The supplied response returns TEAM.
object.players[].team.idintegerUnique identifier of the team.
object.players[].team.namestringTeam name.

Statistics Object

Each object.players[].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 corresponding 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
object.players[].stats.KIndex.Pointsinteger or numberKIndex points returned for the player.
object.players[].stats.KIndex.Ratinginteger or numberKIndex rating returned for the player.

Admin

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

Attempts

The Attempts object contains the attempt-related values returned for the player.
FieldTypeDescription
object.players[].stats.Attempts.TotalintegerTotal number of attempts.
object.players[].stats.Attempts.SuccessintegerNumber of attempts recorded as successful.
object.players[].stats.Attempts.SavedintegerNumber of attempts recorded as saved.
object.players[].stats.Attempts.PenaltyMissedintegerNumber of missed penalty attempts.
object.players[].stats.Attempts.BarsintegerNumber of attempts recorded as hitting the bar or frame of the goal.
object.players[].stats.Attempts.OneOnOneMissedintegerNumber of missed one-on-one attempts.
object.players[].stats.Attempts.AttemptToScoreintegerNumber of actions recorded as attempts to score.
object.players[].stats.Attempts.SuccessAttemptToScoreintegerNumber of successful actions recorded under attempt to score.
object.players[].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
object.players[].stats.BallLost.TotalintegerTotal number of ball losses.
object.players[].stats.BallLost.UnderPressureintegerNumber of ball losses recorded while under pressure.
object.players[].stats.BallLost.AerialintegerNumber of ball losses recorded in aerial situations.

Ball Receive

The BallReceive object contains the player’s recorded ball receptions.
FieldTypeDescription
object.players[].stats.BallReceive.TotalintegerTotal number of ball-reception actions.
object.players[].stats.BallReceive.SuccessintegerNumber of successful ball receptions.
object.players[].stats.BallReceive.FailintegerNumber of failed ball receptions.
object.players[].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
object.players[].stats.BallWon.TotalintegerTotal number of ball-won actions.
object.players[].stats.BallWon.TackleWonintegerNumber of ball-won actions recorded through tackles.
object.players[].stats.BallWon.InterceptionWonintegerNumber of ball-won actions recorded through interceptions.
object.players[].stats.BallWon.AerialintegerNumber of aerial ball-won actions.
object.players[].stats.BallWon.BallRecoverintegerNumber of ball recoveries.

Chances

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

Cards

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

Cross

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

Open-Play Cross

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

Set-Piece Cross

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

Dribble

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

Defensive

The Defensive object contains defensive actions and defensive-related values returned by the endpoint.
FieldTypeDescription
object.players[].stats.Defensive.TackleFailintegerNumber of failed tackles.
object.players[].stats.Defensive.TackleClearintegerNumber of actions recorded as tackle clearances.
object.players[].stats.Defensive.InterceptionClearintegerNumber of actions recorded as interception clearances.
object.players[].stats.Defensive.ClearintegerNumber of clearances.
object.players[].stats.Defensive.CleansheetintegerClean-sheet value returned for the player.
object.players[].stats.Defensive.GoalsSavedintegerNumber of goals saved as returned in the defensive category.
object.players[].stats.Defensive.BlocksintegerNumber of blocks.
object.players[].stats.Defensive.OpportunitySavedintegerNumber of opportunities saved.
object.players[].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
object.players[].stats.Fouls.CommittedintegerNumber of fouls committed by the player.
object.players[].stats.Fouls.AwardedintegerNumber of fouls awarded to the player.
object.players[].stats.Fouls.CommittedInDefensiveThirdintegerNumber of fouls committed in the defensive third.
object.players[].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
object.players[].stats.GK.Attempts.TotalintegerTotal goalkeeper attempt actions returned by the API.
object.players[].stats.GK.Attempts.SuccessintegerNumber of goalkeeper attempt actions recorded as successful.
object.players[].stats.GK.Attempts.SavedintegerNumber of goalkeeper attempt actions recorded as saved.

Goalkeeper One-on-One

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

Goalkeeper Cross

FieldTypeDescription
object.players[].stats.GK.Cross.TotalintegerTotal number of goalkeeper cross actions.
object.players[].stats.GK.Cross.SavedintegerNumber of goalkeeper cross actions recorded as saved.

Goalkeeper Shoot

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

Goalkeeper Penalty

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

Goalkeeper Free Kick

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

Goalkeeper Goals Conceded

FieldTypeDescription
object.players[].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
object.players[].stats.GoalsScored.TotalintegerTotal number of goals scored.
object.players[].stats.GoalsScored.PenaltyScoredintegerNumber of penalty goals scored.
object.players[].stats.GoalsScored.OwnGoalsintegerNumber of own goals recorded for the player.
object.players[].stats.GoalsScored.HeadintegerNumber of goals recorded as scored with the head.
object.players[].stats.GoalsScored.T_0_15integerNumber of goals recorded from minute 0 through minute 15.
object.players[].stats.GoalsScored.T_15_30integerNumber of goals recorded from minute 15 through minute 30.
object.players[].stats.GoalsScored.T_30_45integerNumber of goals recorded from minute 30 through minute 45.
object.players[].stats.GoalsScored.T_45_60integerNumber of goals recorded from minute 45 through minute 60.
object.players[].stats.GoalsScored.T_60_75integerNumber of goals recorded from minute 60 through minute 75.
object.players[].stats.GoalsScored.T_75_90integerNumber of goals recorded from minute 75 through minute 90.
object.players[].stats.GoalsScored.RightFootintegerNumber of goals recorded as scored with the right foot.
object.players[].stats.GoalsScored.LeftFootintegerNumber of goals recorded as scored with the left foot.
object.players[].stats.GoalsScored.OtherintegerNumber of goals recorded under another scoring-body-part classification.
object.players[].stats.GoalsScored.SetPieceintegerNumber of goals recorded as set-piece goals.
object.players[].stats.GoalsScored.T_90_105integerNumber of goals recorded from minute 90 through minute 105.
object.players[].stats.GoalsScored.T_105_120integerNumber of goals recorded from minute 105 through minute 120.
object.players[].stats.GoalsScored.XGnumberExpected-goals value returned for the player.

Goals Conceded

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

Long Pass

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

Pass

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

Penalty

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

Short Pass

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