Classify Any URL
Any Taxonomy
One API Call

# classify raw text — 1 credit
curl -X POST https://api.classivore.com/v1/classify \
  -H "Authorization: Bearer $CV_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "iab-2.2",
    "text": "Tesla announced a new Model Y today...",
    "options": { "max_labels": 3, "min_confidence": 0.5 }
  }'

import os
import requests

# ——— classify raw text — 1 credit ———
r = requests.post(
    "https://api.classivore.com/v1/classify",
    headers={"Authorization": f"Bearer {os.environ['CV_KEY']}"},
    json={
        "model": "iab-2.2",
        "text": "Tesla announced a new Model Y today...",
        "options": {"max_labels": 3, "min_confidence": 0.5},
    },
    timeout=30,
)
r.raise_for_status()
for cat in r.json()["categories"]:
    crumb = " › ".join(cat["path"]) or cat["name"]
    print(f"{crumb:48} {cat['confidence']:.2f}")

# ——— URL input (scrape + classify in one call) — 2 credits ———
r = requests.post(
    "https://api.classivore.com/v1/classify/url",
    headers={"Authorization": f"Bearer {os.environ['CV_KEY']}"},
    json={"url": "https://arstechnica.com/ev-roadmap"},
    timeout=30,
)

// classify raw text — 1 credit — requires Node 18+ (global fetch)
const resp = await fetch("https://api.classivore.com/v1/classify", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.CV_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "iab-2.2",
    text: "Fed raised rates by 25bps...",
    options: { max_labels: 3, min_confidence: 0.5 },
  }),
});

if (!resp.ok) throw new Error(`${resp.status} ${await resp.text()}`);

const { categories } = await resp.json();
for (const c of categories) {
  const crumb = c.path.join(" › ") || c.name;
  console.log(`${crumb.padEnd(48)} ${c.confidence.toFixed(2)}`);
}