Rate Limits & Pricing

The HirePlus API enforces rate limits to ensure fair usage and platform stability. All tiers include API access — your plan determines the monthly call cap and per-call credit cost.

Monthly API Call Caps

Calls within your monthly cap are billed at the standard credit rate. Calls beyond the cap continue at overage rates — they are never hard-blocked.

Per-Call Credit Costs (standard rate)

Costs are in cents per call within your monthly cap.

Throttle Limits

Rate Limit Headers

When you receive a 429 response, check these headers:

Handling Rate Limits

Retry with Exponential Backoff

Base URL: https://hireplus.ai/api/v1

const BASE_URL = `https://${process.env.NEXT_PUBLIC_BRAND_DOMAIN}/api/v1`;

async function analyzeWithRetry(
  formData: FormData,
  apiKey: string,
  maxRetries = 3,
) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const response = await fetch(`${BASE_URL}/analyses`, {
      method: 'POST',
      headers: { 'x-api-key': apiKey },
      body: formData,
    });

    if (response.status !== 429) return response.json();

    const retryAfter = parseInt(
      response.headers.get('Retry-After') ?? '60',
      10,
    );
    const delay = retryAfter * 1000 * Math.pow(2, attempt);
    await new Promise((r) => setTimeout(r, delay));
  }

  throw new Error('Max retries exceeded');
}

Best Practices

1. Batch requests — Space out analyses rather than submitting them all at once
2. Cache results — Store analysis reports locally using the id
3. Monitor usage — Use the /v1/usage endpoint to track your consumption
4. Handle 429s gracefully — Implement retry logic with backoff