The PlayerPenaltyLocation endpoint returns the historical penalty shot locations for a specific player. GET /api.php

​
Parameters

​
module
string
Module API fixed and cannot be changed. Always use api.
​
api
string
Endpoint name. Use PlayerPenaltyLocation.
​
version
string
API version. Use V2.
​
player_id
integer
Unique identifier of the player whose penalty shots are requested.
​
lang
string
Language of the returned player information. Supported values: en, ar.
​
response
string
Output format. Supported values: json, xml, or image.
The response includes:
  • Player information
  • Shot location coordinates
  • Foot used for the penalty
  • Shot result
  • Field and goal dimensions for visualization
This endpoint is useful for:
  • Penalty analysis
  • Player shooting tendencies
  • Goalkeeper preparation
  • Data visualization of penalty placements

​
Example Request

curl "https://korastats.pro/pro/api.php?module=api&api=PlayerPenaltyLocation&version=V2&response=json&lang=en&player_id=6175"

{
  "result": "Success",
  "message": "Penalties successfully loaded, found 7 events",
  "data": {
    "_type": "PENALTY SHOT LOCATION",
    "player": {
      "_type": "PLAYER",
      "id": 6175,
      "name": "Kevin De Bruyne",
      "nickname": "Kevin De Bruyne",
      "dob": "1991-06-28",
      "number": 11,
      "position": {
        "primay": {
          "_type": "POSITION",
          "id": 8,
          "name": "AM"
        },
        "secondary": {
          "_type": "POSITION",
          "id": 7,
          "name": "CM"
        }
      },
      "nationality": {
        "_type": "NATIONALITY",
        "id": 19,
        "name": "Belgium"
      }
    },
    "penalties": [
      {
        "_type": "EVENT",
        "location": { "x": 118, "y": 3 },
        "foot": "RightFoot",
        "result": "Goal"
      },
      {
        "_type": "EVENT",
        "location": { "x": -126, "y": 30 },
        "foot": "RightFoot",
        "result": "Goal"
      },
      {
        "_type": "EVENT",
        "location": { "x": -129, "y": 32 },
        "foot": "RightFoot",
        "result": "Goal"
      },
      {
        "_type": "EVENT",
        "location": { "x": -143, "y": 23 },
        "foot": "RightFoot",
        "result": "Goal"
      },
      {
        "_type": "EVENT",
        "location": { "x": 135, "y": 13 },
        "foot": "RightFoot",
        "result": "Goal"
      },
      {
        "_type": "EVENT",
        "location": { "x": 19, "y": 14 },
        "foot": "RightFoot",
        "result": "Goal"
      },
      {
        "_type": "EVENT",
        "location": { "x": -144, "y": 19 },
        "foot": "RightFoot",
        "result": "Goal"
      }
    ],
    "dimensions": {
      "pixel": {
        "field": {
          "x1": -400,
          "y1": 0,
          "x2": 400,
          "y2": 160
        },
        "goal": {
          "x1": -150,
          "y1": 0,
          "x2": 150,
          "y2": 100
        },
        "unit": "pixels"
      },
      "real": {
        "field": {
          "width": 20,
          "height": 4
        },
        "goal": {
          "width": 7.3152,
          "height": 2.4384
        },
        "unit": "meter"
      }
    }
  }
}

​
Image Output

When the response parameter is set to image, the API returns a rendered visualization of the player’s penalty shots instead of structured data. The generated image displays the goal frame and shot locations, allowing a quick visual understanding of the player’s penalty tendencies. Each penalty is plotted using the coordinates returned by the API.

​
Visualization Elements

ElementDescription
Goal FrameRepresents the official football goal dimensions
Green MarkersEach marker represents a penalty shot location
X CoordinateHorizontal placement of the shot inside the goal
Y CoordinateVertical placement of the shot inside the goal

​
Example Visualization

Hero Dark

​
Use Cases

The image output is designed for scenarios where visual representation is preferred over raw data. Typical use cases include:
  • Scouting reports to quickly identify penalty shooting patterns.
  • Goalkeeper preparation by studying typical shot placement.
  • Broadcast graphics for television or live match analysis.
  • Media articles illustrating a player’s penalty tendencies.
  • Dashboards and analytics platforms displaying quick visual summaries.

​
Notes

  • The visualization is generated dynamically from the penalty shot coordinates.
  • The goal dimensions follow the official size 7.32m × 2.44m.
  • Coordinates are internally mapped to a pixel grid defined in the dimensions section of the API response.