Credits & limits
Crisps meters usage in credits per organization. Every response reports usage in its headers, so you always know the exact cost of a call.
Credit costs
Section titled “Credit costs”| Operation | Cost |
|---|---|
Search — basic | 1 credit |
Search — advanced | 2 credits |
Answer (include_answer) | + surcharge on top of the search |
Extract — basic | 1 credit per 5 successful URLs |
Extract — advanced | 2 credits per 5 successful URLs |
| Map | 1 credit per 10 pages (2 per 10 with instructions) |
| Crawl | like extract — per successfully extracted page (by extract_depth) |
Only successful extractions and mappings are billed — failed URLs are free.
Usage headers
Section titled “Usage headers”Every metered response carries:
| Header | Description |
|---|---|
X-Credits-Limit | Monthly credit allowance. |
X-Credits-Used | Credits used this month (including this call). |
X-Credits-Remaining | Credits left this month. |
X-RateLimit-Limit | Requests allowed per minute on your plan. |
X-RateLimit-Remaining | Requests left in the current window. |
Set include_usage: true on a request to also get a usage object in the body.
Rate limits
Section titled “Rate limits”Requests are rate-limited per minute by plan. Exceeding the limit returns
429 Too Many Requests with a Retry-After header — back off and
retry. Track credits and requests, and change plan, from the dashboard at
app.crisps.ai.
Idempotency
Section titled “Idempotency”Pass an Idempotency-Key header to make a request safe to retry — Crisps
de-duplicates repeated calls with the same key within your organization, so a
retried request is billed exactly once.
curl -X POST https://api.crisps.ai/search \ -H "Authorization: Bearer $CRISPS_API_KEY" \ -H "Idempotency-Key: 2f9c1a7e-…" \ -H "Content-Type: application/json" \ -d '{"query": "…"}'