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"

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."
}