Skip to main content

Documentation Index

Fetch the complete documentation index at: https://arnaud.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

All requests to the Current Weather Data API are subject to rate limits.

Limits

On the Free plan:
  • 60 requests per minute
  • 1,000,000 requests per month
If you exceed these limits, the API returns a 429 Too Many Requests response.

How to handle rate limits

When you receive a 429 response:
  • Stop sending requests temporarily
  • Wait at least one minute before retrying
Avoid sending bursts of requests in a short time window.

Best practices

  • Cache responses when possible
  • Avoid making duplicate requests for the same data
  • Add retry logic with a delay when receiving 429 errors
Example retry strategy (JavaScript):
async function fetchWithRetry(url, options = {}, retries = 3) {
  const response = await fetch(url, options);

  // If rate limited (429) and retries remain, wait and retry
  if (response.status === 429 && retries > 0) {
    const delay = 60000; // wait 60 seconds before retrying
    await new Promise(resolve => setTimeout(resolve, delay));

    return fetchWithRetry(url, options, retries - 1);
  }

  // If the request failed for another reason, throw an error
  if (!response.ok) {
    throw new Error(`Request failed with status ${response.status}`);
  }

  // Otherwise, return the successful response
  return response;
}
Handling rate limits correctly helps prevent unnecessary failures and improves reliability.