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:

#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/....

Region
naNorth America
euwEU West
euneEU Nordic & East

#Queues

MMR is analyzed and tracked for the following queues:

Queue
rankedRanked 5v5 Draft Pick games
normalNormal 5v5 Draft Pick games
ARAMARAM 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

Parameter
nameA case insensitive summoner’s name
Response
<queue>.avgThe estimated MMR for the summoner in this queue. Is null if no estimate is available.
<queue>.errThe margin of error for the estimate using an 95% confidence interval for this queue.
<queue>.warnA boolean flag indicating if there was insufficient match data for this queue.
<queue>.timestampThe UTC timestamp of the last data processed for the summoner in this queue.
<queue>.historicalAn array of previous queue data objects with a minimum timescale of one day.
ranked.summaryHTML-formatted analysis of the summoner’s ranked standings based on MMR.
ranked.tierDataAn array of tier objects relative to the summoner’s current MMR, containing average, min, and max MMR.
ranked.historicalTierDataAn 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

Response
<queue>.<mmr>A scaled number of players at this MMR.