Credits
How Chuger bills usage in credits — per-endpoint cost, monthly allowance, top-ups, and the credit-management endpoints.
Chuger bills usage in credits. Every plan ships with a monthly credit allowance, and each endpoint deducts a fixed number of credits per successful request. Failed requests are never billed.
Credit cost per endpoint
| Endpoint | Basic | Pro | Business |
|---|---|---|---|
/v1/scrape | 1 | 1 | 1 |
/v1/content | 2 | 2 | 2 |
/v1/serp | 5 | 5 | 5 |
/v1/serp/content | 5 + 2/result | 5 + 2/result | 5 + 2/result |
/v1/prompt | 10 | 10 | 10 |
/v1/content/bulk is billed per URL successfully extracted at the /v1/content rate. /v1/serp/content deducts the /v1/serp cost plus the /v1/content cost for every result page that was actually fetched (capped by your max_content value).
When credits are deducted
- Credits are only deducted on a successful result. If we can't fulfill the request and return an error, you are not charged.
- For bulk operations, each successful URL is billed individually as it completes — failures within a batch don't cost credits.
- Credit deduction happens after the response is produced, so you'll see the new balance reflected on the next call.
Monthly allowance
Every plan comes with a monthly credit pool:
| Plan | Monthly credits |
|---|---|
| Basic | 6,000 |
| Pro | 20,000 |
| Business | 90,000 |
The monthly pool resets at the start of each calendar month. Unused allowance credits do not roll over to the next month.
Top-ups
If you need more credits between monthly renewals — or want to keep a reserve on hand — you can buy a one-time top-up at any time, on any plan.
Top-up credits:
- Sit on top of your monthly allowance — they don't replace it.
- Persist beyond the monthly reset — they don't expire at month end.
- Are consumed only after your monthly allowance is exhausted.
See Purchase credits for the API call that initiates a Stripe Checkout session.
Managing credits via the API
A small set of endpoints lets you inspect your balance, audit usage, preview costs, and buy top-ups. All of them are free to call and not subject to rate limits.
| Endpoint | What it does |
|---|---|
| Get balance | Current balance, monthly limit, used amount, low-balance status |
| List transactions | Paginated audit log of credit-consuming actions |
| Preview cost | What an upcoming call (or batch) would cost — no deduction |
| Check affordability | Same as preview cost, with a top-level can_afford flag for in-app gating |
| Usage stats | Compact summary of the current period's usage |
| Purchase credits | Start a Stripe Checkout session for a top-up |
Running out of credits
When you don't have enough credits Chuger returns 402 Payment Required with a stable error code, INSUFFICIENT_CREDITS. Your client can detect this case and prompt the user to upgrade or buy a top-up.
See Errors for the full error reference and recommended handling.