Batch categorization

Up to a hundred items against your taxonomy in one call — products, transactions, tickets — each with a confidence.

POST /v1/categorize$0.03/batch · 3 credits, charged only on success

Send this

{
  "items": [
    "AWS invoice June",
    "Uber to airport",
    "Figma annual"
  ],
  "taxonomy": [
    "software",
    "travel",
    "office",
    "other"
  ]
}

Every response carries usage — the credits burned and your remaining balance. A failed call never burns credits.

Try it live against your own key in the interactive reference; every account gets 500 free credits a month, no card.

Get this back

{
  "results": [
    {
      "index": 0,
      "category": "software",
      "confidence": 0.97
    },
    {
      "index": 1,
      "category": "travel",
      "confidence": 0.98
    },
    {
      "index": 2,
      "category": "software",
      "confidence": 0.96
    }
  ],
  "usage": {
    "credits": 3,
    "balanceRemaining": 355
  }
}

Four ways in. Same $0.03/batch.

curl

curl https://api.kynth.studio/v1/categorize \
  -H "Authorization: Bearer ksk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"items":["AWS invoice June","Uber to airport","Figma annual"],"taxonomy":["software","travel","office","other"]}'

TypeScript

import { KynthCore } from "@kynth/api";

const kynth = new KynthCore({ apiKey: process.env.KYNTH_API_KEY! });
const result = await kynth.categorize({
  "items": [
    "AWS invoice June",
    "Uber to airport",
    "Figma annual"
  ],
  "taxonomy": [
    "software",
    "travel",
    "office",
    "other"
  ]
});

Python

from kynth import Kynth

client = Kynth(api_key=os.environ["KYNTH_API_KEY"])
result = client.categorize(
    items=[
    "AWS invoice June",
    "Uber to airport",
    "Figma annual"
  ],
    taxonomy=[
    "software",
    "travel",
    "office",
    "other"
  ],
)

MCP

// One-time setup in your MCP client (Claude, Cursor, …):
{ "mcpServers": { "kynth-core": {
    "command": "npx", "args": ["@kynth/api-mcp"],
    "env": { "KYNTH_API_KEY": "ksk_live_…" } } } }

// Then the agent just calls the kynth_categorize tool.

More from extract & structure

Field extraction

$0.04/call

Pull a field set you define out of any block of text. You name the fields; you get typed values with confidence.

Classification

$0.02/call

Route or tag text against your own taxonomy — a label, a confidence, and a one-line rationale.

Guaranteed structure

$0.06/call

Any messy input — text, HTML, an email — plus YOUR JSON schema → output that conforms to it. Retries and validation handled.

Get your key — 500 free credits monthly