Documentation Powered by ReDoc

Lolesports Api (1.0.0-alpha-1)

Download OpenAPI specification:Download

Unofficial documentation to the lolesports Api

Authentication

apiKeyAuth

The key is, 0TvQnueqKa5mxJntVWt0w4LpLfEkrV1Ta8rQBb9Z

Security scheme type: API Key
Header parameter name: x-api-key

leagues

Get information about a league, the standings and its various tournaments.

getLeagues

Authorizations:
apiKeyAuth
query Parameters
hl
required
string (locale)
Enum:"en-US" "en-GB" "en-AU" "cs-CZ" "de-DE" "el-GR" "es-ES" "es-MX" "fr-FR" "hu-HU" "it-IT" "pl-PL" "pt-BR" "ro-RO" "ru-RU" "tr-TR" "ja-JP" "ko-KR"

This is the locale or language code using ISO 639-1 and ISO 3166-1 alpha-2

Responses

200

Successful request

get /getLeagues
https://esports-api.lolesports.com/persisted/gw/getLeagues
https://prod-relapi.ewp.gg/persisted/gw/getLeagues

Response samples

application/json
Copy
 Expand all Collapse all
{
  • "data":
    {
    }
}

getTournamentsForLeague

Authorizations:
apiKeyAuth
query Parameters
hl
required
string (locale)
Enum:"en-US" "en-GB" "en-AU" "cs-CZ" "de-DE" "el-GR" "es-ES" "es-MX" "fr-FR" "hu-HU" "it-IT" "pl-PL" "pt-BR" "ro-RO" "ru-RU" "tr-TR" "ja-JP" "ko-KR"

This is the locale or language code using ISO 639-1 and ISO 3166-1 alpha-2

leagueId
integer <int64>

The id of the league you want details of

Responses

200

Successful request

get /getTournamentsForLeague
https://esports-api.lolesports.com/persisted/gw/getTournamentsForLeague
https://prod-relapi.ewp.gg/persisted/gw/getTournamentsForLeague

Response samples

application/json
Copy
 Expand all Collapse all
{
  • "data":
    {
    }
}

getStandings

Authorizations:
apiKeyAuth
query Parameters
hl
required
string (locale)
Enum:"en-US" "en-GB" "en-AU" "cs-CZ" "de-DE" "el-GR" "es-ES" "es-MX" "fr-FR" "hu-HU" "it-IT" "pl-PL" "pt-BR" "ro-RO" "ru-RU" "tr-TR" "ja-JP" "ko-KR"

This is the locale or language code using ISO 639-1 and ISO 3166-1 alpha-2

tournamentId
Array of integers <int64>

The id(s) of the tournament(s) you want details ofs

Responses

200

Successful request

get /getStandings
https://esports-api.lolesports.com/persisted/gw/getStandings
https://prod-relapi.ewp.gg/persisted/gw/getStandings

Response samples

application/json
Copy
 Expand all Collapse all
{
  • "data":
    {
    }
}

events

Get information about ongoing, completed or upcoming events.

getSchedule

Authorizations:
apiKeyAuth
query Parameters
hl
required
string (locale)
Enum:"en-US" "en-GB" "en-AU" "cs-CZ" "de-DE" "el-GR" "es-ES" "es-MX" "fr-FR" "hu-HU" "it-IT" "pl-PL" "pt-BR" "ro-RO" "ru-RU" "tr-TR" "ja-JP" "ko-KR"

This is the locale or language code using ISO 639-1 and ISO 3166-1 alpha-2

leagueId
Array of integers <int64>

The id(s) of the league(s) you want details of

pageToken
string <byte>

Base 64 encoded string used to determine the next "page" of data to pull

Responses

200

Successful request

get /getSchedule
https://esports-api.lolesports.com/persisted/gw/getSchedule
https://prod-relapi.ewp.gg/persisted/gw/getSchedule

Response samples

application/json
Copy
 Expand all Collapse all
{
  • "data":
    {
    }
}

getLive

Authorizations:
apiKeyAuth
query Parameters
hl
required
string (locale)
Enum:"en-US" "en-GB" "en-AU" "cs-CZ" "de-DE" "el-GR" "es-ES" "es-MX" "fr-FR" "hu-HU" "it-IT" "pl-PL" "pt-BR" "ro-RO" "ru-RU" "tr-TR" "ja-JP" "ko-KR"

This is the locale or language code using ISO 639-1 and ISO 3166-1 alpha-2

Responses

200

Successful request

