Introduction - Classify

Classify answers what a page is about. Fast, accurate, and cheap.

Two lanes

Indexed

The URL is already in the index. You get its classifications instantly.

On-demand

The URL isn’t indexed yet, so we fetch and classify it live. Best-effort by design, and you’re never charged for a URL we can’t classify. Every classified URL joins the index.

The response tells you which lane served each URL, and billing follows the lane. See Billing for the full model.

Endpoints

Endpoint	What it does
`POST /v1/classify`	Classify up to 1000 URLs per request
`POST /v1/search`	Semantic search over the live index
`GET /v1/jobs/{job_id}`	Poll an on-demand classification job
`GET /health`	Unauthenticated liveness check

Bring your own key: request one in a minute, then try every endpoint in the API Reference.