leagueofgraphs.com APIleagueofgraphs.com ↗
Access League of Legends and TFT player stats, champion win rates, live game status, and ranked leaderboards via the League of Graphs API.
curl -X GET 'https://api.parse.bot/scraper/a37a789e-d312-4d4e-b7cc-9407bfc6963f/get_lol_summoner_details?name=Faker-KR1®ion=kr' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for a summoner's profile and match history by their Riot ID and region. Returns rank information and recent match history with champion, result, KDA, game type, and duration.
| Param | Type | Description |
|---|---|---|
| namerequired | string | Summoner name and tag (format: Name-Tag or Name#Tag, e.g. Faker-KR1) |
| region | string | Region code (e.g. kr, na, euw, br, jp, vn) |
{
"type": "object",
"fields": {
"name": "string, the summoner name as provided",
"rank": "object with tier (string) and lp (string)",
"region": "string, the region queried",
"match_history": "array of match objects with champion, result, kda, type, duration"
},
"sample": {
"data": {
"name": "Faker-KR1",
"rank": {
"lp": "",
"tier": "Silver IV"
},
"region": "kr",
"match_history": [
{
"kda": "5/10/13",
"type": "Normal (Draft Pick)",
"result": "Defeat",
"champion": "Bard",
"duration": "34min 5s"
}
]
},
"status": "success"
}
}About the leagueofgraphs.com API
The League of Graphs API covers 6 endpoints for League of Legends and Teamfight Tactics data, including summoner profiles with match history, champion statistics, and ranked leaderboards. get_lol_summoner_details returns a player's current rank tier, LP, and up to recent matches with per-game champion, KDA, result, game type, and duration. All major regions are supported, including KR, NA, EUW, BR, JP, and VN.
Summoner and Live Game Endpoints
The get_lol_summoner_details endpoint accepts a Riot ID in Name-Tag or Name#Tag format alongside an optional region code, and returns a rank object containing tier and lp fields plus a match_history array. Each match entry includes champion, result, kda, type (game mode), and duration. The get_lol_live_game endpoint takes the same inputs and returns an in_game boolean and a human-readable status string — useful for real-time presence checks without polling a full match record.
Champion Statistics
get_lol_champion_stats returns a champions array covering every champion in the current patch. Each object includes win_rate, pick_rate, ban_rate, kda, role, and tier. No inputs are required. The TFT counterpart, get_tft_champion_stats, returns a simpler list of objects with championName and championSlug for the current TFT set — useful for building navigation or lookup tables against other TFT data sources.
Rankings and Pagination
Both get_lol_rankings and get_tft_rankings accept an optional page integer and a region filter. The LoL endpoint returns rank, summoner, region, lp, and tier per entry. The TFT endpoint adds wins and played fields, giving a fuller picture of activity at the top of the ladder. Setting region to all returns the global leaderboard across all supported regions.
- Display a player's current rank tier and LP alongside their last N match results in a stats dashboard
- Build a champion tier list using win_rate, pick_rate, ban_rate, and role fields from get_lol_champion_stats
- Trigger alerts when a tracked summoner enters a live game using the in_game boolean from get_lol_live_game
- Populate a regional or global LoL leaderboard with paginated ranked player data
- Compare TFT top players by wins and games played using get_tft_rankings with region filtering
- Seed a champion selector or team builder with current TFT set champion names and slugs
- Track rank progression for a roster of competitive players across KR, NA, and EUW regions
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.