The Text Classification API provides automated document categorization and keyword classification for enterprise text analysis workflows. It supports structured ingestion, preprocessing, classification, and confidence scoring for operational intelligence systems.

Base URL

https://api.example.com/v1

Supported Formats

• JSON
• UTF-8 encoded text
• REST API architecture

Header Format

Authorization: Bearer YOUR_API_KEY

Example

Authorization: Bearer sk_live_7x93_example_key

• POST /classify-text — Classify input text
• POST /clean-text — Normalize text
• GET /models — Retrieve models
• GET /health — API health status

Endpoint

POST /v1/classify-text

Request Body

{
  "text": "The manufacturing workflow failed during calibration validation.",
  "model": "operations-classifier",
  "language": "en"
}

cURL Example

curl -X POST https://api.example.com/v1/classify-text \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"text":"The manufacturing workflow failed during calibration validation.",
"model":"operations-classifier",
"language":"en"
}'

{
  "status": "success",
  "classification": {
    "category": "Operational Compliance",
    "confidence_score": 0.94,
    "keywords": [
      "manufacturing",
      "workflow",
      "calibration",
      "validation"
    ]
  },
  "processing_time_ms": 182
}

400 Bad Request

Missing required parameters.

{
  "error": {
    "code": 400,
    "message": "Missing required parameter: text"
  }
}

401 Unauthorized

Invalid API token.

429 Rate Limit

Too many requests.