Riot Games
App · Gaming · 5 actions
Look up League of Legends players by Riot ID, then pull their ranked stats and match history with your Riot Games API key.
Actions
| Action | What it does |
|---|---|
| Get a summoner | Fetch a League of Legends summoner's profile icon, level, and last-modified date from a PUUID. |
| Get an account | Look up a player's PUUID from their Riot ID. |
| Get match details | Fetch one match's mode, length, and per-player scoreboard. |
| Get ranked stats | Look up a player's rank, LP, and win/loss record in every ranked queue they've played, from their PUUID. |
| List recent matches | List a player's recent match IDs, newest first. |
Get a summoner
Fetch a League of Legends summoner's profile icon, level, and last-modified date from a PUUID.
Inputs
- Game server
platformtextRequired - The game server the account plays on, for example 'na1' or 'euw1'. This is not the same as the continent used by the match actions.One of:
br1,eun1,euw1,jp1,kr,la1,la2,me1,na1,oc1, and 5 more. - Player ID (PUUID)
puuidtextRequired - The player's unique ID, as returned by Get an account. It's stable across name changes and every region.
Outputs
profile_icon_idnumber- ID of the icon shown on the profile
puuidtext- The player's unique ID
revision_datenumber- When the profile last changed, as a Unix timestamp in milliseconds
summoner_levelnumber- The account's level
Example output
{
"profile_icon_id": 6299,
"puuid": "cJ8s4mUeK1p2QwXyZ0aBcDeFgHiJkLmNoPqRsTuVwXyZ0aBcDeFgHiJkLmNoPqRsTuVwXyZ",
"revision_date": 1782934233712,
"summoner_level": 743
}Get an account
Look up a player's PUUID from their Riot ID. Every other action starts here, since Riot retired summoner names.
Inputs
- Continent
routing_regiontextRequired - The continent that serves this data: 'americas', 'europe', 'asia', or 'sea'. Riot routes accounts and matches per continent rather than per game server.One of:
americas,asia,europe,sea. - Riot ID name
game_nametextRequired - The part before the # in a Riot ID -- for 'Faker#KR1' that's 'Faker'.
- Riot ID tag
tag_linetextRequired - The part after the # in a Riot ID -- for 'Faker#KR1' that's 'KR1'. The # itself is optional.
Outputs
game_nametext- The name part of the Riot ID
puuidtext- The player's unique ID. Use with Get a summoner and List recent matches.
tag_linetext- The tag part of the Riot ID
Example output
{
"game_name": "Faker",
"puuid": "cJ8s4mUeK1p2QwXyZ0aBcDeFgHiJkLmNoPqRsTuVwXyZ0aBcDeFgHiJkLmNoPqRsTuVwXyZ",
"tag_line": "KR1"
}Get match details
Fetch one match's mode, length, and per-player scoreboard.
Inputs
- Continent
routing_regiontextRequired - The continent that serves this data: 'americas', 'europe', 'asia', or 'sea'. Riot routes accounts and matches per continent rather than per game server.One of:
americas,asia,europe,sea. - Match ID
match_idtextRequired - The match ID, as returned by List recent matches -- for example 'NA1_4938271056'.
Outputs
game_durationnumber- How long the match lasted, in seconds
game_modetext- The mode played, for example 'CLASSIC' or 'ARAM'
game_startnumber- When the match started, as a Unix timestamp in milliseconds
match_idtext- The match's ID
participantslist- Every player in the match, with their score
Example output
{
"game_duration": 1834,
"game_mode": "CLASSIC",
"game_start": 1782934233712,
"match_id": "NA1_4938271056",
"participants": [
{
"assists": 11,
"champion": "Azir",
"deaths": 2,
"kills": 9,
"puuid": "cJ8s4mUeK1p2QwXyZ0aBcDeFgHiJkLmNoPqRsTuVwXyZ",
"riot_id": "Faker",
"team_position": "MIDDLE",
"win": true
}
]
}Get ranked stats
Look up a player's rank, LP, and win/loss record in every ranked queue they've played, from their PUUID.
Inputs
- Game server
platformtextRequired - The game server the account plays on, for example 'na1' or 'euw1'. This is not the same as the continent used by the match actions.One of:
br1,eun1,euw1,jp1,kr,la1,la2,me1,na1,oc1, and 5 more. - Player ID (PUUID)
puuidtextRequired - The player's unique ID, as returned by Get an account. It's stable across name changes and every region.
Outputs
entrieslist- One entry per ranked queue the summoner has played. Empty if they're unranked this season.
Example output
{
"entries": [
{
"league_points": 47,
"losses": 98,
"queue_type": "RANKED_SOLO_5x5",
"rank": "II",
"tier": "GOLD",
"wins": 112
}
]
}List recent matches
List a player's recent match IDs, newest first.
Inputs
- Continent
routing_regiontextRequired - The continent that serves this data: 'americas', 'europe', 'asia', or 'sea'. Riot routes accounts and matches per continent rather than per game server.One of:
americas,asia,europe,sea. - Player ID (PUUID)
puuidtextRequired - The player's unique ID, as returned by Get an account. It's stable across name changes and every region.
- Start position
startnumber - How many matches to skip before returning any.At least 0. Default:
0. - How many matches
countnumber - How many match IDs to return (1-100).From 1 to 100. Default:
5.
Outputs
match_idslist- Match IDs, newest first. Use with Get match details.
Example output
{
"match_ids": [
"NA1_4938271056",
"NA1_4938104772"
]
}