Frequently asked questions

📘

If you have more questions

This is a growing section answering commonly asked REST API questions. If you have any questions that you can't find an answer to on this page, please join our developer slack to get support!

What is the difference between the status field and the complete field at the game level?

The status field shows the current state of a game, e.g., finished. The complete field indicates whether a finished game is ready for data consumption. For matches with detailed statistics (detailed_stats = true), the complete field shows whether the post-game statistics are available for usage. For games that do not have detailed statistics available (detailed_stats = false), the game will be complete once the status is finished. Users can employ the detailed_stats and complete fields at the game level to handle data consumption after a game has finished. Once a finished game is complete ( complete = true), the statistics should not change.

How can I tell whether a match will have post-game statistics?

The boolean detailed_stats field at the match level indicates whether a match should have detailed statistics available. There may be rare circumstances where, due to data issues, a child game of a match will not have detailed statistics available. In these cases, the detailed_stats field at the game level will return false and the detailed_stats field at the match level will remain true. If all games of a match will not have detailed statistics available, the detailed_stats field at the match and game levels will return false.

If you're only interested in matches that will have detailed statistics available, you can make use of filtering to only receive these matches in the API response, e.g. https://api.pandascore.co/matches/upcoming?filter[detailed_stats]=true.
More details of filtering can be found in our documentation, and filtering options can be seen on each reference page.

When will post-game statistics be available?

Results will be available in real-time, and detailed post-game statistics will be available typically within 15 minutes of the game ending. Post-game data should only be consumed once complete=true at the game level. Before this, statistics may be partial or still being processed. PandaScore relies on external data sources for data validation. If the source data is delayed, our statistics will be too. Major international events (Worlds, MSI, The International) typically have the most reliable and fastest stats. Our team will publish post-game statistics as soon as they have been validated to ensure high data integrity.

Where can I find the rosters for a tournament?

You can access tournament rosters via the endpoint /tournaments/{tournament_id_or_slug}/rosters. This endpoint displays the expected rosters for each team participating in the tournament. Further information for this endpoint can be found in our reference documentation.

What is a game advantage?

When a match has a game advantage, the first game of the match is automatically won by the specified opponent. This is due to the tournament format, and it is especially seen in tournaments with a lower bracket. The field game_advantage will contain the id of the corresponding opponent if there is a game advantage in the match, otherwise, the field will remain null.

Which endpoints should I use for Counter-Strike 2 (CS2)?

All CS2 data uses the /csgo/ prefix in the API. This is due to legacy naming and applies to all CS2 endpoints including: /csgo/matches, /csgo/games/{game_id}, /csgo/players/{game_id}/stats, etc. There is no /cs2/ prefix. For full details, see our Counter-Strike 2 migration guide.

Why am I getting a CORS error when calling the API?

The PandaScore API does not support direct browser-to-API requests from client-side JavaScript. All API calls must be routed through your own backend server. If you see 'No Access-Control-Allow-Origin header', it means you are making a request directly from the browser. Set up a server-side proxy to make API calls on behalf of your frontend.

Do you provide bookmaker odds?

The PandaScore Statistics API does not include third-party bookmaker odds. PandaScore does offer a separate Odds product with esports odds. For more information about the Odds product, please contact us at [email protected].

Are videogame logos available in the API?

Currently, PandaScore does not provide videogame logos (e.g., a League of Legends or CS2 logo) via the API. Images are available for teams (image_url), players (image_url), leagues (image_url), and videogame-specific entities such as champions, but not for the videogames themselves.

How can I see a player's team history?

Use the /players/{player_id_or_slug}/tournaments endpoint. This returns all tournaments the player has participated in, which includes the team they played for in each tournament. This is the most reliable way to trace a player's career across teams.

I need fast, low-latency data. Do you provide that?

We have a new plan dedicated to low-latency data for Counter-Strike, League of Legends and Dota 2. Please get in touch via [email protected] to learn more.