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

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.

Structured verticals

POST /search/{vertical} — structured results from a specific source, normalized to a clean schema.

Vertical	Cost
`products` (shopping)	2 credits
`images`	2 credits
`places` (maps)	1 credit
`news`	1 credit
`jobs`	1 credit
`realestate`	1 credit
`youtube_transcript`	1 credit
`amazon`	1 credit
`scholar`	1 credit
`patents`	1 credit
`trends`	1 credit
`finance`	1 credit
`bing`	1 credit
`duckduckgo`	1 credit
`brave`	1 credit

/extract on a YouTube URL auto-returns the transcript at the standard extract cost.

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

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

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": "…"}'