​
Overview

The MatchPlayerStats endpoint returns the complete performance statistics of a player during a specific match. The response includes:
  • Player information
  • Position and shirt number
  • Detailed statistical breakdown of the player’s performance
Statistics cover multiple performance dimensions including:
  • Passing and short passes
  • Long passes
  • Attempts and shooting
  • Ball possession actions
  • Defensive actions
  • Chances created
  • Fouls and disciplinary records
  • Expected Goals (xG)
  • Expected Threat (xT)
  • Dribbles and crosses
  • Goalkeeper statistics (when applicable)
This endpoint is commonly used for:
  • Player performance analysis
  • Match reports
  • Scouting platforms
  • Broadcast graphics
  • Advanced data analytics systems
GET /api.php

​
Parameters

​
module
string
Always use api
​
api
string
API name. Use MatchPlayerStats
​
version
string
API version. Use V2
​
response
string
Output format (json or xml)
​
lang
string
Language of returned text (en or ar)
​
match_id
integer
The match identifier
​
player_id
integer
The unique identifier of the player
​
since
string
Optional timestamp used for incremental synchronization
Format: YYYY-MM-DD HH:MM:SS
​
key
string
API authentication key

​
Example Request

curl --request GET \
--url "https://korastats.pro/pro/api.php?module=api&api=MatchPlayerStats&version=V2&response=json&lang=en&match_id=25997&player_id=980&since=2024-03-09%2005:31:02&key=YOUR_API_KEY"

{
  "result": "string",
  "message": "string",
  "data": {
    "_type": "PLAYER",
    "id": "integer",
    "name": "string",
    "nickname": "string",
    "dob": "YYYY-MM-DD",
    "shirtnumber": "integer",

    "position": {
      "_type": "POSITION",
      "id": "integer",
      "name": "string"
    },

    "stats": {
      "Admin": {},
      "Attempts": {},
      "BallLost": {},
      "BallReceive": {},
      "BallWon": {},
      "Chances": {},
      "Cards": {},
      "Cross": {},
      "Dribble": {},
      "Defensive": {},
      "Fouls": {},
      "GK": {},
      "GoalsScored": {},
      "GoalsConceded": {},
      "LongPass": {},
      "Pass": {},
      "Penalty": {},
      "ShortPass": {},
      "xT": {}
    }
  }
}

​
Statistics Categories

The stats object contains detailed player performance metrics.

​
Administrative

FieldDescription
MatchesPlayedNumber of matches played
MinutesPlayedTotal minutes played
MatchesPlayedasSubMatches played as substitute
MatchesPlayerSubstitutedInTimes player was substituted into the match

​
Passing

Includes:
  • Total passes
  • Successful passes
  • Pass accuracy
  • Short passes
  • Long passes

​
Attacking

Includes:
  • Attempts
  • Shots on target
  • Chances created
  • Key passes
  • Assists

​
Ball Interaction

MetricDescription
BallReceiveBall reception success
BallLostPossession losses
BallWonDefensive ball recovery

​
Defensive

Includes:
  • Tackles
  • Interceptions
  • Blocks
  • Clearances

​
Cards

Tracks disciplinary actions:
  • Yellow cards
  • Second yellow cards
  • Red cards

​
Expected Goals (xG)

Represents the probability of scoring based on shot quality.

​
Expected Threat (xT)

Represents the threat value generated through player actions, particularly passes and ball progression.