Skip to content

Dev Blog: The Riot API

Riot··0 votes·145,716 views

Hey guys, J. “Riot Sargonas” Eckert of the Developer Relations Team, here to chat with you about the place of 3rd party websites and applications in the League of Legends ecosystem. This has been a frequent topic of discussion amongst the community in the past year, and hopefully I can provide some insight into our vision for supporting developers in providing added value to both League of Legends and players, while at the same time protecting the integrity of the game and most importantly the player experience. Whether it comes in the form of moving 3rd parties off of scraping live services over the API for stability reasons, talking directly with 3rd parties to change the functionality of the apps to be more player focused, working internally to limit the effectiveness of cheating tools, or countless other initiatives, those goals will always be the driving factor.


Developing for League

As League and its community grows, so do the programs and websites created by third parties looking to add to the player experience. Sometimes these ventures provide fresh, fun ways to enhance the League experience, while other times they cross the threshold into providing unfair advantages that upset the competitive balance and integrity of the game, and in some cases harm the overall player experience. Our constant challenge in Developer Relations is to encourage and support positive growth, while trying to mitigate and protect against applications that cause a negative player experience.

With the League experience, there are opportunities that Riot can and should deliver to players, and ones that players should explore and build themselves. When it comes to ways that other players can help build on, there are all sorts of awesome ideas for expanding the League of Legends experience that are worth supporting, so let’s talk a bit about how help do this.


Supporting developers

When it comes to experiences that anyone can help craft for players, we want to do everything we can to empower passionate members of the community. To do that, we’ve created a suite of developer tools, including the Riot API. Over the course of the last year we’ve continually updated the API and Developer Portal with new features, with 50+ updates alone in the first 10 months, aimed at creating a robust toolset for great community contributions, and larger third party sites. So far more than 65,000 developers have created accounts that offer basic tool access suitable for testing, and we’ve approved around 1000 production keys that provide full-scale access. We’ve also put together policies and guidelines to help shape development using these tools in player-focused directions. The whole purpose of this is to see the community use these tools to create meaningful additions to the League experience, even in areas Riot hasn’t gotten to yet. But we also want to make sure they do so with the same player-focused approach Riot uses.


What works, and what doesn’t

So what kind of experiences are we trying to foster? Every day we’re surprised with new and innovative things created by the community. And that’s really the point - we want players to be creative and cook up stuff we’ve never even imagined. The fact is, there are tens of thousands of players for every Rioter, so the math is simply in players’ favor when it comes to thinking up new ideas! Player creations like Ward Score and LSI provide some creative methods for players to engage with League in new ways or even level up their play. As a personal experience, I thought I had my warding bases covered until I looked myself up on Ward Score and found out I was actually in the bottom 5% of my peers. Now I’m in the top 98% and my ability to be an effective contributor on my teams has improved (well, in that area). These are the sorts of things we love seeing the community create, and we want to do whatever we can to help you make more of the same!

Offering an environment friendly to third-party development isn’t without its pitfalls. From time to time things pop up that we (often aided by the community) identify as not necessarily player focused, or harmful to game balance and fair play. When this happens, our first step is to engage the developer in question and attempt to guide them in productive directions where they can create value in line with our goals for League. Sometimes this works, sometimes not, and in the worst cases they may even ignore us and require us to take further steps to protect the player experience, such as revoking API keys or making use of such applications by players to be a TOS violation. At the end of the day though, our motives are always the same: player experience always comes before anything else, such as visibility for an up and coming developer, or the success (or failure) of a third party business trying to break into the industry. Our goal isn't to police applications with a heavy hand, but rather to ensure applications are aligned with our vision for player experience. We want to see these groups providing these experiences succeed, but not at the cost of the players.

We are especially protective of League’s core gameplay experience. We believe the best possible player experience comes from a fully featured competitive toolkit available as soon as you download and install the game. You should never feel the need to first go to a third-party website and download a suite of mods that are required in order to keep up with everyone else. Hence our key policy - “Nothing external should interfere with players’ experience from the moment they press ‘Play’ to the end of match screen.” This usually comes into play with programs that provide gameplay information or functionality not obtainable through normal game interactions (e.g.., everything from specialized overlays, hacks, etc.), which we take a consistently firm stance against in order to preserve a level playing field for all players.


Protecting the landscape

Third-party development in an ecosystem as expansive as League’s is difficult to stay on top of, no doubt about it, and even harder to predict. We can’t see or anticipate every project in development, and sometimes can’t reach out to help developers better align their work with player interests until an app comes to our attention. When we do interact with developers, however, we always seek to respond in whatever way best serves the interests of the entire player base. We are actively trying to foster ALL positive growth in this area, from small independent developers to actual businesses, but we put the players first and are always going to hold player interests above companies simply out to make money. On the flip side, we appreciate your patience as we seek to address the new circumstances and challenges brought about about by the continuing evolution of the third-party scene.

