Skip to main content
Understand how ChatAds billing works, including usage monitoring, plan upgrades, and how different request types affect your quota.
Check usage in two ways:
  1. Dashboard - Visit getchatads.com for real-time usage graphs
  2. API Response - Every response includes meta.usage with current counts:
{
  "meta": {
    "usage": {
      "monthly_requests": 250,
      "daily_requests": 20,
      "daily_limit": 100,
      "is_free_tier": true
    }
  }
}
  1. Go to getchatads.com/settings/billing
  2. Select a higher tier
  3. Complete payment
New limits take effect immediately.
No. Requests blocked by keyword rules or geo-restrictions do not count against your rate limits. Only successful processing attempts are counted.
  • All Requests = every request that hits the API, including those that fail validation, are rate limited, or are blocked by your filters
  • Billable Requests = requests that pass all validation and are analyzed for affiliate opportunities (these are billed)
  • Filled Requests = billable requests where we matched an affiliate ad
Your fill rate = Filled ÷ Billable.
This happens when requests are blocked before analysis. Common reasons:
  1. Rate limit exceeded (429 errors)
  2. Keyword filtering (blocked by your keyword rules)
  3. Geo-filtering (request from blocked country)
  4. Invalid input (message too short/long)
These pre-filtered requests don’t consume your quota and aren’t billed.
Fill rate = Filled Requests ÷ Billable Requests. To improve it:
  1. Send messages with clear product intent (e.g., “looking for running shoes” vs. generic chat)
  2. Avoid messages with mostly PII or blocked keywords (they get sanitized and may become too short)
  3. Ensure messages are in English and from US traffic (we only match US, English content)
  4. Keep messages under 5,000 characters (longer messages are truncated internally)
The free tier includes 100 requests per month to let you test the API. To remove this limit and get usage-based pricing, add a valid credit card in Billing. You’ll only be charged for what you use—no monthly minimums.
ChatAds uses tiered pricing with volume discounts. The more you use, the less you pay per request. See our Pricing page for current rates.Billing is based on billable requests only—requests that pass validation and are analyzed for affiliate matching. Failed requests, rate-limited requests, and blocked requests don’t count toward billing.
ChatAds bills monthly for accumulated usage. At the end of each billing cycle, you’re charged for all billable requests made during that period. There are no upfront costs or monthly minimums—you only pay for what you use.
Not currently in the dashboard, but you can:
  1. Monitor usage in real-time via the dashboard or API responses
  2. Set up alerts by tracking the meta.usage field in API responses
  3. Contact support for custom spending limits on enterprise plans
We’re working on built-in budget controls for a future release.
If a payment fails:
  1. You’ll receive an email notification
  2. A banner appears in the dashboard prompting you to update your payment method
  3. You have a grace period to resolve the issue before service is affected
Update your payment method at Billing to avoid interruption. You can also click “Retry Payment” on failed invoices to try again with your current card.
Go to Billing > Invoices and click the download button next to any invoice to get a PDF copy.
Credits are given out as part of promotions and special offers. When you’re billed, credits are deducted from what you’d otherwise owe. If your credits exceed your bill, you won’t be charged—credits will be deducted instead.View your credit balance on the Billing page.