League of Graphs 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.
What is the League of Graphs 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.
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'
Retrieve a summoner's profile including rank tier and recent match history. Each match includes the champion played, result, KDA, game type, and duration. Also includes peak ranks from past seasons when available, showing the highest tier and LP achieved per season. The summoner is identified by Riot ID (Name#Tag or Name-Tag format) and region. Returns empty match_history and peak_ranks arrays if the profile exists but has no recent games or season history.
| Param | Type | Description |
|---|---|---|
| namerequired | string | Summoner Riot ID (format: Name-Tag or Name#Tag, e.g. Faker-KR1) |
| region | string | Region code for the summoner's server |
{
"type": "object",
"fields": {
"name": "string, the summoner Riot ID as provided",
"rank": "object with tier (string) and lp (string)",
"region": "string, the region queried",
"peak_ranks": "array of objects with season (string), tier (string), and lp (string) representing peak rank per season",
"match_history": "array of match objects with champion, result, kda, type, duration"
},
"sample": {
"data": {
"name": "J1HUIV-000",
"rank": {
"lp": "4544 LP",
"tier": "Challenger"
},
"region": "euw",
"peak_ranks": [
{
"lp": "197",
"tier": "Master",
"season": "13 (Split 1)"
},
{
"lp": "814",
"tier": "GrandMaster",
"season": "14 (Split 1)"
},
{
"lp": "2048",
"tier": "Challenger",
"season": "2025"
}
],
"match_history": [
{
"kda": "12/6/12",
"type": "Soloqueue",
"result": "Defeat",
"champion": "Orianna",
"duration": "33min 4s"
}
]
},
"status": "success"
}
}About the League of Graphs API
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.
The League of Graphs API is a managed, monitored endpoint for leagueofgraphs.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when leagueofgraphs.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official leagueofgraphs.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.