Lastly, it’s important to point out that we never officially support any third-party work. While we may provide tools to empower outside development, the results aren’t an official part of the League of Legends experience and we can’t provide support in resolving issues stemming from them. We’re unable to vet the code of every third party, and can’t adequately test all variations of their applications with our game across the myriad of user setups out there. There is always a risk that external applications may cause game (or system) stability, contain malicious code, or a variety of other potential issues. We always advise you to take the proper steps to protect your account security and computer stability above all else (and to especially *never* share your account credentials with any Third Parties), and forego the use of any programs or applications that cause you concern.



TL;DR - We’ll always take the steps needed to protect players and the integrity of the core game experience. At the same time, we want to help foster growth within and around the League of Legends community by empowering players and outside developers to create experiences that enhance your experience in meaningful, positive ways. The key to this is maintaining a dialogue with players around new stuff in the scene, so we will continue to engage with the community to learn your thoughts on issues like these, and welcome feedback in the comments below. The rest of the team (StillRampant and Riot Tuxedo) and I will be hanging out to answer any questions you might have for the next few hours.

521 Comments

Thurisaz91 votes

Damn, lost my chance for first.

RiotSargonas129 votes

{quoted}

Damn, lost my chance for first.

I'll officially declare you "second" at least! ;)

Anti Social Loli14 votes

can i eithersummoner 4 or summoner 12 to first or second?

Virgin Ray19 votes

Whos number 567908? I AM!!!!

ArcaneMusic22 votes

Hmm, I have a ward score of 1539 :D Take that, other supports. item 2043

Final GirI3 votes

Ward score? How do you check that?

Final GirI10 votes

OH MY GOD MY WARD SCORE IS TRASH! DON'T LOOK! I AM ASHAMED!

Popstar Bulma5 votes

I looked at your WardScore. It's horrible

Final GirI5 votes

I SAID DON'T LOOK! GOD NO!

ZGM Dazzling6 votes

I dont think wardscore exists anymore....... :/

RiotSargonas52 votes

{quoted}

I dont think wardscore exists anymore....... :/

I did till about 20 minutes ago when all the traffic we inadvertently sent it's way gave it's server a death hug! Sorry EnigmaSM!!!

dissolvedplasma38 votes

lol, accidental DDoS attack by Riot!

Ex3cUtIoN118 votes

I did till about 20 minutes ago when all the traffic we inadvertently sent it's way gave it's server a death hug! Sorry EnigmaSM!!!

Well, that explains my problem. Riot, fix your third parties! :p

Focus My ADC9 votes

I have a ward score of 3432, take THAT, other supports. Overall, I ward more than 99% of players. Easy peasy.

Ahripostale18 votes

do you just sit in base and spam sightstone?

Klatn Yelox17 votes

Caught me. Wardscore is more important than rank to me. I'm determined to be the highest wardscoring bronze EVER!

LegitDaveStrider18 votes

I really love the idea of players having the chance to change the game so much.
Rather than most games where the community only changes the game mostly through feedback, this gives those who love the game and have the necessary skill sets the ability to do far more for the game they hold dear. Rito please =)

RiotStillRampant28 votes

{quoted}

I really love the idea of players having the chance to change the game so much.
Rather than most games where the community only changes the game mostly through feedback, this gives those who love the game and have the necessary skill sets the ability to do far more for the game they hold dear. Rito please =)

This. More or less, this is why I love my job. Our goal as a team is to give talented players who see problems as opportunities the means and guidance to improve the player experience in ways that don't compromise the game.

Lord Imrhial10 votes

Yay! The API Team finally got a spotlight! :D

Keep it up guys and gals, or should I say guys and Schmick (Sorry if there are more ladies!!! Caitlyn )

RiotRiot Tuxedo8 votes

[{quoted}](name=Lord Imrhial,realm=NA,application-id=Ag8jgd8Q,discussion-id=yHbhEskR,comment-id=0028,timestamp=2015-01-08T21:16:52.892+0000)

Yay! The API Team finally got a spotlight! :D

Keep it up guys and gals, or should I say guys and Schmick (Sorry if there are more ladies!!! Caitlyn )

I know you :)

Lord Imrhial5 votes

I know you too! :)

P.S. you denied my friend request on the PvP.net client dramatic sad face Amumu lolol jk, I was just curious to see if you ever wanted to duo with another Gold.

##DevDuoFTW

RiotRiotSchmick8 votes

He does want to - me. : P

RiotRiotSchmick6 votes

Heya Imrhial!

Nope, currently I'm the only one.

jellybiscut9 votes

why dont yall (please excuse southern slang) create your own site instead of allowing 3rd party so that way you have complete control instead of doing multiple patches to your available data for them if this is a stupid question please downvote for waste of time.

RiotSargonas10 votes

{quoted}

