Anyone who signs into the developer portal will automatically be granted an API key associated with their account. If you haven't yet done so, please visit the Getting Started page for more information. Your API key allows you to start using the API, and allows us to generate API usage metrics for your key.
Development and Interim API Keys
The API key that was generated for you when you signed into the developer portal is a development API key. Interim API keys are temporarily granted for projects that are not meant for public consumption but do require temporary access to the API. The purpose of a development or interim API key is for you to tinker with the Riot Games API and potentially develop a prototype for a project that you can make available for the community to use.
Other acceptable uses for a development API key include:
- bots for streaming sites, boards, voice com servers, etc.
- to display your own personal stats for your personal website
- personal projects to gather your own stats
- personal research
- projects meant for personal usage and not production
The rate limit for development keys is by design very limited:
- 20 requests every 1 second
- 100 requests every 2 minutes
As per our Terms of Service and policies, you may not run your application for public consumption using a development key, regardless of how long the approval process for your production key takes. Note that public consumption includes open alpha/beta tests. We are aware that the approval times for production keys are backed up and we are working on improving that, but the long approval time does not negate any of our terms or policies. The point of the approval process is to vet applications and ensure that they are not violating any of our policies and are not doing anything that might be bad for the League community. Even if you think your application is in the clear, that doesn't trump the established approval process, terms, or policies. If we find your app/site running for public use on a development key, then your development key will be blocked and your production key will not be approved.
You can find your development API key and its rate limit on your dashboard. In addition, the metrics we generate for your key allow you to track your key's usage under the Development API Key Usage section on your dashboard. Note that these graphs will include all calls made with your API key, even those that don't count against your rate limit (e.g., calls to the static data API). For more information on rate limits, see the Rate Limiting documentation.
Production API Keys
If you have developed an application that you would like to open up to use by the community, you should apply for a production API key. You should not try to maintain a public application or website off of a development API key. Production API keys have a much higher rate limit suitable for sustaining a production application's traffic.
The standard rate limit of a production API key is much larger than the development key:
- 3,000 requests every 10 seconds
- 180,000 requests every 10 minutes
To apply for a production key with an expanded rate limit, click on the "Register Project" button on your dashboard, then fill out and submit the form. The process and length of time required to obtain an approved production key can vary depending on your project and the application's target region(s). It's best to apply for a production API key as soon as you have a functional application, so we can get a better idea of what you're working on and facilitate a speedy application process. For more information on policies and process, see the General Policies and Application Process documentation.
Note that the standard production rate limit will meet the needs of the large majority of developers but it can be expanded if the developer is in good standing, has demonstrated a strong community benefit, and has steadily outgrown the standard production limit.
If you are working on multiple projects, you should register each one separately and each one needs to be individually approved for a separate production API key.
Production API keys are only granted to projects that are available, visible, and usable by the community and comply with our General Policies.
If you have an approved production application, you can click on that application from your dashboard to view the application details page, which will display the rate limit for that application's key. In addition, the metrics we generate for your key allow you to track your key's usage under the API Key Usage section on the application details page. Note that these graphs will include all calls made with your API key, even those that don't count against your rate limit (e.g., calls to the static data API). For more information on rate limits, see the Rate Limiting documentation.
It's important to mention that any key may be revoked if it isn't being properly secured. Securing your API key is a requirement to publishing an project as outlined in the General Policies. For more information on securing your API key, please see the Credentials Security page.