Tournaments in-depth

Learn how to get tournaments participants, brackets, and standings using PandaScore REST API.

Tournaments are a key part of PandaScore data structure. In this section, we will go over some common use cases.

The following example make use of the All video games > Tournaments endpoints. It's also possible to filter tournaments per video games using the video game-specific endpoints (ie. the ones prefixed with /lol, /csgo, etc.)

Running, upcoming, and past tournaments

Since tournaments are the lowest level abstraction around matches, it's common to retrieve matches at the tournament level.

Retrieving the schedule of the active tournaments can be done with the All video games > Get running tournaments endpoint. Similar endpoints exists for past and upcoming tournaments.

Tournaments participants

To get the participants of a tournament, tournaments rosters should be used. Tournaments rosters can be retrieved in two ways.

📘

Notice

Using the teams endpoints only gives the list of players that are currently signed under the organization.

Example

During the first two phases of Flashpoint, Guardian stepped in for Dignitas due to visa approvals delay (source HLTV).

At that time, requesting the team members (/teams/3215) would have returned:

GeT_RiGhT - 17551
Hallzerk - 18347
Xizt - 17552
f0rest - 17553
friberg - 17554

(This is the line-up that was signed with Dignitas.)

While requesting the tournament roster for this team (/tournaments/3798/rosters) would have returned:

f0rest - 17553
Xizt - 17552
GuardiaN - 17525
GeT_RiGhT - 17551
friberg - 17554

(This is the line-up that was playing for Dignitas during this tournament.)

Tournaments brackets

Tournaments brackets are also known as the tree in elimination/knockout tournaments.

To recreate the tournaments brackets, PandaScore provides an API that creates a relationship between a match and its potential predecessors.
Predecessor matches are matches whose winner or loser will automatically be set as participant in a following match.

Using the All video games > Get tournament brackets endpoint, we can retrieve a list of matches with their predecessors defined in the previous_matches field.

For example, 557978 opposes the winners of matches 557974 and 557975.

{
  "id": 557978,
  "name": "Upper Final: EG vs C9",
  "previous_matches": [
    {
      "match_id": 557974,
      "type": "winner"
    },
    {
      "match_id": 557975,
      "type": "winner"
    }
  ]
}

In tournaments with losing bracket, we can also have losers being seeded in a following match. Below is the example of match 557977.

{
  "id": 557977,
  "name": "Lower Round 1: TSM vs 100",
  "previous_matches": [
    {
      "match_id": 557975,
      "type": "loser"
    }
  ]
}

👍

Tip

When the opponents for a match are unknown (TBD vs TBD), you can check the previous_matches to know who are the potential participants.

Tournament standings

Tournament standings can be retrieved using the All video games > Get tournament standings endpoint.


Did this page help you?