why dont yall (please excuse southern slang) create your own site instead of allowing 3rd party so that way you have complete control instead of doing multiple patches to your available data for them if this is a stupid question please downvote for waste of time.

No apologies needed, I spent half my life in Louisville Kentucky and I say "yall" all the time. ;)

As to your question, we touch on this a bit in the blog but I'd be happy to elaborate. Riot has only so much we can do in a certain amount of time, even with the resources we have at our disposal. If there are things that players can do that enhance the experience, we should help them do so! It allows them to work on those sorts of things while we can focus on the stuff that we are uniquely positioned to work on in ways that they can't. Also, the honest fact is people will ALWAYS try to build these tools. It's much easier, and more importantly better for the players, if we help guide them in the right direction towards the best player experience.

Moobeat6 votes

louisville represent

RiotSargonas7 votes

UofL > UK.

runs and hides in a bunker

Andrawesome9 votes

I live in Canada, with absolutely no Southern background, but Y'all is a key part of my vocabulary...

RiotRiotSchmick8 votes

I live in Canada, with absolutely no Southern background, but Y'all is a key part of my vocabulary...

Muhahaha, all is going according to plan....

Nicarasu5 votes

Midwest represent! I live in Indiana and say ya'll all the time.

RiotSargonas5 votes

{quoted}

Midwest represent! I live in Indiana and say ya'll all the time.

Hey me too! While I spent most of my time in Louisville, I'm originally from Jasper Indiana!

WeeDerkaNaut4 votes

My best friend lives in Jasper, I spent most of 2013 over there. Born in Evansville and raised in southern Indiana :D

RiotRiotSchmick16 votes

Native Texan here, and I approve this ya'll.

DorkunedAuras9 votes

Native Texan here y'all <3

RiotRiotSchmick10 votes

I was fixin' to say that.

Toraso7 votes

Nice update; helps remind everyone that you do your best in a world of over a million Lol players. Hope you guys have a great Lunar Revel planned!

RiotSargonas19 votes

{quoted}

Nice update; helps remind everyone that you do your best in a world of over a million Lol players. Hope you guys have a great Lunar Revel planned!

they are over 9000!

;)

ChimeiTekinaNasu6 votes

It's actually 8000. =3 The English dub had a mistranslation.

Nice to know you also watch anime. lol

Klatn Yelox4 votes

Nice to know you also pay attention to fine details in translation bro!

RiotSargonas17 votes

Believe it or not, I'm enough of a Nerd that I knew that.. however I figure with the general internet-at-large saying 9000 instead of 8000 will be more recognizable to more people. ;)

LilStacey874 votes

Im not sure exactly what a 3rd party program is. I read the whole thing and was still a little lost lol. (Doing the Goku head scratch)

RiotRiot Tuxedo5 votes

{quoted}

Im not sure exactly what a 3rd party program is. I read the whole thing and was still a little lost lol. (Doing the Goku head scratch)

A third party application is a website, mobile app, or program that is not developed by Riot Games.

LilStacey872 votes

[{quoted}](name=Riot Tuxedo,realm=NA,application-id=Ag8jgd8Q,discussion-id=yHbhEskR,comment-id=00190000,timestamp=2015-01-08T20:46:39.462+0000)

A third party application is a website, mobile app, or program that is not developed by Riot Games.

Ok, thanks sir/mam

Lord Imrhial9 votes

Grandmaster*

4dmiral3 votes

I think the API is great—will there ever be a way to gather historical data from league? The API is awesome for live data or tools/apps that need current info, but what's the best way to get historical or aggregate data about games played, items used, etc? Does that exist?

RiotSargonas8 votes

{quoted}

I think the API is great—will there ever be a way to gather historical data from league? The API is awesome for live data or tools/apps that need current info, but what's the best way to get historical or aggregate data about games played, items used, etc? Does that exist?

Actually, a large chunk of the API data is just that.. historical data going back to around mid season 2014. The "live" data is actually not even in the API yet, but something we are about to release in a fairly soonish time frame. (Weeks not months.)

Dantilq2 votes

I was disappointed by the API, I wanted to make mods, my own game modes, make my own champion and stuff like that, not third party statistics tools :(

RiotSargonas12 votes

{quoted}

I was disappointed by the API, I wanted to make mods, my own game modes, make my own champion and stuff like that, not third party statistics tools :(

Unfortunately, those sorts of changes are the very things we're trying to protect against for the reasons outlined above. We truly love the enthusiasm and creativity you guys have around these things, but it doesn't mesh well with some of the overall core philosophies we have.

As someone once said "We're running a theme park here. Please don't try to take bolts off the roller coasters." ;)

Rykujinn8 votes

That being said, what about the players (pretty much all of us) who have legitimate full fledged ideas for champions or game modes etc. You see players spouting their ideas in the replies for your announcements, but I have never heard of a place that the developer teams actually legitimately check for what people want to see. Does such a thing exist? Or am I just a dreamer?

More from Announcements