​
Overview

The MatchLocationAttempts endpoint returns the distribution of shot attempts on the pitch using a grid-based system. The pitch is divided into spatial grid cells, and each cell records the number of attempts that occurred within that area. This endpoint is useful for:
  • Shot distribution analysis
  • Tactical attack patterns
  • Broadcast visualizations
  • Performance analytics dashboards
The response includes:
  • Data → number of attempts recorded in each grid cell
  • GridCenter → coordinates of the center of each grid cell

​
Parameters

​
module
string
Module API fixed and cannot be changed. Always use api.
​
api
string
Endpoint name. Use MatchLocationAttempts.
​
version
string
API version. Use V2.
​
match_id
integer
Unique identifier of the match.
​
team_id
integer
Unique identifier of the team whose attempts are being analyzed.
​
grid_size
integer
Defines the grid resolution used to divide the pitch.
​
type
string
Type of attempts to retrieve. Example: all.
​
response
string
Output format (json or xml).
​
key
string
API authentication key.

​
Example Request

curl --request GET \
--url "https://korastats.pro/pro/api.php?module=api&api=MatchLocationAttempts&version=V2&match_id=25997&team_id=2&grid_size=40&type=all&response=json&key=YOUR_API_KEY"


{
  "result": "Success",
  "message": "Data successfully retreived",
  "data": {
    "Data": {
      "B6": 3,
      "D6": 1,
      "D7": 1,
      "C6": 4,
      "C8": 1,
      "C7": 1
    },
    "GridCenter": {
      "A1": { "x": 2.5, "y": 11.5 },
      "B1": { "x": 2.5, "y": 30.5 },
      "C1": { "x": 2.5, "y": 50.5 }
    }
  }
}

​
Grid Data

The Data object contains the number of attempts recorded in each grid cell.
FieldDescription
A1, B1, C1 …Grid cell identifier
ValueNumber of attempts recorded in that grid cell

​
Example

"C6": 4
This means 4 attempts occurred inside grid cell C6.

​
Grid Center Coordinates

The GridCenter object provides the center coordinates of each grid cell, allowing the grid to be plotted on a pitch.
FieldDescription
xHorizontal position on the pitch
yVertical position on the pitch
These coordinates allow visualization systems to accurately place grid cells on the field.

​
Visualization Example

The grid-based shot distribution can be visualized as shown below.
Hero Dark

​
Notes

  • The pitch is divided into grid cells to aggregate shot locations.
  • Each grid cell records the number of attempts inside that spatial region.
  • The GridCenter coordinates allow precise visualization of the grid.
  • This endpoint is commonly used for shot maps and attacking pattern analysis.