{% extends "base.html" %} {% block mainbody %}
{% block docstitle %} {% endblock docstitle %}

Information

Please take note when using this API:

  • This is a consumption-only API - only the HTTP GET method is available on resources.
  • No authentication is required to access this API. All resources are fully open and available.
    • There is, however, a daily rate limit of 300 requests per resource per IP address. So a single IP address can call the bulbasaur resource 300 times a day. Not 300 requests across the entire dataset! This is to stop our database from falling over under heavy load.
  • If you are going to be regularly using the API, I recommend caching data on your service.
    • Luckily, we provide modified/created datetime stamps on every single resource so you can check for updates (and thus make your caching efficient).

Fair Use Policy

PokéAPI is free and open to use. It is also very popular. Because of this, we ask every developer to abide by our fair use policy. People not complying with the fair use policy will have their IP address permenantly banned.

PokéAPI is primarily an educational tool, and we will not tolerate denial of service attacks preventing people from learning.

Rules:

  • Locally cache resources and images when ever you request them.
  • Do not spam the entire service to scrape all the data at once - use the paginated pages.
  • Use the correct user-agent header in API requests.
  • Be nice and friendly to your fellow PokéAPI developer.

Slack

Have questions? Ideas? Notice something amiss here in the docs? Hit us up on Slack. Sign up right here then visit our slack team. We encourage you to come here before opening a ticket on github, so we can keep our issues nice and organized. There are also a solid group of people using the API who may already have answers or plans from experience.

{% block docsbody %} {% endblock docsbody %}
{% endblock %}