PandaScore REST API for All Videogames
Introduction Whether you're looking to build an official Pandascore integration for your service, or you just want to build something awesome, [we can help…
Media & content#openapi#entertainment
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Introduction
Whether you're looking to build an official Pandascore integration for your service, or you just want to build something awesome, we can help you get started.
The API works over the HTTPS protocol, and is accessed from the api.pandascore.co domain.
- The current endpoint is https://api.pandascore.co.
- All data is sent and received as JSON by default.
- Blank fields are included with
nullvalues instead of being omitted. - All timestamps are returned in ISO-8601 format
About this documentation
Clicking on a query parameter like filter or search will show you the available options:
You can also click on a response to see the detailed response schema:
Events hierarchy
The PandaScore API allows you to access data about eSports events by using a certain structure detailed below.
Leagues
Leagues are the top level events. They don't have a date and represent a regular competition. A League is composed of one or several series.
Some League of Legends leagues are: _EU LCS, NA LCS, LCK, etc._
Some Dota 2 leagues are: _ESL One, GESC, The International, PGL, etc._
Series
A Serie represents an occurrence of a league event.
The EU LCS league has two series per year: _spring 2017, summer 2017, spring 2016, summer 2016 etc._
Some Dota2 Series examples would be: _Changsha Major, Open Bucharest, Frankfurt, i-League Invitational etc._
Tournaments
Tournaments groups all the matches of a serie under "stages" and "groups".
The tournaments of the EU LCS of summer 2017 are: _Group A, Group B, Playoffs, etc._
Some Dota 2 tournaments are: _Group A, Group B, Playoffs, etc._
Matches
Finally we have matches which have two players or teams (depending on the played videogame) and several games (the rounds of the match).
Matches of the group A in the EU LCS of summer 2017 are: _G2 vs FNC, MSF vs NIP, etc._
Matches of the group A in the ESL One, Genting tournamnet are: _Lower Round 1, Quarterfinal, Upper Final, etc._
Please note that some matches may be listed as "TBD vs TBD" if the matchup is not announced yet, for example the date of the Final match is known but the quarterfinal is still being played.
Formats
<!-- The API currently supports the JSON format by default, as well as the XML format. Add the desired extension to your request URL in order to get that format. -->
The API currently supports the JSON format by default.
Other formats may be added depending on user needs.
Pagination
The Pandascore API paginates all resources on the index method.
Requests that return multiple items will be paginated to 50 items by default. You can specify further pages with the page[number] parameter. You can also set a custom page size (up to 100) with the page[size] parameter.
The Link HTTP response header contains pagination data with first, previous, next and last raw page links when available, under the format
Link: <https://api.pandascore.co/{Resource}?page=X+1>; rel="next", <https://api.pandascore.co/{Resource}?page=X-1>; rel="prev", <https://api.pandascore.co/{Resource}?page=1>; rel="first", <https://api.pandascore.co/{Resource}?page=X+n>; rel="last"There is also:
- A
X-Pageheader field, which contains the current page. - A
X-Per-Pageheader field, which contains the current pagination length. - A
X-Totalheader field, which contains the total count of items across all pages.
Filtering
The filter query parameter can be used to filter a collection by one or several fields for one or several values. The filter parameter takes the field to filter as a key, and the values to filter as the value. Multiples values must be comma-separated (,).
For example, the following is a request for all the champions with a name matching Twitch or Brand exactly, but only with 21 armor:
GET /lol/champions?filter[name]=Brand,Twitch&filter[armor]=21&token=YOUR_ACCESS_TOKENRange
The range parameter is a hash that allows filtering fields by an interval.
Only values between the given two comma-separated bounds will be returned. The bounds are inclusive.
For example, the following is a request for all the champions with hp within 500 and 1000:
GET /lol/champions?range[hp]=500,1000&token=YOUR_ACCESS_TOKENSearch
The search parameter is a bit like the filter parameter, but it will return all results where the values contain the given parameter.
Note: this only works on strings.
Searching with integer values is not supported and filter or range parameters may be better suited for your needs here.
For example, to get all the champions with a name containing "twi":
$ curl -sg -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' 'https://api.pandascore.co/lol/champions?search[name]=twi' | jq -S '.[].name'
"Twitch"
"Twisted Fate"Sorting
All index endpoints support multiple sort fields with comma-separation (,); the fields are applied in the order…
Endpoints 56
Incidents
- GETList additions
/additions?page=1&per_page=5&type=league&since=2024-01-01T00:00:00Z&videogame=1Get the latest additions. This endpoint only shows unchanged objects. - GETList changes
/changes?page=1&per_page=5&type=league&since=2024-01-01T00:00:00Z&videogame=1Get the latest updates. This endpoint only provides the latest change for an object. It does not keep track of previous changes. - GETList deletions
/deletions?page=1&per_page=5&type=league&since=2024-01-01T00:00:00Z&videogame=1Get the latest deleted documents - GETList changes, additions and deletions
/incidents?page=1&per_page=5&type=league&since=2024-01-01T00:00:00Z&videogame=1Get the latest updates and additions. This endpoint only provides the latest incident for an object. It does not keep track of previous incidents.
Leagues
- GETList leagues
/leagues?search={"name":"Contenders"}&sort=name,-modified_at&range={"modified_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&filter={"id":[1],"modified_at":["2024-01-01T00:00:00Z"],"name":["string"],"slug":["string"],"url":["https://example.com"]}&page=1&per_page=5List leagues - GETGet a league
/leagues/:league_id_or_slugGet a single league by ID or by slug - GETGet matches for a league
/leagues/:league_id_or_slug/matches?filter={"detailed_stats":true}&search={"name":"Finals"}&sort=tournament_id,scheduled_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List matches of the given league - GETGet past matches for league
/leagues/:league_id_or_slug/matches/past?filter={"detailed_stats":true}&search={"name":"Finals"}&sort=tournament_id,scheduled_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List past matches for the given league - GETGet running matches for league
/leagues/:league_id_or_slug/matches/running?filter={"detailed_stats":true}&search={"name":"Finals"}&sort=tournament_id,scheduled_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List currently running matches for the given league - GETGet upcoming matches for league
/leagues/:league_id_or_slug/matches/upcoming?filter={"detailed_stats":true}&search={"name":"Finals"}&sort=tournament_id,scheduled_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List upcoming matches for the given league - GETList series of a league
/leagues/:league_id_or_slug/series?filter={"winner_id":390,"winner_type":"Team"}&search={"slug":"lck"}&sort=year,-modified_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List series for the given league - GETGet tournaments for a league
/leagues/:league_id_or_slug/tournaments?filter={"serie_id":1808}&search={"name":"group"}&sort=serie_id,-begin_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List tournaments of the given league
Matches
- GETList lives matches
/lives?page=1&per_page=5List currently running live matches, available from pandascore with live websocket data. - GETList matches
/matches?filter={"detailed_stats":true}&search={"name":"Finals"}&sort=tournament_id,scheduled_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List matches - GETGet past matches
/matches/past?filter={"detailed_stats":true}&search={"name":"Finals"}&sort=tournament_id,scheduled_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List past matches - GETGet running matches
/matches/running?filter={"detailed_stats":true}&search={"name":"Finals"}&sort=tournament_id,scheduled_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List currently running matches - GETGet upcoming matches
/matches/upcoming?filter={"detailed_stats":true}&search={"name":"Finals"}&sort=tournament_id,scheduled_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List upcoming matches - GETGet a match
/matches/:match_id_or_slugGet a single match by ID or by slug - GETGet match's opponents
/matches/:match_id_or_slug/opponentsList opponents (player or teams) for the given match
Players
- GETList players
/players?filter={"hometown":"France"}&search={"role":"tank"}&sort=last_name&range={"name":["f","i"]}&page=1&per_page=5List players - GETGet a player
/players/:player_id_or_slugGet a single player by ID or by slug - GETGet matches for a player
/players/:player_id_or_slug/matches?filter={"detailed_stats":true}&search={"name":"Finals"}&sort=tournament_id,scheduled_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List matches for the given player. Only matches with detailed stats. Available with the plan _Historical data_.
Series
- GETList series
/series?filter={"winner_id":390,"winner_type":"Team"}&search={"slug":"lck"}&sort=year,-modified_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List series - GETGet past series
/series/past?filter={"winner_id":390,"winner_type":"Team"}&search={"slug":"lck"}&sort=year,-modified_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List past series - GETGet running series
/series/running?filter={"winner_id":390,"winner_type":"Team"}&search={"slug":"lck"}&sort=year,-modified_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List currently running series - GETGet upcoming series
/series/upcoming?filter={"winner_id":390,"winner_type":"Team"}&search={"slug":"lck"}&sort=year,-modified_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List upcoming series - GETGet a serie
/series/:serie_id_or_slugGet a single serie by ID or by slug - GETGet matches for a serie
/series/:serie_id_or_slug/matches?filter={"detailed_stats":true}&search={"name":"Finals"}&sort=tournament_id,scheduled_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List matches of the given serie - GETGet past matches for serie
/series/:serie_id_or_slug/matches/past?filter={"detailed_stats":true}&search={"name":"Finals"}&sort=tournament_id,scheduled_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List past matches for the given serie - GETGet running matches for serie
/series/:serie_id_or_slug/matches/running?filter={"detailed_stats":true}&search={"name":"Finals"}&sort=tournament_id,scheduled_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List currently running matches for the given serie - GETGet upcoming matches for serie
/series/:serie_id_or_slug/matches/upcoming?filter={"detailed_stats":true}&search={"name":"Finals"}&sort=tournament_id,scheduled_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List upcoming matches for the given serie - GETGet players for a serie
/series/:serie_id_or_slug/players?filter={"hometown":"France"}&search={"role":"tank"}&sort=last_name&range={"name":["f","i"]}&page=1&per_page=5List players for the given serie - GETGet tournaments for a serie
/series/:serie_id_or_slug/tournaments?filter={"serie_id":1808}&search={"name":"group"}&sort=serie_id,-begin_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List tournaments of the given serie
Teams
- GETList teams
/teams?filter={"acronym":"RNG"}&search={"name":"vitality"}&sort=name&range={"name":["vitality","vultur"]}&page=1&per_page=5List teams - GETGet a team
/teams/:team_id_or_slugGet a single team by ID or by slug - GETGet leagues for a team
/teams/:team_id_or_slug/leagues?search={"name":"Contenders"}&sort=name,-modified_at&range={"modified_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&filter={"id":[1],"modified_at":["2024-01-01T00:00:00Z"],"name":["string"],"slug":["string"],"url":["https://example.com"]}&page=1&per_page=5List leagues in which the given team was part of - GETGet matches for team
/teams/:team_id_or_slug/matches?filter={"detailed_stats":true}&search={"name":"Finals"}&sort=tournament_id,scheduled_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List matches for the given team - GETGet series for a team
/teams/:team_id_or_slug/series?filter={"winner_id":390,"winner_type":"Team"}&search={"slug":"lck"}&sort=year,-modified_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List series in which the given team was part of - GETGet tournaments for a team
/teams/:team_id_or_slug/tournaments?filter={"serie_id":1808}&search={"name":"group"}&sort=serie_id,-begin_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List tournaments in which the given team was part of
Tournaments
- GETList tournaments
/tournaments?filter={"serie_id":1808}&search={"name":"group"}&sort=serie_id,-begin_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List tournaments - GETGet past tournaments
/tournaments/past?filter={"serie_id":1808}&search={"name":"group"}&sort=serie_id,-begin_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List past tournaments - GETGet running tournaments
/tournaments/running?filter={"serie_id":1808}&search={"name":"group"}&sort=serie_id,-begin_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List currently running tournaments - GETGet upcoming tournaments
/tournaments/upcoming?filter={"serie_id":1808}&search={"name":"group"}&sort=serie_id,-begin_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List upcoming tournaments - GETGet a tournament
/tournaments/:tournament_id_or_slugGet a single tournament by ID or by slug - GETGet a tournament's brackets
/tournaments/:tournament_id_or_slug/brackets?filter={"begin_at":["2024-01-01T00:00:00Z"],"detailed_stats":true,"draw":true,"end_at":["2024-01-01T00:00:00Z"],"forfeit":true,"game_advantage":[1],"id":[1],"live_embed_url":["https://example.com"],"match_type":["best_of"],"modified_at":["2024-01-01T00:00:00Z"],"name":["string"],"number_of_games":[0],"official_stream_url":["https://example.com"],"original_scheduled_at":["2024-01-01T00:00:00Z"],"scheduled_at":["2024-01-01T00:00:00Z"],"slug":["string"],"status":["canceled"],"tournament_id":[1],"winner_id":[1]}&range={"begin_at":["2024-01-01T00:00:00Z"],"detailed_stats":[true],"draw":[true],"end_at":["2024-01-01T00:00:00Z"],"forfeit":[true],"game_advantage":[1],"id":[1],"live_embed_url":["https://example.com"],"match_type":["best_of"],"modified_at":["2024-01-01T00:00:00Z"],"name":["string"],"number_of_games":[0],"official_stream_url":["https://example.com"],"original_scheduled_at":["2024-01-01T00:00:00Z"],"scheduled_at":["2024-01-01T00:00:00Z"],"slug":["string"],"status":["canceled"],"tournament_id":[1],"winner_id":[1]}&sort=begin_at&search={"live_embed_url":"https://example.com","match_type":"best_of","name":"string","official_stream_url":"https://example.com","slug":"string","status":"canceled"}&page=1&per_page=5Get the brackets of the given tournament - GETGet matches for tournament
/tournaments/:tournament_id_or_slug/matches?filter={"detailed_stats":true}&search={"name":"Finals"}&sort=tournament_id,scheduled_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List matches for the given tournament - GETGet players for a tournament
/tournaments/:tournament_id_or_slug/players?filter={"hometown":"France"}&search={"role":"tank"}&sort=last_name&range={"name":["f","i"]}&page=1&per_page=5List players for the given tournament - GETGet rosters for a tournament
/tournaments/:tournament_id_or_slug/rostersList participants (player or team) for a given tournament. - GETGet tournament standings
/tournaments/:tournament_id_or_slug/standings?page=1&per_page=5Get the current standings for a given tournament
tournaments
- GETGet teams for a tournament
/tournaments/:tournament_id_or_slug/teams?filter={"acronym":"RNG"}&search={"name":"vitality"}&sort=name&range={"name":["vitality","vultur"]}&page=1&per_page=5List teams for the given tournament
Videogames
- GETList videogames
/videogames?page=1&per_page=5List videogames - GETGet a videogame
/videogames/:videogame_id_or_slugGet a single videogame by ID or by slug - GETget_videogames_videogameIdOrSlug_leagues
/videogames/:videogame_id_or_slug/leagues?search={"name":"Contenders"}&sort=name,-modified_at&range={"modified_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&filter={"id":[1],"modified_at":["2024-01-01T00:00:00Z"],"name":["string"],"slug":["string"],"url":["https://example.com"]}&page=1&per_page=5 - GETList series for a videogame
/videogames/:videogame_id_or_slug/series?filter={"winner_id":390,"winner_type":"Team"}&search={"slug":"lck"}&sort=year,-modified_at&range={"begin_at":["2019-04-08T17:00:00Z","2019-10-08T22:00:00Z"]}&page=1&per_page=5List series for the given videogame - GETGet tournaments for a videogame
/videogames/:videogame_id_or_slug/tournaments?filter={"begin_at":["2024-01-01T00:00:00Z"],"end_at":["2024-01-01T00:00:00Z"],"id":[1],"live_supported":true,"modified_at":["2024-01-01T00:00:00Z"],"name":["string"],"prizepool":["string"],"serie_id":[1],"slug":["string"],"winner_id":[1],"winner_type":["Player"]}&range={"begin_at":["2024-01-01T00:00:00Z"],"end_at":["2024-01-01T00:00:00Z"],"id":[1],"modified_at":["2024-01-01T00:00:00Z"],"name":["string"],"prizepool":["string"],"serie_id":[1],"slug":["string"],"winner_id":[1],"winner_type":["Player"]}&sort=begin_at&search={"name":"string","prizepool":"string","slug":"string","winner_type":"Player"}&page=1&per_page=5List tournaments of the given videogame - GETList videogame versions
/videogames/:videogame_id_or_slug/versions?filter={"current":true,"name":["string"]}&range={"current":[true],"name":["string"]}&sort=current&search={"name":"string"}&page=1&per_page=5List available versions for a given videogame
API details
- Base URL
https://api.pandascore.co- Authentication
- A bearer token in the Authorization header
An API key in the token query parameter - Operations
- 56 operations on 56 pathsGET 56
- Main resources
- Series 11Tournaments 10Leagues 8Matches 7Teams 6Videogames 6Incidents 4Players 3Lives 1tournaments 1
- Description format
- OpenAPI 3.0.0, API version
2.23.1 - Links
- OpenAPI document
- Listed from
- APIs.guru OpenAPI Directory (CC0-1.0)
Source updated
How to test the PandaScore REST API for All Videogames in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the PandaScore REST API for All Videogames collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “List additions” (GET /additions?page=1&per_page=5&type=league&since=2024-01-01T00:00:00Z&videogame=1), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the PandaScore REST API for All Videogames?
Introduction Whether you're looking to build an official Pandascore integration for your service, or you just want to build something awesome, [we can help… It is listed under Media & content and has 56 endpoints.
Who publishes the PandaScore REST API for All Videogames?
It is listed from PandaScore's public API description (an OpenAPI document), not published by PandaScore on Swastik Codes. Anyone who controls pandascore.co can claim the profile by adding a DNS TXT record.
What is the base URL of the PandaScore REST API for All Videogames?
Requests go to https://api.pandascore.co. Endpoint paths are added to this base URL.
How do I authenticate with the PandaScore REST API for All Videogames?
It accepts 2 methods: A bearer token in the Authorization header; an API key in the token query parameter.
How many endpoints does the PandaScore REST API for All Videogames have?
56 operations on 56 paths (56 GET). The largest groups are Series, Tournaments, Leagues, Matches.
Is forking the PandaScore REST API for All Videogames free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.