> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truscan.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Pricing

> The rate card, and how a request turns into a charge.

Truscan is usage-based. There is no subscription and no per-seat fee. You are
charged for the work each request actually does.

## Rate card

| Item                        |                 Price |
| --------------------------- | --------------------: |
| `instant` search            |  \$7.00 / 1k requests |
| `deep` search               | \$12.00 / 1k requests |
| `deep_reasoning` search     | \$15.00 / 1k requests |
| Additional result beyond 10 |  +\$1.00 / 1k results |
| Content extraction          |     \$1.00 / 1k pages |

Every request includes **10 results** at no extra charge. Only results past the
tenth carry the additional rate.

<Note>
  The live card is served from `GET /api/billing/pricing`, generated from the
  same constants that bill a request, so what you read and what you pay cannot
  drift apart.
</Note>

## How a charge is built

A charge has a base and up to two additions:

```
total = tier base
      + (results beyond 10 × additional rate)
      + (pages enriched × extraction rate)
```

A `deep` search with `limit: 25` and `enrich: true` costs:

| Component          |     Units |         Micro-dollars |
| ------------------ | --------: | --------------------: |
| `deep` base        | 1 request |                12,000 |
| Additional results |        15 |                15,000 |
| Content extraction |  25 pages |                25,000 |
| **Total**          |           | **52,000** (`$0.052`) |

## Micro-dollars

All amounts are integers in **micro-dollars** to avoid floating-point rounding:

```
1 USD = 1,000,000 micro-dollars
```

Fields ending in `_micros` are always integers. Fields ending in `_display` are
pre-formatted strings for showing to a person.

## Quoting before you spend

`POST /api/billing/quote` prices an operation without charging for it:

```bash theme={null}
curl https://api.truscan.co/api/billing/quote \
  -H "Authorization: Bearer $TRUSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operation": "search", "tier": "deep", "units": 1, "results": 25}'
```

```json theme={null}
{
  "success": true,
  "result": {
    "charge": {
      "operation": "search",
      "tier": "deep",
      "units": 1,
      "extra_results": 15,
      "base_micros": 12000,
      "extra_micros": 15000,
      "total_micros": 27000
    },
    "display": "$0.027"
  }
}
```

<Tip>
  Cached searches are not billed. An identical query at the same tier is served
  from cache and costs nothing.
</Tip>