Rate Limits

The Voicy API does not currently enforce per-key request quotas. To keep the service stable for everyone, please stay within these guidelines:

Guideline	Value
Sustained request rate per API key	Up to 60 requests per minute
Bulk operations	Spread requests over time instead of sending bursts

Need a higher sustained rate? Contact us at support@voicy.co.

Build for future limits

Per-key rate limiting is planned. When it is introduced, requests over the limit will receive a 429 Too Many Requests response. We recommend building retry handling now so your integration is unaffected:

Retry with exponential backoff

Retry 429 and 5xx responses with increasing delays:

async function requestWithBackoff(fn, maxRetries = 5) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (error) {
      const retryable = error.status === 429 || error.status >= 500;
      if (retryable && i < maxRetries - 1) {
        const waitTime = Math.pow(2, i) * 1000; // 1s, 2s, 4s, 8s, 16s
        await new Promise(r => setTimeout(r, waitTime));
        continue;
      }
      throw error;
    }
  }
}

Queue bulk requests

For bulk operations, pace requests through a queue:

class RateLimitedQueue {
  constructor(requestsPerMinute = 60) {
    this.queue = [];
    this.interval = 60000 / requestsPerMinute;
    this.processing = false;
  }

  async add(fn) {
    return new Promise((resolve, reject) => {
      this.queue.push({ fn, resolve, reject });
      this.process();
    });
  }

  async process() {
    if (this.processing || this.queue.length === 0) return;
    this.processing = true;

    while (this.queue.length > 0) {
      const { fn, resolve, reject } = this.queue.shift();
      try {
        resolve(await fn());
      } catch (error) {
        reject(error);
      }
      await new Promise(r => setTimeout(r, this.interval));
    }

    this.processing = false;
  }
}