​
Overview

The MatchPlayerHeatmap endpoint returns spatial activity data for a specific player during a match. The response contains coordinates on the pitch where the player interacted with the ball or was active, along with the number of occurrences at each position. This data can be used to generate player heatmaps, showing areas where the player was most active throughout the match. The heatmap is generated relative to a 1920 × 1080 pitch coordinate system. Typical use cases include:
  • Tactical analysis
  • Broadcast graphics
  • Player movement visualization
  • Performance analytics dashboards
  • Scouting tools

​
Parameters

​
module
string
Always use api
​
api
string
API name. Use MatchPlayerHeatmap
​
version
string
API version. Use V2
​
response
string
Output format (json or xml)
​
match_id
integer
Unique identifier of the match
​
team_id
integer
Unique identifier of the player’s team
​
player_id
integer
Unique identifier of the player
​
key
string
API authentication key

​
Example Request

curl --request GET \
--url "https://korastats.pro/pro/api.php?module=api&api=MatchPlayerHeatmap&version=V2&response=json&match_id=25997&team_id=1&player_id=980&key=YOUR_API_KEY"


{
  "result": "Success",
  "message": "heatmap successfully generated",
  "data": [
    {
      "x": "integer",
      "y": "integer",
      "count": "integer"
    }
  ]
}

​
Heatmap Data Fields

FieldDescription
xHorizontal coordinate on the pitch
yVertical coordinate on the pitch
countNumber of recorded events at this coordinate

​
Coordinate System

The heatmap uses a 1920 × 1080 coordinate grid, representing the football pitch.
AxisRangeDescription
X0 → 1920Left to right across the pitch
Y0 → 1080Top to bottom across the pitch
Higher count values indicate areas where the player was more active.

​
Notes

  • Each coordinate represents a cluster of player activity events.
  • Higher counts indicate greater interaction frequency in that zone.
  • The dataset can be visualized using heatmap rendering libraries or pitch visualization tools.
  • Coordinates are designed for full HD pitch visualizations (1920×1080).