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
Free100100
PAYGUnlimited10,000

​
Rate Limit Headers

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

​
Rate Limit Errors

When you exceed your rate limits, you’ll receive a 429 error: 
{
  "success": false,
  "error": {
    "code": "DAILY_LIMIT_EXCEEDED",
    "message": "Daily rate limit exceeded"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-01-15T12:00:00Z",
    "version": "1.0.0"
  }
}

​
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 getchatads.com/settings/billing
  2. Switch to the PAYG plan
  3. Complete the upgrade
Plan changes take effect immediately. Your new limits are available right away.