Welcome to the KoraStats Documentation, the official resource for understanding how the KoraStats platform collects, structures, analyzes, and delivers football data. KoraStats is a modern football analytics ecosystem designed to transform match events into actionable insights.
Through a structured data model, advanced metrics, and visual analysis tools, the platform enables analysts, coaches, scouts, and developers to explore football performance with precision.
This guide explains the core concepts behind the KoraStats data model, event taxonomy, spatial coordinate systems, and analytical workflows used throughout the platform.

​
What You Will Learn

Pitch & Spatial Models

Understand how the normalized pitch coordinate system works and how event locations are represented on the field.

Topics include:

  • Pitch dimensions
  • Coordinate systems
  • Spatial event locations
  • Tactical zones

Event Definitions

Learn the taxonomy used to classify match events.

This includes:

  • Passing events
  • Defensive actions
  • Shooting events
  • Ball progression actions

Match Data Workflow

Explore the data collection and quality control workflow used to ensure the accuracy of match data.

Topics include:

  • Event capture methodology
  • Revision process
  • Quality control
  • Data validation

Statistics & Metrics

Understand how match data is transformed into advanced football metrics.

Examples include:

  • Player performance indicators
  • Possession statistics
  • Attacking metrics
  • Defensive metrics

​
Who This Guide Is For

This documentation is designed for professionals working with football data, including:
  • Performance analysts
  • Coaches and technical staff
  • Scouting departments
  • Data scientists
  • Developers integrating the KoraStats API
Each section provides clear explanations to help users understand how football events are structured, analyzed, and interpreted within the KoraStats ecosystem.

​
Platform Philosophy

KoraStats is built around three fundamental principles:

Accuracy

All data goes through multi-stage validation and quality control processes to ensure reliable analysis.

Clarity

Event definitions and coordinate systems are designed to produce clear and interpretable football insights.

Consistency

Standardized taxonomies and spatial models ensure consistent analysis across competitions and seasons.

​
Getting Started

If you are new to the platform, we recommend starting with the following sections:
  1. Pitch Coordinate System
  2. Event Definitions and Taxonomy
  3. Match Data Workflow
These sections provide the foundational concepts required to understand how KoraStats represents football data.
Throughout the documentation you will find diagrams, coordinate references, and examples designed to help you quickly understand how match events translate into analytical insights.