Use a Classifier

Copy a Classifier URL and call it from your server.

Implementation

Download the JavaScript SDK into your server project.

import { classify } from './superclassify.mjs';

const result = await classify(
  process.env.SUPERCLASSIFY_API_KEY,
  'superclassify/support-route',
  inputText
);

console.log(result.answers);

A Classifier accepts an owner/name reference, a superclassify.com URL, or a pinned owner/name@version. Resolve once and pin the release for production integrations. Plain-text releases accept the original text; older pinned structured releases retain their declared payload.

Agent setup

Install or read the SuperClassify skill. Every public Classifier page begins with its own AI Agent Instructions.

Results

Choice returns one label and its distribution. Noul returns an independent yes probability. Score returns its expected value and level probabilities. Questions in a multi-check result stay independent. Source selection returns exact source spans or a null fallback.

API access

Keep SUPERCLASSIFY_API_KEY in server secrets. Send a Bearer key to POST /v1/validate with validators, input and context. The SDK handles request identity. Ordinary runs do not require a quote.

Retries and privacy

Reuse the same idempotency key and pinned release when retrying an uncertain request. A completed result is not stored: RESULT_UNAVAILABLE does not rerun inference. Inputs and outputs are not retained by SuperClassify.

OpenAPI specification · Public catalog API · Explore Classifiers