GET_getByRiotId
await client.GET_getByRiotId(gameName: str, tagLine: str, cluster: Optional[str] = None)
Parameters
The game name portion of the Riot ID (before the # symbol).
The tag line portion of the Riot ID (after the # symbol).
The cluster to retrieve from. If not provided, uses the client’s default cluster.Valid clusters:
americasasiaesportseurope
Returns
Account information object (or raw dict if raw_data=True).
The player’s unique identifier.
The player’s in-game name (without tag).
The player’s tagline (e.g., “NA1”).
Exceptions
InvalidCluster - If the provided cluster is invalidRiotAPIResponseError - If the API response indicates an error (e.g., account not found)
Example
import asyncio
from valaw import Client
async def main():
client = Client(
token="RGAPI-your-api-key-here",
cluster="americas"
)
try:
# Get account by Riot ID
account = await client.GET_getByRiotId(
gameName="PlayerName",
tagLine="NA1"
)
print(f"PUUID: {account.puuid}")
print(f"Riot ID: {account.gameName}#{account.tagLine}")
except Exception as e:
print(f"Error: {e}")
finally:
await client.close()
asyncio.run(main())
Example with Multiple Accounts
import asyncio
from valaw import Client
async def get_account_info(client, game_name, tag_line):
try:
account = await client.GET_getByRiotId(game_name, tag_line)
return account
except Exception as e:
print(f"Error fetching {game_name}#{tag_line}: {e}")
return None
async def main():
client = Client(
token="RGAPI-your-api-key-here",
cluster="americas"
)
# Fetch multiple accounts
riot_ids = [
("Player1", "NA1"),
("Player2", "NA1"),
("Player3", "NA1")
]
for game_name, tag_line in riot_ids:
account = await get_account_info(client, game_name, tag_line)
if account:
print(f"Found: {account.gameName}#{account.tagLine} (PUUID: {account.puuid})")
await client.close()
asyncio.run(main())
Response Example
AccountDto(
puuid="abc123-def456-ghi789-jkl012",
gameName="PlayerName",
tagLine="NA1"
)
The game name and tag line are case-sensitive. Make sure to use the exact capitalization as displayed in the Riot client.
This endpoint queries across the entire cluster. Make sure you’re using the correct cluster for the player’s region to get accurate results.
