# Krawl Pricing

Krawl offers two ways to pay: **API key plans** (with per-month quotas) and **x402 pay-per-request** for autonomous agents that don't want an account.

## API Key Plans

Authenticate with `X-API-Key: <key>`. Keys look like `krawl_live_...`, `krawl_demo_...`, or `krawl_test_...`. Quotas reset monthly.

| Plan | Price | Deep krawls/mo | Search credits/mo | Rate limit | Notes |
|------|-------|----------------|-------------------|------------|-------|
| **Demo** | Free | 5 | 100 | 5 / hour | Instant key via `POST /auth/demo-key`, no signup. Expires ~24h. |
| **Free** | $0 / month | 25 | 1,000 | 10 / minute | Default plan for signed-up keys. |
| **Pro** | **$49 / month** | Unlimited | Unlimited | 120 / minute | Flat monthly subscription via Stripe. Best for steady usage. |
| **Pay-as-you-go** | Metered (per request) | Unlimited (metered) | Unlimited (metered) | 60 / minute | Billed per use via Stripe. ~$0.30 per deep krawl, ~$0.05 per search. |

Per-request limits: each deep krawl has a hard **$2.50** LLM-cost ceiling and each
quick search a **$0.40** ceiling (see below). Pro and Pay-as-you-go are unlimited
in volume; Demo and Free have the monthly quotas shown above.

When a metered quota is exhausted on Demo/Free, requests return **HTTP 402** with `{"error": "quota_exceeded", "plan": "...", ...}` and an upgrade hint. The PAYG and Pro plans are unlimited and never hit quota.

All plans include every research mode (deep, quick, crypto, token-analysis, etc.), all source types (web, X, GitHub, academic, crypto, media, community), full markdown reports with citations, and SSE streaming.

## Usage & Billing

- **Check usage**: `GET /usage` returns the current month's rollup (tokens, USD cost, deep/search counts). `GET /usage/events` returns paginated per-request events.
- **Upgrade to Pro / PAYG**: `POST /billing/checkout` creates a Stripe Checkout session.
- **Manage subscription**: `POST /billing/portal` opens the Stripe billing portal.
- Every research request also streams a terminal `usage` SSE event with token counts, `cost_usd`, per-model breakdown, and whether the request hit its cost ceiling.

### Per-request cost ceiling

Each request has a hard LLM-cost ceiling: **$2.50** for deep and **$0.40** for quick. If a request crosses its ceiling, the agent stops gathering and synthesizes a report from what it already has (`ceiling_hit: true` in the `usage` event).

## x402 — Pay Per Request (No Account)

Autonomous agents can pay per request in **USDC on Base** with no signup, using the [x402](https://x402.org) protocol. Available when the server has x402 enabled.

- **Deep research**: $5.00 USDC
- **Quick research**: $1.00 USDC

Flow: call a research endpoint with no `X-API-Key` → receive `HTTP 402` with x402 payment requirements → sign an EIP-3009 USDC authorization → retry with an `X-PAYMENT` header → receive the streamed report plus an `X-PAYMENT-RESPONSE` settlement header. See the API reference for details.

## Enterprise — Contact Us

- Dedicated infrastructure
- Custom source integrations
- SLA guarantees (99.9% uptime)
- Priority support with dedicated account manager
- Volume pricing
- On-premise deployment option
- Custom LLM model selection
- API usage analytics dashboard

## Getting Started

```bash
# Get a free demo key instantly (no signup)
curl -X POST https://api.krawl.sh/auth/demo-key

# Start researching
curl -X POST https://api.krawl.sh/research \
  -H "X-API-Key: your_key" \
  -H "Content-Type: application/json" \
  -d '{"query": "your topic", "mode": "deep"}'

# Check your usage
curl https://api.krawl.sh/usage -H "X-API-Key: your_key"
```

Contact: support@krawl.sh