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 app.getchatads.com for real-time usage graphs
  2. API Response - Every response includes meta.usage with current counts:
{
  "meta": {
    "usage": {
      "monthly_requests": 250,
      "free_tier_limit": 100,
      "free_tier_remaining": 50,
      "is_free_tier": true,
      "daily_requests": 20,
      "daily_limit": 100
    }
  }
}
ChatAds offers usage-based pricing with no monthly minimums:
  • Free tier - 100 requests/month to test the API
  • Paid tier - Pay per request with volume discounts
Add a credit card in Billing to unlock unlimited requests. See our Pricing page for current rates.
No credit card required to start. Sign up and get 100 free requests per month immediately. This lets you fully test the API, try different configurations, and validate your integration before committing to paid usage.
Add a credit card at Billing. Once added, your 100-request limit is removed and you’re on pay-as-you-go pricing. No plan selection needed.
Blocked requests are not billed. However, all authenticated requests count toward your daily/monthly rate limits, including those later blocked by keyword rules or geo-restrictions.
  • 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)
  • Non-billable statuses = message_too_short, message_too_long, blocked_keyword, country_not_allowed, ip_country_not_allowed, language_not_allowed, no_brand_found, and no_offer (when classified as not monetizable) are not 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. See Improving Offer Quality and Reducing Costs for detailed tips.
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 when your accumulated usage reaches $100 or at the end of the month, whichever comes first. 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. Your team is downgraded to the free tier immediately
  3. A banner appears in the dashboard prompting you to update your payment method
To restore paid access, add a new payment method at Billing and pay any outstanding invoices. You can also click “Retry Payment” on failed invoices to try again with your current card.If payments fail repeatedly, your account may be suspended. See “What does it mean if my account is suspended?” below.
Account suspension occurs when there are repeated payment failures or a billing dispute (chargeback). When suspended, a red banner appears across your dashboard.
  • Payment failures: Update your payment method at Billing and pay any outstanding invoices. Your account will be automatically reinstated once a successful payment is processed.
  • Billing disputes (chargebacks): Contact support at team@getchatads.com or use the Contact Support button in the banner for manual review.
All team owners receive billing notifications, including payment confirmations and payment failure alerts. To change who receives these emails, update team ownership in Team > Members.
Go to Billing > Invoices and click the download button next to any invoice to get a PDF copy.
Remove your payment method from Billing. If you have unbilled usage of 1ormore,afinalinvoiceiscreatedwithapplicablediscountsandpromotionalcreditsapplied,thenchargedtoyourcard.Ifthechargefails,theinvoiceremainsunpaidandyou′llneedtopayitbeforere−upgrading.Amountsunder1 or more, a final invoice is created with applicable discounts and promotional credits applied, then charged to your card. If the charge fails, the invoice remains unpaid and you'll need to pay it before re-upgrading. Amounts under 1 are forgiven. After removal, your team is downgraded to the free tier immediately.
When you delete a team, any unbilled usage of 1ormoreischargedasafinalinvoice.Discountsandpromotionalcreditsareappliedtothisfinalinvoicejustlikeregularbilling.Amountsunder1 or more is charged as a final invoice. Discounts and promotional credits are applied to this final invoice just like regular billing. Amounts under 1 are forgiven. After the final invoice, your team enters a 30-day soft-delete period.