Why am I receiving 429 errors?

There are a number of possible reasons you might be seeing this error. If you haven’t already, check the response body for more details, we include a detailed plain text message explaining the reason for the 429.

If you see a message like Per anonymous IP rate limit exceeded, it implies that you are not including an API key with your requests. Make sure to include it as a header: Authorization: Bearer <your_api_key>. See the snippets on the API key page for more examples of how to set the API key depending on your client.

If you see something like Per application per IP rate limit exceeded. Limit: x compute units per 300 seconds window, it means you are using a client side API key, but your users are hitting the per IP limit you set for that key. You can increase this limit by editing the API key:

This limit exists to help prevent abuse by a single IP address, but you can set the value to whatever you want.

What are the anonymous limits?

Anonymous limits apply to requests that do not include an API key. Some limits are applied per IP address, while others are applied per IP + origin (to ensure no single site uses up the whole limit):

If you want to access higher limits, please create an account on Geomi to generate an API key. You can further increase your free limits by attaching a credit card (you won’t be charged unless you exceed your limits, and can set budgets to help prevent that).