dpm.lol APIdpm.lol ↗
Access League of Legends champion tier lists, detailed builds, runes, skill orders, and solo queue leaderboards from dpm.lol via a structured JSON API.
curl -X GET 'https://api.parse.bot/scraper/e5096d45-f713-45db-aad7-6b41f5ad43fa/get_champion_list?tier=emerald_plus&game_mode=ranked&timeframe=16.3' \ -H 'X-API-Key: $PARSE_API_KEY'
Get the list of all champions with their basic stats (winrate, pickrate, tier score) for a specific patch and tier. Returns champion data across all lanes.
| Param | Type | Description |
|---|---|---|
| tier | string | Tier filter. Accepted values: emerald_plus, master_plus, all. |
| game_mode | string | Game mode. Accepted values: ranked. |
| timeframe | string | Patch version (e.g. 16.3, 16.2, 16.1). |
{
"type": "object",
"fields": {
"champions": "array of champion objects with championName, championId, lane, pickrate, winrate, banrate, tierScore, winrateVariance, and lanesPickrate"
},
"sample": {
"data": {
"champions": [
{
"lane": "BOTTOM",
"banrate": 5.61,
"winrate": 52.04,
"pickrate": 15.78,
"tierScore": 67.06,
"championId": 222,
"championName": "Jinx",
"lanesPickrate": {
"TOP": 0.06,
"BOTTOM": 99.75,
"JUNGLE": 0.02,
"MIDDLE": 0.13,
"UTILITY": 0.04
},
"winrateVariance": -0.23
}
]
},
"status": "success"
}
}About the dpm.lol API
The dpm.lol API exposes 3 endpoints covering League of Legends champion statistics, build recommendations, and ranked leaderboards. The get_champion_list endpoint returns win rates, pick rates, ban rates, and tier scores for every champion across all lanes, filterable by patch version and rank tier. The get_champion_build endpoint goes deeper, delivering item paths, rune selections, skill leveling orders, summoner spell combinations, and boot choices for a specific champion and lane.
Champion List and Tier Data
The get_champion_list endpoint returns an array of champion objects, each containing championName, championId, lane, pickrate, winrate, banrate, tierScore, winrateVariance, and lanesPi. You can scope results to a specific patch via the timeframe parameter (e.g. 16.3, 16.2) and filter by rank bracket using tier — accepted values are emerald_plus, master_plus, or all. All data is currently scoped to ranked game mode.
Champion Build Details
The get_champion_build endpoint takes a required champion_name (case-sensitive, matching the value returned by get_champion_list, e.g. Ahri, RekSai) and a required lane (top, jungle, middle, bottom, or utility). The response includes boots, items (broken out by item slot with win rate, pick rate, and games played per option), runes (primary and secondary rune IDs with slot-level data), summoners (spell combinations with win rate and pick rate), coreBuilds (complete item path combinations), and skillLevelUp (ordered skill leveling sequences with associated win rates).
Ranked Leaderboard
The get_leaderboard endpoint returns a paginated players array for a given platform (euw1, kr, or na1). Each player entry includes tier, leaguePoints, wins, losses, gameName, displayName, lane, championIds, and kda. An optional is_pro boolean narrows results to professional players. Use the page parameter to step through rankings beyond the first page.
- Build a champion tier list tracker that surfaces win rate and tier score changes across patches using the
timeframeparameter. - Generate optimal build recommendations for any champion and lane, pulling
coreBuildsandskillLevelUpdata fromget_champion_build. - Compare summoner spell win rates across rank brackets by querying
get_champion_buildwithemerald_plusvsmaster_plustier filters. - Track high-elo leaderboard standings for EUW, KR, or NA solo queue using
get_leaderboardwith platform filtering. - Identify high-variance champions by filtering
get_champion_listresults on thewinrateVariancefield. - Filter pro player leaderboard entries separately from the general ladder using the
is_proboolean onget_leaderboard. - Build a rune recommender tool by reading the primary and secondary rune slot data returned by
get_champion_buildfor a given champion and lane.
| 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.
Does dpm.lol have an official developer API?+
What rank tiers can I filter champion data by?+
get_champion_list and get_champion_build accept a tier parameter with three values: emerald_plus, master_plus, and all. This lets you compare how a champion's win rate, pick rate, or recommended build shifts between the general ranked population and high-elo play.Are game modes other than ranked solo queue covered?+
get_champion_list accepts ranked as the sole game_mode value, and get_leaderboard returns solo queue ladder data. ARAM, normal draft, or Arena statistics are not currently included. You can fork this API on Parse and revise it to add endpoints covering those modes.Does the leaderboard endpoint cover all regions?+
get_leaderboard endpoint currently supports three platforms: euw1 (EUW), kr (Korea), and na1 (North America). Other regions such as EUN1, BR1, or LAN are not included. You can fork the API on Parse and revise it to add support for additional platforms.