Skip to main content

​
Overview

ChatAds uses rate limiting to ensure fair usage and service stability. Limits are applied per team and shared across all API keys.

​
Rate Limit Tiers

PlanMonthly RequestsDaily Requests
Free10010
Starter5,000500
Pro50,0005,000
EnterpriseCustomCustom

​
Rate Limit Headers

Each response includes rate limit information in the meta.usage object: 
{
  "meta": {
    "usage": {
      "monthly_requests": 250,
      "daily_requests": 20,
      "daily_limit": 100,
      "is_free_tier": true,
      "free_tier_limit": 100,
      "free_tier_remaining": 0
    }
  }
}

​
Rate Limit Errors

When you exceed your rate limits, you’ll receive a 429 error: 
{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Daily request limit exceeded. You've used 120 of 100 requests for today.",
    "details": {
      "daily_limit": 100,
      "daily_usage": 120,
      "reset_at": "2024-01-02T00:00:00Z"
    }
  }
}

​
Best Practices

Monitor usage

Track your usage values to avoid hitting limits unexpectedly.

Implement backoff

When rate limited, wait before retrying. Use exponential backoff.

Cache responses

Cache affiliate responses for identical queries to reduce API calls.

Upgrade when needed

If you consistently hit limits, consider upgrading your plan.

​
Upgrading Your Plan

To increase your rate limits:
  1. Go to app.getchatads.com/settings/billing
  2. Select a higher tier plan
  3. Complete the upgrade
Plan changes take effect immediately. Your new limits are available right away.