​
Overview

The MatchPlayerHeatmap endpoint can return a rendered heatmap image for a player during a match. Instead of returning raw coordinate data, this request generates a visual heatmap image with a transparent background, showing the areas where the player was most active on the pitch. The heatmap intensity represents frequency of activity:
  • Red zones indicate the highest activity
  • Yellow/green zones represent medium activity
  • Blue zones represent lower activity
This format is typically used for:
  • Broadcast graphics
  • Tactical analysis reports
  • Scouting dashboards
  • Match analysis tools

​
Parameters

​
module
string
Module API fixed and cannot be changed. Always use api.
​
api
string
Endpoint name. Use MatchPlayerHeatmap.
​
version
string
API version. Use V2.
​
match_id
integer
Unique identifier of the match.
​
player_id
integer
Unique identifier of the player.
​
type
string
Set this parameter to image to return the rendered heatmap image.
​
width
integer
Width of the generated image in pixels.
The height is automatically calculated to preserve the image aspect ratio.
​
dot_size
integer
Controls the heat intensity radius of each activity point.
Allowed values: 32, 50, 100.
​
key
string
API authentication key.

​
Example Request

curl --request GET \
--url "https://korastats.pro/pro/api.php?module=api&api=MatchPlayerHeatmap&version=V2&match_id=25997&player_id=980&type=image&width=580&dot_size=32&key=YOUR_API_KEY"
Hero Dark

​
Response

The response is a PNG image with transparent background representing the player heatmap.
Hero Dark

​
Notes

  • The image background is transparent, making it easy to overlay on pitch graphics.
  • Heat colors represent activity density, with red indicating the highest activity zones.
  • Increasing dot_size will produce larger and smoother heat clusters.
  • The height is automatically calculated based on the pitch aspect ratio.
  • This endpoint is commonly used for visual match analysis and broadcast graphics.