# Truscan

> Search API for agents and applications. Ranked results and readable page content in one call.

- [Truscan](https://docs.truscan.co/index.md): A search API that returns ranked results and readable page content in one call.
- [Quickstart](https://docs.truscan.co/quickstart.md): Create a key and run your first search.
- [Authentication](https://docs.truscan.co/authentication.md): API keys, session tokens, and which endpoints are public.
- [Search tiers](https://docs.truscan.co/search/tiers.md): Trade latency and cost for recall depth.
- [Results and ranking](https://docs.truscan.co/search/results.md): Filtering a query, reading a result, and the six signals behind every score.
- [Extract](https://docs.truscan.co/extract/overview.md): Readable text and markdown from URLs you already have.
- [Answer](https://docs.truscan.co/answer/overview.md): A question in, an answer out, with every sentence quoted from the page it cites.
- [Webhooks](https://docs.truscan.co/webhooks/overview.md): Receive a signed POST when something happens on your account.
- [Events](https://docs.truscan.co/webhooks/events.md): Everything Truscan can notify you about, and the shape of each payload.
- [Verifying signatures](https://docs.truscan.co/webhooks/verify.md): Confirm a delivery came from Truscan before you act on it.
- [Retries and delivery](https://docs.truscan.co/webhooks/retries.md): What happens when your endpoint is down, and how to see it.
- [Pricing](https://docs.truscan.co/billing/pricing.md): The rate card, and how a request turns into a charge.
- [Credits and usage](https://docs.truscan.co/billing/credits.md): Your balance, the monthly free grant, topping up, and the audit trail.
- [Errors](https://docs.truscan.co/reference/errors.md): The response envelope, status codes, and how to handle each failure.
- [Rate limits and quotas](https://docs.truscan.co/reference/rate-limits.md): Per-endpoint request limits, field maximums, and account quotas.
- [Run a search](https://docs.truscan.co/api-reference/run-a-search.md)
- [Extract readable content for URLs, without searching](https://docs.truscan.co/api-reference/extract-readable-content-for-urls-without-searching.md)
- [Answer a question with citations](https://docs.truscan.co/api-reference/answer-a-question-with-citations.md)
- [The subscribable event catalogue](https://docs.truscan.co/api-reference/the-subscribable-event-catalogue.md)
- [Your endpoints](https://docs.truscan.co/api-reference/your-endpoints.md): The signing secret is never included. It is returned once, by the create call.
- [Add an endpoint](https://docs.truscan.co/api-reference/add-an-endpoint.md): The response is the only time the signing secret is readable.
- [Update an endpoint](https://docs.truscan.co/api-reference/update-an-endpoint.md)
- [Delete an endpoint](https://docs.truscan.co/api-reference/delete-an-endpoint.md): Queued deliveries for this endpoint are removed with it.
- [Send a test event](https://docs.truscan.co/api-reference/send-a-test-event.md): Queues a `ping` event so an endpoint can be verified without waiting for real activity.
- [Recent delivery attempts](https://docs.truscan.co/api-reference/recent-delivery-attempts.md)
- [List your request history](https://docs.truscan.co/api-reference/logs/list-your-request-history.md): Newest first. Scoped to the authenticated account — there is no parameter for reading another account's history.
- [Headline counts for a window](https://docs.truscan.co/api-reference/logs/headline-counts-for-a-window.md): Latency quantiles are approximate by design; an exact quantile over millions of rows is not worth the scan.
- [List live API keys](https://docs.truscan.co/api-reference/keys/list-live-api-keys.md): Revoked keys are omitted. The secret is never returned, only the last four characters, so keys can be told apart.
- [Create an API key](https://docs.truscan.co/api-reference/keys/create-an-api-key.md): The `secret` in the response is the ONLY time the raw key exists outside the caller's hands. Only its SHA-256 fingerprint is stored, so it cannot be shown again or recovered.
- [Revoke an API key](https://docs.truscan.co/api-reference/keys/revoke-an-api-key.md): Revocation is immediate: the cached identity is dropped in the same call, so the key stops working at once rather than when a cache entry expires.
- [Changelog](https://docs.truscan.co/changelog.md): What changed, newest first.

## OpenAPI Specs

- [answer](/api-reference/answer.json)
- [auth](/api-reference/auth.json)
- [extract](/api-reference/extract.json)
- [logs](/api-reference/logs.json)
- [search](/api-reference/search.json)
- [webhooks](/api-reference/webhooks.json)