> ## 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.

# Truscan

> A search API that returns ranked results and readable page content in one call.

Truscan runs a query across the web, merges and re-ranks the results, and
optionally extracts the readable text of each page, all in a single request.
It is built for agents and applications that need to *read* the web, not just
link to it.

```bash theme={"dark"}
curl https://api.truscan.co/api/search/query \
  -H "Authorization: Bearer $TRUSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "how does the TLS 1.3 handshake work", "tier": "instant"}'
```

## What you get back

Every result carries a `score` and the six `components` that produced it, so
ranking is inspectable rather than opaque:

<CardGroup cols={2}>
  <Card title="Ranked results" icon="list-ol" href="/search/results">
    URL, title, snippet, domain, score, and the per-signal breakdown behind it.
  </Card>

  <Card title="Page content" icon="file-lines" href="/search/contents">
    Readable `text` and `markdown` for each result, with word count and language.
  </Card>

  <Card title="Three depth tiers" icon="layer-group" href="/search/tiers">
    Trade latency for recall: `instant`, `deep`, or `deep_reasoning`.
  </Card>

  <Card title="Usage-based pricing" icon="receipt" href="/billing/pricing">
    Priced per request in micro-dollars. No subscription, no seats.
  </Card>
</CardGroup>

## Base URL

All endpoints are served from a single host:

```
https://api.truscan.co
```

<Note>
  Every request needs an `Authorization: Bearer` header. See
  [Authentication](/authentication) to create a key.
</Note>

## Start here

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    From zero to your first ranked result.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Create an API key and make your first authenticated call.
  </Card>
</CardGroup>