get /getLive
https://esports-api.lolesports.com/persisted/gw/getLive
https://prod-relapi.ewp.gg/persisted/gw/getLive

Response samples

application/json
Copy
 Expand all Collapse all
{
  • "data":
    {
    }
}

getCompletedEvents

Authorizations:
apiKeyAuth
query Parameters
hl
required
string (locale)
Enum:"en-US" "en-GB" "en-AU" "cs-CZ" "de-DE" "el-GR" "es-ES" "es-MX" "fr-FR" "hu-HU" "it-IT" "pl-PL" "pt-BR" "ro-RO" "ru-RU" "tr-TR" "ja-JP" "ko-KR"

This is the locale or language code using ISO 639-1 and ISO 3166-1 alpha-2

tournamentId
Array of integers <int64>

The id(s) of the tournament(s) you want details ofs

Responses

200

Successful request

get /getCompletedEvents
https://esports-api.lolesports.com/persisted/gw/getCompletedEvents
https://prod-relapi.ewp.gg/persisted/gw/getCompletedEvents

Response samples

application/json
Copy
 Expand all Collapse all
{
  • "data":
    {
    }
}

getEventDetails

Authorizations:
apiKeyAuth
query Parameters
hl
required
string (locale)
Enum:"en-US" "en-GB" "en-AU" "cs-CZ" "de-DE" "el-GR" "es-ES" "es-MX" "fr-FR" "hu-HU" "it-IT" "pl-PL" "pt-BR" "ro-RO" "ru-RU" "tr-TR" "ja-JP" "ko-KR"

This is the locale or language code using ISO 639-1 and ISO 3166-1 alpha-2

id
required
integer <int64>

The id of the match that you want

Responses

200

Succesful request

get /getEventDetails
https://esports-api.lolesports.com/persisted/gw/getEventDetails
https://prod-relapi.ewp.gg/persisted/gw/getEventDetails

Response samples

application/json
Copy
 Expand all Collapse all
{
  • "data":
    {
    }
}

getGames

Authorizations:
apiKeyAuth
query Parameters
hl
required
string (locale)
Enum:"en-US" "en-GB" "en-AU" "cs-CZ" "de-DE" "el-GR" "es-ES" "es-MX" "fr-FR" "hu-HU" "it-IT" "pl-PL" "pt-BR" "ro-RO" "ru-RU" "tr-TR" "ja-JP" "ko-KR"

This is the locale or language code using ISO 639-1 and ISO 3166-1 alpha-2

id
Array of integers <int64>

The game Id(s).

You can input more than one game Id(s).

Responses

200

Successful request

get /getGames
https://esports-api.lolesports.com/persisted/gw/getGames
https://prod-relapi.ewp.gg/persisted/gw/getGames

Response samples

application/json
Copy
 Expand all Collapse all
{
  • "data":
    {
    }
}

teams

Get information about a team and its roster.

getTeams

Authorizations:
apiKeyAuth
query Parameters
hl
required
string (locale)
Enum:"en-US" "en-GB" "en-AU" "cs-CZ" "de-DE" "el-GR" "es-ES" "es-MX" "fr-FR" "hu-HU" "it-IT" "pl-PL" "pt-BR" "ro-RO" "ru-RU" "tr-TR" "ja-JP" "ko-KR"

This is the locale or language code using ISO 639-1 and ISO 3166-1 alpha-2

id
Array of strings

The team slug(s).

You can input more than one slug.

Responses

200

Successful request

get /getTeams
https://esports-api.lolesports.com/persisted/gw/getTeams
https://prod-relapi.ewp.gg/persisted/gw/getTeams

Response samples

application/json
Copy
 Expand all Collapse all
{
  • "data":
    {
    }
}

match details

Get the full match details of a game either live or after it has occured.

getWindow

path Parameters
gameId
required
integer <int64>

The game id of the match

query Parameters
startingTime
string <date-time>

The date-time (RFC3339)

Responses

200

Successful request

get /window/{gameId}
https://feed.lolesports.com/livestats/v1/window/{gameId}

Response samples

application/json
Copy
 Expand all Collapse all
{
  • "esportsGameId": "string",
  • "esportsMatchId": "string",
  • "gameMetadata":
    {
    },
  • "frames":
    [
    ]
}

getDetails

path Parameters
gameId
required
integer <int64>

The game id of the match

query Parameters
startingTime
string <date-time>

The date-time (RFC3339)

participantIds
string^\d{1,2}(?:_\d{1,2}){0,9}$

