Skip to content

Getting Started

This guide will walk you through installing riotskillissue and making your first API call.

Prerequisites

Installation

Install the package from PyPI:

pip install riotskillissue

For development with testing tools:

pip install "riotskillissue[dev]"

Configuration

Set the RIOT_API_KEY environment variable:

$env:RIOT_API_KEY = "RGAPI-your-key-here"

set RIOT_API_KEY=RGAPI-your-key-here

export RIOT_API_KEY="RGAPI-your-key-here"

Option 2: Direct Initialization

Pass the API key directly to the client:

from riotskillissue import RiotClient

async with RiotClient(api_key="RGAPI-your-key-here") as client:
    # ...

Your First API Call

Here's a complete example that looks up a player by their Riot ID:

import asyncio
from riotskillissue import RiotClient, Platform, Region

async def main():
    # Client auto-loads RIOT_API_KEY from environment
    async with RiotClient() as client:

        # Step 1: Look up account by Riot ID
        account = await client.account.get_by_riot_id(
            region=Platform.EUROPE,  # Use AMERICAS, EUROPE, ASIA, or SEA
            gameName="Player",
            tagLine="EUW"
        )
        print(f"Account: {account.gameName}#{account.tagLine}")
        print(f"PUUID: {account.puuid}")

        # Step 2: Get summoner data using the PUUID
        summoner = await client.summoner.get_by_puuid(
            region=Region.EUW1,  # Regional server
            encryptedPUUID=account.puuid
        )
        print(f"Summoner Level: {summoner.summonerLevel}")

if __name__ == "__main__":
    asyncio.run(main())

Understanding Regions vs Platforms

The Riot API uses two types of routing:

Type Values Used For
Platform AMERICAS, EUROPE, ASIA, SEA Account lookups, Match history
Region NA1, EUW1, KR, BR1, etc. Summoner data, Live game, Ranked 
from riotskillissue import Region, Platform

# Platform for account/match APIs
account = await client.account.get_by_riot_id(
    region=Platform.AMERICAS,
    gameName="Player",
    tagLine="NA1"
)

# Region for summoner/ranked APIs  
summoner = await client.summoner.get_by_puuid(
    region=Region.NA1,
    encryptedPUUID=account.puuid
)

Next Steps