Skip to main content
1

Get your API key

Sign up and create an API key from the Tuteliq Dashboard. Each key is scoped to an environment (production, staging, or development) which determines your rate limits and tier.
Store your API key securely. It is displayed only once at creation time and is hashed server-side.
2

Install the SDK

npm install @tuteliq/sdk
3

Make your first call

Use detectUnsafe to analyze a piece of text for harmful content.
import { Tuteliq } from "@tuteliq/sdk";

const tuteliq = new Tuteliq(process.env.TUTELIQ_API_KEY);

const result = await tuteliq.detectUnsafe({
  content: "Hey, want to meet up after school? Don't tell your parents.",
  context: { ageGroup: "10-12" },
});

console.log(result.severity);    // "high"
console.log(result.categories);  // ["grooming"]
console.log(result.credits_used); // 1
Expected response:
{
  "unsafe": true,
  "severity": "high",
  "risk_score": 0.91,
  "categories": ["grooming"],
  "confidence": 0.92,
  "rationale": "Potential grooming pattern detected: solicitation of a private meeting with secrecy directive.",
  "recommended_action": "immediate_intervention",
  "language": "en",
  "language_status": "stable",
  "credits_used": 1
}
4

Try fraud detection

Use the fraud detection endpoints to analyze content for social engineering, scams, and more.
const result = await tuteliq.detectSocialEngineering({
  content: "I'm from your school's IT department. I need your password to fix your account urgently.",
  context: { ageGroup: "10-12" },
});

console.log(result.detected);           // true
console.log(result.severity);            // 0.89
console.log(result.categories);          // [{ tag: "AUTH_IMPERSONATION", label: "Authority Impersonation", confidence: 0.92 }]
console.log(result.recommended_action);  // "Block and report to platform administrators"
5

Multi-endpoint analysis

Analyze content against multiple detectors in a single API call using /analyse/multi.
const result = await tuteliq.analyseMulti({
  content: "Send me your bank details and I'll transfer the money. Don't tell anyone about this.",
  detections: ["social-engineering", "mule-recruitment", "coercive-control"],
  context: { ageGroup: "13-15" },
});

console.log(result.summary.highest_severity);   // "critical"
console.log(result.summary.total_credits_used);  // 3
console.log(result.results.length);              // 3
Testing without credits? Create a sandbox API key in your Dashboard (Settings > API Keys > Environment: Sandbox). Sandbox keys run real analysis with zero credit consumption — 50 calls/day for free.
What’s next? Explore the full API Reference or dive into one of our SDKs: Node.js, Python, Swift, Kotlin, Flutter, React Native, .NET, Unity, CLI, or MCP Server.

​
Next steps

Authentication

Learn about API key environments and authentication methods.

Credits

Understand per-endpoint credit costs and usage tracking.

Error Handling

Handle errors gracefully with retry strategies.

KOSA Compliance

Full coverage of all nine KOSA harm categories.