​
Overview

The EntityPlayers endpoint returns a paginated list of players. The endpoint supports search filters, pagination, and incremental synchronization using the since parameter. Each player record includes:
  • Player identity
  • Nationality
  • Date of birth and age
  • Primary and secondary positions
  • Current team
  • Gender
  • Player image
  • Retirement status

​
Typical use cases

  • Build searchable player databases
  • Synchronize players with external systems
  • Retrieve players for scouting platforms
  • Load paginated player lists in dashboards
GET /api.php

​
Parameters

​
module
string
Always use api
​
api
string
Always use EntityPlayers
​
version
string
API version. Example: V2
​
response
string
Response format. Always use json
​
lang
string
Language of the response. Example: en
​
tournament_ids
string
Comma-separated list of tournament IDs used to filter players participating in specific tournaments.
​
season_ids
string
Comma-separated list of season IDs used to filter players participating in specific seasons.
​
team_id
integer
Filter players belonging to a specific team.
​
since
datetime
Returns only players updated after the specified date and time.Format: YYYY-MM-DD HH:MM:SS
​
page_size
integer
Number of players returned per page.
​
page_number
integer
Page number of the results to retrieve.

​
Since Parameter

The since parameter allows incremental synchronization. Only players updated after the provided timestamp will be returned. Format requirements:
  • YYYY-MM-DD HH:MM:SS
  • Local time
  • Example: since=2024-04-20 20:39:35
Date components:
ComponentFormatExample
Year4 digits2024
Month2 digits01–12
Day2 digits01–31
Hour2 digits00–23
Minutes2 digits00–59
Seconds2 digits00–59

​
Pagination

The endpoint supports standard pagination.
ParameterDescription
page_sizeNumber of records returned per request
page_numberPage index of the results
Example: page_size=100 page_number=1

​
Example Request

curl --request GET \
  --url "https://korastats.pro/pro/api.php?module=api&api=EntityPlayers&version=V2&response=json&lang=en&page_size=100&page_number=1"

{
  "type": "object",
  "properties": {
    "root": {
      "type": "object",
      "properties": {
        "result": {
          "type": "boolean"
        },
        "title": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "object": {
          "type": "object",
          "properties": {
            "total_records": {
              "type": "integer",
              "description": "Total number of players matching the query."
            },
            "current_records": {
              "type": "integer",
              "description": "Number of players returned in this page."
            },
            "pages": {
              "type": "integer",
              "description": "Total number of pages available."
            },
            "current_page": {
              "type": "integer",
              "description": "Current page number."
            },
            "Data": {
              "type": "array",
              "description": "List of players",
              "items": {
                "type": "object",
                "properties": {
                  "_type": {
                    "type": "string"
                  },
                  "id": {
                    "type": "integer"
                  },
                  "fullname": {
                    "type": "string"
                  },
                  "nickname": {
                    "type": "string"
                  },
                  "nationality": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "integer"
                      },
                      "name": {
                        "type": "string"
                      }
                    }
                  },
                  "dob": {
                    "type": "string",
                    "format": "date"
                  },
                  "age": {
                    "type": "string"
                  },
                  "positions": {
                    "type": "object",
                    "properties": {
                      "primary": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer"
                          },
                          "name": {
                            "type": "string"
                          }
                        }
                      },
                      "secondary": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer"
                          },
                          "name": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  },
                  "retired": {
                    "type": "boolean"
                  },
                  "current_team": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "integer"
                      },
                      "name": {
                        "type": "string"
                      }
                    }
                  },
                  "gender": {
                    "type": "string"
                  },
                  "image": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}