​

Rate Limits

​

Rate Limit Tiers

​

Rate Limit Headers

​

Example Response Headers

HTTP/1.1 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1702209600
X-Daily-Quota-Limit: 1000
X-Daily-Quota-Remaining: 856
Content-Type: application/json

​

Rate Limit Exceeded

{
  "success": false,
  "error": "Rate limit exceeded",
  "code": "RATE_LIMITED",
  "details": "Maximum 60 requests per minute. Please wait 15 seconds.",
  "retry_after": 15
}

​

Response Headers on 429

HTTP/1.1 429 Too Many Requests
Retry-After: 15
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1702209615

​

Quota Exceeded

{
  "success": false,
  "error": "Daily quota exceeded",
  "code": "QUOTA_EXCEEDED",
  "details": "Daily limit of 1000 requests reached. Resets at midnight UTC.",
  "quota_reset": "2025-12-11T00:00:00Z"
}

​

Best Practices

import time
import requests

def make_request_with_backoff(url, headers, data, max_retries=3):
    for attempt in range(max_retries):
        response = requests.post(url, headers=headers, json=data)

        if response.status_code == 429:
            retry_after = int(response.headers.get('Retry-After', 2 ** attempt))
            time.sleep(retry_after)
            continue

        return response

    raise Exception("Max retries exceeded")

const response = await fetch(url, { headers });
const remaining = parseInt(response.headers.get('X-RateLimit-Remaining'));

if (remaining < 10) {
  console.warn('Rate limit running low:', remaining);
  // Implement throttling logic
}

from functools import lru_cache
import hashlib

def get_cache_key(user_profile, location):
    data = f"{user_profile['travel_type']}-{location['city']}"
    return hashlib.md5(data.encode()).hexdigest()

@lru_cache(maxsize=100)
def get_cached_recommendations(cache_key):
    # Fetch from API
    pass

​

Endpoint-Specific Limits

​

Monitoring Usage

​

Dashboard

• Current minute usage
• Daily quota consumption
• Historical usage graphs
• Alert configuration

​

Usage Alerts

1. Go to API Keys → Your Key → Alerts
2. Configure thresholds:
   • 80% of rate limit
   • 90% of daily quota
3. Choose notification method (email, webhook)

​

Burst Handling

​

Rate Limit by Plan

​

Free Plan (Development)

• Best for: Testing and development
• 10 requests/minute, 100/day
• No production use

​

Basic Plan

• Best for: Small AI agents with moderate traffic
• 60 requests/minute, 1,000/day
• Suitable for: Personal projects, small chatbots

​

Premium Plan

• Best for: Production AI applications
• 300 requests/minute, 10,000/day
• Includes: Priority support, usage analytics

​

Enterprise Plan

• Best for: High-volume applications
• Unlimited requests
• Includes: Dedicated support, SLA, custom integration

​

Requesting Higher Limits

1. Upgrade Plan: Visit privetag.com/pricing
2. Enterprise: Contact enterprise@privetag.com
3. Temporary Increase: Request for special events via support

​

Next Steps