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 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 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 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 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 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 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 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 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 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 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 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_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 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 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 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 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 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 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 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)