Fundamentals

Learn the fundamentals of the opinionated, flexible data structure PandaScore uses to map esports competitions across all video games.

📘

Coming from sports?

This page uses examples from esports and traditional sports to explain PandaScore data structure.

Leagues

Leagues are the top-level data structure used to represent a competition. Leagues are commonly named after the competition they represent. A league includes one or several children Series.

Examples

  • FIFA World Cup
  • The International

Series

Series represent a single timely occurrence of their parent League. A series includes one or several children Tournaments.

Examples

  • FIFA World Cup — 2018
  • The International — 2018

Tournaments

Tournaments represent a stage in their parent Series. A tournament includes one or several children matches that contribute to a unique standing and possible winner.

Examples

  • FIFA World Cup — 2018 — Group C
  • The International — 2018 — Playoffs

Matches

Matches represent a team-versus-team or player-versus-player confrontation between two participants of a parent Tournament. A match includes one or several children Games.

Matches is the most in-depth generic data structure. Despite many common properties, the data structure for Games (and below) is specific to each video game.

Examples

  • FIFA World Cup — 2018 — Group C — Denmark vs Australia (only 1 game)
  • The International — 2018 — Playoffs — Final: OG vs PSG.LGD (5 games)

In-game results should be retrieved via game-level endpoints (only available for video games supporting Historical Data).

Recap diagram

2782

Data Structure


Next Step

Read to jump in? Let's make our first request!