mobalytics.gg APImobalytics.gg ↗
Access League of Legends tier list rankings, champion builds (runes, items, skill order), and matchup stats from Mobalytics via a simple REST API.
curl -X GET 'https://api.parse.bot/scraper/e7dd7967-737e-472d-90c0-f106c9882b4e/get_tier_list' \ -H 'X-API-Key: $PARSE_API_KEY'
Get the current LoL meta tier list showing champion rankings (S/A/B/C/D tiers) for each role. Returns all champions grouped by role and tier, including their champion types. Can be filtered by role and skill level.
| Param | Type | Description |
|---|---|---|
| role | string | Filter by role. Accepts exactly one of: top, jungle, mid, adc, support. Omitting returns all roles. |
| skill_level | string | Skill level tier list. Accepts exactly one of: low-elo, high-elo. |
{
"type": "object",
"fields": {
"tier_list": "object mapping role names to tier groupings, each tier containing an array of champion objects",
"role_filter": "string or null",
"skill_level": "string"
},
"sample": {
"tier_list": {
"MID": {
"A": [
{
"name": "Hwei",
"slug": "hwei",
"tags": null,
"tier": "A",
"champion_types": [
"Mage"
]
}
],
"B": [
{
"name": "Aurora",
"slug": "aurora",
"tags": null,
"tier": "B",
"champion_types": [
"Mage"
]
}
],
"S": [
{
"name": "Fizz",
"slug": "fizz",
"tags": null,
"tier": "S",
"champion_types": [
"Assassin"
]
}
]
}
},
"role_filter": "MID",
"skill_level": "low-elo"
}
}About the mobalytics.gg API
The Mobalytics API provides 3 endpoints covering League of Legends meta data: current tier list rankings by role and skill level, full champion builds including runes, items, and skill order, and per-champion statistics with counter matchups. The get_tier_list endpoint returns all champions grouped by role and tier (S through D), optionally filtered to a single role or skill level bracket.
Tier List Data
The get_tier_list endpoint returns the current LoL meta tier list as an object mapping role names to tier groupings. Each tier contains an array of champion objects. You can pass a role parameter (one of top, jungle, mid, adc, support) to narrow results, and a skill_level parameter (low-elo or high-elo) to get a tier list calibrated to a specific player bracket. The response always includes the applied role_filter and skill_level so you can confirm what context the rankings reflect.
Champion Builds
The get_champion_build endpoint accepts a champion_slug (e.g. leesin, twistedfate) and an optional role. It returns a build object containing skill_order, summoner_spells, runes, and items, sourced from Emerald+ ranked games on the current patch. The response also includes the champion's tier, patch string, and a stats object with win_rate, pick_rate, and ban_rate as percentages — giving enough context to evaluate whether a build is from a statistically significant sample.
Champion Stats and Counters
The get_champion_stats endpoint returns an array of roles objects for every role a champion is played in, each containing tier, win rate, pick rate, ban rate, and a list of top counter champions. The skill_level parameter accepts LOW or HIGH (note: uppercase, unlike the tier list endpoint) to shift the statistical context. The response also includes the numeric champion_id alongside the slug, which is useful for cross-referencing with other League data sources.
- Display a live S-tier champion list for a given role in a draft-assist tool, using
get_tier_listfiltered byrole. - Show recommended rune pages and item builds inside a companion app, pulling from
get_champion_buildfor the user's selected champion and role. - Surface counter-pick suggestions during champion select by reading the
countersarrays fromget_champion_stats. - Compare win rate and pick rate across patches by periodically polling
get_champion_buildfor each champion and storing thepatchandstatsfields. - Build a low-elo vs. high-elo tier difference view by calling
get_tier_listtwice withskill_levelset tolow-eloandhigh-eloand diffing the results. - Populate a champion overview card with aggregated stats across all roles a champion plays, using the
rolesarray fromget_champion_stats.
| 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 Mobalytics have an official public developer API?+
How does the `skill_level` filter work across endpoints, and are the accepted values the same?+
skill_level use different value formats. get_tier_list accepts low-elo or high-elo (lowercase, hyphenated), while get_champion_stats accepts LOW or HIGH (uppercase). Passing the wrong case to either endpoint will not produce the intended filtering.Does the API return historical tier list data or builds from previous patches?+
patch field in get_champion_build tells you which patch the build is sourced from, but there is no historical query parameter. You can fork this API on Parse and revise it to add snapshot storage or historical patch lookups.Does the API cover ARAM, URF, or other non-Summoner's Rift game modes?+
What does the `build` object in `get_champion_build` actually contain?+
build object contains four fields: skill_order (the recommended ability leveling sequence), summoner_spells (the two suggested summoner spells), runes (the recommended rune page), and items (the recommended item build path). All values reflect the most popular build among Emerald+ ranked games on the current patch.