Rate Limits¶
To ensure the availability and stability of the PUBG API, each API key has a limit on the number of requests it can be used to make per minute. The default rate limit is 10 requests per minute for testing/development purposes. When you have exceeded the number of available requests you will receive an HTTP 429 error code (too many requests), but you should be able to make requests again within a minute.
The rate limit headers are defined as follows:
X-RateLimit-Limit - Request limit per day / per minute
X-RateLimit-Remaining - The number of requests left for the time window
X-RateLimit-Reset - The time that the rate limit will be reset, as a UNIX timestamp
Expected Rate Limit Usage¶
Since the /matches and telemetry endpoints are not rate limited, the amount of rate limited requests a typical application needs to make to the API should be directly proportional to the number of users/players using it. For example, each time a player is looked up, the application needs to make two requests (if the information is not already cached):
one to “/players?filter[playerNames]={playerName}” or “/players/{accountId} if the accountId is already known”
one to “/players/{accountId}/seasons/{seasonId}” if season stats are required for the use case
Any following requests to the /matches or telemetry endpoints will not count against the application’s API key rate limit.
Requesting a Higher Rate Limit¶
If you find that the default (10RPM) rate limit is not sufficient for your application, you can request a higher limit by selecting “I NEED A HIGHER LIMIT” in “MY APPS”. Please keep in mind that we require some form of working sample and an explanation of the need for a higher limit in order to approve rate limit increase requests.
Please make sure that you fill out the form completely with as much detail as possible, and we will work with you to provide a more appropriate limit.
In order to determine an appropriate rate limit for your application, we need to know how many API requests your application makes, when it makes them, and analytics showing the number of users if you have active users. We will also want to know about the caching and optimization strategies you are using in order to help reduce the number of API requests that your application requires. Please take a look at our Caching Overview and Caching Implementation sections for additional information.
If the project you are working on has a barrier to entry, please provide all the necessary information on how to access your site.
If your rate limit request is approved, you will receive a notice that the rate limit has been increased for your application.