Guides
Units
How Thunderbit units work: per-endpoint cost, when units are deducted, refunds for cancelled or failed pages, and how to monitor usage in production.
Each API call consumes units from your account.
Cost per operation
| Operation | Units per Request |
|---|---|
| Distill (single page) | 1 unit |
| Extract (single page) | 20 units |
| Batch Distill | 1 unit per URL |
| Batch Extract | 20 units per URL |
| Batch Status Check | Free |
| Batch Cancel | Free |
Deduction order
Bonus units are consumed first, then monthly plan units.
Failed requests
- 4xx caused by your input (invalid URL, bad schema, missing auth) — no unit consumed.
- Target-site failures (404, timeout, anti-bot) — units are only deducted if any data was returned.
- 5xx on our side — never billed.
When a batch contains a mix of successes and failures, only the successful URLs are billed.