A list of the participant Ids separated by underscores and not commas

Responses

200

Successful request

get /details/{gameId}
https://feed.lolesports.com/livestats/v1/details/{gameId}

Response samples

application/json
Copy
 Expand all Collapse all
{
  • "frames":
    [
    ]
}

highlander

These are the old api endpoints.

navItems

Responses

200

Successful request

get /navItems
https://api.lolesports.com/api/v1/navItems

Response samples

application/json
Copy
 Expand all Collapse all
{
  • "navItems":
    [
    ],
  • "leagues":
    [
    ]
}

videos

This endpoint returns details about esports vods on YouTube.

The data returned by this endpoint is fairly large (more than 5MB) since it includes vods from 2015 up to (at the time of writing this) June 2019 and it will continue growing.

Do consider this when dealing with clients (like mobile phones) where bandwidth and memory may be scarce.

It is highly advised that you cache the data from this endpoint.

Responses

200

Successful request

get /videos
https://api.lolesports.com/api/v2/videos

Response samples

application/json
Copy
 Expand all Collapse all
{
  • "videos":
    [
    ]
}

highlanderTournaments

If a league does not have highlanderTournament objects, the API will return 404

query Parameters
league
required
string <int32>

The id of the league you want details of

Responses

200

Successful request

404

Not Found

get /highlanderTournaments
https://api.lolesports.com/api/v2/highlanderTournaments

Response samples

application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

leagues

query Parameters
query
required
object or object

'This endpoint requires either the id or the slug to be passed. If both are present then only the first one will be considered.

Due to a limitation in the OpenApi specification it is not possible to show the mutual exclusive nature that the query parameters in this endpoint require. The schema below is as close as a representation I could get in expressing the nature of the query parameters.

Check the examples below to help better understand the query parameters needed.

Example 1

https://api.lolesports.com/api/v1/leagues?id=3

This will return the details for LEC.

Example 2

https://api.lolesports.com/api/v1/leagues?slug=worlds

This will return the details for Worlds

Example 3

https://api.lolesports.com/api/v1/leagues?id=3&slug=worlds

In such a scenario where both query parameters are used only the first will be considered, hence it will only return the details for LEC.

Example 4

https://api.lolesports.com/api/v1/leagues

This is not valid. At least one of the two query parameters (id or slug) is required.'

Responses

200

Successful request

404

Not Found

get /leagues
https://api.lolesports.com/api/v1/leagues

Response samples

application/json
Copy
 Expand all Collapse all
{
  • "leagues":
    [
    ],
  • "highlanderTournaments":
    [
    ],
  • "highlanderRecords":
    [
    ],
  • "teams":
    [
    ],
  • "players":
    [
    ]
}

scheduleItems

query Parameters
leagueId
required
integer <int32>

The id of the league you want details of

Responses

200

Successful request

get /scheduleItems
https://api.lolesports.com/api/v1/scheduleItems

Response samples

application/json
Copy
 Expand all Collapse all
{
  • "scheduleItems":
    [
    ],
  • "highlanderTournaments":
    [
    ],
  • "teams":
    [
    ],
  • "highlanderRecords":
    [
    ],
  • "players":
    [
    ]
}

teams

If the teamStatsSummaries, teamRosterStats and teamStatsHistories keys are not present, then the team did not take part in that particular tournament.

query Parameters
slug
required
string

The team slug.

tournament
required
string^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$

The tournament ID.

Responses

200

Successful request

get /teams
https://api.lolesports.com/api/v1/teams

Response samples

application/json
Copy
 Expand all Collapse all
{
  • "players":
    [
    ],
  • "highlanderTournaments":
    [
    ],
  • "scheduleItems":
    [
    ],
  • "teamStatsSummaries":
    [
    ],
  • "teamRosterStats":
    [
    ],
  • "teamStatsHistories":
    [
    ],
  • "teams":
    [
    ]
}

players

If the playerStatsSummaries and playerStatsHistories keys are not present, then the player did not take part in that particular tournament.

query Parameters
slug
required
string

The player slug.

tournament
required
string^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$

The tournament ID.

Responses

200

Successful request

get /players
https://api.lolesports.com/api/v1/players

Response samples

application/json
Copy
 Expand all Collapse all
{
  • "players":
    [
    ],
  • "highlanderTournaments":
    [
    ],
  • "scheduleItems":
    [
    ],
  • "teams":
    [
    ],
  • "playerStatsSummaries":
    [
    ],
  • "playerStatsHistories":
    [
    ]
}