Skip to main content
The player profile lookup feature allows users to search for and view League of Legends player information using their Riot ID.

​
Overview

Heimerdinger.lol’s player profile feature:
  • Searches players by Riot ID format (Name#TAG)
  • Displays player rank and division
  • Shows account level and experience
  • Presents champion mastery points
  • Integrates with the Riot Games API
The Riot ID format changed in 2023. Players now use a Name#TAG format (e.g., Faker#KR1) instead of the old summoner name system.

​
Riot ID Format

Riot IDs consist of two parts:

Game Name

The player’s display name (up to 16 characters)Example: Faker

Tagline

A unique identifier (3-5 characters)Example: KR1

​
Complete Riot ID Example

Faker#KR1
Doublelift#NA1
Rekkles#2773
The tagline is case-sensitive and required for accurate player lookup.

​
How to Find Your Riot ID

Players can find their Riot ID in several places:
1

In-game client

Your Riot ID is displayed in the top-right corner of the League of Legends client
2

Profile page

Click on your profile to see your full Riot ID with tagline
3

Match history

Your Riot ID appears in your match history and on loading screens

​
API Integration

The player profile feature uses the Riot Games API to fetch player data:

​
Required Configuration

Set your Riot Games API key in .env: 
RGAPI_KEY="RGAPI-00000000-0000-0000-0000-000000000000"
Get your API key from the Riot Developer Portal.

​
User Agent

The Riot API requires a custom user agent: 
USER_AGENT="Heimerdinger/1.0 (Heimerdinger.lol) PHP"
The user agent format follows Riot’s guidelines: {Product Name}/{Version} ({Website}) {Technology}

​
Player Data

The player profile displays several types of information:

​
Account Information

  • Summoner Name - Display name
  • Tagline - Riot ID tag
  • Level - Account level (1-500+)
  • Profile Icon - Selected summoner icon

​
Ranked Information

  • Rank - Tier and division (e.g., Diamond III)
  • LP - League Points
  • Win/Loss - Win rate statistics
  • Queue Type - Ranked Solo/Duo, Flex, etc.

​
Champion Mastery

  • Top Champions - Highest mastery champions
  • Mastery Points - Total points per champion
  • Mastery Level - Level 1-7 for each champion
  • Chest Earned - Whether the chest has been earned

​
Riot Games API Endpoints

The player profile feature likely uses these Riot API endpoints:
GET /riot/account/v1/accounts/by-riot-id/{gameName}/{tagLine}Retrieves account information by Riot ID
GET /lol/summoner/v4/summoners/by-puuid/{encryptedPUUID}Gets summoner data including level and profile icon
GET /lol/league/v4/entries/by-summoner/{encryptedSummonerId}Retrieves ranked information for a summoner
GET /lol/champion-mastery/v4/champion-masteries/by-puuid/{encryptedPUUID}Gets champion mastery data for a player

​
Rate Limiting

The Riot Games API has strict rate limits. Heimerdinger.lol should implement caching to avoid exceeding these limits.

​
Development API Key Limits

  • 20 requests per second
  • 100 requests every 2 minutes

​
Production API Key Limits

Production keys have higher limits based on your application tier.
Consider caching player data for 5-15 minutes to balance freshness with API rate limits.

​
Privacy Considerations

All player data displayed is publicly available through the Riot Games API and the League of Legends client.

​
Data Collection

Heimerdinger.lol should:
  • Only display data available through official Riot APIs
  • Not store sensitive player information
  • Respect Riot’s API Terms of Service
  • Include proper attribution to Riot Games

​
Disclaimer

As stated in the project README:
Heimerdinger.lol was created under Riot Games’ “Legal Jibber Jabber” policy using assets owned by Riot Games. Riot Games does not endorse or sponsor this project.

​
Regional Endpoints

The Riot API uses different endpoints for different regions:
RegionRouting ValueExamples
AmericasamericasNA, BR, LAN, LAS
AsiaasiaKR, JP
EuropeeuropeEUW, EUNE, TR, RU
Southeast AsiaseaOCE, PH, SG, TH, TW, VN
You must use the correct regional routing value when making API calls to retrieve account data.

Champions

View champion mastery data for players

Assets

Browse summoner icons used in player profiles

Data Sources

Learn about Riot API integration

Configuration

Set up your Riot API credentials

Build docs developers (and LLMs) love

Get started for freeTalk to us