Handling rate limits

API requests are subject to rate limiting to ensure fair usage and system stability.

Rate Limit Response

If you exceed the rate limit, you’ll receive a 429 Too Many Requests response:

{
  "code": "API_KEY_QUOTA_EXCEEDED",
  "details": [
    {
      "message": "limit=1000;type=DAILY;reset_in=3600",
      "field": "DAILY"
    }
  ]
}

The details array contains information about the limit:

Field	Description
`limit`	The maximum number of requests allowed
`type`	The type of rate limit (e.g., `DAILY`)
`reset_in`	Seconds until the rate limit resets

Implement exponential backoff - When you receive a 429 response, wait before retrying and increase the wait time with each retry.
Cache responses - Store API responses locally when possible to reduce the number of requests.
Monitor your usage - Track your API usage to avoid hitting rate limits unexpectedly.