Katteb API

Queue an article for background generation. Returns a job ID for polling. Credits deducted immediately.

Parameters

Example Request

curl -X POST "https://app.katteb.com/api/v2/?endpoint=articles/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "Best AI Writing Tools in 2026",
    "language": "English",
    "country": "us",
    "word_count": 1500,
    "enhancements": ["featured_image", "tldr"]
  }'

Response 201

{
  "success": true,
  "job_id": 4521,
  "topic": "Best AI Writing Tools in 2026",
  "credits_charged": 2005,
  "estimated_time": "2-5 minutes",
  "status": "pending",
  "poll_url": "?endpoint=articles/get&id=4521"
}

Poll this endpoint to check article generation progress. Content is returned when status is "completed".

Example

curl "https://app.katteb.com/api/v2/?endpoint=articles/get&id=4521" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response (completed) 200

{
  "success": true,
  "job_id": 4521,
  "topic": "Best AI Writing Tools in 2026",
  "status": "completed",
  "progress": 100,
  "content_html": "<h1>Best AI Writing Tools...</h1><p>...</p>",
  "featured_image": "https://...",
  "meta_title": "Best AI Writing Tools in 2026",
  "meta_description": "Discover the top AI writing...",
  "word_count": 1523
}

Status Values

pending	Queued, waiting for worker
processing	Being generated (check progress %)
completed	Done — full content available
failed	Generation failed — see error_detail
cancelled	Cancelled by user

curl "https://app.katteb.com/api/v2/?endpoint=articles/list&page=1&limit=10&status=completed" \
  -H "Authorization: Bearer YOUR_API_KEY"

Cancel a pending or scheduled article. Credits are automatically refunded.

curl -X DELETE "https://app.katteb.com/api/v2/?endpoint=articles/cancel&id=4521" \
  -H "Authorization: Bearer YOUR_API_KEY"

Submit a URL or raw text for AI-powered SEO analysis. Returns a job ID for polling.

curl -X POST "https://app.katteb.com/api/v2/?endpoint=seo/analyze" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "url",
    "value": "https://example.com/blog-post",
    "keyword": "ai writing tools"
  }'

Response 201

{
  "success": true,
  "job_id": 4522,
  "keyword": "ai writing tools",
  "credits_charged": 1000,
  "estimated_time": "1-3 minutes",
  "status": "pending",
  "poll_url": "?endpoint=seo/get&id=4522"
}

curl "https://app.katteb.com/api/v2/?endpoint=seo/get&id=4522" \
  -H "Authorization: Bearer YOUR_API_KEY"

Analyze text to determine the probability that it was written by AI. Returns a 0–100 score and a human-readable verdict. Synchronous — returns results immediately.

Parameters

Example Request

curl -X POST "https://app.katteb.com/api/v2/?endpoint=humanizer/detect" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "The landscape of artificial intelligence continues to evolve rapidly, with new paradigms emerging that leverage cutting-edge transformer architectures.",
    "language": "English"
  }'

Response 200

{
  "success": true,
  "ai_probability": 92,
  "verdict": "likely_ai",
  "credits_charged": 1,
  "word_count": 18
}

Verdict Values

likely_human	AI probability < 30%
mixed	AI probability 30–69%
likely_ai	AI probability ≥ 70%

Rewrite text to sound naturally human while preserving meaning. Supports strength levels and optional brand voice. Synchronous — returns rewritten text immediately.

Parameters

Example Request

curl -X POST "https://app.katteb.com/api/v2/?endpoint=humanizer/rewrite" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "The landscape of artificial intelligence continues to evolve rapidly.",
    "strength": "Strong",
    "language": "English",
    "add_imperfections": true
  }'

Response 200

{
  "success": true,
  "rewritten_text": "AI is moving fast, and honestly it's hard to keep up sometimes. What I've seen in the last year alone...",
  "strength": "Strong",
  "language": "English",
  "credits_charged": 100,
  "original_length": 68,
  "rewritten_length": 102
}

Verify a factual claim using AI-powered web search. Returns a TRUE/FALSE/INCONCLUSIVE verdict with explanation and source references. Synchronous — returns results immediately.

Parameters

Example Request

curl -X POST "https://app.katteb.com/api/v2/?endpoint=factcheck/verify" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "The Great Wall of China is visible from space with the naked eye."
  }'

Response 200

{
  "success": true,
  "verdict": "FALSE",
  "is_fact": false,
  "explanation": "The Great Wall of China is not visible from space with the naked eye. Multiple astronauts and NASA have confirmed this is a common misconception.",
  "search_query": "is Great Wall of China visible from space",
  "references": [
    {
      "url": "https://www.nasa.gov/...",
      "title": "NASA - Great Wall Visibility"
    }
  ],
  "credits_charged": 100,
  "word_count": 13
}

Verdict Values

TRUE	Claim is factually accurate based on web sources
FALSE	Claim is factually inaccurate
INCONCLUSIVE	Not enough evidence to determine accuracy

curl "https://app.katteb.com/api/v2/?endpoint=account/credits" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "success": true,
  "credits": 25000,
  "credits_total": 50000,
  "plan_type": "pro",
  "plan_tier": "pro",
  "api_usage_today": { "heavy": 3, "read": 12 }
}

curl "https://app.katteb.com/api/v2/?endpoint=account/limits" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get all your writing styles with their IDs. Use the id as writing_style_id in articles/generate.

Writing styles are created in the Katteb dashboard under Writer → Writing Style. Each style defines tone, formatting rules, and example text that the AI follows.

curl "https://app.katteb.com/api/v2/?endpoint=styles/list" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response 200

{
  "success": true,
  "styles": [
    {
      "id": 42,
      "name": "Conversational Blog",
      "description": "Friendly, engaging tone with short paragraphs",
      "is_active": true,
      "created_at": "2026-03-15 10:30:00"
    },
    {
      "id": 38,
      "name": "Technical Documentation",
      "description": "Formal, precise language with code examples",
      "is_active": false,
      "created_at": "2026-02-20 14:15:00"
    }
  ],
  "count": 2,
  "hint": "Use the 'id' value as 'writing_style_id' in articles/generate."
}

Get all your brands/workspaces with their IDs. Use the id as brand_id in articles/generate or seo/analyze.

curl "https://app.katteb.com/api/v2/?endpoint=brands/list" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response 200

{
  "success": true,
  "brands": [
    {
      "id": 15,
      "name": "My Tech Blog",
      "url": "https://mytechblog.com",
      "created_at": "2026-01-10 08:00:00"
    }
  ],
  "count": 1,
  "hint": "Use the 'id' value as 'brand_id' in articles/generate or seo/analyze."
}