Public API Documentation
v1.2, revised August 8, 2017
# Introduction
WhatIsMyMMR.com analyzes tens of millions of matches each month, resulting in highly correlated MMR values and robust distribution data. The WhatIsMyMMR public API makes it easier than ever to tap into this wealth of knowledge at no cost. This document outlines what’s possible with the API along with the ground rules. Let’s build something amazing!
# License
Creative Commons Attribution 2.0 Generic (CC BY 2.0). You must provide attribution if you use this API.
# Rules
Although the API is a free public resource, API consumers are expected to obey some basic rules to keep things running smoothly:
- Use a unique and descriptive User-Agent string, which should include the target platform, a unique application identifier, and a version string.
- The following format is recommended:
<platform>:<app ID>:<version string>
. For example,User-Agent: iOS:com.example.helloworld:v1.0.3
. - Don’t lie about your User-Agent, such as spoofing popular browsers. This is a bannable offense.
- The following format is recommended:
- Try to limit the number of requests to 60 per minute.
- The database server is only so powerful. If you think you’ll need a higher request rate, contact Josh before hitting the servers.
# Regions
Endpoints are scoped by region and specified by the request subdomain. If no region is specified, na
is used instead. For example, https://na.whatismymmr.com/api/v1/...
.
na | North America |
---|---|
euw | EU West |
eune | EU Nordic & East |
# Queues
MMR is analyzed and tracked for the following queues:
ranked | Ranked 5v5 Draft Pick games |
---|---|
normal | Normal 5v5 Draft Pick games |
ARAM | ARAM games |
#GET /api/v1/summoner
Returns the estimated ranked
, normal
, and ARAM
MMRs for a summoner.
Example: https://na.whatismymmr.com/api/v1/summoner?name=Not+a+Neko
name | A case insensitive summoner’s name |
---|
<queue>.avg | The estimated MMR for the summoner in this queue. Is null if no estimate is available. |
---|---|
<queue>.err | The margin of error for the estimate using an 95% confidence interval for this queue. |
<queue>.warn | A boolean flag indicating if there was insufficient match data for this queue. |
<queue>.timestamp | The UTC timestamp of the last data processed for the summoner in this queue. |
<queue>.historical | An array of previous queue data objects with a minimum timescale of one day. |
ranked.summary | HTML-formatted analysis of the summoner’s ranked standings based on MMR. |
ranked.tierData | An array of tier objects relative to the summoner’s current MMR, containing average, min, and max MMR. |
ranked.historicalTierData | An array of reduced tier objects relative to the summoner’s current MMR, containing the average MMR. |
#GET /api/v1/distribution
Returns a scaled number of players across the entire range of MMR for all queues.
To get the absolute number of players, divide a returned number by the summation of scaled numbers and multiply the result with the total number of players in the queue.
Example: https://na.whatismymmr.com/api/v1/distribution
<queue>.<mmr> | A scaled number of players at this MMR. |
---|