Last updated
@iamtraction
Last updated
Pokédex API is based on a single layer, a HTTPS/REST consumption-only API that only allows the GET
method to consume all the Pokémon information you’ll ever need.
The base URL for all API requests is:
No authentication is required to access this API. All the resources are and available to everyone. However, we will implement authentication methods in the future that will give authenticated users higher rate limits or no rate limits at all (more on later).
Applications and websites using the API must provide a valid which specifies information about the app and website, in the following format:
Applications and websites may append more information and metadata to the end of this string as they wish.
This API rate limits requests in order to prevent abuse and overload of our services. Rate limits are applied on a global basis, spanning across the entire API.
Because we may change rate limits at any time and rate limits can be different per application, rate limits should not be hard coded into your application or website. In order to properly support our dynamic rate limits, your application or website should parse for our rate limits in response headers and locally prevent exceeding of the limits as they change.
Current rate limit is 50 API calls in 10 minutes. And we will increase the rate limits every time we upgrade our server for better performance.
We recommend that your application or website should locally cache the data that you receive to save the number of API calls consumed for the same resource.
For every API request made, we return optional HTTP response headers containing the rate limit encountered during your request.
Retry-After
- The number of milliseconds after which the rate limit will reset. It is returned only if you’ve been rate limited.
RateLimit-Limit
- The number of requests that can be made
RateLimit-Remaining
- The number of remaining requests that can be made
RateLimit-Reset
- Epoch time (seconds since 00:00:00 UTC on January 1, 1970) at which the rate limit resets. It is returned only if you’ve been rate limited.
In the case that a rate limit is exceeded, the API will return a HTTP 429 response code with a JSON body.
Note that the normal rate-limiting headers will be sent in this response.
API users that regularly hit and ignore rate limits will be banned (by their IP address) from using the API again.
The rate-limiting response will look something like the following:
This API implements a process for limiting and preventing excessive requests in accordance with .
Field
Type
Description
status
integer
The HTTP response code.
message
string
A message saying you are being rate limited.