lolpros APIlolpros.gg ↗
Search pro League of Legends players, fetch regional solo queue ladder rankings, and retrieve full player profiles with rank, team, and social data from lolpros.gg.
What is the lolpros API?
The lolpros.gg API exposes 3 endpoints covering professional League of Legends player data: search by name, pull a region's top-10 solo queue ladder, and retrieve a full player profile. The get_player_profile endpoint alone returns over 15 distinct fields including all linked accounts with current and peak ranks, team history, league participation, and social media handles.
curl -X GET 'https://api.parse.bot/scraper/f9ee2f0b-256c-4347-a14d-d8d546e7047e/search_players?name=caps' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace lolpros-gg-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: LolPros SDK — discover pro players, check ladder rankings, drill into profiles."""
from parse_apis.lolpros_gg_api import LolPros, Server, PlayerNotFound
client = LolPros()
# Browse the EUW ladder — top pro players by composite score.
for entry in client.playersummaries.list(server=Server.EUW, limit=3):
print(entry.name, entry.position, entry.score, entry.primary_account.rank, entry.primary_account.winrate)
# Drill into the first ladder entry's full profile.
top = client.playersummaries.list(server=Server.EUW, limit=1).first()
if top:
player = top.details()
print(player.name, player.country, player.position)
for acc in player.accounts:
print(acc.account_name, acc.server, acc.current_rank, acc.lp, acc.peak_rank)
# Search accounts by player name.
for account in client.accounts.search(name="caps", limit=5):
print(account.account_name, account.current_rank, account.lp, account.wins, account.losses)
# Typed error handling: fetch a non-existent player.
try:
client.players.get(slug="nonexistent-player-xyz")
except PlayerNotFound as exc:
print(f"Player not found: slug={exc.slug}")
print("exercised: playersummaries.list / details / accounts.search / players.get / PlayerNotFound")Full-text search across professional player accounts by name. Returns all accounts from every matching player profile, each with current rank, LP, and win/loss record. A single player may contribute multiple accounts. No pagination — the server returns all matches in one response.
| Param | Type | Description |
|---|---|---|
| namerequired | string | Player name to search for. Matches against player display names and account names. |
{
"type": "object",
"fields": {
"items": "array of account objects with accountName, current_rank, lp, wins, losses, last_played"
},
"sample": {
"data": {
"items": [
{
"lp": 2384,
"wins": 384,
"losses": 254,
"accountName": "G2 Caps#1323",
"last_played": "2026-06-09T22:05:54+00:00",
"current_rank": "Challenger"
}
]
},
"status": "success"
}
}About the lolpros API
Search and Ladder Endpoints
The search_players endpoint accepts a name string and returns every account associated with matching player profiles in a single response — no pagination required. Each account object includes accountName, current_rank, lp, wins, losses, and last_played. Because one professional player often maintains multiple accounts, a single query can return several account entries tied to the same person.
The get_ladder endpoint returns the top 10 professional players on a given region's solo queue ladder, ordered by a composite score. The optional server parameter controls which region is returned, defaulting to EUW. Each ladder entry exposes playerName, slug, country, position, team, and a primaryAccount object with rank and winrate data.
Player Profile Endpoint
get_player_profile takes a player slug — available from both search and ladder results — and returns the complete profile record. This includes an accounts array where each entry carries server, current_rank, lp, wins, losses, last_played, peak_rank, and peak_lp. The profile also includes leagues (with name, slug, and shorthand), position, country, and a social_media object covering Twitch, Twitter, Discord, Instagram, and Facebook (fields are nullable). previous_teams is an array of team history objects with name, tag, role, join_date, and leave_date.
Coverage Notes
Data is scoped to players tracked on lolpros.gg, which focuses on professional and high-profile competitive players. The get_ladder response is fixed at 10 entries per region. Slugs used in get_player_profile must match exactly; an unrecognized slug returns input_not_found rather than a partial result.
The lolpros API is a managed, monitored endpoint for lolpros.gg — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when lolpros.gg 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 lolpros.gg 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 real-time regional pro ladder widget showing top 10 players by position and score
- Build a player lookup tool that shows all ranked accounts for a given pro's name, including their LP and win rate
- Track a pro player's peak rank history across multiple accounts over time
- Aggregate team rosters by cross-referencing player slugs with their previous_teams history
- Surface social media links for pro players in a fan-facing directory or stream schedule tool
- Monitor which leagues a set of players participate in using the leagues array from get_player_profile
- Identify which pros are active in EUW, LCK, or NA solo queue by querying get_ladder with different server codes
| 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 | 100 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.