Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getchatads.com/llms.txt

Use this file to discover all available pages before exploring further.

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 - 500 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 500 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 500-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, and language_not_allowed 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 500 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.If your team uses ChatAside, your free tier limits are automatically upgraded to 500/day and 10,000/month on the first widget impression.
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 ChatAds payment fails:
  1. You’ll receive an email notification
  2. Your team is downgraded to the free tier immediately (including any paid ChatAside widget tier)
  3. A banner appears in the dashboard prompting you to update your payment method
If a ChatAside widget payment fails, you’ll receive an email notification and your ChatAds plan is not affected. For monthly renewal failures, your widget tier is downgraded to free. For mid-month upgrade (proration) failures, your widget tier reverts to your previous paid tier instead of dropping to free.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. When a widget invoice is successfully retried, your widget tier is automatically restored to its pre-failure level.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. When you change your ChatAside widget tier (upgrade or downgrade), a confirmation email is sent to you directly. To change who receives payment notifications, update team ownership in Team > Members.
Go to Billing > Invoices and click the download button next to any invoice to get a PDF copy. ChatAside invoices are available separately on the ChatAside Plan & Billing page.
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 ChatAds plan is downgraded to the free tier immediately. If you have a paid ChatAside widget tier, it remains active through the end of the current month and is scheduled for downgrade to free on the 1st of the next month — the same deferred downgrade behavior as changing your widget tier directly. If you re-add a payment method before the 1st, the scheduled widget downgrade is cancelled and your widget tier is preserved.
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.
ChatAside widget plans are billed separately from ChatAds API usage:
  • Free — $0/month, 100 messages/day, 6,000 character page context, “Powered by ChatAside” branding
  • Pro — $19/month, 500 messages/day, 15,000 character page context, no branding
  • Business — $39/month, 1,500 messages/day, 15,000 character page context, no branding
Manage your ChatAside plan at Plan & Billing. Paid tiers require a credit card on file. Upgrades take effect immediately with a prorated charge for the remainder of the month (prorations under $1 are waived). Downgrades and cancellations are scheduled for the 1st of the next month — you keep your current tier’s limits until then, and can cancel the scheduled change at any time. ChatAside invoices appear on the ChatAside billing page (not the main ChatAds billing page) and download as branded “ChatAside Invoice” PDFs. Need more than 1,500 messages/day? Contact chris@getchatads.com.