​
Overview

This endpoint returns the ranking of players in a season based on a specific statistical category. The response includes the tournament information, the season, the selected statistic type, and a sorted list of players with their corresponding statistic values.

​
Typical use cases

  • Retrieve top performing players for a specific statistic
  • Build player leaderboard tables
  • Generate scouting insights and analytical dashboards
  • Compare player performance across a competition season
Each record represents a player statistical data point containing:
  • player full name
  • player nickname
  • statistic type
  • statistic value
GET /api.php

​
Parameters

​
module
string
Always use api
​
api
string
The API name, use SeasonPlayerTopStats
​
version
string
The API version (use V2)
​
lang
string
en for English, ar for Arabic
​
response
string
Output format (json or xml)
​
key
string
Your API key
​
season_id
string
The season ID (example: 385)
​
stat_type_id
string
The statistic type ID (example: 22)
​
sort
string
Sort order for the ranking (asc or desc)

​
Example Request

curl --request GET \
  --url "https://korastats.pro/pro/api.php?module=api&api=SeasonPlayerTopStats&version=V2&lang=en&response=json&key=YOUR_API_KEY&season_id=385&stat_type_id=22&sort=asc"

{
  "api": {
    "results": 2,
    "season_id": "385",
    "stat_type_id": "22",
    "stat_type_name": "Goals",
    "ranking": [
      {
        "rank": 1,
        "player_id": "12345",
        "player_name": "Player A",
        "player_nickname": "P. A",
        "stat_value": 25
      },
      {
        "rank": 2,
        "player_id": "67890",
        "player_name": "Player B",
        "player_nickname": "P. B",
        "stat_value": 20
      }
    ]
  }
}