def shards(api_key=None, **kwargs):
"""
Get shard list.
https://developer.riotgames.com/api/methods#!/908/3143
"""
url = '{}'.format(api_url)
return get_data_from_api(api_key, url, **kwargs)
def featured(api_key=None, region=None, **kwargs):
"""
Get list of featured games.
https://developer.riotgames.com/api/methods#!/977/3337
"""
region = get_region(region)
url = 'https://{}.api.pvp.net/observer-mode/rest/featured'.format(region)
return get_data_from_api(api_key, url, **kwargs)
def shards_region(api_key=None, region=None, **kwargs):
"""
Get shard status. Returns the data available on the status.leagueoflegends.com website for the given region.
https://developer.riotgames.com/api/methods#!/908/3142
"""
region = get_region(region)
url = '{}/{}'.format(api_url, region)
return get_data_from_api(api_key, url, **kwargs)
def featured(api_key=None, region=None, **kwargs):
"""
Get list of featured games.
https://developer.riotgames.com/api/methods#!/977/3337
"""
region = get_region(region)
url = 'https://{}.api.pvp.net/observer-mode/rest/featured'.format(region)
return get_data_from_api(api_key, url, **kwargs)
def summoner_spell_all(api_key=None, region=None, **kwargs):
"""
Retrieves summoner spell list.
https://developer.riotgames.com/api/methods#!/1055/3634
"""
region = get_region(region)
url = '{}{}/{}/summoner-spell'.format(api_url, region, version)
return get_data_from_api(api_key, url, **kwargs)
def mastery(mastery_id, api_key=None, region=None, **kwargs):
"""
Retrieves mastery item by its unique id.
https://developer.riotgames.com/api/methods#!/1055/3626
"""
region = get_region(region)
url = '{}{}/{}/mastery/{}'.format(api_url, region, version, mastery_id)
return get_data_from_api(api_key, url, **kwargs)
def champions_all(api_key=None, region=None, **kwargs):
"""
Retrieves champion list.
https://developer.riotgames.com/api/methods#!/1055/3633
"""
region = get_region(region)
url = '{}{}/{}/champion'.format(api_url, region, version)
return get_data_from_api(api_key, url, **kwargs)
def champions_all(api_key=None, region=None, **kwargs):
"""
Retrieves champion list.
https://developer.riotgames.com/api/methods#!/1055/3633
"""
region = get_region(region)
url = '{}{}/{}/champion'.format(api_url, region, version)
return get_data_from_api(api_key, url, **kwargs)
def realm(api_key=None, region=None, **kwargs):
"""
Retrieve realm data.
https://developer.riotgames.com/api/methods#!/1055/3632
"""
region = get_region(region)
url = '{}{}/{}/realm'.format(api_url, region, version)
return get_data_from_api(api_key, url, **kwargs)
def realm(api_key=None, region=None, **kwargs):
"""
Retrieve realm data.
https://developer.riotgames.com/api/methods#!/1055/3632
"""
region = get_region(region)
url = '{}{}/{}/realm'.format(api_url, region, version)
return get_data_from_api(api_key, url, **kwargs)
def rune(rune_id, api_key=None, region=None, **kwargs):
"""
Retrieves rune by its unique id.
https://developer.riotgames.com/api/methods#!/1055/3629
"""
region = get_region(region)
url = '{}{}/{}/rune/{}'.format(api_url, region, version, rune_id)
return get_data_from_api(api_key, url, **kwargs)
def mastery_all(api_key=None, region=None, **kwargs):
"""
Retrieves mastery list.
https://developer.riotgames.com/api/methods#!/1055/3625
"""
region = get_region(region)
url = '{}{}/{}/mastery'.format(api_url, region, version)
return get_data_from_api(api_key, url, **kwargs)
def mastery(mastery_id, api_key=None, region=None, **kwargs):
"""
Retrieves mastery item by its unique id.
https://developer.riotgames.com/api/methods#!/1055/3626
"""
region = get_region(region)
url = '{}{}/{}/mastery/{}'.format(api_url, region, version, mastery_id)
return get_data_from_api(api_key, url, **kwargs)
def summoner_spell(summoner_spell_id, api_key=None, region=None, **kwargs):
"""
Retrieves summoner spell by its unique id.
https://developer.riotgames.com/api/methods#!/1055/3628
"""
region = get_region(region)
url = '{}{}/{}/summoner-spell/{}'.format(api_url, region, version, summoner_spell_id)
return get_data_from_api(api_key, url, **kwargs)
def rune(rune_id, api_key=None, region=None, **kwargs):
"""
Retrieves rune by its unique id.
https://developer.riotgames.com/api/methods#!/1055/3629
"""
region = get_region(region)
url = '{}{}/{}/rune/{}'.format(api_url, region, version, rune_id)
return get_data_from_api(api_key, url, **kwargs)
def champion(champ_id, api_key=None, region=None, **kwargs):
"""
Retrieves a champion by its id.
https://developer.riotgames.com/api/methods#!/1055/3622
"""
region = get_region(region)
url = '{}{}/{}/champion/{}'.format(api_url, region, version, champ_id)
return get_data_from_api(api_key, url, **kwargs)
def languages(api_key=None, region=None, **kwargs):
"""
Retrieve supported languages data.
https://developer.riotgames.com/api/methods#!/1055/3631
"""
region = get_region(region)
url = '{}{}/{}/languages'.format(api_url, region, version)
return get_data_from_api(api_key, url, **kwargs)
def champion(champ_id, api_key=None, region=None, **kwargs):
"""
Retrieves a champion by its id.
https://developer.riotgames.com/api/methods#!/1055/3622
"""
region = get_region(region)
url = '{}{}/{}/champion/{}'.format(api_url, region, version, champ_id)
return get_data_from_api(api_key, url, **kwargs)
def languages(api_key=None, region=None, **kwargs):
"""
Retrieve supported languages data.
https://developer.riotgames.com/api/methods#!/1055/3631
"""
region = get_region(region)
url = '{}{}/{}/languages'.format(api_url, region, version)
return get_data_from_api(api_key, url, **kwargs)
def mastery_all(api_key=None, region=None, **kwargs):
"""
Retrieves mastery list.
https://developer.riotgames.com/api/methods#!/1055/3625
"""
region = get_region(region)
url = '{}{}/{}/mastery'.format(api_url, region, version)
return get_data_from_api(api_key, url, **kwargs)
def summoner_spell_all(api_key=None, region=None, **kwargs):
"""
Retrieves summoner spell list.
https://developer.riotgames.com/api/methods#!/1055/3634
"""
region = get_region(region)
url = '{}{}/{}/summoner-spell'.format(api_url, region, version)
return get_data_from_api(api_key, url, **kwargs)
def champion(champion_id, api_key=None, region=None, **kwargs):
"""
Retrieve champion by ID.
https://developer.riotgames.com/api/methods#!/1077/3716
"""
region = get_region(region)
url = '{}{}/{}/champion/{}'.format(api_url, region, version, champion_id)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def summoner_spell(summoner_spell_id, api_key=None, region=None, **kwargs):
"""
Retrieves summoner spell by its unique id.
https://developer.riotgames.com/api/methods#!/1055/3628
"""
region = get_region(region)
url = '{}{}/{}/summoner-spell/{}'.format(api_url, region, version,
summoner_spell_id)
return get_data_from_api(api_key, url, **kwargs)
def master(api_key=None, region=None, **kwargs):
"""
Get master tier leagues.
https://developer.riotgames.com/api/methods#!/985/3354
"""
region = get_region(region)
url = '{}{}/{}/league/master'.format(api_url, region, version)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def recent(summoner_id, api_key=None, region=None, **kwargs):
"""
Get recent games by summoner ID.
https://developer.riotgames.com/api/methods#!/1078/3718
"""
region = get_region(region)
url = '{}{}/{}/game/by-summoner/{}/recent'.format(api_url, region, version, summoner_id)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def match(match_id, api_key=None, region=None, **kwargs):
"""
Retrieve match by match ID.
https://developer.riotgames.com/api/methods#!/1064/3671
"""
region = get_region(region)
url = '{}{}/{}/match/{}'.format(api_url, region, version, match_id)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def ranked(summoner_id, api_key=None, region=None, **kwargs):
"""
Get ranked stats by summoner ID.
https://developer.riotgames.com/api/methods#!/1080/3725
"""
region = get_region(region)
url = '{}{}/{}/stats/by-summoner/{}/ranked'.format(api_url, region, version, summoner_id)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def champion(champion_id, api_key=None, region=None, **kwargs):
"""
Retrieve champion by ID.
https://developer.riotgames.com/api/methods#!/1077/3716
"""
region = get_region(region)
url = '{}{}/{}/champion/{}'.format(api_url, region, version, champion_id)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def by_summoner(summoner_id, api_key=None, region=None, **kwargs):
"""
Retrieve match list by summoner ID.
https://developer.riotgames.com/api/methods#!/1069/3683
"""
region = get_region(region)
url = '{}{}/{}/matchlist/by-summoner/{}'.format(api_url, region, version, summoner_id)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def score(player_id, api_key=None, region=None, **kwargs):
"""
Get a player's total champion mastery score.
https://developer.riotgames.com/api/methods#!/1071/3698
"""
region = get_region(region)
platform = platforms[region]
url = '{}{}/player/{}/score'.format(api_url, platform, player_id)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def champions_points(player_id, api_key=None, region=None, **kwargs):
"""
Get all champion mastery entries.
https://developer.riotgames.com/api/methods#!/1071/3696
"""
region = get_region(region)
platform = platforms[region]
url = '{}{}/player/{}/champions'.format(api_url, platform, player_id)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def top_champions(player_id, api_key=None, region=None, **kwargs):
"""
Get specified number of top champion mastery entries
https://developer.riotgames.com/api/methods#!/1071/3692
"""
region = get_region(region)
platform = platforms[region]
url = '{}{}/player/{}/topchampions'.format(api_url, platform, player_id)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def score(player_id, api_key=None, region=None, **kwargs):
"""
Get a player's total champion mastery score.
https://developer.riotgames.com/api/methods#!/1071/3698
"""
region = get_region(region)
platform = platforms[region]
url = '{}{}/player/{}/score'.format(api_url, platform, player_id)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def top_champions(player_id, api_key=None, region=None, **kwargs):
"""
Get specified number of top champion mastery entries
https://developer.riotgames.com/api/methods#!/1071/3692
"""
region = get_region(region)
platform = platforms[region]
url = '{}{}/player/{}/topchampions'.format(api_url, platform, player_id)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def spectator_game_info(summoner_id, api_key=None, region=None, **kwargs):
"""
Get current game information for the given summoner ID
https://developer.riotgames.com/api/methods#!/976/3336
"""
region = get_region(region)
platform = platforms[region]
url = '{}/{}/{}'.format(api_url, platform, summoner_id)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def champions_points(player_id, api_key=None, region=None, **kwargs):
"""
Get all champion mastery entries.
https://developer.riotgames.com/api/methods#!/1071/3696
"""
region = get_region(region)
platform = platforms[region]
url = '{}{}/player/{}/champions'.format(api_url, platform, player_id)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def by_summoner(summoner_id, api_key=None, region=None, **kwargs):
"""
Retrieve match list by summoner ID.
https://developer.riotgames.com/api/methods#!/1069/3683
"""
region = get_region(region)
url = '{}{}/{}/matchlist/by-summoner/{}'.format(api_url, region, version,
summoner_id)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def ranked(summoner_id, api_key=None, region=None, **kwargs):
"""
Get ranked stats by summoner ID.
https://developer.riotgames.com/api/methods#!/1080/3725
"""
region = get_region(region)
url = '{}{}/{}/stats/by-summoner/{}/ranked'.format(api_url, region,
version, summoner_id)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def by_teams(team_ids, api_key=None, region=None, **kwargs):
"""
Get teams mapped by team ID for a given list of team IDs.
https://developer.riotgames.com/api/methods#!/986/3357
:param team_ids: can be both list or string in valid format
"""
region = get_region(region)
ids = to_comma_separated(team_ids)
url = '{}{}/{}/team/{}'.format(api_url, region, version, ids)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def by_summoners_entry(summoner_ids, api_key=None, region=None, **kwargs):
"""
Get league entries mapped by summoner ID for a given list of summoner IDs.
https://developer.riotgames.com/api/methods#!/985/3356
:param summoner_ids: can be both list or string in valid formats
"""
region = get_region(region)
ids = to_comma_separated(summoner_ids)
url = '{}{}/{}/league/by-summoner/{}/entry'.format(api_url, region, version, ids)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def champion_master(player_id, champion, api_key=None, region=None, **kwargs):
"""
Get a champion mastery by player id and champion id.
https://developer.riotgames.com/api/methods#!/1071/3697
"""
region = get_region(region)
champion_id = get_champion_id(champion)
platform = platforms[region]
url = '{}{}/player/{}/champion/{}'.format(api_url, platform, player_id, champion_id)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def by_teams(team_ids, api_key=None, region=None, **kwargs):
"""
Get teams mapped by team ID for a given list of team IDs.
https://developer.riotgames.com/api/methods#!/986/3357
:param team_ids: can be both list or string in valid format
"""
region = get_region(region)
ids = to_comma_separated(team_ids)
url = '{}{}/{}/team/{}'.format(api_url, region, version, ids)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def by_name(summoner_names, api_key=None, region=None, **kwargs):
"""
Get summoner objects mapped by standardized summoner name for a given list of summoner names.
https://developer.riotgames.com/api/methods#!/1079/3722
:param summoner_names: can be both list or string in valid format
"""
region = get_region(region)
names = to_comma_separated(summoner_names)
url = '{}{}/{}/summoner/by-name/{}'.format(api_url, region, version, names)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def runes(summoner_ids, api_key=None, region=None, **kwargs):
"""
Get rune pages mapped by summoner ID for a given list of summoner IDs.
https://developer.riotgames.com/api/methods#!/1079/3719
:param summoner_ids: can be both list or string in valid format
"""
region = get_region(region)
ids = to_comma_separated(summoner_ids)
url = '{}{}/{}/summoner/{}/runes'.format(api_url, region, version, ids)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
def champion_master(player_id, champion, api_key=None, region=None, **kwargs):
"""
Get a champion mastery by player id and champion id.
https://developer.riotgames.com/api/methods#!/1071/3697
"""
region = get_region(region)
champion_id = get_champion_id(champion)
platform = platforms[region]
url = '{}{}/player/{}/champion/{}'.format(api_url, platform, player_id,
champion_id)
url = url.format(region)
return get_data_from_api(api_key, url, **kwargs)
