katsau Docs
GET/v1/classify

AI-powered content classification, topic extraction, and sentiment analysis.

Enterprise

🧠 AI Content Classification

Automatically categorize URLs, extract topics, detect language, analyze sentiment, and identify entities. Perfect for content curation and audience targeting.

Query Parameters

NameTypeRequiredDefaultDescription
urlstring-URL to classify
include_entitiesbooleanfalseExtract named entities (people, orgs)
include_sentimentbooleanfalseAnalyze content sentiment

Request Example

curl "https://api.katsau.com/v1/classify?url=https://techcrunch.com/article&include_entities=true&include_sentiment=true" \
  -H "Authorization: Bearer ks_live_your_api_key"

Response

{
  "success": true,
  "data": {
    "url": "https://techcrunch.com/2024/01/15/ai-startup-funding",
    
    "content_type": "article",
    
    "classification": {
      "primary_category": "Technology",
      "secondary_category": "Business",
      "confidence": 0.92
    },
    
    "topics": [
      { "name": "artificial intelligence", "score": 0.95 },
      { "name": "startup", "score": 0.88 },
      { "name": "venture capital", "score": 0.75 },
      { "name": "funding", "score": 0.72 }
    ],
    
    "entities": [
      { "name": "OpenAI", "type": "organization" },
      { "name": "Sam Altman", "type": "person" },
      { "name": "Microsoft", "type": "organization" }
    ],
    
    "language": {
      "code": "en",
      "name": "English",
      "confidence": 0.95
    },
    
    "sentiment": {
      "label": "positive",
      "score": 0.72
    },
    
    "reading_time": {
      "minutes": 5,
      "words": 1024
    },
    
    "publish_info": {
      "date": "2024-01-15T10:00:00Z",
      "author": "Sarah Smith",
      "publisher": "TechCrunch"
    }
  },
  "meta": {
    "request_id": "req_abc123xyz",
    "response_time_ms": 567
  }
}

Supported Categories

Content is classified into these primary categories:

Technology
Software, AI, startups, coding
Business
Finance, marketing, enterprise
News
Breaking news, politics, reports
Entertainment
Movies, music, gaming, TV
Education
Courses, tutorials, universities
E-commerce
Shopping, products, deals
Health & Wellness
Medical, fitness, nutrition
Travel
Hotels, flights, destinations
Food & Cooking
Recipes, restaurants, cuisine
Sports
Games, scores, athletes

Content Types

The content_type field identifies what the page is:

articleproductvideoprofilehomepagewebsite

Sentiment Analysis

When include_sentiment=true, we analyze the title and description:

LabelScore Range
positive> 0.6
neutral0.4 - 0.6
negative< 0.4

Use Cases

  • •Content Curation: Auto-categorize articles for news aggregators
  • •Ad Targeting: Understand page context for relevant ads
  • •Brand Monitoring: Track sentiment of mentions and articles
  • •Lead Scoring: Understand industry/interests from company homepages